Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O recomendador de papéis do IAM usa dados de acesso agregado do IAM, coletados durante o uso de serviços emGoogle Cloud, para fornecer recomendações. Esses dados são usados principalmente para fins de conformidade.
Para publicar notificações sobre sua transferência em um tópico existente do Pub/Sub:
Leitor do Pub/Sub (roles/pubsub.viewer)
no projeto que receberá os dados exportados
Para publicar notificações sobre seu tópico em um novo tópico do Pub/Sub:
Editor do Pub/Sub (roles/pubsub.editor)
no projeto para onde você vai exportar dados
Para exportar o histórico de acesso agregado do IAM dos seus projetos para o
BigQuery, use a Central de transparência e controle para configurar uma transferência
de dados:
No Google Cloud console, acesse a página Privacidade e segurança.
Selecione a organização na lista suspensa e clique em Selecionar.
Clique em Transparência e controle.
Na tabela Grupo de processamento de dados, clique em IAM.
Na seção Fontes de dados da página, clique em
AdicionarCriar transferência.
No campo Projeto, clique em Procurar e selecione o projeto para o qual
você quer exportar dados. Se o projeto não tiver a
API BigQuery Data Transfer Service ativada, clique em Ativar API e aguarde até que a API esteja
ativada.
Clique em Next.
Configurar a transferência de dados
No campo Nome de exibição, insira um nome de exibição para sua transferência
de dados.
Na seção Opções de programação, escolha quando a transferência de dados será iniciada
e com que frequência ela será executada.
Para escolher quando iniciar a transferência, use o valor padrão
Começar agora ou clique em Começar no horário definido.
No campo Repetições, escolha uma opção de frequência de execução da
transferência. Se você escolher uma opção diferente de "Diário", outras opções
estarão disponíveis. Por exemplo, se você escolher "Semanal", aparecerá uma opção
para selecionar o dia da semana.
Para Data e hora de início, insira a data e a hora para iniciar a transferência. Se você escolher Iniciar agora, essa opção ficará desativada.
No campo ID do conjunto de dados, escolha um conjunto de dados do BigQuery
para onde os dados serão exportados.
Você pode exportar dados para um conjunto de dados existente ou criar um novo conjunto de dados:
Para exportar dados para um conjunto de dados existente, clique no campo ID do conjunto de dados
e selecione um conjunto de dados na lista suspensa.
Para exportar dados para um novo conjunto de dados, clique no campo ID do conjunto de dados, clique em
Criar novo conjunto de dados e preencha os campos no painel Criar
conjunto de dados:
No campo ID do conjunto de dados, insira um ID para o conjunto de dados. Letras,
números e sublinhados são permitidos.
Na lista suspensa Local dos dados, selecione Estados
Unidos (EUA) ou União Europeia (UE).
Opcional: ative a validade da tabela
selecionando Ativar expiração da tabela.
Opcional: selecione um método de criptografia. O método de criptografia
padrão é Google-managed encryption key. Se você selecionar a
chave de criptografia gerenciada pelo cliente (CMEK, na sigla em inglês), também será necessário selecionar uma
chave gerenciada pelo cliente.
A transferência configurada ficará na mesma região do conjunto de dados e
não poderá ser movida.
No campo project_numbers, insira os números dos projetos
cujos dados de acesso agregado do IAM você quer
exportar. Para listar vários números de projeto, separe-os
com vírgulas. É possível exportar dados de até 10 projetos por vez.
Para encontrar o número de um projeto, faça o seguinte:
No console Google Cloud , acesse a página Configurações.
Opcional: ative as notificações para sua transferência:
Para ativar notificações para execuções de transferência com falha, clique no
botão Notificações por e-mail.
Quando essa opção está ativada, o administrador de transferência
recebe uma notificação por e-mail quando uma execução de transferência falha.
Selecione a organização na lista suspensa e clique em Selecionar.
Clique em Transparência e controle.
Na tabela Grupo de processamento de dados, clique em IAM. A seção Transferências
de dados da página lista todas as transferências
de dados de acesso do IAM agregadas para sua organização.
Para gerenciar uma transferência individual, clique no nome de exibição dela.
Para visualizar todas as transferências de dados em um projeto, incluindo transferências de dados de acesso
agregado do IAM, use o BigQuery:
No Google Cloud console, acesse a página Transferências de dados.
Selecione o projeto para onde você exportou dados.
A página Transferências de dados mostrará todas as transferências de dados do seu projeto,
incluindo transferências de dados de acesso agregado do IAM.
Para gerenciar uma transferência individual, clique no nome de exibição dela.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-11 UTC."],[],[],null,["# Export data for role recommendations\n\nThe [IAM role recommender](/policy-intelligence/docs/role-recommendations-overview) uses aggregated\nIAM access data, collected during the usage of services in\nGoogle Cloud, to provide recommendations. This data is primarily used for\ncompliance purposes.\n\nThis page explains how to export that access data to BigQuery using the\n[BigQuery Data Transfer Service](/bigquery-transfer/docs/introduction).\n\nIf you want to export a snapshot of your insights and recommendations, see\n[Export recommendations to\nBigQuery](/policy-intelligence/docs/export-recommendations).\n\nBefore you begin\n----------------\n\n-\n\n\n Enable the IAM, Resource Manager, Recommender, BigQuery, BigQuery Data Transfer Service, and Pub/Sub APIs.\n\n\n [Enable the APIs](https://console.cloud.google.com/flows/enableapi?apiid=iam.googleapis.com,cloudresourcemanager.googleapis.com,recommender.googleapis.com,bigquery.googleapis.com,bigquerydatatransfer.googleapis.com,pubsub.googleapis.com&redirect=https://console.cloud.google.com)\n\n \u003cbr /\u003e\n\n- Read about [role recommendations](/policy-intelligence/docs/role-recommendations-overview).\n\n### Required permissions\n\n\nTo get the permissions that\nyou need to create a data transfer,\n\nask your administrator to grant you the\nfollowing IAM roles:\n\n- [Data Processing Controls Resource Admin](/iam/docs/roles-permissions/dataprocessing#dataprocessing.admin) (`roles/dataprocessing.admin`) on your organization\n- [BigQuery Admin](/iam/docs/roles-permissions/bigquery#bigquery.admin) (`roles/bigquery.admin`) on the project that you will export data to\n- To publish notifications for your transfer to an existing Pub/Sub topic: [Pub/Sub Viewer](/iam/docs/roles-permissions/pubsub#pubsub.viewer) (`roles/pubsub.viewer`) on the project that you will export data to\n- To publish notifications for your topic to a new Pub/Sub topic: [Pub/Sub Editor](/iam/docs/roles-permissions/pubsub#pubsub.editor) (`roles/pubsub.editor`) on the project that you will export data to\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\nExport aggregated IAM access data\n---------------------------------\n\nTo export your projects' aggregated IAM access history to\nBigQuery, use the Transparency and Control Center to set up a data\ntransfer:\n\n1. In the Google Cloud console, go to the **Privacy \\& Security** page.\n\n [Go to Privacy \\& Security](https://console.cloud.google.com/projectselector/iam-admin/privacy?supportedpurview=organizationId)\n2. Select your organization from the drop-down list, then click **Select**.\n\n3. Click **Transparency \\& control**.\n\n4. In the **Data processing group** table, click **IAM**.\n\n5. In the **Data sources** section of the page, click\n add **Create transfer**.\n\n6. In the **Project** field, click **Browse** , then select the project that\n you want to export data to. If the project does not have the\n BigQuery Data Transfer Service API enabled, click **Enable API** and wait until the API is\n enabled.\n\n7. Click **Next**.\n\n8. Configure the data transfer:\n\n 1. In the **Display name** field, enter a display name for your data transfer.\n 2. In **Schedule options** section, choose when the data transfer will start\n and how often it will run.\n\n - To choose when to start the transfer, you can leave the default value of **Start now** , or click **Start at a set time**.\n - In the **Repeats** field, choose an option for how often to run the transfer. If you choose an option other than Daily, additional options are available. For example, if you choose **Weekly**, an option appears for you to select the day of the week.\n - For **Start date and run time** , enter the date and time to start the transfer. If you choose **Start now**, this option is disabled.\n 3. In the **Dataset ID** field, choose a BigQuery dataset\n to export the data to.\n\n | **Important:** This dataset must have a location of **United States (US)** or **European Union (EU)**. No other regions are supported.\n\n You can export data to an existing dataset, or create a new dataset:\n - To export data to an existing dataset, click the **Dataset ID** field, then select a dataset from the drop-down list.\n - To export data to a new dataset, click the **Dataset ID** field, click\n **Create new dataset** , and fill out the fields in the **Create\n dataset** pane:\n\n 1. In the **Dataset ID** field, enter an ID for the dataset. Letters, numbers, and underscores are allowed.\n 2. From the **Data location** drop-down list, select either **United\n States (US)** or **European Union (EU)**.\n 3. Optional: Enable [table expiration](/bigquery/docs/managing-tables#updating_a_tables_expiration_time) by selecting **Enable table expiration**.\n 4. Optional: Select an encryption method. The default encryption method is **Google-managed encryption key** . If you select **Customer-managed encryption key (CMEK)** , you must also select a [customer-managed key](/kms/docs/cmek).\n\n The transfer you set up will be in the same region as the dataset, and\n cannot be moved.\n 4. In the **project_numbers** field, enter the project numbers for the\n projects whose aggregated IAM access data you want to\n export. If you list multiple project numbers, separate the project\n numbers with commas. You can export data for up to 10 projects at a time.\n\n To find a project's number, do the following:\n 1. In the Google Cloud console, go to the **Settings** page.\n\n [Go to Settings](https://console.cloud.google.com/projectselector/iam-admin/settings?supportedpurview=project)\n 2. Select your project.\n\n 3. Copy the project ID from the **Project number** field.\n\n 5. Optional: Enable notifications for your transfer:\n\n - To enable notifications for failed transfer runs, click the **Email notifications** toggle. When you enable this option, the transfer administrator receives an email notification when a transfer run fails.\n - To enable [Pub/Sub notifications for your\n transfer](/bigquery-transfer/docs/transfer-run-notifications), click **Select a Pub/Sub\n topic**, then select or create a topic.\n9. Click **Done**.\n\n10. If prompted, allow **IAM Recommender Aggregated Access Transfers** access\n to your Google account.\n\nManage existing data transfers\n------------------------------\n\nYou can view and manage your transfers in the Transparency and Control Center, or\nin BigQuery:\n\n- To view all aggregated IAM access data transfers for your\n organization, use the Transparency and Control Center:\n\n 1. In the Google Cloud console, go to the **Privacy \\& Security** page.\n\n [Go to Privacy \\& Security](https://console.cloud.google.com/projectselector/iam-admin/privacy?supportedpurview=organizationId)\n 2. Select your organization from the drop-down list, then click **Select**.\n\n 3. Click **Transparency \\& control**.\n\n 4. In the **Data processing group** table, click **IAM** . The **Data\n transfers** section of the page lists all aggregated IAM\n access data transfers for your organization.\n\n 5. To manage an individual transfer, click the transfer's display name.\n\n- To view all data transfers in a project, including aggregated\n IAM access data transfers, use BigQuery:\n\n 1. In the Google Cloud console, go to the **Data transfers** page.\n\n [Go to Data transfers](https://console.cloud.google.com/projectselector/bigquery/transfers?supportedpurview=project)\n 2. Select the project that you exported data to.\n\n 3. The **Data transfers** page shows all data transfers for your project,\n including aggregated IAM access data transfers.\n\n 4. To manage an individual transfer, click the transfer's display name.\n\nWhat's next\n-----------\n\n- Learn how to [export a snapshot of your recommendations and\n insights](/policy-intelligence/docs/export-recommendations).\n- Understand [best practices for using role recommendations](/policy-intelligence/docs/role-recommendations-best-practices).\n- Find out how to [review and apply recommendations](/policy-intelligence/docs/review-apply-role-recommendations).\n- Learn how to [disable role recommendations](/recommender/docs/opting-out)."]]