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}/v1beta1/{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 API allows users to acknowledge a compliance violation in their workload, effectively ignoring it with a valid business justification.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request to acknowledge a violation is a \u003ccode\u003ePOST\u003c/code\u003e request to a specific endpoint, requiring the violation's resource name in the URL path.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a \u003ccode\u003ecomment\u003c/code\u003e explaining the business justification and can optionally include the type of acknowledgment with the \u003ccode\u003eacknowledgeType\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eThe process of acknowledging a violation is permanent and cannot be undone, as noted in the description.\u003c/p\u003e\n"],["\u003cp\u003eSuccessfully acknowledging a violation results in an empty response body, and the operation requires specific authorization scopes and IAM permissions on the target resource.\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}/v1beta1/{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."]]