pulumi-snowflake 0.50.2a1709892015__py3-none-any.whl → 1.2.0a1736835738__py3-none-any.whl

pulumi_snowflake/get_views.py

@@ -4,11 +4,17 @@
 
 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 *
 
 __all__ = [
     'GetViewsResult',
@@ -22,52 +28,85 @@ class GetViewsResult:
     """
     A collection of values returned by getViews.
     """
-    def __init__(__self__, database=None, id=None, schema=None, views=None):
-        if database and not isinstance(database, str):
-            raise TypeError("Expected argument 'database' to be a str")
-        pulumi.set(__self__, "database", database)
+    def __init__(__self__, id=None, in_=None, like=None, limit=None, starts_with=None, views=None, with_describe=None):
         if id and not isinstance(id, str):
             raise TypeError("Expected argument 'id' to be a str")
         pulumi.set(__self__, "id", id)
-        if schema and not isinstance(schema, str):
-            raise TypeError("Expected argument 'schema' to be a str")
-        pulumi.set(__self__, "schema", schema)
+        if in_ and not isinstance(in_, dict):
+            raise TypeError("Expected argument 'in_' to be a dict")
+        pulumi.set(__self__, "in_", in_)
+        if like and not isinstance(like, str):
+            raise TypeError("Expected argument 'like' to be a str")
+        pulumi.set(__self__, "like", like)
+        if limit and not isinstance(limit, dict):
+            raise TypeError("Expected argument 'limit' to be a dict")
+        pulumi.set(__self__, "limit", limit)
+        if starts_with and not isinstance(starts_with, str):
+            raise TypeError("Expected argument 'starts_with' to be a str")
+        pulumi.set(__self__, "starts_with", starts_with)
         if views and not isinstance(views, list):
             raise TypeError("Expected argument 'views' to be a list")
         pulumi.set(__self__, "views", views)
+        if with_describe and not isinstance(with_describe, bool):
+            raise TypeError("Expected argument 'with_describe' to be a bool")
+        pulumi.set(__self__, "with_describe", with_describe)
 
     @property
     @pulumi.getter
-    def database(self) -> str:
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter(name="in")
+    def in_(self) -> Optional['outputs.GetViewsInResult']:
         """
-        The database from which to return the schemas from.
+        IN clause to filter the list of views
         """
-        return pulumi.get(self, "database")
+        return pulumi.get(self, "in_")
 
     @property
     @pulumi.getter
-    def id(self) -> str:
+    def like(self) -> Optional[str]:
         """
-        The provider-assigned unique ID for this managed resource.
+        Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
         """
-        return pulumi.get(self, "id")
+        return pulumi.get(self, "like")
 
     @property
     @pulumi.getter
-    def schema(self) -> str:
+    def limit(self) -> Optional['outputs.GetViewsLimitResult']:
         """
-        The schema from which to return the views from.
+        Limits the number of rows returned. If the `limit.from` is set, then the limit wll start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern with `starts_with` or `like`.
         """
-        return pulumi.get(self, "schema")
+        return pulumi.get(self, "limit")
+
+    @property
+    @pulumi.getter(name="startsWith")
+    def starts_with(self) -> Optional[str]:
+        """
+        Filters the output with **case-sensitive** characters indicating the beginning of the object name.
+        """
+        return pulumi.get(self, "starts_with")
 
     @property
     @pulumi.getter
     def views(self) -> Sequence['outputs.GetViewsViewResult']:
         """
-        The views in the schema
+        Holds the aggregated output of all views details queries.
         """
         return pulumi.get(self, "views")
 
+    @property
+    @pulumi.getter(name="withDescribe")
+    def with_describe(self) -> Optional[bool]:
+        """
+        Runs DESC VIEW for each view returned by SHOW VIEWS. The output of describe is saved to the description field. By default this value is set to true.
+        """
+        return pulumi.get(self, "with_describe")
+
 
 class AwaitableGetViewsResult(GetViewsResult):
     # pylint: disable=using-constant-test
@@ -75,52 +114,77 @@ class AwaitableGetViewsResult(GetViewsResult):
         if False:
             yield self
         return GetViewsResult(
-            database=self.database,
             id=self.id,
-            schema=self.schema,
-            views=self.views)
-
-
-def get_views(database: Optional[str] = None,
-              schema: Optional[str] = None,
+            in_=self.in_,
+            like=self.like,
+            limit=self.limit,
+            starts_with=self.starts_with,
+            views=self.views,
+            with_describe=self.with_describe)
+
+
+def get_views(in_: Optional[Union['GetViewsInArgs', 'GetViewsInArgsDict']] = None,
+              like: Optional[str] = None,
+              limit: Optional[Union['GetViewsLimitArgs', 'GetViewsLimitArgsDict']] = None,
+              starts_with: Optional[str] = None,
+              with_describe: Optional[bool] = None,
               opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetViewsResult:
     """
-    ## Example Usage
+    Data source used to get details of filtered views. Filtering is aligned with the current possibilities for [SHOW VIEWS](https://docs.snowflake.com/en/sql-reference/sql/show-views) query (only `like` is supported). The results of SHOW and DESCRIBE are encapsulated in one output collection `views`.
 
-    ```python
-    import pulumi
-    import pulumi_snowflake as snowflake
 
-    current = snowflake.get_views(database="MYDB",
-        schema="MYSCHEMA")
-    ```
+    :param Union['GetViewsInArgs', 'GetViewsInArgsDict'] in_: IN clause to filter the list of views
+    :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
+    :param Union['GetViewsLimitArgs', 'GetViewsLimitArgsDict'] limit: Limits the number of rows returned. If the `limit.from` is set, then the limit wll start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern with `starts_with` or `like`.
+    :param str starts_with: Filters the output with **case-sensitive** characters indicating the beginning of the object name.
+    :param bool with_describe: Runs DESC VIEW for each view returned by SHOW VIEWS. The output of describe is saved to the description field. By default this value is set to true.
     """
     __args__ = dict()
-    __args__['database'] = database
-    __args__['schema'] = schema
+    __args__['in'] = in_
+    __args__['like'] = like
+    __args__['limit'] = limit
+    __args__['startsWith'] = starts_with
+    __args__['withDescribe'] = with_describe
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('snowflake:index/getViews:getViews', __args__, opts=opts, typ=GetViewsResult).value
 
     return AwaitableGetViewsResult(
-        database=pulumi.get(__ret__, 'database'),
         id=pulumi.get(__ret__, 'id'),
-        schema=pulumi.get(__ret__, 'schema'),
-        views=pulumi.get(__ret__, 'views'))
-
-
-@_utilities.lift_output_func(get_views)
-def get_views_output(database: Optional[pulumi.Input[str]] = None,
-                     schema: Optional[pulumi.Input[str]] = None,
-                     opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetViewsResult]:
+        in_=pulumi.get(__ret__, 'in_'),
+        like=pulumi.get(__ret__, 'like'),
+        limit=pulumi.get(__ret__, 'limit'),
+        starts_with=pulumi.get(__ret__, 'starts_with'),
+        views=pulumi.get(__ret__, 'views'),
+        with_describe=pulumi.get(__ret__, 'with_describe'))
+def get_views_output(in_: Optional[pulumi.Input[Optional[Union['GetViewsInArgs', 'GetViewsInArgsDict']]]] = None,
+                     like: Optional[pulumi.Input[Optional[str]]] = None,
+                     limit: Optional[pulumi.Input[Optional[Union['GetViewsLimitArgs', 'GetViewsLimitArgsDict']]]] = None,
+                     starts_with: Optional[pulumi.Input[Optional[str]]] = None,
+                     with_describe: Optional[pulumi.Input[Optional[bool]]] = None,
+                     opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetViewsResult]:
     """
-    ## Example Usage
+    Data source used to get details of filtered views. Filtering is aligned with the current possibilities for [SHOW VIEWS](https://docs.snowflake.com/en/sql-reference/sql/show-views) query (only `like` is supported). The results of SHOW and DESCRIBE are encapsulated in one output collection `views`.
 
-    ```python
-    import pulumi
-    import pulumi_snowflake as snowflake
 
-    current = snowflake.get_views(database="MYDB",
-        schema="MYSCHEMA")
-    ```
+    :param Union['GetViewsInArgs', 'GetViewsInArgsDict'] in_: IN clause to filter the list of views
+    :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
+    :param Union['GetViewsLimitArgs', 'GetViewsLimitArgsDict'] limit: Limits the number of rows returned. If the `limit.from` is set, then the limit wll start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern with `starts_with` or `like`.
+    :param str starts_with: Filters the output with **case-sensitive** characters indicating the beginning of the object name.
+    :param bool with_describe: Runs DESC VIEW for each view returned by SHOW VIEWS. The output of describe is saved to the description field. By default this value is set to true.
     """
-    ...
+    __args__ = dict()
+    __args__['in'] = in_
+    __args__['like'] = like
+    __args__['limit'] = limit
+    __args__['startsWith'] = starts_with
+    __args__['withDescribe'] = with_describe
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('snowflake:index/getViews:getViews', __args__, opts=opts, typ=GetViewsResult)
+    return __ret__.apply(lambda __response__: GetViewsResult(
+        id=pulumi.get(__response__, 'id'),
+        in_=pulumi.get(__response__, 'in_'),
+        like=pulumi.get(__response__, 'like'),
+        limit=pulumi.get(__response__, 'limit'),
+        starts_with=pulumi.get(__response__, 'starts_with'),
+        views=pulumi.get(__response__, 'views'),
+        with_describe=pulumi.get(__response__, 'with_describe')))

pulumi_snowflake/get_warehouses.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
 
@@ -22,13 +27,22 @@ class GetWarehousesResult:
     """
     A collection of values returned by getWarehouses.
     """
-    def __init__(__self__, id=None, warehouses=None):
+    def __init__(__self__, id=None, like=None, warehouses=None, with_describe=None, with_parameters=None):
         if id and not isinstance(id, str):
             raise TypeError("Expected argument 'id' to be a str")
         pulumi.set(__self__, "id", id)
+        if like and not isinstance(like, str):
+            raise TypeError("Expected argument 'like' to be a str")
+        pulumi.set(__self__, "like", like)
         if warehouses and not isinstance(warehouses, list):
             raise TypeError("Expected argument 'warehouses' to be a list")
         pulumi.set(__self__, "warehouses", warehouses)
+        if with_describe and not isinstance(with_describe, bool):
+            raise TypeError("Expected argument 'with_describe' to be a bool")
+        pulumi.set(__self__, "with_describe", with_describe)
+        if with_parameters and not isinstance(with_parameters, bool):
+            raise TypeError("Expected argument 'with_parameters' to be a bool")
+        pulumi.set(__self__, "with_parameters", with_parameters)
 
     @property
     @pulumi.getter
@@ -38,14 +52,38 @@ class GetWarehousesResult:
         """
         return pulumi.get(self, "id")
 
+    @property
+    @pulumi.getter
+    def like(self) -> Optional[str]:
+        """
+        Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
+        """
+        return pulumi.get(self, "like")
+
     @property
     @pulumi.getter
     def warehouses(self) -> Sequence['outputs.GetWarehousesWarehouseResult']:
         """
-        The warehouses in the database
+        Holds the aggregated output of all warehouse details queries.
         """
         return pulumi.get(self, "warehouses")
 
+    @property
+    @pulumi.getter(name="withDescribe")
+    def with_describe(self) -> Optional[bool]:
+        """
+        Runs DESC WAREHOUSE for each warehouse returned by SHOW WAREHOUSES. The output of describe is saved to the description field. By default this value is set to true.
+        """
+        return pulumi.get(self, "with_describe")
+
+    @property
+    @pulumi.getter(name="withParameters")
+    def with_parameters(self) -> Optional[bool]:
+        """
+        Runs SHOW PARAMETERS FOR WAREHOUSE for each warehouse returned by SHOW WAREHOUSES. The output of describe is saved to the parameters field as a map. By default this value is set to true.
+        """
+        return pulumi.get(self, "with_parameters")
+
 
 class AwaitableGetWarehousesResult(GetWarehousesResult):
     # pylint: disable=using-constant-test
@@ -54,39 +92,58 @@ class AwaitableGetWarehousesResult(GetWarehousesResult):
             yield self
         return GetWarehousesResult(
             id=self.id,
-            warehouses=self.warehouses)
+            like=self.like,
+            warehouses=self.warehouses,
+            with_describe=self.with_describe,
+            with_parameters=self.with_parameters)
 
 
-def get_warehouses(opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetWarehousesResult:
+def get_warehouses(like: Optional[str] = None,
+                   with_describe: Optional[bool] = None,
+                   with_parameters: Optional[bool] = None,
+                   opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetWarehousesResult:
     """
-    ## Example Usage
+    Data source used to get details of filtered warehouses. Filtering is aligned with the current possibilities for [SHOW WAREHOUSES](https://docs.snowflake.com/en/sql-reference/sql/show-warehouses) query (only `like` is supported). The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection.
 
-    ```python
-    import pulumi
-    import pulumi_snowflake as snowflake
 
-    current = snowflake.get_warehouses()
-    ```
+    :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
+    :param bool with_describe: Runs DESC WAREHOUSE for each warehouse returned by SHOW WAREHOUSES. The output of describe is saved to the description field. By default this value is set to true.
+    :param bool with_parameters: Runs SHOW PARAMETERS FOR WAREHOUSE for each warehouse returned by SHOW WAREHOUSES. The output of describe is saved to the parameters field as a map. By default this value is set to true.
     """
     __args__ = dict()
+    __args__['like'] = like
+    __args__['withDescribe'] = with_describe
+    __args__['withParameters'] = with_parameters
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('snowflake:index/getWarehouses:getWarehouses', __args__, opts=opts, typ=GetWarehousesResult).value
 
     return AwaitableGetWarehousesResult(
         id=pulumi.get(__ret__, 'id'),
-        warehouses=pulumi.get(__ret__, 'warehouses'))
-
-
-@_utilities.lift_output_func(get_warehouses)
-def get_warehouses_output(opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetWarehousesResult]:
+        like=pulumi.get(__ret__, 'like'),
+        warehouses=pulumi.get(__ret__, 'warehouses'),
+        with_describe=pulumi.get(__ret__, 'with_describe'),
+        with_parameters=pulumi.get(__ret__, 'with_parameters'))
+def get_warehouses_output(like: Optional[pulumi.Input[Optional[str]]] = None,
+                          with_describe: Optional[pulumi.Input[Optional[bool]]] = None,
+                          with_parameters: Optional[pulumi.Input[Optional[bool]]] = None,
+                          opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetWarehousesResult]:
     """
-    ## Example Usage
+    Data source used to get details of filtered warehouses. Filtering is aligned with the current possibilities for [SHOW WAREHOUSES](https://docs.snowflake.com/en/sql-reference/sql/show-warehouses) query (only `like` is supported). The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection.
 
-    ```python
-    import pulumi
-    import pulumi_snowflake as snowflake
 
-    current = snowflake.get_warehouses()
-    ```
+    :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
+    :param bool with_describe: Runs DESC WAREHOUSE for each warehouse returned by SHOW WAREHOUSES. The output of describe is saved to the description field. By default this value is set to true.
+    :param bool with_parameters: Runs SHOW PARAMETERS FOR WAREHOUSE for each warehouse returned by SHOW WAREHOUSES. The output of describe is saved to the parameters field as a map. By default this value is set to true.
     """
-    ...
+    __args__ = dict()
+    __args__['like'] = like
+    __args__['withDescribe'] = with_describe
+    __args__['withParameters'] = with_parameters
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('snowflake:index/getWarehouses:getWarehouses', __args__, opts=opts, typ=GetWarehousesResult)
+    return __ret__.apply(lambda __response__: GetWarehousesResult(
+        id=pulumi.get(__response__, 'id'),
+        like=pulumi.get(__response__, 'like'),
+        warehouses=pulumi.get(__response__, 'warehouses'),
+        with_describe=pulumi.get(__response__, 'with_describe'),
+        with_parameters=pulumi.get(__response__, 'with_parameters')))

pulumi_snowflake/grant_account_role.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__ = ['GrantAccountRoleArgs', 'GrantAccountRole']
@@ -19,9 +24,9 @@ class GrantAccountRoleArgs:
                  user_name: Optional[pulumi.Input[str]] = None):
         """
         The set of arguments for constructing a GrantAccountRole resource.
-        :param pulumi.Input[str] role_name: The fully qualified name of the role which will be granted to the user or parent role.
-        :param pulumi.Input[str] parent_role_name: The fully qualified name of the parent role which will create a parent-child relationship between the roles.
-        :param pulumi.Input[str] user_name: The fully qualified name of the user on which specified role will be granted.
+        :param pulumi.Input[str] role_name: The fully qualified name of the role which will be granted to the user or parent role. For more information about this resource, see docs.
+        :param pulumi.Input[str] parent_role_name: The fully qualified name of the parent role which will create a parent-child relationship between the roles. For more information about this resource, see docs.
+        :param pulumi.Input[str] user_name: The fully qualified name of the user on which specified role will be granted. For more information about this resource, see docs.
         """
         pulumi.set(__self__, "role_name", role_name)
         if parent_role_name is not None:
@@ -33,7 +38,7 @@ class GrantAccountRoleArgs:
     @pulumi.getter(name="roleName")
     def role_name(self) -> pulumi.Input[str]:
         """
-        The fully qualified name of the role which will be granted to the user or parent role.
+        The fully qualified name of the role which will be granted to the user or parent role. For more information about this resource, see docs.
         """
         return pulumi.get(self, "role_name")
 
@@ -45,7 +50,7 @@ class GrantAccountRoleArgs:
     @pulumi.getter(name="parentRoleName")
     def parent_role_name(self) -> Optional[pulumi.Input[str]]:
         """
-        The fully qualified name of the parent role which will create a parent-child relationship between the roles.
+        The fully qualified name of the parent role which will create a parent-child relationship between the roles. For more information about this resource, see docs.
         """
         return pulumi.get(self, "parent_role_name")
 
@@ -57,7 +62,7 @@ class GrantAccountRoleArgs:
     @pulumi.getter(name="userName")
     def user_name(self) -> Optional[pulumi.Input[str]]:
         """
-        The fully qualified name of the user on which specified role will be granted.
+        The fully qualified name of the user on which specified role will be granted. For more information about this resource, see docs.
         """
         return pulumi.get(self, "user_name")
 
@@ -74,9 +79,9 @@ class _GrantAccountRoleState:
                  user_name: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering GrantAccountRole resources.
-        :param pulumi.Input[str] parent_role_name: The fully qualified name of the parent role which will create a parent-child relationship between the roles.
-        :param pulumi.Input[str] role_name: The fully qualified name of the role which will be granted to the user or parent role.
-        :param pulumi.Input[str] user_name: The fully qualified name of the user on which specified role will be granted.
+        :param pulumi.Input[str] parent_role_name: The fully qualified name of the parent role which will create a parent-child relationship between the roles. For more information about this resource, see docs.
+        :param pulumi.Input[str] role_name: The fully qualified name of the role which will be granted to the user or parent role. For more information about this resource, see docs.
+        :param pulumi.Input[str] user_name: The fully qualified name of the user on which specified role will be granted. For more information about this resource, see docs.
         """
         if parent_role_name is not None:
             pulumi.set(__self__, "parent_role_name", parent_role_name)
@@ -89,7 +94,7 @@ class _GrantAccountRoleState:
     @pulumi.getter(name="parentRoleName")
     def parent_role_name(self) -> Optional[pulumi.Input[str]]:
         """
-        The fully qualified name of the parent role which will create a parent-child relationship between the roles.
+        The fully qualified name of the parent role which will create a parent-child relationship between the roles. For more information about this resource, see docs.
         """
         return pulumi.get(self, "parent_role_name")
 
@@ -101,7 +106,7 @@ class _GrantAccountRoleState:
     @pulumi.getter(name="roleName")
     def role_name(self) -> Optional[pulumi.Input[str]]:
         """
-        The fully qualified name of the role which will be granted to the user or parent role.
+        The fully qualified name of the role which will be granted to the user or parent role. For more information about this resource, see docs.
         """
         return pulumi.get(self, "role_name")
 
@@ -113,7 +118,7 @@ class _GrantAccountRoleState:
     @pulumi.getter(name="userName")
     def user_name(self) -> Optional[pulumi.Input[str]]:
         """
-        The fully qualified name of the user on which specified role will be granted.
+        The fully qualified name of the user on which specified role will be granted. For more information about this resource, see docs.
         """
         return pulumi.get(self, "user_name")
 
@@ -132,38 +137,19 @@ class GrantAccountRole(pulumi.CustomResource):
                  user_name: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        ## Example Usage
-        ### grant account role to account role
-        ##################################
-
-        resource "snowflake_role" "role" {
-          name = var.role_name
-        }
-
-        resource "snowflake_role" "parent_role" {
-          name = var.parent_role_name
-        }
-
-        resource "snowflake_grant_account_role" "g" {
-          role_name        = snowflake_role.role.name
-          parent_role_name = snowflake_role.parent_role.name
-        }
-
-        ##################################
-
         ## Import
 
         format is role_name (string) | grantee_object_type (ROLE|USER) | grantee_name (string)
 
         ```sh
-        $ pulumi import snowflake:index/grantAccountRole:GrantAccountRole "\\"test_role\\"|ROLE|\\"test_parent_role\\""
+        $ pulumi import snowflake:index/grantAccountRole:GrantAccountRole example '"test_role"|ROLE|"test_parent_role"'
         ```
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] parent_role_name: The fully qualified name of the parent role which will create a parent-child relationship between the roles.
-        :param pulumi.Input[str] role_name: The fully qualified name of the role which will be granted to the user or parent role.
-        :param pulumi.Input[str] user_name: The fully qualified name of the user on which specified role will be granted.
+        :param pulumi.Input[str] parent_role_name: The fully qualified name of the parent role which will create a parent-child relationship between the roles. For more information about this resource, see docs.
+        :param pulumi.Input[str] role_name: The fully qualified name of the role which will be granted to the user or parent role. For more information about this resource, see docs.
+        :param pulumi.Input[str] user_name: The fully qualified name of the user on which specified role will be granted. For more information about this resource, see docs.
         """
         ...
     @overload
@@ -172,31 +158,12 @@ class GrantAccountRole(pulumi.CustomResource):
                  args: GrantAccountRoleArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        ## Example Usage
-        ### grant account role to account role
-        ##################################
-
-        resource "snowflake_role" "role" {
-          name = var.role_name
-        }
-
-        resource "snowflake_role" "parent_role" {
-          name = var.parent_role_name
-        }
-
-        resource "snowflake_grant_account_role" "g" {
-          role_name        = snowflake_role.role.name
-          parent_role_name = snowflake_role.parent_role.name
-        }
-
-        ##################################
-
         ## Import
 
         format is role_name (string) | grantee_object_type (ROLE|USER) | grantee_name (string)
 
         ```sh
-        $ pulumi import snowflake:index/grantAccountRole:GrantAccountRole "\\"test_role\\"|ROLE|\\"test_parent_role\\""
+        $ pulumi import snowflake:index/grantAccountRole:GrantAccountRole example '"test_role"|ROLE|"test_parent_role"'
         ```
 
         :param str resource_name: The name of the resource.
@@ -251,9 +218,9 @@ class GrantAccountRole(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] parent_role_name: The fully qualified name of the parent role which will create a parent-child relationship between the roles.
-        :param pulumi.Input[str] role_name: The fully qualified name of the role which will be granted to the user or parent role.
-        :param pulumi.Input[str] user_name: The fully qualified name of the user on which specified role will be granted.
+        :param pulumi.Input[str] parent_role_name: The fully qualified name of the parent role which will create a parent-child relationship between the roles. For more information about this resource, see docs.
+        :param pulumi.Input[str] role_name: The fully qualified name of the role which will be granted to the user or parent role. For more information about this resource, see docs.
+        :param pulumi.Input[str] user_name: The fully qualified name of the user on which specified role will be granted. For more information about this resource, see docs.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -268,7 +235,7 @@ class GrantAccountRole(pulumi.CustomResource):
     @pulumi.getter(name="parentRoleName")
     def parent_role_name(self) -> pulumi.Output[Optional[str]]:
         """
-        The fully qualified name of the parent role which will create a parent-child relationship between the roles.
+        The fully qualified name of the parent role which will create a parent-child relationship between the roles. For more information about this resource, see docs.
         """
         return pulumi.get(self, "parent_role_name")
 
@@ -276,7 +243,7 @@ class GrantAccountRole(pulumi.CustomResource):
     @pulumi.getter(name="roleName")
     def role_name(self) -> pulumi.Output[str]:
         """
-        The fully qualified name of the role which will be granted to the user or parent role.
+        The fully qualified name of the role which will be granted to the user or parent role. For more information about this resource, see docs.
         """
         return pulumi.get(self, "role_name")
 
@@ -284,7 +251,7 @@ class GrantAccountRole(pulumi.CustomResource):
     @pulumi.getter(name="userName")
     def user_name(self) -> pulumi.Output[Optional[str]]:
         """
-        The fully qualified name of the user on which specified role will be granted.
+        The fully qualified name of the user on which specified role will be granted. For more information about this resource, see docs.
         """
         return pulumi.get(self, "user_name")