aws_sdk_ec2/client/
get_allowed_images_settings.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`GetAllowedImagesSettings`](crate::operation::get_allowed_images_settings::builders::GetAllowedImagesSettingsFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`dry_run(bool)`](crate::operation::get_allowed_images_settings::builders::GetAllowedImagesSettingsFluentBuilder::dry_run) / [`set_dry_run(Option<bool>)`](crate::operation::get_allowed_images_settings::builders::GetAllowedImagesSettingsFluentBuilder::set_dry_run):<br>required: **false**<br><p>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 <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p><br>
7    /// - On success, responds with [`GetAllowedImagesSettingsOutput`](crate::operation::get_allowed_images_settings::GetAllowedImagesSettingsOutput) with field(s):
8    ///   - [`state(Option<String>)`](crate::operation::get_allowed_images_settings::GetAllowedImagesSettingsOutput::state): <p>The current state of the Allowed AMIs setting at the account level in the specified Amazon Web Services Region.</p> <p>Possible values:</p> <ul>  <li>   <p><code>disabled</code>: All AMIs are allowed.</p></li>  <li>   <p><code>audit-mode</code>: All AMIs are allowed, but the <code>ImageAllowed</code> field is set to <code>true</code> if the AMI would be allowed with the current list of criteria if allowed AMIs was enabled.</p></li>  <li>   <p><code>enabled</code>: Only AMIs matching the image criteria are discoverable and available for use.</p></li> </ul>
9    ///   - [`image_criteria(Option<Vec::<ImageCriterion>>)`](crate::operation::get_allowed_images_settings::GetAllowedImagesSettingsOutput::image_criteria): <p>The list of criteria for images that are discoverable and usable in the account in the specified Amazon Web Services Region.</p>
10    ///   - [`managed_by(Option<ManagedBy>)`](crate::operation::get_allowed_images_settings::GetAllowedImagesSettingsOutput::managed_by): <p>The entity that manages the Allowed AMIs settings. Possible values include:</p> <ul>  <li>   <p><code>account</code> - The Allowed AMIs settings is managed by the account.</p></li>  <li>   <p><code>declarative-policy</code> - The Allowed AMIs settings is managed by a declarative policy and can't be modified by the account.</p></li> </ul>
11    /// - On failure, responds with [`SdkError<GetAllowedImagesSettingsError>`](crate::operation::get_allowed_images_settings::GetAllowedImagesSettingsError)
12    pub fn get_allowed_images_settings(&self) -> crate::operation::get_allowed_images_settings::builders::GetAllowedImagesSettingsFluentBuilder {
13        crate::operation::get_allowed_images_settings::builders::GetAllowedImagesSettingsFluentBuilder::new(self.handle.clone())
14    }
15}