pulumi-aws 7.11.1__py3-none-any.whl → 7.12.0__py3-none-any.whl

pulumi_aws/dms/outputs.py

@@ -964,7 +964,7 @@ class EndpointPostgresSettings(dict):
         :param _builtins.bool map_jsonb_as_clob: Optional When true, DMS migrates JSONB values as CLOB.
         :param _builtins.str map_long_varchar_as: Optional When true, DMS migrates LONG values as VARCHAR.
         :param _builtins.int max_file_size: Specifies the maximum size (in KB) of any .csv file used to transfer data to PostgreSQL. Default is `32,768 KB`.
-        :param _builtins.str plugin_name: Specifies the plugin to use to create a replication slot. Valid values: `pglogical`, `test_decoding`.
+        :param _builtins.str plugin_name: Specifies the plugin to use to create a replication slot. Valid values: `pglogical`, `test-decoding`.
         :param _builtins.str service_access_role_arn: Specifies the IAM role to use to authenticate the connection.
         :param _builtins.str slot_name: Sets the name of a previously created logical replication slot for a CDC load of the PostgreSQL source instance.
         """
@@ -1129,7 +1129,7 @@ class EndpointPostgresSettings(dict):
     @pulumi.getter(name="pluginName")
     def plugin_name(self) -> Optional[_builtins.str]:
         """
-        Specifies the plugin to use to create a replication slot. Valid values: `pglogical`, `test_decoding`.
+        Specifies the plugin to use to create a replication slot. Valid values: `pglogical`, `test-decoding`.
         """
         return pulumi.get(self, "plugin_name")
 

pulumi_aws/ec2/__init__.py

@@ -7,6 +7,7 @@ from .. import _utilities
 import typing
 # Export this package's modules as members:
 from ._enums import *
+from .allowed_images_settings import *
 from .ami import *
 from .ami_copy import *
 from .ami_from_instance import *

pulumi_aws/ec2/_inputs.py

@@ -16,6 +16,12 @@ from .. import _utilities
 from ._enums import *
 
 __all__ = [
+    'AllowedImagesSettingsImageCriterionArgs',
+    'AllowedImagesSettingsImageCriterionArgsDict',
+    'AllowedImagesSettingsImageCriterionCreationDateConditionArgs',
+    'AllowedImagesSettingsImageCriterionCreationDateConditionArgsDict',
+    'AllowedImagesSettingsImageCriterionDeprecationTimeConditionArgs',
+    'AllowedImagesSettingsImageCriterionDeprecationTimeConditionArgsDict',
     'AmiCopyEbsBlockDeviceArgs',
     'AmiCopyEbsBlockDeviceArgsDict',
     'AmiCopyEphemeralBlockDeviceArgs',
@@ -606,6 +612,182 @@ __all__ = [
 
 MYPY = False
 
+if not MYPY:
+    class AllowedImagesSettingsImageCriterionArgsDict(TypedDict):
+        creation_date_condition: NotRequired[pulumi.Input['AllowedImagesSettingsImageCriterionCreationDateConditionArgsDict']]
+        """
+        Condition based on AMI creation date. See `creation_date_condition` below.
+        """
+        deprecation_time_condition: NotRequired[pulumi.Input['AllowedImagesSettingsImageCriterionDeprecationTimeConditionArgsDict']]
+        """
+        Condition based on AMI deprecation time. See `deprecation_time_condition` below.
+        """
+        image_names: NotRequired[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]
+        """
+        Set of AMI name patterns to allow. Maximum of 50 names.
+        """
+        image_providers: NotRequired[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]
+        """
+        Set of image providers to allow. Maximum of 200 providers. Valid values include `amazon`, `aws-marketplace`, `aws-backup-vault`, `none`, or a 12-digit AWS account ID.
+        """
+        marketplace_product_codes: NotRequired[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]
+        """
+        Set of AWS Marketplace product codes to allow. Maximum of 50 product codes.
+        """
+elif False:
+    AllowedImagesSettingsImageCriterionArgsDict: TypeAlias = Mapping[str, Any]
+
+@pulumi.input_type
+class AllowedImagesSettingsImageCriterionArgs:
+    def __init__(__self__, *,
+                 creation_date_condition: Optional[pulumi.Input['AllowedImagesSettingsImageCriterionCreationDateConditionArgs']] = None,
+                 deprecation_time_condition: Optional[pulumi.Input['AllowedImagesSettingsImageCriterionDeprecationTimeConditionArgs']] = None,
+                 image_names: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
+                 image_providers: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None,
+                 marketplace_product_codes: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]] = None):
+        """
+        :param pulumi.Input['AllowedImagesSettingsImageCriterionCreationDateConditionArgs'] creation_date_condition: Condition based on AMI creation date. See `creation_date_condition` below.
+        :param pulumi.Input['AllowedImagesSettingsImageCriterionDeprecationTimeConditionArgs'] deprecation_time_condition: Condition based on AMI deprecation time. See `deprecation_time_condition` below.
+        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] image_names: Set of AMI name patterns to allow. Maximum of 50 names.
+        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] image_providers: Set of image providers to allow. Maximum of 200 providers. Valid values include `amazon`, `aws-marketplace`, `aws-backup-vault`, `none`, or a 12-digit AWS account ID.
+        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] marketplace_product_codes: Set of AWS Marketplace product codes to allow. Maximum of 50 product codes.
+        """
+        if creation_date_condition is not None:
+            pulumi.set(__self__, "creation_date_condition", creation_date_condition)
+        if deprecation_time_condition is not None:
+            pulumi.set(__self__, "deprecation_time_condition", deprecation_time_condition)
+        if image_names is not None:
+            pulumi.set(__self__, "image_names", image_names)
+        if image_providers is not None:
+            pulumi.set(__self__, "image_providers", image_providers)
+        if marketplace_product_codes is not None:
+            pulumi.set(__self__, "marketplace_product_codes", marketplace_product_codes)
+
+    @_builtins.property
+    @pulumi.getter(name="creationDateCondition")
+    def creation_date_condition(self) -> Optional[pulumi.Input['AllowedImagesSettingsImageCriterionCreationDateConditionArgs']]:
+        """
+        Condition based on AMI creation date. See `creation_date_condition` below.
+        """
+        return pulumi.get(self, "creation_date_condition")
+
+    @creation_date_condition.setter
+    def creation_date_condition(self, value: Optional[pulumi.Input['AllowedImagesSettingsImageCriterionCreationDateConditionArgs']]):
+        pulumi.set(self, "creation_date_condition", value)
+
+    @_builtins.property
+    @pulumi.getter(name="deprecationTimeCondition")
+    def deprecation_time_condition(self) -> Optional[pulumi.Input['AllowedImagesSettingsImageCriterionDeprecationTimeConditionArgs']]:
+        """
+        Condition based on AMI deprecation time. See `deprecation_time_condition` below.
+        """
+        return pulumi.get(self, "deprecation_time_condition")
+
+    @deprecation_time_condition.setter
+    def deprecation_time_condition(self, value: Optional[pulumi.Input['AllowedImagesSettingsImageCriterionDeprecationTimeConditionArgs']]):
+        pulumi.set(self, "deprecation_time_condition", value)
+
+    @_builtins.property
+    @pulumi.getter(name="imageNames")
+    def image_names(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]:
+        """
+        Set of AMI name patterns to allow. Maximum of 50 names.
+        """
+        return pulumi.get(self, "image_names")
+
+    @image_names.setter
+    def image_names(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]):
+        pulumi.set(self, "image_names", value)
+
+    @_builtins.property
+    @pulumi.getter(name="imageProviders")
+    def image_providers(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]:
+        """
+        Set of image providers to allow. Maximum of 200 providers. Valid values include `amazon`, `aws-marketplace`, `aws-backup-vault`, `none`, or a 12-digit AWS account ID.
+        """
+        return pulumi.get(self, "image_providers")
+
+    @image_providers.setter
+    def image_providers(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]):
+        pulumi.set(self, "image_providers", value)
+
+    @_builtins.property
+    @pulumi.getter(name="marketplaceProductCodes")
+    def marketplace_product_codes(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]:
+        """
+        Set of AWS Marketplace product codes to allow. Maximum of 50 product codes.
+        """
+        return pulumi.get(self, "marketplace_product_codes")
+
+    @marketplace_product_codes.setter
+    def marketplace_product_codes(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]):
+        pulumi.set(self, "marketplace_product_codes", value)
+
+
+if not MYPY:
+    class AllowedImagesSettingsImageCriterionCreationDateConditionArgsDict(TypedDict):
+        maximum_days_since_created: NotRequired[pulumi.Input[_builtins.int]]
+        """
+        Maximum number of days since the AMI was created.
+        """
+elif False:
+    AllowedImagesSettingsImageCriterionCreationDateConditionArgsDict: TypeAlias = Mapping[str, Any]
+
+@pulumi.input_type
+class AllowedImagesSettingsImageCriterionCreationDateConditionArgs:
+    def __init__(__self__, *,
+                 maximum_days_since_created: Optional[pulumi.Input[_builtins.int]] = None):
+        """
+        :param pulumi.Input[_builtins.int] maximum_days_since_created: Maximum number of days since the AMI was created.
+        """
+        if maximum_days_since_created is not None:
+            pulumi.set(__self__, "maximum_days_since_created", maximum_days_since_created)
+
+    @_builtins.property
+    @pulumi.getter(name="maximumDaysSinceCreated")
+    def maximum_days_since_created(self) -> Optional[pulumi.Input[_builtins.int]]:
+        """
+        Maximum number of days since the AMI was created.
+        """
+        return pulumi.get(self, "maximum_days_since_created")
+
+    @maximum_days_since_created.setter
+    def maximum_days_since_created(self, value: Optional[pulumi.Input[_builtins.int]]):
+        pulumi.set(self, "maximum_days_since_created", value)
+
+
+if not MYPY:
+    class AllowedImagesSettingsImageCriterionDeprecationTimeConditionArgsDict(TypedDict):
+        maximum_days_since_deprecated: NotRequired[pulumi.Input[_builtins.int]]
+        """
+        Maximum number of days since the AMI was deprecated. Setting this to `0` means no deprecated images are allowed.
+        """
+elif False:
+    AllowedImagesSettingsImageCriterionDeprecationTimeConditionArgsDict: TypeAlias = Mapping[str, Any]
+
+@pulumi.input_type
+class AllowedImagesSettingsImageCriterionDeprecationTimeConditionArgs:
+    def __init__(__self__, *,
+                 maximum_days_since_deprecated: Optional[pulumi.Input[_builtins.int]] = None):
+        """
+        :param pulumi.Input[_builtins.int] maximum_days_since_deprecated: Maximum number of days since the AMI was deprecated. Setting this to `0` means no deprecated images are allowed.
+        """
+        if maximum_days_since_deprecated is not None:
+            pulumi.set(__self__, "maximum_days_since_deprecated", maximum_days_since_deprecated)
+
+    @_builtins.property
+    @pulumi.getter(name="maximumDaysSinceDeprecated")
+    def maximum_days_since_deprecated(self) -> Optional[pulumi.Input[_builtins.int]]:
+        """
+        Maximum number of days since the AMI was deprecated. Setting this to `0` means no deprecated images are allowed.
+        """
+        return pulumi.get(self, "maximum_days_since_deprecated")
+
+    @maximum_days_since_deprecated.setter
+    def maximum_days_since_deprecated(self, value: Optional[pulumi.Input[_builtins.int]]):
+        pulumi.set(self, "maximum_days_since_deprecated", value)
+
+
 if not MYPY:
     class AmiCopyEbsBlockDeviceArgsDict(TypedDict):
         delete_on_termination: NotRequired[pulumi.Input[_builtins.bool]]

pulumi_aws/ec2/allowed_images_settings.py

@@ -0,0 +1,338 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins as _builtins
+import warnings
+import sys
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
+from .. import _utilities
+from . import outputs
+from ._inputs import *
+
+__all__ = ['AllowedImagesSettingsArgs', 'AllowedImagesSettings']
+
+@pulumi.input_type
+class AllowedImagesSettingsArgs:
+    def __init__(__self__, *,
+                 state: pulumi.Input[_builtins.str],
+                 image_criterions: Optional[pulumi.Input[Sequence[pulumi.Input['AllowedImagesSettingsImageCriterionArgs']]]] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None):
+        """
+        The set of arguments for constructing a AllowedImagesSettings resource.
+        :param pulumi.Input[_builtins.str] state: State of the allowed images settings. Valid values are `enabled` or `audit-mode`.
+        :param pulumi.Input[Sequence[pulumi.Input['AllowedImagesSettingsImageCriterionArgs']]] image_criterions: List of image criteria. Maximum of 10 criterion blocks allowed. See `image_criterion` below.
+        :param pulumi.Input[_builtins.str] region: Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
+        """
+        pulumi.set(__self__, "state", state)
+        if image_criterions is not None:
+            pulumi.set(__self__, "image_criterions", image_criterions)
+        if region is not None:
+            pulumi.set(__self__, "region", region)
+
+    @_builtins.property
+    @pulumi.getter
+    def state(self) -> pulumi.Input[_builtins.str]:
+        """
+        State of the allowed images settings. Valid values are `enabled` or `audit-mode`.
+        """
+        return pulumi.get(self, "state")
+
+    @state.setter
+    def state(self, value: pulumi.Input[_builtins.str]):
+        pulumi.set(self, "state", value)
+
+    @_builtins.property
+    @pulumi.getter(name="imageCriterions")
+    def image_criterions(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['AllowedImagesSettingsImageCriterionArgs']]]]:
+        """
+        List of image criteria. Maximum of 10 criterion blocks allowed. See `image_criterion` below.
+        """
+        return pulumi.get(self, "image_criterions")
+
+    @image_criterions.setter
+    def image_criterions(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['AllowedImagesSettingsImageCriterionArgs']]]]):
+        pulumi.set(self, "image_criterions", value)
+
+    @_builtins.property
+    @pulumi.getter
+    def region(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
+        """
+        return pulumi.get(self, "region")
+
+    @region.setter
+    def region(self, value: Optional[pulumi.Input[_builtins.str]]):
+        pulumi.set(self, "region", value)
+
+
+@pulumi.input_type
+class _AllowedImagesSettingsState:
+    def __init__(__self__, *,
+                 image_criterions: Optional[pulumi.Input[Sequence[pulumi.Input['AllowedImagesSettingsImageCriterionArgs']]]] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None,
+                 state: Optional[pulumi.Input[_builtins.str]] = None):
+        """
+        Input properties used for looking up and filtering AllowedImagesSettings resources.
+        :param pulumi.Input[Sequence[pulumi.Input['AllowedImagesSettingsImageCriterionArgs']]] image_criterions: List of image criteria. Maximum of 10 criterion blocks allowed. See `image_criterion` below.
+        :param pulumi.Input[_builtins.str] region: Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
+        :param pulumi.Input[_builtins.str] state: State of the allowed images settings. Valid values are `enabled` or `audit-mode`.
+        """
+        if image_criterions is not None:
+            pulumi.set(__self__, "image_criterions", image_criterions)
+        if region is not None:
+            pulumi.set(__self__, "region", region)
+        if state is not None:
+            pulumi.set(__self__, "state", state)
+
+    @_builtins.property
+    @pulumi.getter(name="imageCriterions")
+    def image_criterions(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['AllowedImagesSettingsImageCriterionArgs']]]]:
+        """
+        List of image criteria. Maximum of 10 criterion blocks allowed. See `image_criterion` below.
+        """
+        return pulumi.get(self, "image_criterions")
+
+    @image_criterions.setter
+    def image_criterions(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['AllowedImagesSettingsImageCriterionArgs']]]]):
+        pulumi.set(self, "image_criterions", value)
+
+    @_builtins.property
+    @pulumi.getter
+    def region(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
+        """
+        return pulumi.get(self, "region")
+
+    @region.setter
+    def region(self, value: Optional[pulumi.Input[_builtins.str]]):
+        pulumi.set(self, "region", value)
+
+    @_builtins.property
+    @pulumi.getter
+    def state(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        State of the allowed images settings. Valid values are `enabled` or `audit-mode`.
+        """
+        return pulumi.get(self, "state")
+
+    @state.setter
+    def state(self, value: Optional[pulumi.Input[_builtins.str]]):
+        pulumi.set(self, "state", value)
+
+
+@pulumi.type_token("aws:ec2/allowedImagesSettings:AllowedImagesSettings")
+class AllowedImagesSettings(pulumi.CustomResource):
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 image_criterions: Optional[pulumi.Input[Sequence[pulumi.Input[Union['AllowedImagesSettingsImageCriterionArgs', 'AllowedImagesSettingsImageCriterionArgsDict']]]]] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None,
+                 state: Optional[pulumi.Input[_builtins.str]] = None,
+                 __props__=None):
+        """
+        Provides EC2 allowed images settings for an AWS account. This feature allows you to control which AMIs can be used to launch EC2 instances in your account based on specified criteria.
+
+        For more information about the image criteria that can be set, see the [AWS documentation on Allowed AMIs JSON configuration](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-allowed-amis.html#allowed-amis-json-configuration).
+
+        > **NOTE:** The AWS API does not delete this resource. When you run `destroy`, the provider will attempt to disable the setting.
+
+        > **NOTE:** There is only one allowed images settings configuration per AWS account and region. Creating this resource will configure the account-level settings.
+
+        ## Example Usage
+
+        ### Enable with Amazon AMIs only
+
+        ```python
+        import pulumi
+        import pulumi_aws as aws
+
+        example = aws.ec2.AllowedImagesSettings("example",
+            state="enabled",
+            image_criterions=[{
+                "image_providers": ["amazon"],
+            }])
+        ```
+
+        ### Enable audit mode with specific account IDs
+
+        ```python
+        import pulumi
+        import pulumi_aws as aws
+
+        example = aws.ec2.AllowedImagesSettings("example",
+            state="audit-mode",
+            image_criterions=[{
+                "image_providers": [
+                    "amazon",
+                    "123456789012",
+                ],
+            }])
+        ```
+
+        ## Import
+
+        Using `pulumi import`, import EC2 allowed images settings. For example:
+
+        ```sh
+        $ pulumi import aws:ec2/allowedImagesSettings:AllowedImagesSettings example us-east-1
+        ```
+
+        :param str resource_name: The name of the resource.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['AllowedImagesSettingsImageCriterionArgs', 'AllowedImagesSettingsImageCriterionArgsDict']]]] image_criterions: List of image criteria. Maximum of 10 criterion blocks allowed. See `image_criterion` below.
+        :param pulumi.Input[_builtins.str] region: Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
+        :param pulumi.Input[_builtins.str] state: State of the allowed images settings. Valid values are `enabled` or `audit-mode`.
+        """
+        ...
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 args: AllowedImagesSettingsArgs,
+                 opts: Optional[pulumi.ResourceOptions] = None):
+        """
+        Provides EC2 allowed images settings for an AWS account. This feature allows you to control which AMIs can be used to launch EC2 instances in your account based on specified criteria.
+
+        For more information about the image criteria that can be set, see the [AWS documentation on Allowed AMIs JSON configuration](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-allowed-amis.html#allowed-amis-json-configuration).
+
+        > **NOTE:** The AWS API does not delete this resource. When you run `destroy`, the provider will attempt to disable the setting.
+
+        > **NOTE:** There is only one allowed images settings configuration per AWS account and region. Creating this resource will configure the account-level settings.
+
+        ## Example Usage
+
+        ### Enable with Amazon AMIs only
+
+        ```python
+        import pulumi
+        import pulumi_aws as aws
+
+        example = aws.ec2.AllowedImagesSettings("example",
+            state="enabled",
+            image_criterions=[{
+                "image_providers": ["amazon"],
+            }])
+        ```
+
+        ### Enable audit mode with specific account IDs
+
+        ```python
+        import pulumi
+        import pulumi_aws as aws
+
+        example = aws.ec2.AllowedImagesSettings("example",
+            state="audit-mode",
+            image_criterions=[{
+                "image_providers": [
+                    "amazon",
+                    "123456789012",
+                ],
+            }])
+        ```
+
+        ## Import
+
+        Using `pulumi import`, import EC2 allowed images settings. For example:
+
+        ```sh
+        $ pulumi import aws:ec2/allowedImagesSettings:AllowedImagesSettings example us-east-1
+        ```
+
+        :param str resource_name: The name of the resource.
+        :param AllowedImagesSettingsArgs args: The arguments to use to populate this resource's properties.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        """
+        ...
+    def __init__(__self__, resource_name: str, *args, **kwargs):
+        resource_args, opts = _utilities.get_resource_args_opts(AllowedImagesSettingsArgs, pulumi.ResourceOptions, *args, **kwargs)
+        if resource_args is not None:
+            __self__._internal_init(resource_name, opts, **resource_args.__dict__)
+        else:
+            __self__._internal_init(resource_name, *args, **kwargs)
+
+    def _internal_init(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 image_criterions: Optional[pulumi.Input[Sequence[pulumi.Input[Union['AllowedImagesSettingsImageCriterionArgs', 'AllowedImagesSettingsImageCriterionArgsDict']]]]] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None,
+                 state: Optional[pulumi.Input[_builtins.str]] = None,
+                 __props__=None):
+        opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
+        if not isinstance(opts, pulumi.ResourceOptions):
+            raise TypeError('Expected resource options to be a ResourceOptions instance')
+        if opts.id is None:
+            if __props__ is not None:
+                raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
+            __props__ = AllowedImagesSettingsArgs.__new__(AllowedImagesSettingsArgs)
+
+            __props__.__dict__["image_criterions"] = image_criterions
+            __props__.__dict__["region"] = region
+            if state is None and not opts.urn:
+                raise TypeError("Missing required property 'state'")
+            __props__.__dict__["state"] = state
+        super(AllowedImagesSettings, __self__).__init__(
+            'aws:ec2/allowedImagesSettings:AllowedImagesSettings',
+            resource_name,
+            __props__,
+            opts)
+
+    @staticmethod
+    def get(resource_name: str,
+            id: pulumi.Input[str],
+            opts: Optional[pulumi.ResourceOptions] = None,
+            image_criterions: Optional[pulumi.Input[Sequence[pulumi.Input[Union['AllowedImagesSettingsImageCriterionArgs', 'AllowedImagesSettingsImageCriterionArgsDict']]]]] = None,
+            region: Optional[pulumi.Input[_builtins.str]] = None,
+            state: Optional[pulumi.Input[_builtins.str]] = None) -> 'AllowedImagesSettings':
+        """
+        Get an existing AllowedImagesSettings resource's state with the given name, id, and optional extra
+        properties used to qualify the lookup.
+
+        :param str resource_name: The unique name of the resulting resource.
+        :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['AllowedImagesSettingsImageCriterionArgs', 'AllowedImagesSettingsImageCriterionArgsDict']]]] image_criterions: List of image criteria. Maximum of 10 criterion blocks allowed. See `image_criterion` below.
+        :param pulumi.Input[_builtins.str] region: Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
+        :param pulumi.Input[_builtins.str] state: State of the allowed images settings. Valid values are `enabled` or `audit-mode`.
+        """
+        opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
+
+        __props__ = _AllowedImagesSettingsState.__new__(_AllowedImagesSettingsState)
+
+        __props__.__dict__["image_criterions"] = image_criterions
+        __props__.__dict__["region"] = region
+        __props__.__dict__["state"] = state
+        return AllowedImagesSettings(resource_name, opts=opts, __props__=__props__)
+
+    @_builtins.property
+    @pulumi.getter(name="imageCriterions")
+    def image_criterions(self) -> pulumi.Output[Optional[Sequence['outputs.AllowedImagesSettingsImageCriterion']]]:
+        """
+        List of image criteria. Maximum of 10 criterion blocks allowed. See `image_criterion` below.
+        """
+        return pulumi.get(self, "image_criterions")
+
+    @_builtins.property
+    @pulumi.getter
+    def region(self) -> pulumi.Output[_builtins.str]:
+        """
+        Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
+        """
+        return pulumi.get(self, "region")
+
+    @_builtins.property
+    @pulumi.getter
+    def state(self) -> pulumi.Output[_builtins.str]:
+        """
+        State of the allowed images settings. Valid values are `enabled` or `audit-mode`.
+        """
+        return pulumi.get(self, "state")
+

pulumi_aws/ec2/get_coip_pools.py

@@ -97,6 +97,18 @@ def get_coip_pools(filters: Optional[Sequence[Union['GetCoipPoolsFilterArgs', 'G
     """
     Provides information for multiple EC2 Customer-Owned IP Pools, such as their identifiers.
 
+    ## Example Usage
+
+    The following shows outputting all COIP Pool Ids.
+
+    ```python
+    import pulumi
+    import pulumi_aws as aws
+
+    foo = aws.ec2.get_coip_pools()
+    pulumi.export("foo", foo.ids)
+    ```
+
 
     :param Sequence[Union['GetCoipPoolsFilterArgs', 'GetCoipPoolsFilterArgsDict']] filters: Custom filter block as described below.
            
@@ -126,6 +138,18 @@ def get_coip_pools_output(filters: Optional[pulumi.Input[Optional[Sequence[Union
     """
     Provides information for multiple EC2 Customer-Owned IP Pools, such as their identifiers.
 
+    ## Example Usage
+
+    The following shows outputting all COIP Pool Ids.
+
+    ```python
+    import pulumi
+    import pulumi_aws as aws
+
+    foo = aws.ec2.get_coip_pools()
+    pulumi.export("foo", foo.ids)
+    ```
+
 
     :param Sequence[Union['GetCoipPoolsFilterArgs', 'GetCoipPoolsFilterArgsDict']] filters: Custom filter block as described below.