Conoscere lo stato di un controllo

Questa pagina descrive come ottenere lo stato di un audit in corso avviato utilizzando Audit Manager o Compliance Manager. Gli audit sono operazioni a lunga esecuzione e può essere utile ottenere lo stato di un audit durante l'esecuzione dell'operazione.

Prima di iniziare

Ottenere lo stato di un audit in corso

Console

  1. Nella Google Cloud console, vai alla pagina Visualizza audit.

    Vai a Visualizza audit

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

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

gcloud

Il gcloud audit-manager operations describe comando 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, un progetto o una cartella. Ad esempio: folders o projects.
  • RESOURCE_ID: l'ID risorsa del progetto o della cartella. Ad esempio: 8767234.
  • LOCATION: la località dell'endpoint dell'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 inclusa 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 audit 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 audit.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager sta caricando il report di audit e le prove nella destinazione.
OPERATION_STATE_DONE La procedura di generazione del report di audit è stata completata.
OPERATION_STATE_FAILED La procedura di generazione del report di audit non è riuscita.

Ciascuno dei tipi di stato di esecuzione può fornire le seguenti informazioni aggiuntive, se applicabili:

Stato aggiuntivo Descrizione
failure_reason Se la valutazione dell'audit non riesce, questo campo fornisce il motivo dell'errore.
evaluation_percent_complete Se la valutazione è iniziata, questo campo fornisce la percentuale di avanzamento. Quando la procedura non è ancora iniziata, il campo inizia da 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 la procedura non è ancora iniziata, il campo inizia da 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 la procedura non è ancora iniziata, il campo inizia da 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, un progetto o una cartella. Ad esempio: folders o projects.
  • RESOURCE_ID: l'ID risorsa del progetto o della cartella. Ad esempio: 8767234.
  • LOCATION: la località dell'endpoint dell'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 inclusa 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 audit 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 audit.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager sta caricando il report di audit e le prove nella destinazione.
OPERATION_STATE_DONE La procedura di generazione del report di audit è stata completata.
OPERATION_STATE_FAILED La procedura di generazione del report di audit non è riuscita.

Ciascuno dei tipi di stato di esecuzione può fornire le seguenti informazioni aggiuntive, se applicabili:

Stato aggiuntivo Descrizione
failure_reason Se la valutazione dell'audit non riesce, questo campo fornisce il motivo dell'errore.
evaluation_percent_complete Se la valutazione è iniziata, questo campo fornisce la percentuale di avanzamento. Quando la procedura non è ancora iniziata, il campo inizia da 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 la procedura non è ancora iniziata, il campo inizia da 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 la procedura non è ancora iniziata, il campo inizia da 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"
  }
}

Al termine del caricamento di un report di audit, viene restituito un link al report.

Passaggi successivi