pulumi-snowflake 0.50.3a1710160126__py3-none-any.whl → 1.2.0a1736835738__py3-none-any.whl

pulumi_snowflake/stage.py

@@ -4,9 +4,14 @@
 
 import copy
 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 *
@@ -32,15 +37,17 @@ class StageArgs:
                  url: Optional[pulumi.Input[str]] = None):
         """
         The set of arguments for constructing a Stage resource.
-        :param pulumi.Input[str] database: Name of the database that the tag was created in.
-        :param pulumi.Input[str] schema: Name of the schema that the tag was created in.
+        :param pulumi.Input[str] database: The database in which to create the stage.
+        :param pulumi.Input[str] schema: The schema in which to create the stage.
+        :param pulumi.Input[str] aws_external_id: A unique ID assigned to the specific stage. The ID has the following format: <snowflakeAccount>*SFCRole=<snowflakeRoleId>*<randomId>
         :param pulumi.Input[str] comment: Specifies a comment for the stage.
         :param pulumi.Input[str] copy_options: Specifies the copy options for the stage.
         :param pulumi.Input[str] credentials: Specifies the credentials for the stage.
         :param pulumi.Input[str] directory: Specifies the directory settings for the stage.
         :param pulumi.Input[str] encryption: Specifies the encryption settings for the stage.
-        :param pulumi.Input[str] file_format: Specifies the file format for the stage.
-        :param pulumi.Input[str] name: Tag name, e.g. department.
+        :param pulumi.Input[str] file_format: Specifies the file format for the stage. Specifying the default Snowflake value (e.g. TYPE = CSV) will currently result in a permadiff (check #2679). For now, omit the default values; it will be fixed in the upcoming provider versions.
+        :param pulumi.Input[str] name: Specifies the identifier for the stage; must be unique for the database and schema in which the stage is created.
+        :param pulumi.Input[str] snowflake_iam_user: An AWS IAM user created for your Snowflake account. This user is the same for every external S3 stage created in your account.
         :param pulumi.Input[str] storage_integration: Specifies the name of the storage integration used to delegate authentication responsibility for external cloud storage to a Snowflake identity and access management (IAM) entity.
         :param pulumi.Input[Sequence[pulumi.Input['StageTagArgs']]] tags: Definitions of a tag to associate with the resource.
         :param pulumi.Input[str] url: Specifies the URL for the stage.
@@ -79,7 +86,7 @@ class StageArgs:
     @pulumi.getter
     def database(self) -> pulumi.Input[str]:
         """
-        Name of the database that the tag was created in.
+        The database in which to create the stage.
         """
         return pulumi.get(self, "database")
 
@@ -91,7 +98,7 @@ class StageArgs:
     @pulumi.getter
     def schema(self) -> pulumi.Input[str]:
         """
-        Name of the schema that the tag was created in.
+        The schema in which to create the stage.
         """
         return pulumi.get(self, "schema")
 
@@ -102,6 +109,9 @@ class StageArgs:
     @property
     @pulumi.getter(name="awsExternalId")
     def aws_external_id(self) -> Optional[pulumi.Input[str]]:
+        """
+        A unique ID assigned to the specific stage. The ID has the following format: <snowflakeAccount>*SFCRole=<snowflakeRoleId>*<randomId>
+        """
         return pulumi.get(self, "aws_external_id")
 
     @aws_external_id.setter
@@ -172,7 +182,7 @@ class StageArgs:
     @pulumi.getter(name="fileFormat")
     def file_format(self) -> Optional[pulumi.Input[str]]:
         """
-        Specifies the file format for the stage.
+        Specifies the file format for the stage. Specifying the default Snowflake value (e.g. TYPE = CSV) will currently result in a permadiff (check #2679). For now, omit the default values; it will be fixed in the upcoming provider versions.
         """
         return pulumi.get(self, "file_format")
 
@@ -184,7 +194,7 @@ class StageArgs:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        Tag name, e.g. department.
+        Specifies the identifier for the stage; must be unique for the database and schema in which the stage is created.
         """
         return pulumi.get(self, "name")
 
@@ -195,6 +205,9 @@ class StageArgs:
     @property
     @pulumi.getter(name="snowflakeIamUser")
     def snowflake_iam_user(self) -> Optional[pulumi.Input[str]]:
+        """
+        An AWS IAM user created for your Snowflake account. This user is the same for every external S3 stage created in your account.
+        """
         return pulumi.get(self, "snowflake_iam_user")
 
     @snowflake_iam_user.setter
@@ -215,13 +228,11 @@ class StageArgs:
 
     @property
     @pulumi.getter
+    @_utilities.deprecated("""Use the 'snowflake_tag_association' resource instead.""")
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['StageTagArgs']]]]:
         """
         Definitions of a tag to associate with the resource.
         """
-        warnings.warn("""Use the 'snowflake_tag_association' resource instead.""", DeprecationWarning)
-        pulumi.log.warn("""tags is deprecated: Use the 'snowflake_tag_association' resource instead.""")
-
         return pulumi.get(self, "tags")
 
     @tags.setter
@@ -252,6 +263,7 @@ class _StageState:
                  directory: Optional[pulumi.Input[str]] = None,
                  encryption: Optional[pulumi.Input[str]] = None,
                  file_format: Optional[pulumi.Input[str]] = None,
+                 fully_qualified_name: Optional[pulumi.Input[str]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  schema: Optional[pulumi.Input[str]] = None,
                  snowflake_iam_user: Optional[pulumi.Input[str]] = None,
@@ -260,15 +272,18 @@ class _StageState:
                  url: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering Stage resources.
+        :param pulumi.Input[str] aws_external_id: A unique ID assigned to the specific stage. The ID has the following format: <snowflakeAccount>*SFCRole=<snowflakeRoleId>*<randomId>
         :param pulumi.Input[str] comment: Specifies a comment for the stage.
         :param pulumi.Input[str] copy_options: Specifies the copy options for the stage.
         :param pulumi.Input[str] credentials: Specifies the credentials for the stage.
-        :param pulumi.Input[str] database: Name of the database that the tag was created in.
+        :param pulumi.Input[str] database: The database in which to create the stage.
         :param pulumi.Input[str] directory: Specifies the directory settings for the stage.
         :param pulumi.Input[str] encryption: Specifies the encryption settings for the stage.
-        :param pulumi.Input[str] file_format: Specifies the file format for the stage.
-        :param pulumi.Input[str] name: Tag name, e.g. department.
-        :param pulumi.Input[str] schema: Name of the schema that the tag was created in.
+        :param pulumi.Input[str] file_format: Specifies the file format for the stage. Specifying the default Snowflake value (e.g. TYPE = CSV) will currently result in a permadiff (check #2679). For now, omit the default values; it will be fixed in the upcoming provider versions.
+        :param pulumi.Input[str] fully_qualified_name: Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
+        :param pulumi.Input[str] name: Specifies the identifier for the stage; must be unique for the database and schema in which the stage is created.
+        :param pulumi.Input[str] schema: The schema in which to create the stage.
+        :param pulumi.Input[str] snowflake_iam_user: An AWS IAM user created for your Snowflake account. This user is the same for every external S3 stage created in your account.
         :param pulumi.Input[str] storage_integration: Specifies the name of the storage integration used to delegate authentication responsibility for external cloud storage to a Snowflake identity and access management (IAM) entity.
         :param pulumi.Input[Sequence[pulumi.Input['StageTagArgs']]] tags: Definitions of a tag to associate with the resource.
         :param pulumi.Input[str] url: Specifies the URL for the stage.
@@ -289,6 +304,8 @@ class _StageState:
             pulumi.set(__self__, "encryption", encryption)
         if file_format is not None:
             pulumi.set(__self__, "file_format", file_format)
+        if fully_qualified_name is not None:
+            pulumi.set(__self__, "fully_qualified_name", fully_qualified_name)
         if name is not None:
             pulumi.set(__self__, "name", name)
         if schema is not None:
@@ -308,6 +325,9 @@ class _StageState:
     @property
     @pulumi.getter(name="awsExternalId")
     def aws_external_id(self) -> Optional[pulumi.Input[str]]:
+        """
+        A unique ID assigned to the specific stage. The ID has the following format: <snowflakeAccount>*SFCRole=<snowflakeRoleId>*<randomId>
+        """
         return pulumi.get(self, "aws_external_id")
 
     @aws_external_id.setter
@@ -354,7 +374,7 @@ class _StageState:
     @pulumi.getter
     def database(self) -> Optional[pulumi.Input[str]]:
         """
-        Name of the database that the tag was created in.
+        The database in which to create the stage.
         """
         return pulumi.get(self, "database")
 
@@ -390,7 +410,7 @@ class _StageState:
     @pulumi.getter(name="fileFormat")
     def file_format(self) -> Optional[pulumi.Input[str]]:
         """
-        Specifies the file format for the stage.
+        Specifies the file format for the stage. Specifying the default Snowflake value (e.g. TYPE = CSV) will currently result in a permadiff (check #2679). For now, omit the default values; it will be fixed in the upcoming provider versions.
         """
         return pulumi.get(self, "file_format")
 
@@ -398,11 +418,23 @@ class _StageState:
     def file_format(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "file_format", value)
 
+    @property
+    @pulumi.getter(name="fullyQualifiedName")
+    def fully_qualified_name(self) -> Optional[pulumi.Input[str]]:
+        """
+        Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
+        """
+        return pulumi.get(self, "fully_qualified_name")
+
+    @fully_qualified_name.setter
+    def fully_qualified_name(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "fully_qualified_name", value)
+
     @property
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        Tag name, e.g. department.
+        Specifies the identifier for the stage; must be unique for the database and schema in which the stage is created.
         """
         return pulumi.get(self, "name")
 
@@ -414,7 +446,7 @@ class _StageState:
     @pulumi.getter
     def schema(self) -> Optional[pulumi.Input[str]]:
         """
-        Name of the schema that the tag was created in.
+        The schema in which to create the stage.
         """
         return pulumi.get(self, "schema")
 
@@ -425,6 +457,9 @@ class _StageState:
     @property
     @pulumi.getter(name="snowflakeIamUser")
     def snowflake_iam_user(self) -> Optional[pulumi.Input[str]]:
+        """
+        An AWS IAM user created for your Snowflake account. This user is the same for every external S3 stage created in your account.
+        """
         return pulumi.get(self, "snowflake_iam_user")
 
     @snowflake_iam_user.setter
@@ -445,13 +480,11 @@ class _StageState:
 
     @property
     @pulumi.getter
+    @_utilities.deprecated("""Use the 'snowflake_tag_association' resource instead.""")
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['StageTagArgs']]]]:
         """
         Definitions of a tag to associate with the resource.
         """
-        warnings.warn("""Use the 'snowflake_tag_association' resource instead.""", DeprecationWarning)
-        pulumi.log.warn("""tags is deprecated: Use the 'snowflake_tag_association' resource instead.""")
-
         return pulumi.get(self, "tags")
 
     @tags.setter
@@ -488,31 +521,10 @@ class Stage(pulumi.CustomResource):
                  schema: Optional[pulumi.Input[str]] = None,
                  snowflake_iam_user: Optional[pulumi.Input[str]] = None,
                  storage_integration: Optional[pulumi.Input[str]] = None,
-                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['StageTagArgs']]]]] = None,
+                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[Union['StageTagArgs', 'StageTagArgsDict']]]]] = None,
                  url: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        ## Example Usage
-
-        <!--Start PulumiCodeChooser -->
-        ```python
-        import pulumi
-        import pulumi_snowflake as snowflake
-
-        example_stage = snowflake.Stage("exampleStage",
-            url="s3://com.example.bucket/prefix",
-            database="EXAMPLE_DB",
-            schema="EXAMPLE_SCHEMA",
-            credentials=f"AWS_KEY_ID='{var['example_aws_key_id']}' AWS_SECRET_KEY='{var['example_aws_secret_key']}'")
-        grant_example_stage = snowflake.StageGrant("grantExampleStage",
-            database_name=example_stage.database,
-            schema_name=example_stage.schema,
-            roles=["LOADER"],
-            privilege="OWNERSHIP",
-            stage_name=example_stage.name)
-        ```
-        <!--End PulumiCodeChooser -->
-
         ## Import
 
         format is database name | schema name | stage name
@@ -523,17 +535,19 @@ class Stage(pulumi.CustomResource):
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[str] aws_external_id: A unique ID assigned to the specific stage. The ID has the following format: &lt;snowflakeAccount&gt;*SFCRole=&lt;snowflakeRoleId&gt;*&lt;randomId&gt;
         :param pulumi.Input[str] comment: Specifies a comment for the stage.
         :param pulumi.Input[str] copy_options: Specifies the copy options for the stage.
         :param pulumi.Input[str] credentials: Specifies the credentials for the stage.
-        :param pulumi.Input[str] database: Name of the database that the tag was created in.
+        :param pulumi.Input[str] database: The database in which to create the stage.
         :param pulumi.Input[str] directory: Specifies the directory settings for the stage.
         :param pulumi.Input[str] encryption: Specifies the encryption settings for the stage.
-        :param pulumi.Input[str] file_format: Specifies the file format for the stage.
-        :param pulumi.Input[str] name: Tag name, e.g. department.
-        :param pulumi.Input[str] schema: Name of the schema that the tag was created in.
+        :param pulumi.Input[str] file_format: Specifies the file format for the stage. Specifying the default Snowflake value (e.g. TYPE = CSV) will currently result in a permadiff (check #2679). For now, omit the default values; it will be fixed in the upcoming provider versions.
+        :param pulumi.Input[str] name: Specifies the identifier for the stage; must be unique for the database and schema in which the stage is created.
+        :param pulumi.Input[str] schema: The schema in which to create the stage.
+        :param pulumi.Input[str] snowflake_iam_user: An AWS IAM user created for your Snowflake account. This user is the same for every external S3 stage created in your account.
         :param pulumi.Input[str] storage_integration: Specifies the name of the storage integration used to delegate authentication responsibility for external cloud storage to a Snowflake identity and access management (IAM) entity.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['StageTagArgs']]]] tags: Definitions of a tag to associate with the resource.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['StageTagArgs', 'StageTagArgsDict']]]] tags: Definitions of a tag to associate with the resource.
         :param pulumi.Input[str] url: Specifies the URL for the stage.
         """
         ...
@@ -543,27 +557,6 @@ class Stage(pulumi.CustomResource):
                  args: StageArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        ## Example Usage
-
-        <!--Start PulumiCodeChooser -->
-        ```python
-        import pulumi
-        import pulumi_snowflake as snowflake
-
-        example_stage = snowflake.Stage("exampleStage",
-            url="s3://com.example.bucket/prefix",
-            database="EXAMPLE_DB",
-            schema="EXAMPLE_SCHEMA",
-            credentials=f"AWS_KEY_ID='{var['example_aws_key_id']}' AWS_SECRET_KEY='{var['example_aws_secret_key']}'")
-        grant_example_stage = snowflake.StageGrant("grantExampleStage",
-            database_name=example_stage.database,
-            schema_name=example_stage.schema,
-            roles=["LOADER"],
-            privilege="OWNERSHIP",
-            stage_name=example_stage.name)
-        ```
-        <!--End PulumiCodeChooser -->
-
         ## Import
 
         format is database name | schema name | stage name
@@ -599,7 +592,7 @@ class Stage(pulumi.CustomResource):
                  schema: Optional[pulumi.Input[str]] = None,
                  snowflake_iam_user: Optional[pulumi.Input[str]] = None,
                  storage_integration: Optional[pulumi.Input[str]] = None,
-                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['StageTagArgs']]]]] = None,
+                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[Union['StageTagArgs', 'StageTagArgsDict']]]]] = None,
                  url: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
@@ -628,6 +621,7 @@ class Stage(pulumi.CustomResource):
             __props__.__dict__["storage_integration"] = storage_integration
             __props__.__dict__["tags"] = tags
             __props__.__dict__["url"] = url
+            __props__.__dict__["fully_qualified_name"] = None
         secret_opts = pulumi.ResourceOptions(additional_secret_outputs=["credentials"])
         opts = pulumi.ResourceOptions.merge(opts, secret_opts)
         super(Stage, __self__).__init__(
@@ -648,11 +642,12 @@ class Stage(pulumi.CustomResource):
             directory: Optional[pulumi.Input[str]] = None,
             encryption: Optional[pulumi.Input[str]] = None,
             file_format: Optional[pulumi.Input[str]] = None,
+            fully_qualified_name: Optional[pulumi.Input[str]] = None,
             name: Optional[pulumi.Input[str]] = None,
             schema: Optional[pulumi.Input[str]] = None,
             snowflake_iam_user: Optional[pulumi.Input[str]] = None,
             storage_integration: Optional[pulumi.Input[str]] = None,
-            tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['StageTagArgs']]]]] = None,
+            tags: Optional[pulumi.Input[Sequence[pulumi.Input[Union['StageTagArgs', 'StageTagArgsDict']]]]] = None,
             url: Optional[pulumi.Input[str]] = None) -> 'Stage':
         """
         Get an existing Stage resource's state with the given name, id, and optional extra
@@ -661,17 +656,20 @@ class Stage(pulumi.CustomResource):
         :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[str] aws_external_id: A unique ID assigned to the specific stage. The ID has the following format: &lt;snowflakeAccount&gt;*SFCRole=&lt;snowflakeRoleId&gt;*&lt;randomId&gt;
         :param pulumi.Input[str] comment: Specifies a comment for the stage.
         :param pulumi.Input[str] copy_options: Specifies the copy options for the stage.
         :param pulumi.Input[str] credentials: Specifies the credentials for the stage.
-        :param pulumi.Input[str] database: Name of the database that the tag was created in.
+        :param pulumi.Input[str] database: The database in which to create the stage.
         :param pulumi.Input[str] directory: Specifies the directory settings for the stage.
         :param pulumi.Input[str] encryption: Specifies the encryption settings for the stage.
-        :param pulumi.Input[str] file_format: Specifies the file format for the stage.
-        :param pulumi.Input[str] name: Tag name, e.g. department.
-        :param pulumi.Input[str] schema: Name of the schema that the tag was created in.
+        :param pulumi.Input[str] file_format: Specifies the file format for the stage. Specifying the default Snowflake value (e.g. TYPE = CSV) will currently result in a permadiff (check #2679). For now, omit the default values; it will be fixed in the upcoming provider versions.
+        :param pulumi.Input[str] fully_qualified_name: Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
+        :param pulumi.Input[str] name: Specifies the identifier for the stage; must be unique for the database and schema in which the stage is created.
+        :param pulumi.Input[str] schema: The schema in which to create the stage.
+        :param pulumi.Input[str] snowflake_iam_user: An AWS IAM user created for your Snowflake account. This user is the same for every external S3 stage created in your account.
         :param pulumi.Input[str] storage_integration: Specifies the name of the storage integration used to delegate authentication responsibility for external cloud storage to a Snowflake identity and access management (IAM) entity.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['StageTagArgs']]]] tags: Definitions of a tag to associate with the resource.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['StageTagArgs', 'StageTagArgsDict']]]] tags: Definitions of a tag to associate with the resource.
         :param pulumi.Input[str] url: Specifies the URL for the stage.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -686,6 +684,7 @@ class Stage(pulumi.CustomResource):
         __props__.__dict__["directory"] = directory
         __props__.__dict__["encryption"] = encryption
         __props__.__dict__["file_format"] = file_format
+        __props__.__dict__["fully_qualified_name"] = fully_qualified_name
         __props__.__dict__["name"] = name
         __props__.__dict__["schema"] = schema
         __props__.__dict__["snowflake_iam_user"] = snowflake_iam_user
@@ -697,6 +696,9 @@ class Stage(pulumi.CustomResource):
     @property
     @pulumi.getter(name="awsExternalId")
     def aws_external_id(self) -> pulumi.Output[str]:
+        """
+        A unique ID assigned to the specific stage. The ID has the following format: &lt;snowflakeAccount&gt;*SFCRole=&lt;snowflakeRoleId&gt;*&lt;randomId&gt;
+        """
         return pulumi.get(self, "aws_external_id")
 
     @property
@@ -727,7 +729,7 @@ class Stage(pulumi.CustomResource):
     @pulumi.getter
     def database(self) -> pulumi.Output[str]:
         """
-        Name of the database that the tag was created in.
+        The database in which to create the stage.
         """
         return pulumi.get(self, "database")
 
@@ -751,15 +753,23 @@ class Stage(pulumi.CustomResource):
     @pulumi.getter(name="fileFormat")
     def file_format(self) -> pulumi.Output[Optional[str]]:
         """
-        Specifies the file format for the stage.
+        Specifies the file format for the stage. Specifying the default Snowflake value (e.g. TYPE = CSV) will currently result in a permadiff (check #2679). For now, omit the default values; it will be fixed in the upcoming provider versions.
         """
         return pulumi.get(self, "file_format")
 
+    @property
+    @pulumi.getter(name="fullyQualifiedName")
+    def fully_qualified_name(self) -> pulumi.Output[str]:
+        """
+        Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
+        """
+        return pulumi.get(self, "fully_qualified_name")
+
     @property
     @pulumi.getter
     def name(self) -> pulumi.Output[str]:
         """
-        Tag name, e.g. department.
+        Specifies the identifier for the stage; must be unique for the database and schema in which the stage is created.
         """
         return pulumi.get(self, "name")
 
@@ -767,13 +777,16 @@ class Stage(pulumi.CustomResource):
     @pulumi.getter
     def schema(self) -> pulumi.Output[str]:
         """
-        Name of the schema that the tag was created in.
+        The schema in which to create the stage.
         """
         return pulumi.get(self, "schema")
 
     @property
     @pulumi.getter(name="snowflakeIamUser")
     def snowflake_iam_user(self) -> pulumi.Output[str]:
+        """
+        An AWS IAM user created for your Snowflake account. This user is the same for every external S3 stage created in your account.
+        """
         return pulumi.get(self, "snowflake_iam_user")
 
     @property
@@ -786,13 +799,11 @@ class Stage(pulumi.CustomResource):
 
     @property
     @pulumi.getter
+    @_utilities.deprecated("""Use the 'snowflake_tag_association' resource instead.""")
     def tags(self) -> pulumi.Output[Optional[Sequence['outputs.StageTag']]]:
         """
         Definitions of a tag to associate with the resource.
         """
-        warnings.warn("""Use the 'snowflake_tag_association' resource instead.""", DeprecationWarning)
-        pulumi.log.warn("""tags is deprecated: Use the 'snowflake_tag_association' resource instead.""")
-
         return pulumi.get(self, "tags")
 
     @property

pulumi_snowflake/storage_integration.py

@@ -4,9 +4,14 @@
 
 import copy
 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
 
 __all__ = ['StorageIntegrationArgs', 'StorageIntegration']
@@ -27,6 +32,7 @@ class StorageIntegrationArgs:
         """
         The set of arguments for constructing a StorageIntegration resource.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] storage_allowed_locations: Explicitly limits external stages that use the integration to reference one or more storage locations.
+        :param pulumi.Input[str] storage_provider: Specifies the storage provider for the integration. Valid options are: `S3` | `S3GOV` | `S3CHINA` | `GCS` | `AZURE`
         :param pulumi.Input[str] storage_aws_object_acl: "bucket-owner-full-control" Enables support for AWS access control lists (ACLs) to grant the bucket owner full control.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] storage_blocked_locations: Explicitly prohibits external stages that use the integration from referencing one or more storage locations.
         """
@@ -64,6 +70,9 @@ class StorageIntegrationArgs:
     @property
     @pulumi.getter(name="storageProvider")
     def storage_provider(self) -> pulumi.Input[str]:
+        """
+        Specifies the storage provider for the integration. Valid options are: `S3` | `S3GOV` | `S3CHINA` | `GCS` | `AZURE`
+        """
         return pulumi.get(self, "storage_provider")
 
     @storage_provider.setter
@@ -158,6 +167,7 @@ class _StorageIntegrationState:
                  comment: Optional[pulumi.Input[str]] = None,
                  created_on: Optional[pulumi.Input[str]] = None,
                  enabled: Optional[pulumi.Input[bool]] = None,
+                 fully_qualified_name: Optional[pulumi.Input[str]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  storage_allowed_locations: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  storage_aws_external_id: Optional[pulumi.Input[str]] = None,
@@ -173,12 +183,14 @@ class _StorageIntegrationState:
         :param pulumi.Input[str] azure_consent_url: The consent URL that is used to create an Azure Snowflake service principle inside your tenant.
         :param pulumi.Input[str] azure_multi_tenant_app_name: This is the name of the Snowflake client application created for your account.
         :param pulumi.Input[str] created_on: Date and time when the storage integration was created.
+        :param pulumi.Input[str] fully_qualified_name: Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
         :param pulumi.Input[Sequence[pulumi.Input[str]]] storage_allowed_locations: Explicitly limits external stages that use the integration to reference one or more storage locations.
         :param pulumi.Input[str] storage_aws_external_id: The external ID that Snowflake will use when assuming the AWS role.
         :param pulumi.Input[str] storage_aws_iam_user_arn: The Snowflake user that will attempt to assume the AWS role.
         :param pulumi.Input[str] storage_aws_object_acl: "bucket-owner-full-control" Enables support for AWS access control lists (ACLs) to grant the bucket owner full control.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] storage_blocked_locations: Explicitly prohibits external stages that use the integration from referencing one or more storage locations.
         :param pulumi.Input[str] storage_gcp_service_account: This is the name of the Snowflake Google Service Account created for your account.
+        :param pulumi.Input[str] storage_provider: Specifies the storage provider for the integration. Valid options are: `S3` | `S3GOV` | `S3CHINA` | `GCS` | `AZURE`
         """
         if azure_consent_url is not None:
             pulumi.set(__self__, "azure_consent_url", azure_consent_url)
@@ -192,6 +204,8 @@ class _StorageIntegrationState:
             pulumi.set(__self__, "created_on", created_on)
         if enabled is not None:
             pulumi.set(__self__, "enabled", enabled)
+        if fully_qualified_name is not None:
+            pulumi.set(__self__, "fully_qualified_name", fully_qualified_name)
         if name is not None:
             pulumi.set(__self__, "name", name)
         if storage_allowed_locations is not None:
@@ -276,6 +290,18 @@ class _StorageIntegrationState:
     def enabled(self, value: Optional[pulumi.Input[bool]]):
         pulumi.set(self, "enabled", value)
 
+    @property
+    @pulumi.getter(name="fullyQualifiedName")
+    def fully_qualified_name(self) -> Optional[pulumi.Input[str]]:
+        """
+        Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
+        """
+        return pulumi.get(self, "fully_qualified_name")
+
+    @fully_qualified_name.setter
+    def fully_qualified_name(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "fully_qualified_name", value)
+
     @property
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
@@ -369,6 +395,9 @@ class _StorageIntegrationState:
     @property
     @pulumi.getter(name="storageProvider")
     def storage_provider(self) -> Optional[pulumi.Input[str]]:
+        """
+        Specifies the storage provider for the integration. Valid options are: `S3` | `S3GOV` | `S3CHINA` | `GCS` | `AZURE`
+        """
         return pulumi.get(self, "storage_provider")
 
     @storage_provider.setter
@@ -402,8 +431,6 @@ class StorageIntegration(pulumi.CustomResource):
                  type: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        ## Example Usage
-
         ## Import
 
         ```sh
@@ -415,6 +442,7 @@ class StorageIntegration(pulumi.CustomResource):
         :param pulumi.Input[Sequence[pulumi.Input[str]]] storage_allowed_locations: Explicitly limits external stages that use the integration to reference one or more storage locations.
         :param pulumi.Input[str] storage_aws_object_acl: "bucket-owner-full-control" Enables support for AWS access control lists (ACLs) to grant the bucket owner full control.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] storage_blocked_locations: Explicitly prohibits external stages that use the integration from referencing one or more storage locations.
+        :param pulumi.Input[str] storage_provider: Specifies the storage provider for the integration. Valid options are: `S3` | `S3GOV` | `S3CHINA` | `GCS` | `AZURE`
         """
         ...
     @overload
@@ -423,8 +451,6 @@ class StorageIntegration(pulumi.CustomResource):
                  args: StorageIntegrationArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        ## Example Usage
-
         ## Import
 
         ```sh
@@ -482,6 +508,7 @@ class StorageIntegration(pulumi.CustomResource):
             __props__.__dict__["azure_consent_url"] = None
             __props__.__dict__["azure_multi_tenant_app_name"] = None
             __props__.__dict__["created_on"] = None
+            __props__.__dict__["fully_qualified_name"] = None
             __props__.__dict__["storage_aws_external_id"] = None
             __props__.__dict__["storage_aws_iam_user_arn"] = None
             __props__.__dict__["storage_gcp_service_account"] = None
@@ -501,6 +528,7 @@ class StorageIntegration(pulumi.CustomResource):
             comment: Optional[pulumi.Input[str]] = None,
             created_on: Optional[pulumi.Input[str]] = None,
             enabled: Optional[pulumi.Input[bool]] = None,
+            fully_qualified_name: Optional[pulumi.Input[str]] = None,
             name: Optional[pulumi.Input[str]] = None,
             storage_allowed_locations: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
             storage_aws_external_id: Optional[pulumi.Input[str]] = None,
@@ -521,12 +549,14 @@ class StorageIntegration(pulumi.CustomResource):
         :param pulumi.Input[str] azure_consent_url: The consent URL that is used to create an Azure Snowflake service principle inside your tenant.
         :param pulumi.Input[str] azure_multi_tenant_app_name: This is the name of the Snowflake client application created for your account.
         :param pulumi.Input[str] created_on: Date and time when the storage integration was created.
+        :param pulumi.Input[str] fully_qualified_name: Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
         :param pulumi.Input[Sequence[pulumi.Input[str]]] storage_allowed_locations: Explicitly limits external stages that use the integration to reference one or more storage locations.
         :param pulumi.Input[str] storage_aws_external_id: The external ID that Snowflake will use when assuming the AWS role.
         :param pulumi.Input[str] storage_aws_iam_user_arn: The Snowflake user that will attempt to assume the AWS role.
         :param pulumi.Input[str] storage_aws_object_acl: "bucket-owner-full-control" Enables support for AWS access control lists (ACLs) to grant the bucket owner full control.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] storage_blocked_locations: Explicitly prohibits external stages that use the integration from referencing one or more storage locations.
         :param pulumi.Input[str] storage_gcp_service_account: This is the name of the Snowflake Google Service Account created for your account.
+        :param pulumi.Input[str] storage_provider: Specifies the storage provider for the integration. Valid options are: `S3` | `S3GOV` | `S3CHINA` | `GCS` | `AZURE`
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -538,6 +568,7 @@ class StorageIntegration(pulumi.CustomResource):
         __props__.__dict__["comment"] = comment
         __props__.__dict__["created_on"] = created_on
         __props__.__dict__["enabled"] = enabled
+        __props__.__dict__["fully_qualified_name"] = fully_qualified_name
         __props__.__dict__["name"] = name
         __props__.__dict__["storage_allowed_locations"] = storage_allowed_locations
         __props__.__dict__["storage_aws_external_id"] = storage_aws_external_id
@@ -589,6 +620,14 @@ class StorageIntegration(pulumi.CustomResource):
     def enabled(self) -> pulumi.Output[Optional[bool]]:
         return pulumi.get(self, "enabled")
 
+    @property
+    @pulumi.getter(name="fullyQualifiedName")
+    def fully_qualified_name(self) -> pulumi.Output[str]:
+        """
+        Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
+        """
+        return pulumi.get(self, "fully_qualified_name")
+
     @property
     @pulumi.getter
     def name(self) -> pulumi.Output[str]:
@@ -650,6 +689,9 @@ class StorageIntegration(pulumi.CustomResource):
     @property
     @pulumi.getter(name="storageProvider")
     def storage_provider(self) -> pulumi.Output[str]:
+        """
+        Specifies the storage provider for the integration. Valid options are: `S3` | `S3GOV` | `S3CHINA` | `GCS` | `AZURE`
+        """
         return pulumi.get(self, "storage_provider")
 
     @property