Skip to main content

image_block_public_access_states

Creates, updates, deletes, gets or lists an image_block_public_access_states resource.

Overview

Nameimage_block_public_access_states
TypeResource
Idaws.ec2.image_block_public_access_states

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
image_block_public_access_statestringThe current state of block public access for AMIs at the account level in the specified Amazon Web Services 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.
managed_bystringThe 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.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_image_block_public_access_stateselectregionDryRunGets the current state of block public access for AMIs at the account level in the specified Amazon Web Services Region. For more information, see Block public access to your AMIs in the Amazon EC2 User Guide.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
DryRunbooleanChecks 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.

SELECT examples

Gets the current state of block public access for AMIs at the account level in the specified Amazon Web Services Region. For more information, see Block public access to your AMIs in the Amazon EC2 User Guide.

SELECT
image_block_public_access_state,
managed_by
FROM aws.ec2.image_block_public_access_states
WHERE region = '{{ region }}' -- required
AND DryRun = '{{ DryRun }}'
;