Acknowledges an existing violation. By acknowledging a violation, users acknowledge the existence of a compliance violation in their workload and decide to ignore it due to a valid business justification. Acknowledgement is a permanent operation and it cannot be reverted.
HTTP request
POST https://{endpoint}/v1/{name=organizations/*/locations/*/workloads/*/violations/*}:acknowledge
Required. The resource name of the Violation to acknowledge. Format: organizations/{organization}/locations/{location}/workloads/{workload}/violations/{violation}
Request body
The request body contains data with the following structure:
Required. Business justification explaining the need for violation acknowledgement
nonCompliantOrgPolicy (deprecated)
string
Optional. This field is deprecated and will be removed in future version of the API. Name of the OrgPolicy which was modified with non-compliant change and resulted in this violation. Format: projects/{project_number}/policies/{constraint_name} folders/{folderId}/policies/{constraint_name} organizations/{organization_id}/policies/{constraint_name}
[[["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-06-30 UTC."],[[["\u003cp\u003eThis document describes how to acknowledge a compliance violation in a workload, which is a permanent action indicating the user's awareness and decision to ignore it due to business reasons.\u003c/p\u003e\n"],["\u003cp\u003eAcknowledging a violation is done through a \u003ccode\u003ePOST\u003c/code\u003e HTTP request to a specific endpoint, with the required \u003ccode\u003ename\u003c/code\u003e path parameter specifying the violation's resource name.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003ecomment\u003c/code\u003e field for business justification, and can also include an optional \u003ccode\u003eacknowledgeType\u003c/code\u003e to specify if only the violation should be acknowledged or also any associated resource violations.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful acknowledgment results in an empty response body, and requires \u003ccode\u003eassuredworkloads.violations.update\u003c/code\u003e IAM permission along with the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eThe deprecated field \u003ccode\u003enonCompliantOrgPolicy\u003c/code\u003e will be removed in the future.\u003c/p\u003e\n"]]],[],null,["# Method: organizations.locations.workloads.violations.acknowledge\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [AcknowledgeType](#AcknowledgeType)\n\nAcknowledges an existing violation. By acknowledging a violation, users acknowledge the existence of a compliance violation in their workload and decide to ignore it due to a valid business justification. Acknowledgement is a permanent operation and it cannot be reverted.\n\n### HTTP request\n\n`POST https://{endpoint}/v1/{name=organizations/*/locations/*/workloads/*/violations/*}:acknowledge`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/assured-workloads/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `assuredworkloads.violations.update`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs).\n\nAcknowledgeType\n---------------\n\nAcknowledge type values."]]