Conoscere lo stato di un controllo

Puoi ottenere lo stato di un audit in corso che hai avviato utilizzando Audit Manager o Compliance Manager. I controlli possono richiedere molto tempo e il monitoraggio di questo stato ti aiuta a seguire l'avanzamento del controllo mentre è in esecuzione.

Prima di iniziare

  • Assicurati di disporre di uno dei seguenti ruoli IAM:

  • Identifica l'audit per cui vuoi ottenere lo stato.

Controlla lo stato di un controllo in corso

Console

  1. Nella console Google Cloud , vai alla pagina Visualizza i controlli.

    Vai a Visualizza i controlli

  2. Nella pagina Visualizza valutazioni, puoi visualizzare lo stato attuale di un audit in corso o ricevere ulteriori informazioni su un audit completato.

  3. Per visualizzare ulteriori informazioni sull'audit, fai clic sul link nella colonna Stato.

  4. Per visualizzare ulteriori informazioni sul controllo, fai clic sul nome del controllo.

gcloud

Il comando gcloud audit-manager operations describe descrive un'operazione di 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.
  • AUDIT_OPERATION_ID: l'ID univoco dell'operazione in corso incluso nel corpo della risposta quando hai eseguito l'audit. Ad esempio: 098234.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud audit-manager operations describe AUDIT_OPERATION_ID \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

Windows (PowerShell)

gcloud audit-manager operations describe AUDIT_OPERATION_ID `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows (cmd.exe)

gcloud audit-manager operations describe AUDIT_OPERATION_ID ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

Una risposta corretta include uno dei seguenti tipi di stato di esecuzione:

Tipo di stato Descrizione
OPERATION_STATE_UNSPECIFIED Uno stato non valido.
OPERATION_STATE_NOT_STARTED La procedura di generazione del report di controllo non è ancora iniziata.
OPERATION_STATE_EVALUATION_IN_PROGRESS Audit Manager sta valutando le risorse in base ai controlli di conformità.
OPERATION_STATE_EVALUATION_DONE Audit Manager ha completato la valutazione della conformità.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager sta creando un report di audit dai dati valutati.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager ha completato la generazione del report di controllo.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager sta caricando il report di controllo e le prove nella destinazione.
OPERATION_STATE_DONE Il processo di generazione del report di controllo è stato completato.
OPERATION_STATE_FAILED Il processo di generazione del report di controllo non è riuscito.

Ognuno dei tipi di stato di esecuzione potrebbe fornire una delle seguenti informazioni aggiuntive, se applicabile:

Stato aggiuntivo Descrizione
failure_reason Se la valutazione dell'audit non va a buon fine, questo campo fornisce il motivo dell'errore.
evaluation_percent_complete Se la valutazione è iniziata, questo campo fornisce la percentuale di avanzamento. Quando il processo non è ancora iniziato, il campo inizia con 0. Al termine della procedura, il campo viene impostato su 100.
report_generation_percent_complete Se la generazione del report è iniziata, questo campo fornisce la percentuale di avanzamento. Quando il processo non è ancora iniziato, il campo inizia con 0. Al termine della procedura, il campo viene impostato su 100.
report_uploading_percent_complete Se il caricamento del report è iniziato, questo campo fornisce la percentuale di avanzamento. Quando il processo non è ancora iniziato, il campo inizia con 0. Al termine della procedura, il campo viene impostato su 100.

Una risposta gcloud corretta è simile alla seguente:

done: true
name: projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID
response:
  '@type': type.googleapis.com/google.cloud.auditmanager.v1.AuditReport
  gcsUri: gs://testbucketauditmanager

REST

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_OPERATION_ID: l'ID univoco dell'operazione in corso incluso nel corpo della risposta quando hai eseguito l'audit. Ad esempio: 098234.

Metodo HTTP e URL: 

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_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//operationDetails/AUDIT_OPERATION_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//operationDetails/AUDIT_OPERATION_ID" | Select-Object -Expand Content

Una risposta corretta include uno dei seguenti tipi di stato di esecuzione:

Tipo di stato Descrizione
OPERATION_STATE_UNSPECIFIED Uno stato non valido.
OPERATION_STATE_NOT_STARTED La procedura di generazione del report di controllo non è ancora iniziata.
OPERATION_STATE_EVALUATION_IN_PROGRESS Audit Manager sta valutando le risorse in base ai controlli di conformità.
OPERATION_STATE_EVALUATION_DONE Audit Manager ha completato la valutazione della conformità.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager sta creando un report di audit dai dati valutati.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager ha completato la generazione del report di controllo.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager sta caricando il report di controllo e le prove nella destinazione.
OPERATION_STATE_DONE Il processo di generazione del report di controllo è stato completato.
OPERATION_STATE_FAILED Il processo di generazione del report di controllo non è riuscito.

Ognuno dei tipi di stato di esecuzione potrebbe fornire una delle seguenti informazioni aggiuntive, se applicabile:

Stato aggiuntivo Descrizione
failure_reason Se la valutazione dell'audit non va a buon fine, questo campo fornisce il motivo dell'errore.
evaluation_percent_complete Se la valutazione è iniziata, questo campo fornisce la percentuale di avanzamento. Quando il processo non è ancora iniziato, il campo inizia con 0. Al termine della procedura, il campo viene impostato su 100.
report_generation_percent_complete Se la generazione del report è iniziata, questo campo fornisce la percentuale di avanzamento. Quando il processo non è ancora iniziato, il campo inizia con 0. Al termine della procedura, il campo viene impostato su 100.
report_uploading_percent_complete Se il caricamento del report è iniziato, questo campo fornisce la percentuale di avanzamento. Quando il processo non è ancora iniziato, il campo inizia con 0. Al termine della procedura, il campo viene impostato su 100.

Una risposta REST corretta è simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.auditmanager.v1.AuditReport",
    "gcsUri": "gs://testbucketauditmanager"
  }
}

Quando un report di controllo viene completato e caricato, viene restituito un link al report.

Passaggi successivi