Stay organized with collections
Save and categorize content based on your preferences.
This page describes how to get the status of an in-progress
audit in Audit Manager. Audits are long-running operations, and it can
be helpful to get the status of an audit while the operation is running.
Before you begin
Ensure that you have one of the following IAM roles:
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.
When an audit report is completed and uploaded, a link to the report is
returned.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThis guide explains how to check the status of an ongoing audit in Google Cloud's Audit Manager, which are long-running operations.\u003c/p\u003e\n"],["\u003cp\u003eTo view the status via the console, navigate to the Audit Manager page, then to the View Audits section, where the status of each audit can be seen.\u003c/p\u003e\n"],["\u003cp\u003eYou can also use the \u003ccode\u003egcloud audit-manager operations describe\u003c/code\u003e command, specifying the audit operation ID, resource type, resource ID, and location, to get the current status.\u003c/p\u003e\n"],["\u003cp\u003eUsing the REST API, you can issue a \u003ccode\u003eGET\u003c/code\u003e request to the specified endpoint, replacing placeholders with the relevant audit details, to obtain the audit's status.\u003c/p\u003e\n"],["\u003cp\u003eThe status response will contain information on the audit, like if it is in progress, has failed, or has completed, along with any potential additional information like the percentage of progress, or the reason for a failure.\u003c/p\u003e\n"]]],[],null,["# Get the status of an audit\n\nThis page describes how to get the status of an in-progress\naudit in Audit Manager. Audits are long-running operations, and it can\nbe helpful to get the status of an audit while the operation is running.\n\nBefore you begin\n----------------\n\n- Ensure that you have one of the following IAM roles:\n\n - [Audit Manager Admin](/iam/docs/understanding-roles#auditmanager.admin) (`roles/auditmanager.admin`)\n - [Audit Manager Auditor](/iam/docs/understanding-roles#auditmanager.auditor) (`roles/auditmanager.auditor`)\n- Identify the audit for which you want to get the status.\n\nGet the status of an in-progress audit\n--------------------------------------\n\n### Console\n\n1. In the Google Cloud console, go to the **Audit Manager** page.\n\n [Go to Audit Manager](https://console.cloud.google.com/compliance/auditmanager)\n2. In the **Compliance audits** section, click **View audits**.\n\n3. On the **View assessments** page, you can view the current status of an\n in-progress audit or get more information about a completed audit.\n\n4. To view more information about the audit, click the link in the **Status** column.\n\n### gcloud\n\nThe [`gcloud audit-manager operations describe`](/sdk/gcloud/reference/audit-manager/operations/describe)\ncommand describes an audit operation.\n\n\nBefore using any of the command data below,\nmake the following replacements:\n\n- \u003cvar class=\"edit\" scope=\"RESOURCE_TYPE\" translate=\"no\"\u003eRESOURCE_TYPE\u003c/var\u003e: The type of resource, either a project or a folder. For example: `folder`.\n- \u003cvar class=\"edit\" scope=\"RESOURCE_ID\" translate=\"no\"\u003eRESOURCE_ID\u003c/var\u003e: The resource ID of the project or folder. For example: `8767234`.\n- \u003cvar class=\"edit\" scope=\"LOCATION\" translate=\"no\"\u003eLOCATION\u003c/var\u003e: The location of the Audit Manager API endpoint. For a list of available endpoints, see [Locations](/audit-manager/docs/locations). For example: `us-central1`.\n- \u003cvar translate=\"no\"\u003eAUDIT_OPERATION_ID\u003c/var\u003e: The unique ID for the in-progress operation that was included in the response body when you ran the audit. For example: `098234`.\n\n\nExecute the\n\nfollowing\n\ncommand:\n\n#### Linux, macOS, or Cloud Shell\n\n**Note:** Ensure you have initialized the Google Cloud CLI with authentication and a project by running either [gcloud init](/sdk/gcloud/reference/init); or [gcloud auth login](/sdk/gcloud/reference/auth/login) and [gcloud config set project](/sdk/gcloud/reference/config/set). \n\n```bash\ngcloud audit-manager operations describe AUDIT_OPERATION_ID \\\n --RESOURCE_TYPE=RESOURCE_ID \\\n --location=LOCATION\n```\n\n#### Windows (PowerShell)\n\n**Note:** Ensure you have initialized the Google Cloud CLI with authentication and a project by running either [gcloud init](/sdk/gcloud/reference/init); or [gcloud auth login](/sdk/gcloud/reference/auth/login) and [gcloud config set project](/sdk/gcloud/reference/config/set). \n\n```bash\ngcloud audit-manager operations describe AUDIT_OPERATION_ID `\n --RESOURCE_TYPE=RESOURCE_ID `\n --location=LOCATION\n```\n\n#### Windows (cmd.exe)\n\n**Note:** Ensure you have initialized the Google Cloud CLI with authentication and a project by running either [gcloud init](/sdk/gcloud/reference/init); or [gcloud auth login](/sdk/gcloud/reference/auth/login) and [gcloud config set project](/sdk/gcloud/reference/config/set). \n\n```bash\ngcloud audit-manager operations describe AUDIT_OPERATION_ID ^\n --RESOURCE_TYPE=RESOURCE_ID ^\n --location=LOCATION\n```\n\n\u003cbr /\u003e\n\n### REST\n\n\nBefore using any of the request data,\nmake the following replacements:\n\n- \u003cvar class=\"edit\" scope=\"RESOURCE_TYPE\" translate=\"no\"\u003eRESOURCE_TYPE\u003c/var\u003e: The type of resource, either a project or a folder. For example: `folder`.\n- \u003cvar class=\"edit\" scope=\"RESOURCE_ID\" translate=\"no\"\u003eRESOURCE_ID\u003c/var\u003e: The resource ID of the project or folder. For example: `8767234`.\n- \u003cvar class=\"edit\" scope=\"LOCATION\" translate=\"no\"\u003eLOCATION\u003c/var\u003e: The location of the Audit Manager API endpoint. For a list of available endpoints, see [Locations](/audit-manager/docs/locations). For example: `us-central1`.\n- \u003cvar translate=\"no\"\u003eAUDIT_OPERATION_ID\u003c/var\u003e: The unique ID for the in-progress operation that was included in the response body when you ran the audit. For example: `098234`.\n\n\nHTTP method and URL:\n\n```\nGET https://auditmanager.googleapis.com/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID\n```\n\nTo send your request, choose one of these options: \n\n#### curl\n\n| **Note:** The following command assumes that you have logged in to the `gcloud` CLI with your user account by running [`gcloud init`](/sdk/gcloud/reference/init) or [`gcloud auth login`](/sdk/gcloud/reference/auth/login) , or by using [Cloud Shell](/shell/docs), which automatically logs you into the `gcloud` CLI . You can check the currently active account by running [`gcloud auth list`](/sdk/gcloud/reference/auth/list).\n\n\nExecute the following command:\n\n```\ncurl -X GET \\\n -H \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n \"https://auditmanager.googleapis.com/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID\"\n```\n\n#### PowerShell\n\n| **Note:** The following command assumes that you have logged in to the `gcloud` CLI with your user account by running [`gcloud init`](/sdk/gcloud/reference/init) or [`gcloud auth login`](/sdk/gcloud/reference/auth/login) . You can check the currently active account by running [`gcloud auth list`](/sdk/gcloud/reference/auth/list).\n\n\nExecute the following command:\n\n```\n$cred = gcloud auth print-access-token\n$headers = @{ \"Authorization\" = \"Bearer $cred\" }\n\nInvoke-WebRequest `\n -Method GET `\n -Headers $headers `\n -Uri \"https://auditmanager.googleapis.com/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID\" | Select-Object -Expand Content\n```\nA successful response includes the one of the following execution status types:\n\n```\n\n Status type\n Description\n \n `OPERATION_STATE_UNSPECIFIED`\n An invalid state.\n \n \n `OPERATION_STATE_NOT_STARTED`\n The audit report generation process has not yet started.\n \n \n `OPERATION_STATE_EVALUATION_IN_PROGRESS`\n Audit Manager is evaluating the resources against compliance\n controls.\n \n \n `OPERATION_STATE_EVALUATION_DONE`\n Audit Manager has completed\n compliance evaluation.\n \n \n `OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS`\n Audit Manager is creating an audit report from the evaluated data.\n \n \n `OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE`\n Audit Manager has completed the generation of the audit report.\n \n \n `OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS`\n Audit Manager is uploading the audit report and evidence to the destination.\n \n \n `OPERATION_STATE_DONE`\n The audit report generation process is completed.\n \n \n `OPERATION_STATE_FAILED`\n The audit report generation process has failed.\n \n\n\n Each of the execution status types might provide any of the following additional information, when applicable:\n\n \n Additional status\n Description\n \n `failure_reason`\n If the audit assessment fails, this field\n provides the reason for the failure.\n \n \n `evaluation_percent_complete`\n If evaluation has started, this\n field provides the percentage of the progress.\n When the process is yet to start, the field starts at `0`.\n When the process is concluded, the field is\n set to `100`.\n \n \n `report_generation_percent_complete`\n If the report generation has started, this\n field provides percentage of the progress. When the process is yet to start,\n the field starts at `0`. When the process is concluded, the field is\n set to `100`.\n \n \n `report_uploading_percent_complete`\n If the report uploading has started, this\n field provides percentage of the progress. When the process is yet to start,\n the field starts at `0`. When the process is concluded, the field is set to `100`.\n \n \n```\n\n\u003cbr /\u003e\n\nWhen an audit report is completed and uploaded, a link to the report is\nreturned.\n\nWhat's next\n-----------\n\n- [View an audit report](/audit-manager/docs/view-audit)."]]