Deletes a policy statement from a resource policy. If you delete the last statement from a policy, the policy is deleted. If you specify a statement ID that doesn't exist in the policy, or if the bot or bot alias doesn't have a policy attached, Amazon Lex returns an exception.
You need to add the DeleteResourcePolicy or UpdateResourcePolicy
action to the bot role in order to call the API.
Request Syntax
DELETE /policy/resourceArn/statements/statementId/?expectedRevisionId=expectedRevisionId HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- expectedRevisionId
-
The identifier of the revision of the policy to delete the statement from. If this revision ID doesn't match the current revision ID, Amazon Lex throws an exception.
If you don't specify a revision, Amazon Lex removes the current contents of the statement.
Length Constraints: Minimum length of 1. Maximum length of 5.
Pattern:
^[0-9]+$ - resourceArn
-
The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.
Length Constraints: Minimum length of 1. Maximum length of 1011.
Required: Yes
- statementId
-
The name of the statement (SID) to delete from the policy.
Length Constraints: Minimum length of 1. Maximum length of 100.
Pattern:
^([0-9a-zA-Z][_-]?){1,100}$Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 204
Content-type: application/json
{
"resourceArn": "string",
"revisionId": "string"
}Response Elements
If the action is successful, the service sends back an HTTP 204 response.
The following data is returned in JSON format by the service.
- resourceArn
-
The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy statement was removed from.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 1011.
- revisionId
-
The current revision of the resource policy. Use the revision ID to make sure that you are updating the most current version of a resource policy when you add a policy statement to a resource, delete a resource, or update a resource.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 5.
Pattern:
^[0-9]+$
Errors
For information about the errors that are common to all actions, see Common Errors.
- InternalServerException
-
The service encountered an unexpected condition. Try your request again.
HTTP Status Code: 500
- PreconditionFailedException
-
Your request couldn't be completed because one or more request fields aren't valid. Check the fields in your request and try again.
HTTP Status Code: 412
- ResourceNotFoundException
-
You asked to describe a resource that doesn't exist. Check the resource that you are requesting and try again.
HTTP Status Code: 404
- ThrottlingException
-
Your request rate is too high. Reduce the frequency of requests.
HTTP Status Code: 429
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
