Conoscere lo stato di un controllo

Puoi ottenere lo stato di un audit in corso che hai avviato utilizzando Audit Manager o Compliance Manager. Il completamento degli audit può richiedere molto tempo e il monitoraggio di questo stato ti aiuta a seguire l'avanzamento dell'audit durante l'esecuzione.

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 maggiori informazioni su un audit completato.

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

  4. (Anteprima) Facoltativo: per visualizzare lo stato dell'audit utilizzando la nuova esperienza della console, completa i seguenti passaggi:

    1. Fai clic su Passa alla nuova esperienza.

    2. Per visualizzare ulteriori informazioni sull'audit, fai clic sul nome dell'audit.

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, che può essere un'organizzazione (anteprima), una cartella o un progetto. Ad esempio: folders o projects.
  • RESOURCE_ID: l'ID risorsa dell'organizzazione (anteprima), del progetto o della cartella. Ad esempio: 8767234.
  • LOCATION: la località dell'endpoint dell'API Audit Manager. Per un elenco degli endpoint disponibili, vedi 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, che può essere un'organizzazione (anteprima), una cartella o un progetto. Ad esempio: folders o projects.
  • RESOURCE_ID: l'ID risorsa dell'organizzazione (anteprima), del progetto o della cartella. Ad esempio: 8767234.
  • LOCATION: la località dell'endpoint dell'API Audit Manager. Per un elenco degli endpoint disponibili, vedi 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