O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Programar e executar uma auditoria

As auditorias permitem coletar as evidências necessárias para avaliar sua organização doGoogle Cloud em relação aos frameworks compatíveis. É possível programar uma auditoria para ser executada em um intervalo regular ou executar uma auditoria on demand.

Uma auditoria é uma operação de longa duração que pode levar algumas horas. A duração depende do número de recursos no escopo da auditoria, que é a organização, o projeto ou a pasta que você registrou anteriormente.

Se você programar uma auditoria, só poderá criar uma programação para um framework e recurso específicos se ainda não houver uma programação ativa ou pausada para a combinação de framework e recurso.

Antes de começar

Verifique se você tem um dos seguintes papéis do IAM:
- Administrador do Audit Manager (roles/auditmanager.admin)
- Auditor do Audit Manager (roles/auditmanager.auditor)
Verifique se a organização, o projeto ou a pasta foi inscrito para auditoria.

Programar e executar uma auditoria

É possível criar uma programação para executar uma auditoria de forma recorrente ou sob demanda.

Console

No console do Google Cloud , acesse a página Executar avaliação no Audit Manager.

Acessar o Audit Manager
Na seção Escolher recurso e região, faça o seguinte:
1. Selecione a organização, a pasta ou o projeto que precisa ser auditado.
2. Selecione o local em que a avaliação de auditoria precisa ser processada. Para ver a lista de locais compatíveis, consulte Locais do Gerenciador de Auditoria.
3. Clique em Próxima.
Na seção Escolher regulamentação, selecione o framework que você quer usar para auditar o recurso e clique em Próxima. Para informações sobre frameworks compatíveis, consulte Frameworks compatíveis.
Opcional: se a seção Configurar parâmetros aparecer, faça o seguinte:
1. Clique em Modificar configuração.
2. Na janela Configurar parâmetros, adicione os parâmetros necessários para os controles de nuvem. Para mais informações sobre os parâmetros, consulte a referência de controle de nuvem do Compliance Manager e os controles de nuvem do Assured Workloads.
3. Clique em Salvar.
Opcional: na seção Ver plano de avaliação, é possível fazer o download de um arquivo ODS que contém informações sobre o escopo da auditoria com base no framework selecionado. Para baixar o arquivo, clique no link e em Próxima.
Na seção Escolher bucket de armazenamento, selecione um bucket de armazenamento em que o relatório de auditoria e as evidências precisam ser salvos e clique em Concluído. Se o bucket não estiver listado, peça ao administrador para registrar o recurso com o bucket de armazenamento.
Opcional: na seção Programação, defina uma das seguintes opções:
- A frequência com que a auditoria deve ser repetida (diária, mensal, trimestral ou anual).
- O período a ser incluído na auditoria. Se você escolher Sem fim, a auditoria vai continuar sendo executada a partir da data de início especificada até que você a interrompa manualmente.
Para iniciar a auditoria, clique em Executar auditoria ou Executar auditoria programada.

É possível conferir o status da auditoria na página Ver avaliações.

gcloud

Opcional: gerar uma avaliação de auditoria

Antes de executar uma auditoria real, é possível gerar uma avaliação (ou escopo) de auditoria que inclui um detalhamento de tarefas para a auditoria com base no framework de compliance escolhido.

O comando gcloud audit-manager audit-scopes generate gera um escopo de auditoria.

Antes de usar os dados do comando abaixo, faça estas substituições:

RESOURCE_TYPE: o tipo do recurso. Os valores válidos são organization, folder e project.
RESOURCE_ID: o ID do recurso da organização, do projeto ou da pasta. Por exemplo, 8767234.
LOCATION: o local do endpoint de API do Audit Manager. Para uma lista de endpoints disponíveis, consulte Locais do Gerenciador de Auditoria. Por exemplo: us-central1.
FRAMEWORK: o ID do framework a ser auditado. Por exemplo, builtin-cis-v8. Para encontrar o ID de um framework, consulte a página Ver avaliações no Gerenciador de Auditoria.
AUDIT_REPORT_FORMAT: o formato do relatório de auditoria de saída. Somente o formato ODF é aceito: AUDIT_REPORT_FORMAT_ODF.
OUTPUT_DIRECTORY: o diretório em que a saída precisa ser armazenada. Por exemplo, reports.
OUTPUT_FILENAME: o nome do arquivo de saída. Não inclua a extensão de arquivo no nome do arquivo. Por exemplo:scopeReport.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud audit-manager audit-scopes generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --output-directory=OUTPUT_DIRECTORY \
    --output-file-name=OUTPUT_FILENAME

Windows (PowerShell)

gcloud audit-manager audit-scopes generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --output-directory=OUTPUT_DIRECTORY `
    --output-file-name=OUTPUT_FILENAME

Windows (cmd.exe)

gcloud audit-manager audit-scopes generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --output-directory=OUTPUT_DIRECTORY ^
    --output-file-name=OUTPUT_FILENAME

Executar uma auditoria sob demanda

O comando gcloud audit-manager audit-reports generate executa uma auditoria.

Antes de usar os dados do comando abaixo, faça estas substituições:

RESOURCE_TYPE: o tipo do recurso. Os valores válidos são organization, folder e project.
RESOURCE_ID: o ID do recurso da organização, do projeto ou da pasta. Por exemplo, 8767234.
LOCATION: o local do endpoint de API do Audit Manager. Para uma lista de endpoints disponíveis, consulte Locais do Gerenciador de Auditoria. Por exemplo: us-central1.
FRAMEWORK: o ID do framework a ser auditado. Por exemplo, builtin-cis-v8. Para encontrar o ID de um framework, consulte a página Ver avaliações no Gerenciador de Auditoria.
BUCKET_URI: o URI do bucket do Cloud Storage. Por exemplo: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: o formato do relatório de auditoria de saída. Somente o formato ODF é aceito: AUDIT_REPORT_FORMAT_ODF.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud audit-manager audit-reports generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --gcs-uri=BUCKET_URI

Windows (PowerShell)

gcloud audit-manager audit-reports generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --gcs-uri=BUCKET_URI

Windows (cmd.exe)

gcloud audit-manager audit-reports generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI

Você receberá uma resposta semelhante a esta

done: false
name: projects/10398413/locations/987234/operations/operation-1726842525305-6228ddb4dca96-78a6db59-f9dd9a24

REST

Opcional: gerar uma avaliação de auditoria

Antes de executar uma auditoria real, é possível gerar uma avaliação (ou escopo) de auditoria que inclui um detalhamento de tarefas para a auditoria com base no framework de compliance escolhido.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

RESOURCE_TYPE: o tipo do recurso. Os valores válidos são organizations, folders e projects.
RESOURCE_ID: o ID do recurso da organização, do projeto ou da pasta. Por exemplo, 8767234.
LOCATION: o local do endpoint de API do Audit Manager. Para uma lista de endpoints disponíveis, consulte Locais do Gerenciador de Auditoria. Por exemplo: us-central1.
FRAMEWORK: o ID do framework a ser auditado. Por exemplo, builtin-cis-v8. Para encontrar o ID de um framework, consulte a página Ver avaliações no Gerenciador de Auditoria.
AUDIT_REPORT_FORMAT: o formato do relatório de auditoria de saída. Somente o formato ODF é aceito: AUDIT_REPORT_FORMAT_ODF.

Método HTTP e URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate

Corpo JSON da solicitação:


{
  "compliance_framework" : "FRAMEWORK"
  "report_format" : "AUDIT_REPORT_FORMAT"
}

Para enviar a solicitação, escolha uma destas opções:

curl

Observação: o comando a seguir pressupõe que você tenha feito login na gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login ou usando o Cloud Shell, que faz login automaticamente na gcloud CLI. Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate"

PowerShell

Observação: o comando a seguir pressupõe que você fez login na gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login. Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{

  "scope_report_contents" : "980u43nrf090834uhbkfehf......"
  "name" : "folders/8767234/locations/us-west"
}

A resposta tem as seguintes informações:

O campo scope_reports_contents é o formato de byte do conteúdo, que precisa ser convertido para o formato ODF antes da análise.

name: um identificador de string exclusivo do recurso aplicável.

Executar uma auditoria sob demanda

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

RESOURCE_TYPE: o tipo do recurso. Os valores válidos são organizations, folders e projects.
RESOURCE_ID: o ID do recurso da organização, do projeto ou da pasta. Por exemplo, 8767234.
LOCATION: o local do endpoint de API do Audit Manager. Para uma lista de endpoints disponíveis, consulte Locais do Gerenciador de Auditoria. Por exemplo: us-central1.
FRAMEWORK: o ID do framework a ser auditado. Por exemplo, builtin-cis-v8. Para encontrar o ID de um framework, consulte a página Ver avaliações no Gerenciador de Auditoria.
BUCKET_URI: o URI do bucket do Cloud Storage. Por exemplo: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: o formato do relatório de auditoria de saída. Somente o formato ODF é aceito: AUDIT_REPORT_FORMAT_ODF.

Método HTTP e URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate

Corpo JSON da solicitação:


{
  "destination" : {
    "gcs_uri" : "BUCKET_URI"
  },
  "compliance_framework" : "FRAMEWORK"
  "report_format" : "AUDIT_REPORT_FORMAT"
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate"

PowerShell

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "organizations/834/projects/10398413/locations/987234/operations/098234",
  "done": false
}

A resposta tem as seguintes informações:

name: um identificador de string exclusivo da solicitação de operação de avaliação de auditoria. Esse identificador é usado para acompanhar o progresso do processo de avaliação de auditoria. Por exemplo, operation/098234.
done: uma flag booleana definida como false que indica que o processo foi acionado. É definido como true quando a avaliação de auditoria é concluída.

Executar uma auditoria programada

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

RESOURCE_TYPE: o tipo do recurso. Os valores válidos são organizations, folders e projects.
RESOURCE_ID: o ID do recurso da organização, do projeto ou da pasta. Por exemplo, 8767234.
LOCATION: o local do endpoint de API do Audit Manager. Para uma lista de endpoints disponíveis, consulte Locais do Gerenciador de Auditoria. Por exemplo: us-central1.
FRAMEWORK: o ID do framework a ser auditado. Por exemplo, builtin-cis-v8. Para encontrar o ID de um framework, consulte a página Ver avaliações no Gerenciador de Auditoria.
BUCKET_URI: o URI do bucket do Cloud Storage. Por exemplo: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: o formato do relatório de auditoria de saída. Somente o formato ODF é aceito: AUDIT_REPORT_FORMAT_ODF.
DISPLAY_NAME: um nome para a programação de auditoria. Por exemplo, NIST 800-53 Daily Audit.
SCHEDULE_START_TIME: o carimbo de data/hora em que a programação de auditoria se torna ativa. Por exemplo, 2026-02-25T10:00:00Z.
SCHEDULE_END_TIME: o carimbo de data/hora em que a programação de auditoria é interrompida. Por exemplo, 2027-02-25T10:00:00Z.
FREQUENCY: a frequência das execuções de auditoria programadas. Pode ser um dos seguintes: DAILY, WEEKLY, MONTHLY, QUARTERLY ou ANNUALLY. Por exemplo: DAILY.
TIME_ZONE: o fuso horário da programação de auditoria no formato IANA. Essa variável é usada para interpretar start_time e end_time. Se não for especificado, o padrão será UTC. Exemplo: America/New_York.
SCHEDULE_STATE: o estado da programação de auditoria. Pode ser: SCHEDULE_STATE_ACTIVE, SCHEDULE_STATE_PAUSED ou SCHEDULE_STATE_DELETED. Por exemplo: SCHEDULE_STATE_ACTIVE.
AUDIT_SCHEDULE_ID: um identificador exclusivo para a programação de auditoria.

Método HTTP e URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID

Corpo JSON da solicitação:

{
  "display_name": "DISPLAY_NAME",
  "gcs_uri": "BUCKET_URI",
  "compliance_framework": "FRAMEWORK",
  "report_format": "AUDIT_REPORT_FORMAT",
  "schedule_config": {
    "start_time": "SCHEDULE_START_TIME",
    "end_time": "SCHEDULE_END_TIME",
    "frequency": "FREQUENCY",
    "time_zone": "TIME_ZONE"
  },
  "state": "SCHEDULE_STATE"
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID"

PowerShell

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "display_name": "My first audit schedule",
  "gcs_uri": "gs://my-bucket",
  "compliance_framework": "NIST_800_53",
  "report_format": "AUDIT_REPORT_FORMAT_ODF",
  "schedule_config": {
    "start_time": "2026-02-25T10:00:00Z",
    "end_time": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "time_zone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "create_time": "2026-02-25T13:27:00Z",
  "update_time": "2026-02-25T13:27:00Z"
}

Atualizar auditorias programadas

É possível pausar, retomar e interromper auditorias recorrentes. Se você quiser mudar a programação, exclua a auditoria programada atual e crie uma nova.

Console

No console do Google Cloud , acesse a página Gerenciamento de auditoria no Audit Manager.

Acessar o Audit Manager
Na guia Programações, encontre a auditoria programada que você quer atualizar.
Escolha uma destas opções:
- Para pausar uma programação de auditoria, clique em Pausar programação.
- Para reiniciar uma auditoria pausada, clique em Retomar programação.
- Para excluir uma auditoria programada, clique em Interromper programação.

REST

Para pausar, retomar ou excluir uma programação de auditoria, envie uma solicitação PATCH para atualizar o state da programação.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

RESOURCE_TYPE: o tipo do recurso. Os valores válidos são organizations, folders e projects.
RESOURCE_ID: o ID do recurso da organização, do projeto ou da pasta. Por exemplo, 8767234.
LOCATION: o local do endpoint de API do Audit Manager. Para uma lista de endpoints disponíveis, consulte Locais do Gerenciador de Auditoria. Por exemplo: us-central1.
AUDIT_SCHEDULE_ID: o ID da programação de auditoria a ser atualizada. Por exemplo, my-schedule-id.
SCHEDULE_STATE: o estado de destino da programação de auditoria. Defina como um dos seguintes:
- SCHEDULE_STATE_PAUSED: para pausar uma programação ativa.
- SCHEDULE_STATE_ACTIVE: para retomar uma programação pausada.
- SCHEDULE_STATE_DELETED: para interromper e excluir uma programação.

Método HTTP e URL:

PATCH https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state

Corpo JSON da solicitação:

{
  "state": "SCHEDULE_STATE"
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state"

PowerShell

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "display_name": "My first audit schedule",
  "gcs_uri": "gs://my-bucket",
  "compliance_framework": "NIST_800_53",
  "report_format": "AUDIT_REPORT_FORMAT_ODF",
  "schedule_config": {
    "start_time": "2026-02-25T10:00:00Z",
    "end_time": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "time_zone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_PAUSED",
  "create_time": "2026-02-25T13:27:00Z",
  "update_time": "2026-09-11T18:15:00Z"
}

Programar e executar uma auditoria Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Programar e executar uma auditoria

Console

gcloud

Opcional: gerar uma avaliação de auditoria

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Executar uma auditoria sob demanda

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

Opcional: gerar uma avaliação de auditoria

curl

PowerShell

Executar uma auditoria sob demanda

curl

PowerShell

Executar uma auditoria programada

curl

PowerShell

Atualizar auditorias programadas

Console

REST

curl

PowerShell

A seguir

Programar e executar uma auditoria