pulumi-snowflake 0.57.1a1722856643__py3-none-any.whl → 0.58.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of pulumi-snowflake might be problematic. Click here for more details.

Files changed (88) hide show
  1. pulumi_snowflake/_inputs.py +5859 -127
  2. pulumi_snowflake/account.py +28 -50
  3. pulumi_snowflake/account_parameter.py +0 -28
  4. pulumi_snowflake/account_password_policy_attachment.py +2 -30
  5. pulumi_snowflake/account_role.py +51 -32
  6. pulumi_snowflake/alert.py +33 -45
  7. pulumi_snowflake/api_authentication_integration_with_authorization_code_grant.py +39 -19
  8. pulumi_snowflake/api_authentication_integration_with_client_credentials.py +39 -19
  9. pulumi_snowflake/api_authentication_integration_with_jwt_bearer.py +39 -19
  10. pulumi_snowflake/api_integration.py +28 -54
  11. pulumi_snowflake/cortex_search_service.py +28 -0
  12. pulumi_snowflake/database.py +97 -148
  13. pulumi_snowflake/database_old.py +5 -77
  14. pulumi_snowflake/database_role.py +76 -42
  15. pulumi_snowflake/dynamic_table.py +33 -43
  16. pulumi_snowflake/email_notification_integration.py +28 -26
  17. pulumi_snowflake/external_function.py +38 -62
  18. pulumi_snowflake/external_oauth_integration.py +41 -21
  19. pulumi_snowflake/external_table.py +38 -58
  20. pulumi_snowflake/failover_group.py +38 -82
  21. pulumi_snowflake/file_format.py +28 -26
  22. pulumi_snowflake/function.py +33 -9
  23. pulumi_snowflake/get_cortex_search_services.py +16 -16
  24. pulumi_snowflake/get_database_roles.py +61 -38
  25. pulumi_snowflake/get_databases.py +4 -4
  26. pulumi_snowflake/get_dynamic_tables.py +12 -12
  27. pulumi_snowflake/get_grants.py +138 -138
  28. pulumi_snowflake/get_schemas.py +8 -8
  29. pulumi_snowflake/get_streamlits.py +8 -8
  30. pulumi_snowflake/get_users.py +96 -33
  31. pulumi_snowflake/get_views.py +92 -53
  32. pulumi_snowflake/grant_account_role.py +0 -4
  33. pulumi_snowflake/grant_application_role.py +0 -4
  34. pulumi_snowflake/grant_database_role.py +0 -4
  35. pulumi_snowflake/grant_ownership.py +5 -5
  36. pulumi_snowflake/grant_privileges_to_account_role.py +15 -15
  37. pulumi_snowflake/grant_privileges_to_database_role.py +16 -12
  38. pulumi_snowflake/grant_privileges_to_share.py +47 -0
  39. pulumi_snowflake/managed_account.py +28 -4
  40. pulumi_snowflake/masking_policy.py +33 -89
  41. pulumi_snowflake/materialized_view.py +33 -39
  42. pulumi_snowflake/network_policy.py +47 -49
  43. pulumi_snowflake/network_policy_attachment.py +0 -30
  44. pulumi_snowflake/network_rule.py +28 -66
  45. pulumi_snowflake/notification_integration.py +28 -34
  46. pulumi_snowflake/oauth_integration.py +0 -34
  47. pulumi_snowflake/oauth_integration_for_custom_clients.py +39 -105
  48. pulumi_snowflake/oauth_integration_for_partner_applications.py +39 -19
  49. pulumi_snowflake/object_parameter.py +5 -103
  50. pulumi_snowflake/outputs.py +11648 -3842
  51. pulumi_snowflake/password_policy.py +28 -28
  52. pulumi_snowflake/pipe.py +28 -4
  53. pulumi_snowflake/procedure.py +33 -9
  54. pulumi_snowflake/provider.py +16 -16
  55. pulumi_snowflake/pulumi-plugin.json +1 -1
  56. pulumi_snowflake/resource_monitor.py +28 -48
  57. pulumi_snowflake/role.py +51 -32
  58. pulumi_snowflake/row_access_policy.py +28 -34
  59. pulumi_snowflake/saml2_integration.py +39 -19
  60. pulumi_snowflake/saml_integration.py +0 -34
  61. pulumi_snowflake/schema.py +45 -25
  62. pulumi_snowflake/scim_integration.py +39 -19
  63. pulumi_snowflake/secondary_database.py +35 -19
  64. pulumi_snowflake/sequence.py +4 -36
  65. pulumi_snowflake/session_parameter.py +0 -32
  66. pulumi_snowflake/share.py +28 -28
  67. pulumi_snowflake/shared_database.py +35 -15
  68. pulumi_snowflake/stage.py +33 -33
  69. pulumi_snowflake/storage_integration.py +28 -4
  70. pulumi_snowflake/stream.py +28 -4
  71. pulumi_snowflake/streamlit.py +39 -19
  72. pulumi_snowflake/table.py +43 -47
  73. pulumi_snowflake/table_column_masking_policy_application.py +2 -14
  74. pulumi_snowflake/table_constraint.py +5 -157
  75. pulumi_snowflake/tag.py +28 -40
  76. pulumi_snowflake/tag_association.py +5 -125
  77. pulumi_snowflake/tag_masking_policy_association.py +0 -4
  78. pulumi_snowflake/task.py +28 -92
  79. pulumi_snowflake/unsafe_execute.py +2 -20
  80. pulumi_snowflake/user.py +3341 -368
  81. pulumi_snowflake/user_password_policy_attachment.py +0 -36
  82. pulumi_snowflake/view.py +465 -185
  83. pulumi_snowflake/warehouse.py +39 -43
  84. {pulumi_snowflake-0.57.1a1722856643.dist-info → pulumi_snowflake-0.58.0.dist-info}/METADATA +1 -1
  85. pulumi_snowflake-0.58.0.dist-info/RECORD +129 -0
  86. {pulumi_snowflake-0.57.1a1722856643.dist-info → pulumi_snowflake-0.58.0.dist-info}/WHEEL +1 -1
  87. pulumi_snowflake-0.57.1a1722856643.dist-info/RECORD +0 -129
  88. {pulumi_snowflake-0.57.1a1722856643.dist-info → pulumi_snowflake-0.58.0.dist-info}/top_level.txt +0 -0
@@ -130,9 +130,9 @@ class AwaitableGetSchemasResult(GetSchemasResult):
130
130
  with_parameters=self.with_parameters)
131
131
 
132
132
 
133
- def get_schemas(in_: Optional[pulumi.InputType['GetSchemasInArgs']] = None,
133
+ def get_schemas(in_: Optional[Union['GetSchemasInArgs', 'GetSchemasInArgsDict']] = None,
134
134
  like: Optional[str] = None,
135
- limit: Optional[pulumi.InputType['GetSchemasLimitArgs']] = None,
135
+ limit: Optional[Union['GetSchemasLimitArgs', 'GetSchemasLimitArgsDict']] = None,
136
136
  starts_with: Optional[str] = None,
137
137
  with_describe: Optional[bool] = None,
138
138
  with_parameters: Optional[bool] = None,
@@ -143,9 +143,9 @@ def get_schemas(in_: Optional[pulumi.InputType['GetSchemasInArgs']] = None,
143
143
  Datasource used to get details of filtered schemas. Filtering is aligned with the current possibilities for [SHOW SCHEMAS](https://docs.snowflake.com/en/sql-reference/sql/show-schemas) query. The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection.
144
144
 
145
145
 
146
- :param pulumi.InputType['GetSchemasInArgs'] in_: IN clause to filter the list of streamlits
146
+ :param Union['GetSchemasInArgs', 'GetSchemasInArgsDict'] in_: IN clause to filter the list of streamlits
147
147
  :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
148
- :param pulumi.InputType['GetSchemasLimitArgs'] 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`.
148
+ :param Union['GetSchemasLimitArgs', 'GetSchemasLimitArgsDict'] 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`.
149
149
  :param str starts_with: Filters the output with **case-sensitive** characters indicating the beginning of the object name.
150
150
  :param bool with_describe: Runs DESC SCHEMA for each schema returned by SHOW SCHEMAS. The output of describe is saved to the description field. By default this value is set to true.
151
151
  :param bool with_parameters: Runs SHOW PARAMETERS FOR SCHEMA for each schema returned by SHOW SCHEMAS. The output of describe is saved to the parameters field as a map. By default this value is set to true.
@@ -172,9 +172,9 @@ def get_schemas(in_: Optional[pulumi.InputType['GetSchemasInArgs']] = None,
172
172
 
173
173
 
174
174
  @_utilities.lift_output_func(get_schemas)
175
- def get_schemas_output(in_: Optional[pulumi.Input[Optional[pulumi.InputType['GetSchemasInArgs']]]] = None,
175
+ def get_schemas_output(in_: Optional[pulumi.Input[Optional[Union['GetSchemasInArgs', 'GetSchemasInArgsDict']]]] = None,
176
176
  like: Optional[pulumi.Input[Optional[str]]] = None,
177
- limit: Optional[pulumi.Input[Optional[pulumi.InputType['GetSchemasLimitArgs']]]] = None,
177
+ limit: Optional[pulumi.Input[Optional[Union['GetSchemasLimitArgs', 'GetSchemasLimitArgsDict']]]] = None,
178
178
  starts_with: Optional[pulumi.Input[Optional[str]]] = None,
179
179
  with_describe: Optional[pulumi.Input[Optional[bool]]] = None,
180
180
  with_parameters: Optional[pulumi.Input[Optional[bool]]] = None,
@@ -185,9 +185,9 @@ def get_schemas_output(in_: Optional[pulumi.Input[Optional[pulumi.InputType['Get
185
185
  Datasource used to get details of filtered schemas. Filtering is aligned with the current possibilities for [SHOW SCHEMAS](https://docs.snowflake.com/en/sql-reference/sql/show-schemas) query. The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection.
186
186
 
187
187
 
188
- :param pulumi.InputType['GetSchemasInArgs'] in_: IN clause to filter the list of streamlits
188
+ :param Union['GetSchemasInArgs', 'GetSchemasInArgsDict'] in_: IN clause to filter the list of streamlits
189
189
  :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
190
- :param pulumi.InputType['GetSchemasLimitArgs'] 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`.
190
+ :param Union['GetSchemasLimitArgs', 'GetSchemasLimitArgsDict'] 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`.
191
191
  :param str starts_with: Filters the output with **case-sensitive** characters indicating the beginning of the object name.
192
192
  :param bool with_describe: Runs DESC SCHEMA for each schema returned by SHOW SCHEMAS. The output of describe is saved to the description field. By default this value is set to true.
193
193
  :param bool with_parameters: Runs SHOW PARAMETERS FOR SCHEMA for each schema returned by SHOW SCHEMAS. The output of describe is saved to the parameters field as a map. By default this value is set to true.
@@ -106,9 +106,9 @@ class AwaitableGetStreamlitsResult(GetStreamlitsResult):
106
106
  with_describe=self.with_describe)
107
107
 
108
108
 
109
- def get_streamlits(in_: Optional[pulumi.InputType['GetStreamlitsInArgs']] = None,
109
+ def get_streamlits(in_: Optional[Union['GetStreamlitsInArgs', 'GetStreamlitsInArgsDict']] = None,
110
110
  like: Optional[str] = None,
111
- limit: Optional[pulumi.InputType['GetStreamlitsLimitArgs']] = None,
111
+ limit: Optional[Union['GetStreamlitsLimitArgs', 'GetStreamlitsLimitArgsDict']] = None,
112
112
  with_describe: Optional[bool] = None,
113
113
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetStreamlitsResult:
114
114
  """
@@ -117,9 +117,9 @@ def get_streamlits(in_: Optional[pulumi.InputType['GetStreamlitsInArgs']] = None
117
117
  Datasource used to get details of filtered streamlits. Filtering is aligned with the current possibilities for [SHOW STREAMLITS](https://docs.snowflake.com/en/sql-reference/sql/show-streamlits) query (only `like` is supported). The results of SHOW and DESCRIBE are encapsulated in one output collection `streamlits`.
118
118
 
119
119
 
120
- :param pulumi.InputType['GetStreamlitsInArgs'] in_: IN clause to filter the list of streamlits
120
+ :param Union['GetStreamlitsInArgs', 'GetStreamlitsInArgsDict'] in_: IN clause to filter the list of streamlits
121
121
  :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
122
- :param pulumi.InputType['GetStreamlitsLimitArgs'] 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`.
122
+ :param Union['GetStreamlitsLimitArgs', 'GetStreamlitsLimitArgsDict'] 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`.
123
123
  :param bool with_describe: Runs DESC STREAMLIT for each streamlit returned by SHOW STREAMLITS. The output of describe is saved to the description field. By default this value is set to true.
124
124
  """
125
125
  __args__ = dict()
@@ -140,9 +140,9 @@ def get_streamlits(in_: Optional[pulumi.InputType['GetStreamlitsInArgs']] = None
140
140
 
141
141
 
142
142
  @_utilities.lift_output_func(get_streamlits)
143
- def get_streamlits_output(in_: Optional[pulumi.Input[Optional[pulumi.InputType['GetStreamlitsInArgs']]]] = None,
143
+ def get_streamlits_output(in_: Optional[pulumi.Input[Optional[Union['GetStreamlitsInArgs', 'GetStreamlitsInArgsDict']]]] = None,
144
144
  like: Optional[pulumi.Input[Optional[str]]] = None,
145
- limit: Optional[pulumi.Input[Optional[pulumi.InputType['GetStreamlitsLimitArgs']]]] = None,
145
+ limit: Optional[pulumi.Input[Optional[Union['GetStreamlitsLimitArgs', 'GetStreamlitsLimitArgsDict']]]] = None,
146
146
  with_describe: Optional[pulumi.Input[Optional[bool]]] = None,
147
147
  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetStreamlitsResult]:
148
148
  """
@@ -151,9 +151,9 @@ def get_streamlits_output(in_: Optional[pulumi.Input[Optional[pulumi.InputType['
151
151
  Datasource used to get details of filtered streamlits. Filtering is aligned with the current possibilities for [SHOW STREAMLITS](https://docs.snowflake.com/en/sql-reference/sql/show-streamlits) query (only `like` is supported). The results of SHOW and DESCRIBE are encapsulated in one output collection `streamlits`.
152
152
 
153
153
 
154
- :param pulumi.InputType['GetStreamlitsInArgs'] in_: IN clause to filter the list of streamlits
154
+ :param Union['GetStreamlitsInArgs', 'GetStreamlitsInArgsDict'] in_: IN clause to filter the list of streamlits
155
155
  :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
156
- :param pulumi.InputType['GetStreamlitsLimitArgs'] 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`.
156
+ :param Union['GetStreamlitsLimitArgs', 'GetStreamlitsLimitArgsDict'] 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`.
157
157
  :param bool with_describe: Runs DESC STREAMLIT for each streamlit returned by SHOW STREAMLITS. The output of describe is saved to the description field. By default this value is set to true.
158
158
  """
159
159
  ...
@@ -9,6 +9,7 @@ import pulumi.runtime
9
9
  from typing import Any, Mapping, Optional, Sequence, Union, overload
10
10
  from . import _utilities
11
11
  from . import outputs
12
+ from ._inputs import *
12
13
 
13
14
  __all__ = [
14
15
  'GetUsersResult',
@@ -22,16 +23,28 @@ class GetUsersResult:
22
23
  """
23
24
  A collection of values returned by getUsers.
24
25
  """
25
- def __init__(__self__, id=None, pattern=None, users=None):
26
+ def __init__(__self__, id=None, like=None, limit=None, starts_with=None, users=None, with_describe=None, with_parameters=None):
26
27
  if id and not isinstance(id, str):
27
28
  raise TypeError("Expected argument 'id' to be a str")
28
29
  pulumi.set(__self__, "id", id)
29
- if pattern and not isinstance(pattern, str):
30
- raise TypeError("Expected argument 'pattern' to be a str")
31
- pulumi.set(__self__, "pattern", pattern)
30
+ if like and not isinstance(like, str):
31
+ raise TypeError("Expected argument 'like' to be a str")
32
+ pulumi.set(__self__, "like", like)
33
+ if limit and not isinstance(limit, dict):
34
+ raise TypeError("Expected argument 'limit' to be a dict")
35
+ pulumi.set(__self__, "limit", limit)
36
+ if starts_with and not isinstance(starts_with, str):
37
+ raise TypeError("Expected argument 'starts_with' to be a str")
38
+ pulumi.set(__self__, "starts_with", starts_with)
32
39
  if users and not isinstance(users, list):
33
40
  raise TypeError("Expected argument 'users' to be a list")
34
41
  pulumi.set(__self__, "users", users)
42
+ if with_describe and not isinstance(with_describe, bool):
43
+ raise TypeError("Expected argument 'with_describe' to be a bool")
44
+ pulumi.set(__self__, "with_describe", with_describe)
45
+ if with_parameters and not isinstance(with_parameters, bool):
46
+ raise TypeError("Expected argument 'with_parameters' to be a bool")
47
+ pulumi.set(__self__, "with_parameters", with_parameters)
35
48
 
36
49
  @property
37
50
  @pulumi.getter
@@ -43,20 +56,52 @@ class GetUsersResult:
43
56
 
44
57
  @property
45
58
  @pulumi.getter
46
- def pattern(self) -> str:
59
+ def like(self) -> Optional[str]:
47
60
  """
48
- Users pattern for which to return metadata. Please refer to LIKE keyword from snowflake documentation : https://docs.snowflake.com/en/sql-reference/sql/show-users.html#parameters
61
+ Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
49
62
  """
50
- return pulumi.get(self, "pattern")
63
+ return pulumi.get(self, "like")
64
+
65
+ @property
66
+ @pulumi.getter
67
+ def limit(self) -> Optional['outputs.GetUsersLimitResult']:
68
+ """
69
+ 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`.
70
+ """
71
+ return pulumi.get(self, "limit")
72
+
73
+ @property
74
+ @pulumi.getter(name="startsWith")
75
+ def starts_with(self) -> Optional[str]:
76
+ """
77
+ Filters the output with **case-sensitive** characters indicating the beginning of the object name.
78
+ """
79
+ return pulumi.get(self, "starts_with")
51
80
 
52
81
  @property
53
82
  @pulumi.getter
54
83
  def users(self) -> Sequence['outputs.GetUsersUserResult']:
55
84
  """
56
- The users in the database
85
+ Holds the aggregated output of all user details queries.
57
86
  """
58
87
  return pulumi.get(self, "users")
59
88
 
89
+ @property
90
+ @pulumi.getter(name="withDescribe")
91
+ def with_describe(self) -> Optional[bool]:
92
+ """
93
+ Runs DESC USER for each user returned by SHOW USERS. The output of describe is saved to the description field. By default this value is set to true.
94
+ """
95
+ return pulumi.get(self, "with_describe")
96
+
97
+ @property
98
+ @pulumi.getter(name="withParameters")
99
+ def with_parameters(self) -> Optional[bool]:
100
+ """
101
+ Runs SHOW PARAMETERS FOR USER for each user returned by SHOW USERS. The output of describe is saved to the parameters field as a map. By default this value is set to true.
102
+ """
103
+ return pulumi.get(self, "with_parameters")
104
+
60
105
 
61
106
  class AwaitableGetUsersResult(GetUsersResult):
62
107
  # pylint: disable=using-constant-test
@@ -65,50 +110,68 @@ class AwaitableGetUsersResult(GetUsersResult):
65
110
  yield self
66
111
  return GetUsersResult(
67
112
  id=self.id,
68
- pattern=self.pattern,
69
- users=self.users)
70
-
71
-
72
- def get_users(pattern: Optional[str] = None,
113
+ like=self.like,
114
+ limit=self.limit,
115
+ starts_with=self.starts_with,
116
+ users=self.users,
117
+ with_describe=self.with_describe,
118
+ with_parameters=self.with_parameters)
119
+
120
+
121
+ def get_users(like: Optional[str] = None,
122
+ limit: Optional[Union['GetUsersLimitArgs', 'GetUsersLimitArgsDict']] = None,
123
+ starts_with: Optional[str] = None,
124
+ with_describe: Optional[bool] = None,
125
+ with_parameters: Optional[bool] = None,
73
126
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetUsersResult:
74
127
  """
75
- ## Example Usage
128
+ !> **V1 release candidate** This data source was reworked and is a release candidate for the V1. We do not expect significant changes in it before the V1. We will welcome any feedback and adjust the data source if needed. Any errors reported will be resolved with a higher priority. We encourage checking this data source out before the V1 release. Please follow the migration guide to use it.
76
129
 
77
- ```python
78
- import pulumi
79
- import pulumi_snowflake as snowflake
130
+ Datasource used to get details of filtered users. Filtering is aligned with the current possibilities for [SHOW USERS](https://docs.snowflake.com/en/sql-reference/sql/show-users) query. The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection. Important note is that when querying users you don't have permissions to, the querying options are limited. You won't get almost any field in `show_output` (only empty or default values), the DESCRIBE command cannot be called, so you have to set `with_describe = false`. Only `parameters` output is not affected by the lack of privileges.
80
131
 
81
- current = snowflake.get_users(pattern="user1")
82
- ```
83
132
 
84
-
85
- :param str pattern: Users pattern for which to return metadata. Please refer to LIKE keyword from snowflake documentation : https://docs.snowflake.com/en/sql-reference/sql/show-users.html#parameters
133
+ :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
134
+ :param Union['GetUsersLimitArgs', 'GetUsersLimitArgsDict'] 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`.
135
+ :param str starts_with: Filters the output with **case-sensitive** characters indicating the beginning of the object name.
136
+ :param bool with_describe: Runs DESC USER for each user returned by SHOW USERS. The output of describe is saved to the description field. By default this value is set to true.
137
+ :param bool with_parameters: Runs SHOW PARAMETERS FOR USER for each user returned by SHOW USERS. The output of describe is saved to the parameters field as a map. By default this value is set to true.
86
138
  """
87
139
  __args__ = dict()
88
- __args__['pattern'] = pattern
140
+ __args__['like'] = like
141
+ __args__['limit'] = limit
142
+ __args__['startsWith'] = starts_with
143
+ __args__['withDescribe'] = with_describe
144
+ __args__['withParameters'] = with_parameters
89
145
  opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
90
146
  __ret__ = pulumi.runtime.invoke('snowflake:index/getUsers:getUsers', __args__, opts=opts, typ=GetUsersResult).value
91
147
 
92
148
  return AwaitableGetUsersResult(
93
149
  id=pulumi.get(__ret__, 'id'),
94
- pattern=pulumi.get(__ret__, 'pattern'),
95
- users=pulumi.get(__ret__, 'users'))
150
+ like=pulumi.get(__ret__, 'like'),
151
+ limit=pulumi.get(__ret__, 'limit'),
152
+ starts_with=pulumi.get(__ret__, 'starts_with'),
153
+ users=pulumi.get(__ret__, 'users'),
154
+ with_describe=pulumi.get(__ret__, 'with_describe'),
155
+ with_parameters=pulumi.get(__ret__, 'with_parameters'))
96
156
 
97
157
 
98
158
  @_utilities.lift_output_func(get_users)
99
- def get_users_output(pattern: Optional[pulumi.Input[str]] = None,
159
+ def get_users_output(like: Optional[pulumi.Input[Optional[str]]] = None,
160
+ limit: Optional[pulumi.Input[Optional[Union['GetUsersLimitArgs', 'GetUsersLimitArgsDict']]]] = None,
161
+ starts_with: Optional[pulumi.Input[Optional[str]]] = None,
162
+ with_describe: Optional[pulumi.Input[Optional[bool]]] = None,
163
+ with_parameters: Optional[pulumi.Input[Optional[bool]]] = None,
100
164
  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetUsersResult]:
101
165
  """
102
- ## Example Usage
103
-
104
- ```python
105
- import pulumi
106
- import pulumi_snowflake as snowflake
166
+ !> **V1 release candidate** This data source was reworked and is a release candidate for the V1. We do not expect significant changes in it before the V1. We will welcome any feedback and adjust the data source if needed. Any errors reported will be resolved with a higher priority. We encourage checking this data source out before the V1 release. Please follow the migration guide to use it.
107
167
 
108
- current = snowflake.get_users(pattern="user1")
109
- ```
168
+ Datasource used to get details of filtered users. Filtering is aligned with the current possibilities for [SHOW USERS](https://docs.snowflake.com/en/sql-reference/sql/show-users) query. The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection. Important note is that when querying users you don't have permissions to, the querying options are limited. You won't get almost any field in `show_output` (only empty or default values), the DESCRIBE command cannot be called, so you have to set `with_describe = false`. Only `parameters` output is not affected by the lack of privileges.
110
169
 
111
170
 
112
- :param str pattern: Users pattern for which to return metadata. Please refer to LIKE keyword from snowflake documentation : https://docs.snowflake.com/en/sql-reference/sql/show-users.html#parameters
171
+ :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
172
+ :param Union['GetUsersLimitArgs', 'GetUsersLimitArgsDict'] 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`.
173
+ :param str starts_with: Filters the output with **case-sensitive** characters indicating the beginning of the object name.
174
+ :param bool with_describe: Runs DESC USER for each user returned by SHOW USERS. The output of describe is saved to the description field. By default this value is set to true.
175
+ :param bool with_parameters: Runs SHOW PARAMETERS FOR USER for each user returned by SHOW USERS. The output of describe is saved to the parameters field as a map. By default this value is set to true.
113
176
  """
114
177
  ...
@@ -9,6 +9,7 @@ import pulumi.runtime
9
9
  from typing import Any, Mapping, Optional, Sequence, Union, overload
10
10
  from . import _utilities
11
11
  from . import outputs
12
+ from ._inputs import *
12
13
 
13
14
  __all__ = [
14
15
  'GetViewsResult',
@@ -22,52 +23,85 @@ class GetViewsResult:
22
23
  """
23
24
  A collection of values returned by getViews.
24
25
  """
25
- def __init__(__self__, database=None, id=None, schema=None, views=None):
26
- if database and not isinstance(database, str):
27
- raise TypeError("Expected argument 'database' to be a str")
28
- pulumi.set(__self__, "database", database)
26
+ def __init__(__self__, id=None, in_=None, like=None, limit=None, starts_with=None, views=None, with_describe=None):
29
27
  if id and not isinstance(id, str):
30
28
  raise TypeError("Expected argument 'id' to be a str")
31
29
  pulumi.set(__self__, "id", id)
32
- if schema and not isinstance(schema, str):
33
- raise TypeError("Expected argument 'schema' to be a str")
34
- pulumi.set(__self__, "schema", schema)
30
+ if in_ and not isinstance(in_, dict):
31
+ raise TypeError("Expected argument 'in_' to be a dict")
32
+ pulumi.set(__self__, "in_", in_)
33
+ if like and not isinstance(like, str):
34
+ raise TypeError("Expected argument 'like' to be a str")
35
+ pulumi.set(__self__, "like", like)
36
+ if limit and not isinstance(limit, dict):
37
+ raise TypeError("Expected argument 'limit' to be a dict")
38
+ pulumi.set(__self__, "limit", limit)
39
+ if starts_with and not isinstance(starts_with, str):
40
+ raise TypeError("Expected argument 'starts_with' to be a str")
41
+ pulumi.set(__self__, "starts_with", starts_with)
35
42
  if views and not isinstance(views, list):
36
43
  raise TypeError("Expected argument 'views' to be a list")
37
44
  pulumi.set(__self__, "views", views)
45
+ if with_describe and not isinstance(with_describe, bool):
46
+ raise TypeError("Expected argument 'with_describe' to be a bool")
47
+ pulumi.set(__self__, "with_describe", with_describe)
38
48
 
39
49
  @property
40
50
  @pulumi.getter
41
- def database(self) -> str:
51
+ def id(self) -> str:
52
+ """
53
+ The provider-assigned unique ID for this managed resource.
54
+ """
55
+ return pulumi.get(self, "id")
56
+
57
+ @property
58
+ @pulumi.getter(name="in")
59
+ def in_(self) -> Optional['outputs.GetViewsInResult']:
42
60
  """
43
- The database from which to return the schemas from.
61
+ IN clause to filter the list of views
44
62
  """
45
- return pulumi.get(self, "database")
63
+ return pulumi.get(self, "in_")
46
64
 
47
65
  @property
48
66
  @pulumi.getter
49
- def id(self) -> str:
67
+ def like(self) -> Optional[str]:
50
68
  """
51
- The provider-assigned unique ID for this managed resource.
69
+ Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
52
70
  """
53
- return pulumi.get(self, "id")
71
+ return pulumi.get(self, "like")
54
72
 
55
73
  @property
56
74
  @pulumi.getter
57
- def schema(self) -> str:
75
+ def limit(self) -> Optional['outputs.GetViewsLimitResult']:
76
+ """
77
+ 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`.
78
+ """
79
+ return pulumi.get(self, "limit")
80
+
81
+ @property
82
+ @pulumi.getter(name="startsWith")
83
+ def starts_with(self) -> Optional[str]:
58
84
  """
59
- The schema from which to return the views from.
85
+ Filters the output with **case-sensitive** characters indicating the beginning of the object name.
60
86
  """
61
- return pulumi.get(self, "schema")
87
+ return pulumi.get(self, "starts_with")
62
88
 
63
89
  @property
64
90
  @pulumi.getter
65
91
  def views(self) -> Sequence['outputs.GetViewsViewResult']:
66
92
  """
67
- The views in the schema
93
+ Holds the aggregated output of all views details queries.
68
94
  """
69
95
  return pulumi.get(self, "views")
70
96
 
97
+ @property
98
+ @pulumi.getter(name="withDescribe")
99
+ def with_describe(self) -> Optional[bool]:
100
+ """
101
+ 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.
102
+ """
103
+ return pulumi.get(self, "with_describe")
104
+
71
105
 
72
106
  class AwaitableGetViewsResult(GetViewsResult):
73
107
  # pylint: disable=using-constant-test
@@ -75,60 +109,65 @@ class AwaitableGetViewsResult(GetViewsResult):
75
109
  if False:
76
110
  yield self
77
111
  return GetViewsResult(
78
- database=self.database,
79
112
  id=self.id,
80
- schema=self.schema,
81
- views=self.views)
82
-
83
-
84
- def get_views(database: Optional[str] = None,
85
- schema: Optional[str] = None,
113
+ in_=self.in_,
114
+ like=self.like,
115
+ limit=self.limit,
116
+ starts_with=self.starts_with,
117
+ views=self.views,
118
+ with_describe=self.with_describe)
119
+
120
+
121
+ def get_views(in_: Optional[Union['GetViewsInArgs', 'GetViewsInArgsDict']] = None,
122
+ like: Optional[str] = None,
123
+ limit: Optional[Union['GetViewsLimitArgs', 'GetViewsLimitArgsDict']] = None,
124
+ starts_with: Optional[str] = None,
125
+ with_describe: Optional[bool] = None,
86
126
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetViewsResult:
87
127
  """
88
- ## Example Usage
89
-
90
- ```python
91
- import pulumi
92
- import pulumi_snowflake as snowflake
128
+ Datasource 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`.
93
129
 
94
- current = snowflake.get_views(database="MYDB",
95
- schema="MYSCHEMA")
96
- ```
97
130
 
98
-
99
- :param str database: The database from which to return the schemas from.
100
- :param str schema: The schema from which to return the views from.
131
+ :param Union['GetViewsInArgs', 'GetViewsInArgsDict'] in_: IN clause to filter the list of views
132
+ :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
133
+ :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`.
134
+ :param str starts_with: Filters the output with **case-sensitive** characters indicating the beginning of the object name.
135
+ :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.
101
136
  """
102
137
  __args__ = dict()
103
- __args__['database'] = database
104
- __args__['schema'] = schema
138
+ __args__['in'] = in_
139
+ __args__['like'] = like
140
+ __args__['limit'] = limit
141
+ __args__['startsWith'] = starts_with
142
+ __args__['withDescribe'] = with_describe
105
143
  opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
106
144
  __ret__ = pulumi.runtime.invoke('snowflake:index/getViews:getViews', __args__, opts=opts, typ=GetViewsResult).value
107
145
 
108
146
  return AwaitableGetViewsResult(
109
- database=pulumi.get(__ret__, 'database'),
110
147
  id=pulumi.get(__ret__, 'id'),
111
- schema=pulumi.get(__ret__, 'schema'),
112
- views=pulumi.get(__ret__, 'views'))
148
+ in_=pulumi.get(__ret__, 'in_'),
149
+ like=pulumi.get(__ret__, 'like'),
150
+ limit=pulumi.get(__ret__, 'limit'),
151
+ starts_with=pulumi.get(__ret__, 'starts_with'),
152
+ views=pulumi.get(__ret__, 'views'),
153
+ with_describe=pulumi.get(__ret__, 'with_describe'))
113
154
 
114
155
 
115
156
  @_utilities.lift_output_func(get_views)
116
- def get_views_output(database: Optional[pulumi.Input[str]] = None,
117
- schema: Optional[pulumi.Input[str]] = None,
157
+ def get_views_output(in_: Optional[pulumi.Input[Optional[Union['GetViewsInArgs', 'GetViewsInArgsDict']]]] = None,
158
+ like: Optional[pulumi.Input[Optional[str]]] = None,
159
+ limit: Optional[pulumi.Input[Optional[Union['GetViewsLimitArgs', 'GetViewsLimitArgsDict']]]] = None,
160
+ starts_with: Optional[pulumi.Input[Optional[str]]] = None,
161
+ with_describe: Optional[pulumi.Input[Optional[bool]]] = None,
118
162
  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetViewsResult]:
119
163
  """
120
- ## Example Usage
121
-
122
- ```python
123
- import pulumi
124
- import pulumi_snowflake as snowflake
125
-
126
- current = snowflake.get_views(database="MYDB",
127
- schema="MYSCHEMA")
128
- ```
164
+ Datasource 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`.
129
165
 
130
166
 
131
- :param str database: The database from which to return the schemas from.
132
- :param str schema: The schema from which to return the views from.
167
+ :param Union['GetViewsInArgs', 'GetViewsInArgsDict'] in_: IN clause to filter the list of views
168
+ :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
169
+ :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`.
170
+ :param str starts_with: Filters the output with **case-sensitive** characters indicating the beginning of the object name.
171
+ :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.
133
172
  """
134
173
  ...
@@ -132,8 +132,6 @@ class GrantAccountRole(pulumi.CustomResource):
132
132
  user_name: Optional[pulumi.Input[str]] = None,
133
133
  __props__=None):
134
134
  """
135
- ## Example Usage
136
-
137
135
  ## Import
138
136
 
139
137
  format is role_name (string) | grantee_object_type (ROLE|USER) | grantee_name (string)
@@ -155,8 +153,6 @@ class GrantAccountRole(pulumi.CustomResource):
155
153
  args: GrantAccountRoleArgs,
156
154
  opts: Optional[pulumi.ResourceOptions] = None):
157
155
  """
158
- ## Example Usage
159
-
160
156
  ## Import
161
157
 
162
158
  format is role_name (string) | grantee_object_type (ROLE|USER) | grantee_name (string)
@@ -132,8 +132,6 @@ class GrantApplicationRole(pulumi.CustomResource):
132
132
  parent_account_role_name: Optional[pulumi.Input[str]] = None,
133
133
  __props__=None):
134
134
  """
135
- ## Example Usage
136
-
137
135
  ## Import
138
136
 
139
137
  format is application_role_name (string) | object_type (ACCOUNT_ROLE|APPLICATION) | grantee_name (string)
@@ -155,8 +153,6 @@ class GrantApplicationRole(pulumi.CustomResource):
155
153
  args: GrantApplicationRoleArgs,
156
154
  opts: Optional[pulumi.ResourceOptions] = None):
157
155
  """
158
- ## Example Usage
159
-
160
156
  ## Import
161
157
 
162
158
  format is application_role_name (string) | object_type (ACCOUNT_ROLE|APPLICATION) | grantee_name (string)
@@ -165,8 +165,6 @@ class GrantDatabaseRole(pulumi.CustomResource):
165
165
  share_name: Optional[pulumi.Input[str]] = None,
166
166
  __props__=None):
167
167
  """
168
- ## Example Usage
169
-
170
168
  ## Import
171
169
 
172
170
  format is database_role_name (string) | object_type (ROLE|DATABASE ROLE|SHARE) | grantee_name (string)
@@ -189,8 +187,6 @@ class GrantDatabaseRole(pulumi.CustomResource):
189
187
  args: GrantDatabaseRoleArgs,
190
188
  opts: Optional[pulumi.ResourceOptions] = None):
191
189
  """
192
- ## Example Usage
193
-
194
190
  ## Import
195
191
 
196
192
  format is database_role_name (string) | object_type (ROLE|DATABASE ROLE|SHARE) | grantee_name (string)
@@ -163,7 +163,7 @@ class GrantOwnership(pulumi.CustomResource):
163
163
  opts: Optional[pulumi.ResourceOptions] = None,
164
164
  account_role_name: Optional[pulumi.Input[str]] = None,
165
165
  database_role_name: Optional[pulumi.Input[str]] = None,
166
- on: Optional[pulumi.Input[pulumi.InputType['GrantOwnershipOnArgs']]] = None,
166
+ on: Optional[pulumi.Input[Union['GrantOwnershipOnArgs', 'GrantOwnershipOnArgsDict']]] = None,
167
167
  outbound_privileges: Optional[pulumi.Input[str]] = None,
168
168
  __props__=None):
169
169
  """
@@ -217,7 +217,7 @@ class GrantOwnership(pulumi.CustomResource):
217
217
  :param pulumi.ResourceOptions opts: Options for the resource.
218
218
  :param pulumi.Input[str] account_role_name: The fully qualified name of the account role to which privileges will be granted.
219
219
  :param pulumi.Input[str] database_role_name: The fully qualified name of the database role to which privileges will be granted.
220
- :param pulumi.Input[pulumi.InputType['GrantOwnershipOnArgs']] on: Configures which object(s) should transfer their ownership to the specified role.
220
+ :param pulumi.Input[Union['GrantOwnershipOnArgs', 'GrantOwnershipOnArgsDict']] on: Configures which object(s) should transfer their ownership to the specified role.
221
221
  :param pulumi.Input[str] outbound_privileges: Specifies whether to remove or transfer all existing outbound privileges on the object when ownership is transferred to a new role. Available options are: REVOKE for removing existing privileges and COPY to transfer them with ownership. For more information head over to [Snowflake documentation](https://docs.snowflake.com/en/sql-reference/sql/grant-ownership#optional-parameters).
222
222
  """
223
223
  ...
@@ -290,7 +290,7 @@ class GrantOwnership(pulumi.CustomResource):
290
290
  opts: Optional[pulumi.ResourceOptions] = None,
291
291
  account_role_name: Optional[pulumi.Input[str]] = None,
292
292
  database_role_name: Optional[pulumi.Input[str]] = None,
293
- on: Optional[pulumi.Input[pulumi.InputType['GrantOwnershipOnArgs']]] = None,
293
+ on: Optional[pulumi.Input[Union['GrantOwnershipOnArgs', 'GrantOwnershipOnArgsDict']]] = None,
294
294
  outbound_privileges: Optional[pulumi.Input[str]] = None,
295
295
  __props__=None):
296
296
  opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
@@ -319,7 +319,7 @@ class GrantOwnership(pulumi.CustomResource):
319
319
  opts: Optional[pulumi.ResourceOptions] = None,
320
320
  account_role_name: Optional[pulumi.Input[str]] = None,
321
321
  database_role_name: Optional[pulumi.Input[str]] = None,
322
- on: Optional[pulumi.Input[pulumi.InputType['GrantOwnershipOnArgs']]] = None,
322
+ on: Optional[pulumi.Input[Union['GrantOwnershipOnArgs', 'GrantOwnershipOnArgsDict']]] = None,
323
323
  outbound_privileges: Optional[pulumi.Input[str]] = None) -> 'GrantOwnership':
324
324
  """
325
325
  Get an existing GrantOwnership resource's state with the given name, id, and optional extra
@@ -330,7 +330,7 @@ class GrantOwnership(pulumi.CustomResource):
330
330
  :param pulumi.ResourceOptions opts: Options for the resource.
331
331
  :param pulumi.Input[str] account_role_name: The fully qualified name of the account role to which privileges will be granted.
332
332
  :param pulumi.Input[str] database_role_name: The fully qualified name of the database role to which privileges will be granted.
333
- :param pulumi.Input[pulumi.InputType['GrantOwnershipOnArgs']] on: Configures which object(s) should transfer their ownership to the specified role.
333
+ :param pulumi.Input[Union['GrantOwnershipOnArgs', 'GrantOwnershipOnArgsDict']] on: Configures which object(s) should transfer their ownership to the specified role.
334
334
  :param pulumi.Input[str] outbound_privileges: Specifies whether to remove or transfer all existing outbound privileges on the object when ownership is transferred to a new role. Available options are: REVOKE for removing existing privileges and COPY to transfer them with ownership. For more information head over to [Snowflake documentation](https://docs.snowflake.com/en/sql-reference/sql/grant-ownership#optional-parameters).
335
335
  """
336
336
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))