DisableImageBlockPublicAccess
Disables block public access for AMIs at the account level in the specified Amazon Region. This removes the block public access restriction from your account. With the restriction removed, you can publicly share your AMIs in the specified Amazon Region.
The API can take up to 10 minutes to configure this setting. During this time, if you run
GetImageBlockPublicAccessState, the response will be
block-new-sharing
. When the API has completed the configuration, the response
will be unblocked
.
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
-
Returns
unblocked
if the request succeeds; otherwise, it returns an error.Type: String
Valid Values:
unblocked
- 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 disables block public access for AMIs at the account level in the specified Region to allow users in your account to publicly share your AMIs in the specified Region.
Sample Request
https://ec2.amazonaws.com/?Action=DisableImageBlockPublicAccess
&Region=us-east-1
&AUTHPARAMS
Sample Response
<DisableImageBlockPublicAccessResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
<requestId>11aabb229-4eac-35bd-99ed-be587EXAMPLE</requestId>
<return>unblocked</return>
</DisableImageBlockPublicAccessResponse>
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: