Programar ou 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.

Só é possível criar uma programação para uma combinação específica de framework e recurso se ainda não houver uma programação ativa ou pausada para essa combinação.

Antes de começar

• Para receber as permissões necessárias para executar ou programar uma auditoria, peça ao administrador para conceder a você um dos seguintes papéis do Identity and Access Management (IAM):

  • Administrador do Gerenciador de Auditoria (roles/auditmanager.admin)
  • Auditor do Audit Manager (roles/auditmanager.auditor)

• Inscreva sua organização, projeto ou pasta para auditoria.

Programar e executar uma auditoria

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

Console

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

   Acessar o Gerenciador de Auditoria

2. Na seção Escolher recurso e região, faça o seguinte:

   1. Selecione a organização, a pasta ou o projeto que você quer auditar.

   2. Selecione o local em que você quer processar a avaliação de auditoria. Para ver a lista de locais compatíveis, consulte Locais do Gerenciador de Auditoria.

   3. Clique em Próxima.

3. 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.

4. 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.

5. 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.

6. Na seção Escolher bucket de armazenamento, selecione o bucket em que você quer salvar o relatório de auditoria e as evidências e clique em Concluído. Se o bucket não estiver listado, peça ao administrador para registrar o recurso no bucket de armazenamento.

7. Opcional: na seção Programação, defina uma das seguintes opções:

   • A frequência de repetição da auditoria (diária, semanal, 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.

8. Para iniciar a auditoria, clique em Executar auditoria ou Executar auditoria programada.

   É possível conferir o status de uma auditoria on demand na página Ver avaliações ou as auditorias programadas na guia Programações da página Gerenciamento de auditorias.

gcloud

Opcional: gerar uma avaliação de auditoria

Antes de executar uma auditoria, é possível gerar uma avaliação ou um escopo de auditoria, que inclui um detalhamento de tarefas para a auditoria com base no framework 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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. 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 console do Google Cloud .
• 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

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. 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 console do Google Cloud .
• 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

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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

Agendar uma auditoria

O comando gcloud audit-manager audit-schedules create cria uma programação 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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. Por exemplo: us-central1.
• AUDIT_SCHEDULE_ID: o ID da programação de auditoria. Por exemplo, my-schedule-id. Para encontrar o ID de uma programação, consulte a página Gerenciamento de auditoria no console do Google Cloud .
• 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 console do Google Cloud .
• AUDIT_REPORT_FORMAT: o formato do relatório de auditoria de saída. Somente o formato OpenDocument (ODF) é compatível: odf.
• BUCKET_URI: o URI do bucket do Cloud Storage. Por exemplo: gs://testbucketauditmanager.
• FREQUENCY: a frequência das execuções de auditoria programadas. Os valores válidos são daily, weekly, monthly, quarterly e annually. Por exemplo: weekly.
• SCHEDULE_START_TIME: a data e a hora em que a primeira execução de auditoria começa, no formato RFC 3339. Por exemplo: 2026-10-25T10:00:00Z.
• DISPLAY_NAME: opcional. Um nome de exibição para a programação de auditoria. Por exemplo, NIST 800-53 Weekly Audit.
• SCHEDULE_END_TIME: opcional. A data e a hora em que a programação de auditoria é interrompida, no formato RFC 3339. Por exemplo, 2027-10-25T10:00:00Z.
• TIME_ZONE: opcional. O fuso horário da programação de auditoria no formato IANA. O Gerenciador de Auditoria usa esse valor para interpretar o horário de início e de término. Se não for especificado, o padrão será UTC. Por exemplo: America/New_York.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules create \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --audit-schedule-id=AUDIT_SCHEDULE_ID \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --gcs-uri=BUCKET_URI \
    --start-time=SCHEDULE_START_TIME \
    --frequency=FREQUENCY \
    --display-name="DISPLAY_NAME" \
    --end-time=SCHEDULE_END_TIME \
    --time-zone=TIME_ZONE

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules create `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --audit-schedule-id=AUDIT_SCHEDULE_ID `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --gcs-uri=BUCKET_URI `
    --start-time=SCHEDULE_START_TIME `
    --frequency=FREQUENCY `
    --display-name="DISPLAY_NAME" `
    --end-time=SCHEDULE_END_TIME `
    --time-zone=TIME_ZONE

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules create ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --audit-schedule-id=AUDIT_SCHEDULE_ID ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI ^
    --start-time=SCHEDULE_START_TIME ^
    --frequency=FREQUENCY ^
    --display-name="DISPLAY_NAME" ^
    --end-time=SCHEDULE_END_TIME ^
    --time-zone=TIME_ZONE

Você receberá uma resposta semelhante a esta

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: weekly
  startTime: '2026-10-25T10:00:00Z'
state: SCHEDULE_STATE_ACTIVE

REST

Opcional: gerar uma avaliação de auditoria

Antes de executar uma auditoria, é possível gerar uma avaliação ou um escopo de auditoria, que inclui um detalhamento de tarefas para a auditoria com base no framework 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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. 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 console do Google Cloud .
• 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 inclui as seguintes informações:

• scope_report_contents: o formato de byte do conteúdo do relatório, que precisa ser convertido para o formato OpenDocument (ODF) antes da análise.
• name: um identificador de string exclusivo do recurso aplicável.

Executar uma auditoria sob demanda

Para executar uma auditoria on demand, envie uma solicitação POST para o endpoint auditReport:generate.

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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. 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 console do Google Cloud .
• 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

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/auditReport: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/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 inclui as seguintes informações:

• name: um identificador de string exclusivo para a solicitação de operação de avaliação de auditoria. Use esse identificador para acompanhar o progresso da avaliação de auditoria. Por exemplo, projects/PROJECT_ID/locations/LOCATION/operations/098234UNIQUE_ID.
• done: uma flag booleana que indica se a avaliação de auditoria foi concluída. Essa flag é definida como false quando o processo é iniciado e muda para true quando a avaliação de auditoria é concluída.

Agendar uma auditoria

Para programar uma auditoria recorrente, envie uma solicitação POST para o endpoint auditSchedules.

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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. Por exemplo: us-central1.
• AUDIT_SCHEDULE_ID: o ID da programação de auditoria. Por exemplo, my-schedule-id. Para encontrar o ID de uma programação, consulte a página Gerenciamento de auditoria no console do Google Cloud .
• 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 console do Google Cloud .
• 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.
• FREQUENCY: a frequência das execuções de auditoria programadas. Os valores válidos são DAILY, WEEKLY, MONTHLY, QUARTERLY e ANNUALLY. Por exemplo: WEEKLY.
• SCHEDULE_START_TIME: a data e a hora em que a primeira execução de auditoria começa, no formato RFC 3339. Por exemplo: 2026-10-25T10:00:00Z.
• DISPLAY_NAME: opcional. Um nome de exibição para a programação de auditoria. Por exemplo, NIST 800-53 Weekly Audit.
• SCHEDULE_END_TIME: opcional. A data e a hora em que a programação de auditoria é interrompida, no formato RFC 3339. Por exemplo, 2027-10-25T10:00:00Z.
• TIME_ZONE: opcional. O fuso horário da programação de auditoria no formato IANA. O Gerenciador de Auditoria usa esse valor para interpretar o horário de início e de término. Se não for especificado, o padrão será UTC. Por exemplo: America/New_York.

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "displayName": "DISPLAY_NAME",
  "gcsUri": "BUCKET_URI",
  "complianceFramework": "FRAMEWORK",
  "reportFormat": "AUDIT_REPORT_FORMAT",
  "scheduleConfig": {
    "startTime": "SCHEDULE_START_TIME",
    "endTime": "SCHEDULE_END_TIME",
    "frequency": "FREQUENCY",
    "timeZone": "TIME_ZONE"
  }
}

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/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID"

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/auditSchedules?auditScheduleId=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",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-10-25T10:00:00Z",
    "endTime": "2027-10-25T10:00:00Z",
    "frequency": "WEEKLY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "createTime": "2026-10-25T13:27:00Z",
  "updateTime": "2026-10-25T13:27:00Z"
}

Ver auditorias programadas

É possível ver detalhes sobre as auditorias programadas, incluindo o escopo, o framework e a configuração da programação.

Console

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

   Acessar o Gerenciador de Auditoria

2. Na guia Programações, confira a lista de auditorias programadas.

gcloud

Ver uma lista de auditorias programadas

Para ver uma lista de auditorias programadas, execute o comando gcloud audit-manager audit-schedules list.

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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. Por exemplo: us-central1.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules list \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules list `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules list ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

Você receberá uma resposta semelhante a esta:

┌────────────┬────────────┬──────────────┬────────────┬────────────┬───────────────┬─────────────────┬─────────────┬─────────────┬───────────────┬───────────────────┬───────────────┐
│     ID     │ FRAMEWORK  │ DISPLAY_NAME │   STATE    │  GCS_URI   │ REPORT_FORMAT │ SCHEDULE_CONFIG │ CREATE_TIME │ UPDATE_TIME │ NEXT_RUN_TIME │ LAST_TRIGGER_TIME │ ERROR_MESSAGE │
├────────────┼────────────┼──────────────┼────────────┼────────────┼───────────────┼─────────────────┼─────────────┼─────────────┼───────────────┼───────────────────┼───────────────┤
│ my-schedul │ builtin-ci │ My first aud │ SCHEDULE_S │ gs://my-bu │ AUDIT_REPORT_ │ {'frequency':   │ 2026-10-25T │ 2026-10-25T │               │                   │               │
│ e-id       │ s-v8       │ it schedule  │ TATE_ACTIV │ cket       │ FORMAT_ODF    │ 'weekly',       │ 13:27:00Z   │ 13:27:00Z   │               │                   │               │
│            │            │              │ E          │            │               │ 'startTime':    │             │             │               │                   │               │
│            │            │              │            │            │               │ '2026-10-25T10: │             │             │               │                   │               │
│            │            │              │            │            │               │ 00:00Z'}        │             │             │               │                   │               │
└────────────┴────────────┴──────────────┴────────────┴────────────┴───────────────┴─────────────────┴─────────────┴─────────────┴───────────────┴───────────────────┴───────────────┘

Ver detalhes sobre uma auditoria programada

Para ver detalhes sobre uma auditoria programada específica, execute o comando gcloud audit-manager audit-schedules describe.

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 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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. Por exemplo: us-central1.
• AUDIT_SCHEDULE_ID: o ID da programação de auditoria. Por exemplo, my-schedule-id. Para encontrar o ID de uma programação, consulte a página Gerenciamento de auditoria no console do Google Cloud .

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules describe \
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules describe `
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules describe ^
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

Você receberá uma resposta semelhante a esta

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: weekly
  startTime: '2026-10-25T10:00:00Z'
state: SCHEDULE_STATE_ACTIVE

REST

Ver uma lista de auditorias programadas

Para ver uma lista de auditorias programadas, envie uma solicitação GET para o endpoint auditSchedules.

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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. Por exemplo: us-central1.

Método HTTP e URL:

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules

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.

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules"

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.

Execute o seguinte comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "auditSchedules": [
    {
      "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
      "displayName": "My first audit schedule",
      "gcsUri": "gs://my-bucket",
      "complianceFramework": "builtin-cis-v8",
      "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
      "scheduleConfig": {
        "startTime": "2026-10-25T10:00:00Z",
        "endTime": "2027-10-25T10:00:00Z",
        "frequency": "WEEKLY",
        "timeZone": "America/New_York"
      },
      "state": "SCHEDULE_STATE_ACTIVE",
      "createTime": "2026-10-25T13:27:00Z",
      "updateTime": "2026-10-25T13:27:00Z"
    }
  ]
}

Ver detalhes sobre uma auditoria programada

Para ver detalhes sobre uma auditoria programada específica, envie uma solicitação GET para o endpoint auditSchedules e especifique o ID 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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. Por exemplo: us-central1.
• AUDIT_SCHEDULE_ID: o ID da programação de auditoria. Por exemplo, my-schedule-id. Para encontrar o ID de uma programação, consulte a página Gerenciamento de auditoria no console do Google Cloud .

Método HTTP e URL:

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

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.

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID"

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.

Execute o seguinte comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/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",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-10-25T10:00:00Z",
    "endTime": "2027-10-25T10:00:00Z",
    "frequency": "WEEKLY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "createTime": "2026-10-25T13:27:00Z",
  "updateTime": "2026-10-25T13:27:00Z"
}

Atualizar auditorias programadas

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

Console

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

   Acessar o Gerenciador de Auditoria

2. Na guia Programações, encontre a auditoria programada que você quer atualizar.

3. 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.

gcloud

Para pausar, retomar ou excluir uma programação de auditoria, execute o comando gcloud audit-manager audit-schedules update para atualizar o estado da programação.

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 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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. Por exemplo: us-central1.
• AUDIT_SCHEDULE_ID: o ID da programação de auditoria. Por exemplo, my-schedule-id. Para encontrar o ID de uma programação, consulte a página Gerenciamento de auditoria no console do Google Cloud .
• SCHEDULE_STATE: o estado de destino da programação de auditoria. Defina como um dos seguintes:
  • paused: para pausar uma programação ativa.
  • active: para retomar uma programação pausada.
  • deleted: para interromper e excluir uma programação.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules update \
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID \
    --state=SCHEDULE_STATE

Windows (PowerShell)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules update `
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID `
    --state=SCHEDULE_STATE

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud audit-manager audit-schedules update ^
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID ^
    --state=SCHEDULE_STATE

Você receberá uma resposta semelhante a esta

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: daily
  startTime: '2026-02-25T10:00:00Z'
state: SCHEDULE_STATE_PAUSED

REST

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

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 ver uma lista de endpoints disponíveis, consulte Locais do Audit Manager. Por exemplo: us-central1.
• AUDIT_SCHEDULE_ID: o ID da programação de auditoria. Por exemplo, my-schedule-id. Para encontrar o ID de uma programação, consulte a página Gerenciamento de auditoria no console do Google Cloud .
• 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

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 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

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 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",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-02-25T10:00:00Z",
    "endTime": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_PAUSED",
  "createTime": "2026-02-25T13:27:00Z",
  "updateTime": "2026-09-11T18:15:00Z"
}

A seguir

• Verificar o status de uma auditoria
• Resolver problemas de auditoria de execução