Gets the current state of block public access for AMIs at the account level in the specified AWS Region.
For more information, see Block public access to your AMIs in the Amazon EC2 User Guide.
Request ParametersFor more information about required and optional parameters that are common to all actions, see Common Query Parameters.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation
. Otherwise, it is UnauthorizedOperation
.
Type: Boolean
Required: No
The following elements are returned by the service.
The current state of block public access for AMIs at the account level in the specified AWS Region.
Possible values:
block-new-sharing
- Any attempt to publicly share your AMIs in the specified Region is blocked.
unblocked
- Your AMIs in the specified Region can be publicly shared.
Type: String
The entity that manages the state for block public access for AMIs. Possible values include:
account
- The state is managed by the account.
declarative-policy
- The state is managed by a declarative policy and can't be modified by the account.
Type: String
Valid Values: account | declarative-policy
The ID of the request.
Type: String
For information about the errors that are common to all actions, see Common client error codes.
Examples ExampleThis example gets the state of block public access for AMIs at the account level in the specified Region to see whether the public sharing of your AMIs is blocked in your account. The value for the response is either block-new-sharing
or unblocked
.
https://ec2.amazonaws.com/?Action=GetImageBlockPublicAccessState
&Region=us-east-1
&AUTHPARAMS
Sample Response
<GetImageBlockPublicAccessStateResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
<requestId>11aabb229-4eac-35bd-99ed-be587EXAMPLE</requestId>
<return>block-new-sharing</return>
</GetImageBlockPublicAccessStateResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4