Conoscere lo stato di un controllo

Questa pagina descrive come ottenere lo stato di un audit in corso in Audit Manager. Gli audit sono operazioni a lunga esecuzione e può essere utile ottenere lo stato di un audit mentre l'operazione è in esecuzione.

Prima di iniziare

Visualizzare lo stato di un audit in corso

Console

  1. Nella console Google Cloud , vai alla pagina Audit Manager.

    Vai a Audit Manager

  2. Nella sezione Controlli di conformità, fai clic su Visualizza controlli.

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

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

gcloud

Il comando gcloud audit-manager operations describe descrive un'operazione di controllo.

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

  • RESOURCE_TYPE: il tipo di risorsa, ovvero un progetto o una cartella. Ad esempio: folder.
  • RESOURCE_ID: l'ID risorsa del progetto o della cartella. Ad esempio: 8767234.
  • LOCATION: la posizione dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località. Ad esempio us-central1.
  • AUDIT_OPERATION_ID: l'ID univoco dell'operazione in corso incluso nel corpo della risposta quando hai eseguito il controllo. 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

REST

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

  • RESOURCE_TYPE: il tipo di risorsa, ovvero un progetto o una cartella. Ad esempio: folder.
  • RESOURCE_ID: l'ID risorsa del progetto o della cartella. Ad esempio: 8767234.
  • LOCATION: la posizione dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località. Ad esempio us-central1.
  • AUDIT_OPERATION_ID: l'ID univoco dell'operazione in corso incluso nel corpo della risposta quando hai eseguito il controllo. Ad esempio: 098234.

Metodo HTTP e URL: 

GET https://auditmanager.googleapis.com/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/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/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: 

  
Status type
  Description
  

  OPERATION_STATE_UNSPECIFIED
  An invalid state.
  

  

  OPERATION_STATE_NOT_STARTED
  The audit report generation process has not yet started.
  

  

  OPERATION_STATE_EVALUATION_IN_PROGRESS
  Audit Manager is evaluating the resources against compliance
   controls.
  

  

  OPERATION_STATE_EVALUATION_DONE
  Audit Manager has completed
    compliance evaluation.
  

    

  OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS
  Audit Manager is creating an audit report from the evaluated data.
  

  

  OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE
  Audit Manager has completed the generation of the audit report.
  

  

  OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS
  Audit Manager is uploading the audit report and evidence to the destination.
  

  

  OPERATION_STATE_DONE
  The audit report generation process is completed.
  

  

  OPERATION_STATE_FAILED
  The audit report generation process has failed.
  




  
Each of the execution status types might provide any of the following additional information, when applicable:


  

  
Additional status
  Description
  

  failure_reason
  If the audit assessment fails, this field
   provides the reason for the failure.
  

  

  evaluation_percent_complete
  If evaluation has started, this
    field provides the percentage of the progress.
    When the process is yet to start, the field starts at 0.
    When the process is concluded, the field is
    set to 100.
  

  

  report_generation_percent_complete
  If the report generation has started, this
    field provides percentage of the progress. When the process is yet to start,
    the field starts at 0. When the process is concluded, the field is
    set to 100.
  

  

  report_uploading_percent_complete
  If the report uploading has started, this
    field provides percentage of the progress. When the process is yet to start,
    the field starts at 0. When the process is concluded, the field is set to 100.

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

Passaggi successivi