DeleteResourcePolicy - AWS Systems Manager

DeleteResourcePolicy

Deletes a Systems Manager resource policy. A resource policy helps you to define the IAM entity (for example, an AWS account) that can manage your Systems Manager resources. The following resources support Systems Manager resource policies.

  • OpsItemGroup - The resource policy for OpsItemGroup enables AWS accounts to view and interact with OpsCenter operational work items (OpsItems).

  • Parameter - The resource policy is used to share a parameter with other accounts using AWS Resource Access Manager (AWS RAM). For more information about cross-account sharing of parameters, see Working with shared parameters in the AWS Systems Manager User Guide.

Request Syntax

{ "PolicyHash": "string", "PolicyId": "string", "ResourceArn": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

PolicyHash

ID of the current policy version. The hash helps to prevent multiple calls from attempting to overwrite a policy.

Type: String

Required: Yes

PolicyId

The policy ID.

Type: String

Required: Yes

ResourceArn

Amazon Resource Name (ARN) of the resource to which the policies are attached.

Type: String

Length Constraints: Minimum length of 20. Maximum length of 2048.

Required: Yes

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

For information about the errors that are common to all actions, see Common Errors.

InternalServerError

An error occurred on the server side.

HTTP Status Code: 500

MalformedResourcePolicyDocumentException

The specified policy document is malformed or invalid, or excessive PutResourcePolicy or DeleteResourcePolicy calls have been made.

HTTP Status Code: 400

ResourceNotFoundException

The specified parameter to be shared could not be found.

HTTP Status Code: 400

ResourcePolicyConflictException

The hash provided in the call doesn't match the stored hash. This exception is thrown when trying to update an obsolete policy version or when multiple requests to update a policy are sent.

HTTP Status Code: 400

ResourcePolicyInvalidParameterException

One or more parameters specified for the call aren't valid. Verify the parameters and their values and try again.

HTTP Status Code: 400

ResourcePolicyNotFoundException

No policies with the specified policy ID and hash could be found.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: