Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Pianifica o esegui un controllo

I controlli ti consentono di raccogliere le prove necessarie per valutare la tua organizzazioneGoogle Cloud in base ai framework supportati. Puoi pianificare un controllo da eseguire a intervalli regolari o eseguire un controllo on demand.

Un audit è un'operazione a lunga esecuzione che potrebbe richiedere alcune ore. La durata dipende dal numero di risorse nell'ambito dell'audit, ovvero l'organizzazione, il progetto o la cartella che hai registrato in precedenza.

Puoi creare una pianificazione per una combinazione specifica di framework e risorse solo se non esiste già una pianificazione attiva o in pausa per quella combinazione.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per eseguire o pianificare un audit, chiedi all'amministratore di concederti uno dei seguenti ruoli Identity and Access Management (IAM):
- Audit Manager Admin (roles/auditmanager.admin)
- Audit Manager Auditor (roles/auditmanager.auditor)
Registra la tua organizzazione, il tuo progetto o la tua cartella per l'audit.

Pianifica ed esegui un audit

Puoi creare una pianificazione per eseguire un audit su base ricorrente o eseguire un audit on demand.

Console

Nella console Google Cloud , vai alla pagina Esegui valutazione in Audit Manager.

Vai ad Audit Manager
Nella sezione Scegli risorsa e regione, segui questi passaggi:
1. Seleziona l'organizzazione, la cartella o il progetto che vuoi controllare.
2. Seleziona la località in cui vuoi elaborare la valutazione dell'audit. Per l'elenco delle località supportate, consulta Località di Audit Manager.
3. Fai clic su Avanti.
Nella sezione Scegli regolamento, seleziona il framework in base al quale vuoi controllare la risorsa, quindi fai clic su Avanti. Per informazioni sui framework supportati, consulta Framework supportati.
(Facoltativo) Se viene visualizzata la sezione Configura parametri, completa quanto segue:
1. Fai clic su Modifica configurazione.
2. Nella finestra Configura parametri, aggiungi i parametri richiesti per i controlli cloud. Per ulteriori informazioni sui parametri, consulta il riferimento ai controlli cloud di Compliance Manager e i controlli cloud di Assured Workloads.
3. Fai clic su Salva.
(Facoltativo) Nella sezione Visualizza piano di valutazione, puoi scaricare un file ODS contenente informazioni sull'ambito di audit in base al framework selezionato. Per scaricare il file, fai clic sul link e poi su Avanti.
Nella sezione Scegli il bucket di archiviazione, seleziona il bucket di archiviazione in cui vuoi salvare il report di controllo e le prove, quindi fai clic su Fine. Se il tuo bucket non è presente nell'elenco, chiedi all'amministratore di registrare la risorsa con il bucket di archiviazione.
(Facoltativo) Nella sezione Pianificazione, imposta una delle seguenti opzioni:
- La frequenza con cui ripetere il controllo (giornaliera, settimanale, mensile, trimestrale o annuale).
- Il periodo di tempo da includere nel controllo. Se scegli Senza fine, il controllo continua a essere eseguito dalla data di inizio specificata fino a quando non lo interrompi manualmente.
Per avviare il controllo, fai clic su Esegui controllo o Esegui controllo pianificato.

Puoi visualizzare lo stato di un audit on demand nella pagina Visualizza valutazioni o visualizzare gli audit pianificati nella scheda Pianificazioni della pagina Gestione degli audit.

gcloud

(Facoltativo) Genera una valutazione di controllo

Prima di eseguire un audit, puoi generare una valutazione o un ambito dell'audit che include un'analisi dettagliata delle attività per l'audit in base al framework scelto.

Il comando gcloud audit-manager audit-scopes generate genera un ambito di controllo.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organization, folder e project.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni nella console Google Cloud .
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato ODF: AUDIT_REPORT_FORMAT_ODF.
OUTPUT_DIRECTORY: la directory in cui deve essere archiviato l'output. Ad esempio: reports.
OUTPUT_FILENAME: il nome del file di output. Non includere l'estensione del file nel nome file. Ad esempio: scopeReport.

Esegui questo comando:

Linux, macOS o 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

Esegui un controllo on demand

Il comando gcloud audit-manager audit-reports generate esegue un audit.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organization, folder e project.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni nella console Google Cloud .
BUCKET_URI: l'URI del bucket Cloud Storage. Ad esempio: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato ODF: AUDIT_REPORT_FORMAT_ODF.

Esegui questo comando:

Linux, macOS o 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

Dovresti ricevere una risposta simile alla seguente:

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

Pianifica un controllo

Il comando gcloud audit-manager audit-schedules create crea una pianificazione di controllo.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organization, folder e project.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
AUDIT_SCHEDULE_ID: l'ID della pianificazione di controllo. Ad esempio: my-schedule-id. Per trovare l'ID di una pianificazione esistente, consulta la pagina Gestione dei controlli nella console Google Cloud .
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni nella console Google Cloud .
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato OpenDocument (ODF): odf.
BUCKET_URI: l'URI del bucket Cloud Storage. Ad esempio: gs://testbucketauditmanager.
FREQUENCY: la frequenza delle esecuzioni dei controlli pianificati. I valori validi sono daily, weekly, monthly, quarterly e annually. Ad esempio: weekly.
SCHEDULE_START_TIME: la data e l'ora di inizio della prima esecuzione del controllo, in formato RFC 3339. Ad esempio: 2026-10-25T10:00:00Z.
DISPLAY_NAME: facoltativo. Un nome visualizzato per la pianificazione del controllo. Ad esempio: NIST 800-53 Weekly Audit.
SCHEDULE_END_TIME: facoltativo. La data e l'ora di interruzione della pianificazione di controllo, nel formato RFC 3339. Ad esempio: 2027-10-25T10:00:00Z.
TIME_ZONE: facoltativo. Il fuso orario per la pianificazione del controllo in formato IANA. Audit Manager utilizza questo valore per interpretare l'ora di inizio e l'ora di fine. Se non specificato, il valore predefinito è UTC. Ad esempio America/New_York.

Esegui questo comando:

Linux, macOS o Cloud Shell

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)

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)

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

Dovresti ricevere una risposta simile alla seguente:

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

(Facoltativo) Genera una valutazione di controllo

Prima di eseguire un audit, puoi generare una valutazione o un ambito dell'audit che include un'analisi dettagliata delle attività per l'audit in base al framework scelto.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni nella console Google Cloud .
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato ODF: AUDIT_REPORT_FORMAT_ODF.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:


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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{

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

La risposta include le seguenti informazioni:

scope_report_contents: il formato byte dei contenuti del report, che devi convertire in formato OpenDocument (ODF) prima della revisione.
name: un identificatore di stringa univoco della risorsa applicabile.

Esegui un controllo on demand

Per eseguire un audit on demand, invia una richiesta POST all'endpoint auditReport:generate.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni nella console Google Cloud .
BUCKET_URI: l'URI del bucket Cloud Storage. Ad esempio: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato ODF: AUDIT_REPORT_FORMAT_ODF.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:


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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

La risposta include le seguenti informazioni:

name: un identificatore di stringa univoco per la richiesta di operazione di valutazione dell'audit. Utilizza questo identificatore per monitorare l'avanzamento della valutazione del controllo. Ad esempio: projects/PROJECT_ID/locations/LOCATION/operations/098234UNIQUE_ID.
done: un flag booleano che indica se la valutazione dell'audit è completa. Questo flag è impostato su false all'avvio del processo e cambia in true al termine della valutazione dell'audit.

Pianifica un controllo

Per pianificare un audit ricorrente, invia una richiesta POST all'endpoint auditSchedules.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
AUDIT_SCHEDULE_ID: l'ID della pianificazione di controllo. Ad esempio: my-schedule-id. Per trovare l'ID di una pianificazione esistente, consulta la pagina Gestione dei controlli nella console Google Cloud .
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni nella console Google Cloud .
BUCKET_URI: l'URI del bucket Cloud Storage. Ad esempio: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato ODF: AUDIT_REPORT_FORMAT_ODF.
FREQUENCY: la frequenza delle esecuzioni dei controlli pianificati. I valori validi sono DAILY, WEEKLY, MONTHLY, QUARTERLY e ANNUALLY. Ad esempio: WEEKLY.
SCHEDULE_START_TIME: la data e l'ora di inizio della prima esecuzione del controllo, in formato RFC 3339. Ad esempio: 2026-10-25T10:00:00Z.
DISPLAY_NAME: facoltativo. Un nome visualizzato per la pianificazione del controllo. Ad esempio: NIST 800-53 Weekly Audit.
SCHEDULE_END_TIME: facoltativo. La data e l'ora di interruzione della pianificazione di controllo, nel formato RFC 3339. Ad esempio: 2027-10-25T10:00:00Z.
TIME_ZONE: facoltativo. Il fuso orario per la pianificazione del controllo in formato IANA. Audit Manager utilizza questo valore per interpretare l'ora di inizio e l'ora di fine. Se non specificato, il valore predefinito è UTC. Ad esempio America/New_York.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "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"
  }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
}

Visualizza i controlli pianificati

Puoi visualizzare i dettagli degli audit pianificati, tra cui l'ambito, il framework e la configurazione della pianificazione.

Console

Nella console Google Cloud , vai alla pagina Gestione dei controlli in Audit Manager.

Vai ad Audit Manager
Nella scheda Pianificazioni, visualizza l'elenco dei controlli pianificati.

gcloud

Visualizza un elenco di audit pianificati

Per visualizzare un elenco dei controlli pianificati, esegui il comando gcloud audit-manager audit-schedules list.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organization, folder e project.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Dovresti ricevere una risposta simile alla seguente:

┌────────────┬────────────┬──────────────┬────────────┬────────────┬───────────────┬─────────────────┬─────────────┬─────────────┬───────────────┬───────────────────┬───────────────┐
│     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'}        │             │             │               │                   │               │
└────────────┴────────────┴──────────────┴────────────┴────────────┴───────────────┴─────────────────┴─────────────┴─────────────┴───────────────┴───────────────────┴───────────────┘

Visualizza i dettagli di un audit pianificato

Per visualizzare i dettagli di un audit pianificato specifico, esegui il comando gcloud audit-manager audit-schedules describe.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
AUDIT_SCHEDULE_ID: l'ID della pianificazione di controllo. Ad esempio: my-schedule-id. Per trovare l'ID di una pianificazione esistente, consulta la pagina Gestione dei controlli nella console Google Cloud .

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Dovresti ricevere una risposta simile alla seguente:

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

Visualizza un elenco di audit pianificati

Per visualizzare un elenco di audit pianificati, invia una richiesta GET all'endpoint auditSchedules.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.

Metodo HTTP e URL:

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
    }
  ]
}

Visualizza i dettagli di un audit pianificato

Per visualizzare i dettagli di un audit pianificato specifico, invia una richiesta GET all'endpoint auditSchedules e specifica l'ID della pianificazione.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
AUDIT_SCHEDULE_ID: l'ID della pianificazione di controllo. Ad esempio: my-schedule-id. Per trovare l'ID di una pianificazione esistente, consulta la pagina Gestione dei controlli nella console Google Cloud .

Metodo HTTP e URL:

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
}

Aggiorna i controlli pianificati

Puoi mettere in pausa, riprendere e interrompere i controlli ricorrenti. Per modificare una pianificazione, devi eliminare l'audit pianificato esistente e crearne uno nuovo.

Console

Nella console Google Cloud , vai alla pagina Gestione dei controlli in Audit Manager.

Vai ad Audit Manager
Nella scheda Pianificazioni, trova l'audit pianificato che vuoi aggiornare.
Esegui una delle seguenti operazioni:
- Per mettere in pausa una pianificazione di controllo, fai clic su Metti in pausa la pianificazione.
- Per riavviare un controllo che hai messo in pausa, fai clic su Riprendi pianificazione.
- Per eliminare un controllo pianificato, fai clic su Interrompi pianificazione.

gcloud

Per mettere in pausa, riprendere o eliminare una pianificazione di controllo, esegui il comando gcloud audit-manager audit-schedules update per aggiornare lo stato della pianificazione.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
AUDIT_SCHEDULE_ID: l'ID della pianificazione di controllo. Ad esempio: my-schedule-id. Per trovare l'ID di una pianificazione esistente, consulta la pagina Gestione dei controlli nella console Google Cloud .
SCHEDULE_STATE: lo stato target per la pianificazione dell'audit. Imposta uno dei seguenti valori:
- paused: per mettere in pausa una pianificazione attiva.
- active: per riprendere una pianificazione in pausa.
- deleted: per interrompere ed eliminare una pianificazione.

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Dovresti ricevere una risposta simile alla seguente:

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

Per mettere in pausa, riprendere o eliminare una pianificazione di controllo, invia una richiesta PATCH per aggiornare il campo state della pianificazione di controllo.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
AUDIT_SCHEDULE_ID: l'ID della pianificazione di controllo. Ad esempio: my-schedule-id. Per trovare l'ID di una pianificazione esistente, consulta la pagina Gestione dei controlli nella console Google Cloud .
SCHEDULE_STATE: lo stato target per la pianificazione dell'audit. Imposta uno dei seguenti valori:
- SCHEDULE_STATE_PAUSED: per mettere in pausa una pianificazione attiva.
- SCHEDULE_STATE_ACTIVE: per riprendere una pianificazione in pausa.
- SCHEDULE_STATE_DELETED: per interrompere ed eliminare una pianificazione.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "state": "SCHEDULE_STATE"
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
}

Pianifica o esegui un controllo Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Pianifica ed esegui un audit

Console

gcloud

(Facoltativo) Genera una valutazione di controllo

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Esegui un controllo on demand

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Pianifica un controllo

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

(Facoltativo) Genera una valutazione di controllo

curl

PowerShell

Esegui un controllo on demand

curl

PowerShell

Pianifica un controllo

curl

PowerShell

Visualizza i controlli pianificati

Console

gcloud

Visualizza un elenco di audit pianificati

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Visualizza i dettagli di un audit pianificato

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

Visualizza un elenco di audit pianificati

curl

PowerShell

Visualizza i dettagli di un audit pianificato

curl

PowerShell

Aggiorna i controlli pianificati

Console

gcloud

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Passaggi successivi

Pianifica o esegui un controllo