GetImageBlockPublicAccessState
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 Parameters
For more information about required and optional parameters that are common to all actions, see Common Query Parameters.
- DryRun
-
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 isUnauthorizedOperation
.Type: Boolean
Required: No
Response Elements
The following elements are returned by the service.
- imageBlockPublicAccessState
-
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
-
- managedBy
-
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
-
- requestId
-
The ID of the request.
Type: String
Errors
For information about the errors that are common to all actions, see Common client error codes.
Examples
Example
This 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
.
Sample Request
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: