Conoscere lo stato di un controllo

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

Prima di iniziare

  • Assicurati di disporre di uno dei seguenti ruoli IAM:

  • Identifica l'audit per il quale vuoi ottenere lo stato.

Visualizzare lo stato di un controllo in corso

Console

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

    Vai a Visualizza controlli

  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 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, 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 posizione 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 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

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 La procedura di generazione del report di controllo è stata completata.
OPERATION_STATE_FAILED Il processo di generazione del report di controllo non è riuscito.

Ciascun tipo di stato di esecuzione può 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 indica il motivo dell'errore.
evaluation_percent_complete Se la valutazione è iniziata, questo campo indica la percentuale di avanzamento. Quando la procedura non è ancora iniziata, il campo inizia da 0. Al termine della procedura, il campo è impostato su 100.
report_generation_percent_complete Se la generazione del report è iniziata, questo campo indica la percentuale di avanzamento. Quando la procedura non è ancora iniziata, il campo inizia da 0. Al termine della procedura, il campo è impostato su 100.
report_uploading_percent_complete Se il caricamento del report è iniziato, questo campo indica la percentuale di avanzamento. Quando la procedura non è ancora iniziata, il campo inizia da 0. Al termine della procedura, il campo è 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 posizione 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 il controllo. 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 La procedura di generazione del report di controllo è stata completata.
OPERATION_STATE_FAILED Il processo di generazione del report di controllo non è riuscito.

Ciascun tipo di stato di esecuzione può 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 indica il motivo dell'errore.
evaluation_percent_complete Se la valutazione è iniziata, questo campo indica la percentuale di avanzamento. Quando la procedura non è ancora iniziata, il campo inizia da 0. Al termine della procedura, il campo è impostato su 100.
report_generation_percent_complete Se la generazione del report è iniziata, questo campo indica la percentuale di avanzamento. Quando la procedura non è ancora iniziata, il campo inizia da 0. Al termine della procedura, il campo è impostato su 100.
report_uploading_percent_complete Se il caricamento del report è iniziato, questo campo indica la percentuale di avanzamento. Quando la procedura non è ancora iniziata, il campo inizia da 0. Al termine della procedura, il campo è 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