pulumi-aws 7.15.0__py3-none-any.whl → 7.16.0__py3-none-any.whl

pulumi_aws/dynamodb/global_secondary_index.py

@@ -0,0 +1,666 @@
+# 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__ = ['GlobalSecondaryIndexArgs', 'GlobalSecondaryIndex']
+
+@pulumi.input_type
+class GlobalSecondaryIndexArgs:
+    def __init__(__self__, *,
+                 index_name: pulumi.Input[_builtins.str],
+                 table_name: pulumi.Input[_builtins.str],
+                 key_schemas: Optional[pulumi.Input[Sequence[pulumi.Input['GlobalSecondaryIndexKeySchemaArgs']]]] = None,
+                 on_demand_throughput: Optional[pulumi.Input['GlobalSecondaryIndexOnDemandThroughputArgs']] = None,
+                 projection: Optional[pulumi.Input['GlobalSecondaryIndexProjectionArgs']] = None,
+                 provisioned_throughput: Optional[pulumi.Input['GlobalSecondaryIndexProvisionedThroughputArgs']] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None,
+                 timeouts: Optional[pulumi.Input['GlobalSecondaryIndexTimeoutsArgs']] = None,
+                 warm_throughput: Optional[pulumi.Input['GlobalSecondaryIndexWarmThroughputArgs']] = None):
+        """
+        The set of arguments for constructing a GlobalSecondaryIndex resource.
+        :param pulumi.Input[_builtins.str] index_name: Name of the index.
+        :param pulumi.Input[_builtins.str] table_name: Name of the table this index belongs to.
+               
+               The following arguments are optional:
+        :param pulumi.Input[Sequence[pulumi.Input['GlobalSecondaryIndexKeySchemaArgs']]] key_schemas: Set of nested attribute definitions.
+               At least 1 element defining a `HASH` is required.
+               All elements with the `key_type` of `HASH` must precede elements with `key_type` of `RANGE`.
+               Changing any values in `key_schema` will re-create the resource.
+               See `key_schema` below.
+        :param pulumi.Input['GlobalSecondaryIndexOnDemandThroughputArgs'] on_demand_throughput: Sets the maximum number of read and write units for the index.
+               See `on_demand_throughput` below.
+               Only valid if the table's `billing_mode` is `PAY_PER_REQUEST`.
+        :param pulumi.Input['GlobalSecondaryIndexProjectionArgs'] projection: Describes which attributes from the table are represented in the index.
+               See `projection` below.
+        :param pulumi.Input['GlobalSecondaryIndexProvisionedThroughputArgs'] provisioned_throughput: Provisioned throughput for the index.
+               See `provisioned_throughput` below.
+               Required if the table's `billing_mode` is `PROVISIONED`.
+        :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['GlobalSecondaryIndexWarmThroughputArgs'] warm_throughput: Sets the number of warm read and write units for this index.
+               See `warm_throughput` below.
+        """
+        pulumi.set(__self__, "index_name", index_name)
+        pulumi.set(__self__, "table_name", table_name)
+        if key_schemas is not None:
+            pulumi.set(__self__, "key_schemas", key_schemas)
+        if on_demand_throughput is not None:
+            pulumi.set(__self__, "on_demand_throughput", on_demand_throughput)
+        if projection is not None:
+            pulumi.set(__self__, "projection", projection)
+        if provisioned_throughput is not None:
+            pulumi.set(__self__, "provisioned_throughput", provisioned_throughput)
+        if region is not None:
+            pulumi.set(__self__, "region", region)
+        if timeouts is not None:
+            pulumi.set(__self__, "timeouts", timeouts)
+        if warm_throughput is not None:
+            pulumi.set(__self__, "warm_throughput", warm_throughput)
+
+    @_builtins.property
+    @pulumi.getter(name="indexName")
+    def index_name(self) -> pulumi.Input[_builtins.str]:
+        """
+        Name of the index.
+        """
+        return pulumi.get(self, "index_name")
+
+    @index_name.setter
+    def index_name(self, value: pulumi.Input[_builtins.str]):
+        pulumi.set(self, "index_name", value)
+
+    @_builtins.property
+    @pulumi.getter(name="tableName")
+    def table_name(self) -> pulumi.Input[_builtins.str]:
+        """
+        Name of the table this index belongs to.
+
+        The following arguments are optional:
+        """
+        return pulumi.get(self, "table_name")
+
+    @table_name.setter
+    def table_name(self, value: pulumi.Input[_builtins.str]):
+        pulumi.set(self, "table_name", value)
+
+    @_builtins.property
+    @pulumi.getter(name="keySchemas")
+    def key_schemas(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['GlobalSecondaryIndexKeySchemaArgs']]]]:
+        """
+        Set of nested attribute definitions.
+        At least 1 element defining a `HASH` is required.
+        All elements with the `key_type` of `HASH` must precede elements with `key_type` of `RANGE`.
+        Changing any values in `key_schema` will re-create the resource.
+        See `key_schema` below.
+        """
+        return pulumi.get(self, "key_schemas")
+
+    @key_schemas.setter
+    def key_schemas(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['GlobalSecondaryIndexKeySchemaArgs']]]]):
+        pulumi.set(self, "key_schemas", value)
+
+    @_builtins.property
+    @pulumi.getter(name="onDemandThroughput")
+    def on_demand_throughput(self) -> Optional[pulumi.Input['GlobalSecondaryIndexOnDemandThroughputArgs']]:
+        """
+        Sets the maximum number of read and write units for the index.
+        See `on_demand_throughput` below.
+        Only valid if the table's `billing_mode` is `PAY_PER_REQUEST`.
+        """
+        return pulumi.get(self, "on_demand_throughput")
+
+    @on_demand_throughput.setter
+    def on_demand_throughput(self, value: Optional[pulumi.Input['GlobalSecondaryIndexOnDemandThroughputArgs']]):
+        pulumi.set(self, "on_demand_throughput", value)
+
+    @_builtins.property
+    @pulumi.getter
+    def projection(self) -> Optional[pulumi.Input['GlobalSecondaryIndexProjectionArgs']]:
+        """
+        Describes which attributes from the table are represented in the index.
+        See `projection` below.
+        """
+        return pulumi.get(self, "projection")
+
+    @projection.setter
+    def projection(self, value: Optional[pulumi.Input['GlobalSecondaryIndexProjectionArgs']]):
+        pulumi.set(self, "projection", value)
+
+    @_builtins.property
+    @pulumi.getter(name="provisionedThroughput")
+    def provisioned_throughput(self) -> Optional[pulumi.Input['GlobalSecondaryIndexProvisionedThroughputArgs']]:
+        """
+        Provisioned throughput for the index.
+        See `provisioned_throughput` below.
+        Required if the table's `billing_mode` is `PROVISIONED`.
+        """
+        return pulumi.get(self, "provisioned_throughput")
+
+    @provisioned_throughput.setter
+    def provisioned_throughput(self, value: Optional[pulumi.Input['GlobalSecondaryIndexProvisionedThroughputArgs']]):
+        pulumi.set(self, "provisioned_throughput", 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 timeouts(self) -> Optional[pulumi.Input['GlobalSecondaryIndexTimeoutsArgs']]:
+        return pulumi.get(self, "timeouts")
+
+    @timeouts.setter
+    def timeouts(self, value: Optional[pulumi.Input['GlobalSecondaryIndexTimeoutsArgs']]):
+        pulumi.set(self, "timeouts", value)
+
+    @_builtins.property
+    @pulumi.getter(name="warmThroughput")
+    def warm_throughput(self) -> Optional[pulumi.Input['GlobalSecondaryIndexWarmThroughputArgs']]:
+        """
+        Sets the number of warm read and write units for this index.
+        See `warm_throughput` below.
+        """
+        return pulumi.get(self, "warm_throughput")
+
+    @warm_throughput.setter
+    def warm_throughput(self, value: Optional[pulumi.Input['GlobalSecondaryIndexWarmThroughputArgs']]):
+        pulumi.set(self, "warm_throughput", value)
+
+
+@pulumi.input_type
+class _GlobalSecondaryIndexState:
+    def __init__(__self__, *,
+                 arn: Optional[pulumi.Input[_builtins.str]] = None,
+                 index_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 key_schemas: Optional[pulumi.Input[Sequence[pulumi.Input['GlobalSecondaryIndexKeySchemaArgs']]]] = None,
+                 on_demand_throughput: Optional[pulumi.Input['GlobalSecondaryIndexOnDemandThroughputArgs']] = None,
+                 projection: Optional[pulumi.Input['GlobalSecondaryIndexProjectionArgs']] = None,
+                 provisioned_throughput: Optional[pulumi.Input['GlobalSecondaryIndexProvisionedThroughputArgs']] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None,
+                 table_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 timeouts: Optional[pulumi.Input['GlobalSecondaryIndexTimeoutsArgs']] = None,
+                 warm_throughput: Optional[pulumi.Input['GlobalSecondaryIndexWarmThroughputArgs']] = None):
+        """
+        Input properties used for looking up and filtering GlobalSecondaryIndex resources.
+        :param pulumi.Input[_builtins.str] arn: ARN of the GSI.
+        :param pulumi.Input[_builtins.str] index_name: Name of the index.
+        :param pulumi.Input[Sequence[pulumi.Input['GlobalSecondaryIndexKeySchemaArgs']]] key_schemas: Set of nested attribute definitions.
+               At least 1 element defining a `HASH` is required.
+               All elements with the `key_type` of `HASH` must precede elements with `key_type` of `RANGE`.
+               Changing any values in `key_schema` will re-create the resource.
+               See `key_schema` below.
+        :param pulumi.Input['GlobalSecondaryIndexOnDemandThroughputArgs'] on_demand_throughput: Sets the maximum number of read and write units for the index.
+               See `on_demand_throughput` below.
+               Only valid if the table's `billing_mode` is `PAY_PER_REQUEST`.
+        :param pulumi.Input['GlobalSecondaryIndexProjectionArgs'] projection: Describes which attributes from the table are represented in the index.
+               See `projection` below.
+        :param pulumi.Input['GlobalSecondaryIndexProvisionedThroughputArgs'] provisioned_throughput: Provisioned throughput for the index.
+               See `provisioned_throughput` below.
+               Required if the table's `billing_mode` is `PROVISIONED`.
+        :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] table_name: Name of the table this index belongs to.
+               
+               The following arguments are optional:
+        :param pulumi.Input['GlobalSecondaryIndexWarmThroughputArgs'] warm_throughput: Sets the number of warm read and write units for this index.
+               See `warm_throughput` below.
+        """
+        if arn is not None:
+            pulumi.set(__self__, "arn", arn)
+        if index_name is not None:
+            pulumi.set(__self__, "index_name", index_name)
+        if key_schemas is not None:
+            pulumi.set(__self__, "key_schemas", key_schemas)
+        if on_demand_throughput is not None:
+            pulumi.set(__self__, "on_demand_throughput", on_demand_throughput)
+        if projection is not None:
+            pulumi.set(__self__, "projection", projection)
+        if provisioned_throughput is not None:
+            pulumi.set(__self__, "provisioned_throughput", provisioned_throughput)
+        if region is not None:
+            pulumi.set(__self__, "region", region)
+        if table_name is not None:
+            pulumi.set(__self__, "table_name", table_name)
+        if timeouts is not None:
+            pulumi.set(__self__, "timeouts", timeouts)
+        if warm_throughput is not None:
+            pulumi.set(__self__, "warm_throughput", warm_throughput)
+
+    @_builtins.property
+    @pulumi.getter
+    def arn(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        ARN of the GSI.
+        """
+        return pulumi.get(self, "arn")
+
+    @arn.setter
+    def arn(self, value: Optional[pulumi.Input[_builtins.str]]):
+        pulumi.set(self, "arn", value)
+
+    @_builtins.property
+    @pulumi.getter(name="indexName")
+    def index_name(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        Name of the index.
+        """
+        return pulumi.get(self, "index_name")
+
+    @index_name.setter
+    def index_name(self, value: Optional[pulumi.Input[_builtins.str]]):
+        pulumi.set(self, "index_name", value)
+
+    @_builtins.property
+    @pulumi.getter(name="keySchemas")
+    def key_schemas(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['GlobalSecondaryIndexKeySchemaArgs']]]]:
+        """
+        Set of nested attribute definitions.
+        At least 1 element defining a `HASH` is required.
+        All elements with the `key_type` of `HASH` must precede elements with `key_type` of `RANGE`.
+        Changing any values in `key_schema` will re-create the resource.
+        See `key_schema` below.
+        """
+        return pulumi.get(self, "key_schemas")
+
+    @key_schemas.setter
+    def key_schemas(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['GlobalSecondaryIndexKeySchemaArgs']]]]):
+        pulumi.set(self, "key_schemas", value)
+
+    @_builtins.property
+    @pulumi.getter(name="onDemandThroughput")
+    def on_demand_throughput(self) -> Optional[pulumi.Input['GlobalSecondaryIndexOnDemandThroughputArgs']]:
+        """
+        Sets the maximum number of read and write units for the index.
+        See `on_demand_throughput` below.
+        Only valid if the table's `billing_mode` is `PAY_PER_REQUEST`.
+        """
+        return pulumi.get(self, "on_demand_throughput")
+
+    @on_demand_throughput.setter
+    def on_demand_throughput(self, value: Optional[pulumi.Input['GlobalSecondaryIndexOnDemandThroughputArgs']]):
+        pulumi.set(self, "on_demand_throughput", value)
+
+    @_builtins.property
+    @pulumi.getter
+    def projection(self) -> Optional[pulumi.Input['GlobalSecondaryIndexProjectionArgs']]:
+        """
+        Describes which attributes from the table are represented in the index.
+        See `projection` below.
+        """
+        return pulumi.get(self, "projection")
+
+    @projection.setter
+    def projection(self, value: Optional[pulumi.Input['GlobalSecondaryIndexProjectionArgs']]):
+        pulumi.set(self, "projection", value)
+
+    @_builtins.property
+    @pulumi.getter(name="provisionedThroughput")
+    def provisioned_throughput(self) -> Optional[pulumi.Input['GlobalSecondaryIndexProvisionedThroughputArgs']]:
+        """
+        Provisioned throughput for the index.
+        See `provisioned_throughput` below.
+        Required if the table's `billing_mode` is `PROVISIONED`.
+        """
+        return pulumi.get(self, "provisioned_throughput")
+
+    @provisioned_throughput.setter
+    def provisioned_throughput(self, value: Optional[pulumi.Input['GlobalSecondaryIndexProvisionedThroughputArgs']]):
+        pulumi.set(self, "provisioned_throughput", 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(name="tableName")
+    def table_name(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        Name of the table this index belongs to.
+
+        The following arguments are optional:
+        """
+        return pulumi.get(self, "table_name")
+
+    @table_name.setter
+    def table_name(self, value: Optional[pulumi.Input[_builtins.str]]):
+        pulumi.set(self, "table_name", value)
+
+    @_builtins.property
+    @pulumi.getter
+    def timeouts(self) -> Optional[pulumi.Input['GlobalSecondaryIndexTimeoutsArgs']]:
+        return pulumi.get(self, "timeouts")
+
+    @timeouts.setter
+    def timeouts(self, value: Optional[pulumi.Input['GlobalSecondaryIndexTimeoutsArgs']]):
+        pulumi.set(self, "timeouts", value)
+
+    @_builtins.property
+    @pulumi.getter(name="warmThroughput")
+    def warm_throughput(self) -> Optional[pulumi.Input['GlobalSecondaryIndexWarmThroughputArgs']]:
+        """
+        Sets the number of warm read and write units for this index.
+        See `warm_throughput` below.
+        """
+        return pulumi.get(self, "warm_throughput")
+
+    @warm_throughput.setter
+    def warm_throughput(self, value: Optional[pulumi.Input['GlobalSecondaryIndexWarmThroughputArgs']]):
+        pulumi.set(self, "warm_throughput", value)
+
+
+@pulumi.type_token("aws:dynamodb/globalSecondaryIndex:GlobalSecondaryIndex")
+class GlobalSecondaryIndex(pulumi.CustomResource):
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 index_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 key_schemas: Optional[pulumi.Input[Sequence[pulumi.Input[Union['GlobalSecondaryIndexKeySchemaArgs', 'GlobalSecondaryIndexKeySchemaArgsDict']]]]] = None,
+                 on_demand_throughput: Optional[pulumi.Input[Union['GlobalSecondaryIndexOnDemandThroughputArgs', 'GlobalSecondaryIndexOnDemandThroughputArgsDict']]] = None,
+                 projection: Optional[pulumi.Input[Union['GlobalSecondaryIndexProjectionArgs', 'GlobalSecondaryIndexProjectionArgsDict']]] = None,
+                 provisioned_throughput: Optional[pulumi.Input[Union['GlobalSecondaryIndexProvisionedThroughputArgs', 'GlobalSecondaryIndexProvisionedThroughputArgsDict']]] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None,
+                 table_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 timeouts: Optional[pulumi.Input[Union['GlobalSecondaryIndexTimeoutsArgs', 'GlobalSecondaryIndexTimeoutsArgsDict']]] = None,
+                 warm_throughput: Optional[pulumi.Input[Union['GlobalSecondaryIndexWarmThroughputArgs', 'GlobalSecondaryIndexWarmThroughputArgsDict']]] = None,
+                 __props__=None):
+        """
+        ## Import
+
+        ### Identity Schema
+
+        #### Required
+
+        * `index_name` (String) Name of the index.
+
+        * `table_name` (String) Name of the table this index belongs to.
+
+        #### Optional
+
+        * `account_id` (String) AWS Account where this resource is managed.
+
+        * `region` (String) Region where this resource is managed.
+
+        Using `pulumi import`, import DynamoDB tables using the `table_name` and `index_name`, separated by a comma. For example:
+
+        % pulumi import aws_dynamodb_global_secondary_index.example 'example-table,example-index'
+
+        :param str resource_name: The name of the resource.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[_builtins.str] index_name: Name of the index.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['GlobalSecondaryIndexKeySchemaArgs', 'GlobalSecondaryIndexKeySchemaArgsDict']]]] key_schemas: Set of nested attribute definitions.
+               At least 1 element defining a `HASH` is required.
+               All elements with the `key_type` of `HASH` must precede elements with `key_type` of `RANGE`.
+               Changing any values in `key_schema` will re-create the resource.
+               See `key_schema` below.
+        :param pulumi.Input[Union['GlobalSecondaryIndexOnDemandThroughputArgs', 'GlobalSecondaryIndexOnDemandThroughputArgsDict']] on_demand_throughput: Sets the maximum number of read and write units for the index.
+               See `on_demand_throughput` below.
+               Only valid if the table's `billing_mode` is `PAY_PER_REQUEST`.
+        :param pulumi.Input[Union['GlobalSecondaryIndexProjectionArgs', 'GlobalSecondaryIndexProjectionArgsDict']] projection: Describes which attributes from the table are represented in the index.
+               See `projection` below.
+        :param pulumi.Input[Union['GlobalSecondaryIndexProvisionedThroughputArgs', 'GlobalSecondaryIndexProvisionedThroughputArgsDict']] provisioned_throughput: Provisioned throughput for the index.
+               See `provisioned_throughput` below.
+               Required if the table's `billing_mode` is `PROVISIONED`.
+        :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] table_name: Name of the table this index belongs to.
+               
+               The following arguments are optional:
+        :param pulumi.Input[Union['GlobalSecondaryIndexWarmThroughputArgs', 'GlobalSecondaryIndexWarmThroughputArgsDict']] warm_throughput: Sets the number of warm read and write units for this index.
+               See `warm_throughput` below.
+        """
+        ...
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 args: GlobalSecondaryIndexArgs,
+                 opts: Optional[pulumi.ResourceOptions] = None):
+        """
+        ## Import
+
+        ### Identity Schema
+
+        #### Required
+
+        * `index_name` (String) Name of the index.
+
+        * `table_name` (String) Name of the table this index belongs to.
+
+        #### Optional
+
+        * `account_id` (String) AWS Account where this resource is managed.
+
+        * `region` (String) Region where this resource is managed.
+
+        Using `pulumi import`, import DynamoDB tables using the `table_name` and `index_name`, separated by a comma. For example:
+
+        % pulumi import aws_dynamodb_global_secondary_index.example 'example-table,example-index'
+
+        :param str resource_name: The name of the resource.
+        :param GlobalSecondaryIndexArgs 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(GlobalSecondaryIndexArgs, 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,
+                 index_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 key_schemas: Optional[pulumi.Input[Sequence[pulumi.Input[Union['GlobalSecondaryIndexKeySchemaArgs', 'GlobalSecondaryIndexKeySchemaArgsDict']]]]] = None,
+                 on_demand_throughput: Optional[pulumi.Input[Union['GlobalSecondaryIndexOnDemandThroughputArgs', 'GlobalSecondaryIndexOnDemandThroughputArgsDict']]] = None,
+                 projection: Optional[pulumi.Input[Union['GlobalSecondaryIndexProjectionArgs', 'GlobalSecondaryIndexProjectionArgsDict']]] = None,
+                 provisioned_throughput: Optional[pulumi.Input[Union['GlobalSecondaryIndexProvisionedThroughputArgs', 'GlobalSecondaryIndexProvisionedThroughputArgsDict']]] = None,
+                 region: Optional[pulumi.Input[_builtins.str]] = None,
+                 table_name: Optional[pulumi.Input[_builtins.str]] = None,
+                 timeouts: Optional[pulumi.Input[Union['GlobalSecondaryIndexTimeoutsArgs', 'GlobalSecondaryIndexTimeoutsArgsDict']]] = None,
+                 warm_throughput: Optional[pulumi.Input[Union['GlobalSecondaryIndexWarmThroughputArgs', 'GlobalSecondaryIndexWarmThroughputArgsDict']]] = 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__ = GlobalSecondaryIndexArgs.__new__(GlobalSecondaryIndexArgs)
+
+            if index_name is None and not opts.urn:
+                raise TypeError("Missing required property 'index_name'")
+            __props__.__dict__["index_name"] = index_name
+            __props__.__dict__["key_schemas"] = key_schemas
+            __props__.__dict__["on_demand_throughput"] = on_demand_throughput
+            __props__.__dict__["projection"] = projection
+            __props__.__dict__["provisioned_throughput"] = provisioned_throughput
+            __props__.__dict__["region"] = region
+            if table_name is None and not opts.urn:
+                raise TypeError("Missing required property 'table_name'")
+            __props__.__dict__["table_name"] = table_name
+            __props__.__dict__["timeouts"] = timeouts
+            __props__.__dict__["warm_throughput"] = warm_throughput
+            __props__.__dict__["arn"] = None
+        super(GlobalSecondaryIndex, __self__).__init__(
+            'aws:dynamodb/globalSecondaryIndex:GlobalSecondaryIndex',
+            resource_name,
+            __props__,
+            opts)
+
+    @staticmethod
+    def get(resource_name: str,
+            id: pulumi.Input[str],
+            opts: Optional[pulumi.ResourceOptions] = None,
+            arn: Optional[pulumi.Input[_builtins.str]] = None,
+            index_name: Optional[pulumi.Input[_builtins.str]] = None,
+            key_schemas: Optional[pulumi.Input[Sequence[pulumi.Input[Union['GlobalSecondaryIndexKeySchemaArgs', 'GlobalSecondaryIndexKeySchemaArgsDict']]]]] = None,
+            on_demand_throughput: Optional[pulumi.Input[Union['GlobalSecondaryIndexOnDemandThroughputArgs', 'GlobalSecondaryIndexOnDemandThroughputArgsDict']]] = None,
+            projection: Optional[pulumi.Input[Union['GlobalSecondaryIndexProjectionArgs', 'GlobalSecondaryIndexProjectionArgsDict']]] = None,
+            provisioned_throughput: Optional[pulumi.Input[Union['GlobalSecondaryIndexProvisionedThroughputArgs', 'GlobalSecondaryIndexProvisionedThroughputArgsDict']]] = None,
+            region: Optional[pulumi.Input[_builtins.str]] = None,
+            table_name: Optional[pulumi.Input[_builtins.str]] = None,
+            timeouts: Optional[pulumi.Input[Union['GlobalSecondaryIndexTimeoutsArgs', 'GlobalSecondaryIndexTimeoutsArgsDict']]] = None,
+            warm_throughput: Optional[pulumi.Input[Union['GlobalSecondaryIndexWarmThroughputArgs', 'GlobalSecondaryIndexWarmThroughputArgsDict']]] = None) -> 'GlobalSecondaryIndex':
+        """
+        Get an existing GlobalSecondaryIndex 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[_builtins.str] arn: ARN of the GSI.
+        :param pulumi.Input[_builtins.str] index_name: Name of the index.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['GlobalSecondaryIndexKeySchemaArgs', 'GlobalSecondaryIndexKeySchemaArgsDict']]]] key_schemas: Set of nested attribute definitions.
+               At least 1 element defining a `HASH` is required.
+               All elements with the `key_type` of `HASH` must precede elements with `key_type` of `RANGE`.
+               Changing any values in `key_schema` will re-create the resource.
+               See `key_schema` below.
+        :param pulumi.Input[Union['GlobalSecondaryIndexOnDemandThroughputArgs', 'GlobalSecondaryIndexOnDemandThroughputArgsDict']] on_demand_throughput: Sets the maximum number of read and write units for the index.
+               See `on_demand_throughput` below.
+               Only valid if the table's `billing_mode` is `PAY_PER_REQUEST`.
+        :param pulumi.Input[Union['GlobalSecondaryIndexProjectionArgs', 'GlobalSecondaryIndexProjectionArgsDict']] projection: Describes which attributes from the table are represented in the index.
+               See `projection` below.
+        :param pulumi.Input[Union['GlobalSecondaryIndexProvisionedThroughputArgs', 'GlobalSecondaryIndexProvisionedThroughputArgsDict']] provisioned_throughput: Provisioned throughput for the index.
+               See `provisioned_throughput` below.
+               Required if the table's `billing_mode` is `PROVISIONED`.
+        :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] table_name: Name of the table this index belongs to.
+               
+               The following arguments are optional:
+        :param pulumi.Input[Union['GlobalSecondaryIndexWarmThroughputArgs', 'GlobalSecondaryIndexWarmThroughputArgsDict']] warm_throughput: Sets the number of warm read and write units for this index.
+               See `warm_throughput` below.
+        """
+        opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
+
+        __props__ = _GlobalSecondaryIndexState.__new__(_GlobalSecondaryIndexState)
+
+        __props__.__dict__["arn"] = arn
+        __props__.__dict__["index_name"] = index_name
+        __props__.__dict__["key_schemas"] = key_schemas
+        __props__.__dict__["on_demand_throughput"] = on_demand_throughput
+        __props__.__dict__["projection"] = projection
+        __props__.__dict__["provisioned_throughput"] = provisioned_throughput
+        __props__.__dict__["region"] = region
+        __props__.__dict__["table_name"] = table_name
+        __props__.__dict__["timeouts"] = timeouts
+        __props__.__dict__["warm_throughput"] = warm_throughput
+        return GlobalSecondaryIndex(resource_name, opts=opts, __props__=__props__)
+
+    @_builtins.property
+    @pulumi.getter
+    def arn(self) -> pulumi.Output[_builtins.str]:
+        """
+        ARN of the GSI.
+        """
+        return pulumi.get(self, "arn")
+
+    @_builtins.property
+    @pulumi.getter(name="indexName")
+    def index_name(self) -> pulumi.Output[_builtins.str]:
+        """
+        Name of the index.
+        """
+        return pulumi.get(self, "index_name")
+
+    @_builtins.property
+    @pulumi.getter(name="keySchemas")
+    def key_schemas(self) -> pulumi.Output[Optional[Sequence['outputs.GlobalSecondaryIndexKeySchema']]]:
+        """
+        Set of nested attribute definitions.
+        At least 1 element defining a `HASH` is required.
+        All elements with the `key_type` of `HASH` must precede elements with `key_type` of `RANGE`.
+        Changing any values in `key_schema` will re-create the resource.
+        See `key_schema` below.
+        """
+        return pulumi.get(self, "key_schemas")
+
+    @_builtins.property
+    @pulumi.getter(name="onDemandThroughput")
+    def on_demand_throughput(self) -> pulumi.Output[Optional['outputs.GlobalSecondaryIndexOnDemandThroughput']]:
+        """
+        Sets the maximum number of read and write units for the index.
+        See `on_demand_throughput` below.
+        Only valid if the table's `billing_mode` is `PAY_PER_REQUEST`.
+        """
+        return pulumi.get(self, "on_demand_throughput")
+
+    @_builtins.property
+    @pulumi.getter
+    def projection(self) -> pulumi.Output[Optional['outputs.GlobalSecondaryIndexProjection']]:
+        """
+        Describes which attributes from the table are represented in the index.
+        See `projection` below.
+        """
+        return pulumi.get(self, "projection")
+
+    @_builtins.property
+    @pulumi.getter(name="provisionedThroughput")
+    def provisioned_throughput(self) -> pulumi.Output[Optional['outputs.GlobalSecondaryIndexProvisionedThroughput']]:
+        """
+        Provisioned throughput for the index.
+        See `provisioned_throughput` below.
+        Required if the table's `billing_mode` is `PROVISIONED`.
+        """
+        return pulumi.get(self, "provisioned_throughput")
+
+    @_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(name="tableName")
+    def table_name(self) -> pulumi.Output[_builtins.str]:
+        """
+        Name of the table this index belongs to.
+
+        The following arguments are optional:
+        """
+        return pulumi.get(self, "table_name")
+
+    @_builtins.property
+    @pulumi.getter
+    def timeouts(self) -> pulumi.Output[Optional['outputs.GlobalSecondaryIndexTimeouts']]:
+        return pulumi.get(self, "timeouts")
+
+    @_builtins.property
+    @pulumi.getter(name="warmThroughput")
+    def warm_throughput(self) -> pulumi.Output['outputs.GlobalSecondaryIndexWarmThroughput']:
+        """
+        Sets the number of warm read and write units for this index.
+        See `warm_throughput` below.
+        """
+        return pulumi.get(self, "warm_throughput")
+