pulumi-alicloud 3.86.0a1758340042__py3-none-any.whl → 3.89.0a1763702747__py3-none-any.whl

pulumi_alicloud/pulumi-plugin.json

@@ -1,5 +1,5 @@
 {
   "resource": true,
   "name": "alicloud",
-  "version": "3.86.0-alpha.1758340042"
+  "version": "3.89.0-alpha.1763702747"
 }

pulumi_alicloud/pvtz/get_service.py

@@ -75,21 +75,23 @@ def get_service(enable: Optional[_builtins.str] = None,
     """
     Using this data source can open Private Zone service automatically. If the service has been opened, it will return opened.
 
-    For information about Priavte Zone and how to use it, see [What is Private Zone](https://www.alibabacloud.com/help/en/product/64583.htm).
+    For information about Private Zone and how to use it, see [What is Private Zone](https://www.alibabacloud.com/help/en/product/64583.htm).
 
-    > **NOTE:** Available in v1.114.0+
+    > **NOTE:** Available since v1.114.0.
 
     ## Example Usage
 
+    Basic Usage
+
     ```python
     import pulumi
     import pulumi_alicloud as alicloud
 
-    open = alicloud.pvtz.get_service(enable="On")
+    default = alicloud.pvtz.get_service(enable="On")
     ```
 
 
-    :param _builtins.str enable: Setting the value to `On` to enable the service. If has been enabled, return the result. Valid values: "On" or "Off". Default to "Off".
+    :param _builtins.str enable: Setting the value to `On` to enable the service. If has been enabled, return the result. Default value: `Off`. Valid values: `On` and `Off`.
            
            > **NOTE:** Setting `enable = "On"` to open the Private Zone service that means you have read and agreed the [Private Zone Terms of Service](https://help.aliyun.com/document_detail/65657.html). The service can not closed once it is opened.
     """
@@ -107,21 +109,23 @@ def get_service_output(enable: Optional[pulumi.Input[Optional[_builtins.str]]] =
     """
     Using this data source can open Private Zone service automatically. If the service has been opened, it will return opened.
 
-    For information about Priavte Zone and how to use it, see [What is Private Zone](https://www.alibabacloud.com/help/en/product/64583.htm).
+    For information about Private Zone and how to use it, see [What is Private Zone](https://www.alibabacloud.com/help/en/product/64583.htm).
 
-    > **NOTE:** Available in v1.114.0+
+    > **NOTE:** Available since v1.114.0.
 
     ## Example Usage
 
+    Basic Usage
+
     ```python
     import pulumi
     import pulumi_alicloud as alicloud
 
-    open = alicloud.pvtz.get_service(enable="On")
+    default = alicloud.pvtz.get_service(enable="On")
     ```
 
 
-    :param _builtins.str enable: Setting the value to `On` to enable the service. If has been enabled, return the result. Valid values: "On" or "Off". Default to "Off".
+    :param _builtins.str enable: Setting the value to `On` to enable the service. If has been enabled, return the result. Default value: `Off`. Valid values: `On` and `Off`.
            
            > **NOTE:** Setting `enable = "On"` to open the Private Zone service that means you have read and agreed the [Private Zone Terms of Service](https://help.aliyun.com/document_detail/65657.html). The service can not closed once it is opened.
     """

pulumi_alicloud/ram/get_policies.py

@@ -27,7 +27,7 @@ class GetPoliciesResult:
     """
     A collection of values returned by getPolicies.
     """
-    def __init__(__self__, enable_details=None, group_name=None, id=None, ids=None, name_regex=None, names=None, output_file=None, policies=None, role_name=None, type=None, user_name=None):
+    def __init__(__self__, enable_details=None, group_name=None, id=None, ids=None, name_regex=None, names=None, output_file=None, policies=None, role_name=None, tags=None, type=None, user_name=None):
         if enable_details and not isinstance(enable_details, bool):
             raise TypeError("Expected argument 'enable_details' to be a bool")
         pulumi.set(__self__, "enable_details", enable_details)
@@ -55,6 +55,9 @@ class GetPoliciesResult:
         if role_name and not isinstance(role_name, str):
             raise TypeError("Expected argument 'role_name' to be a str")
         pulumi.set(__self__, "role_name", role_name)
+        if tags and not isinstance(tags, dict):
+            raise TypeError("Expected argument 'tags' to be a dict")
+        pulumi.set(__self__, "tags", tags)
         if type and not isinstance(type, str):
             raise TypeError("Expected argument 'type' to be a str")
         pulumi.set(__self__, "type", type)
@@ -94,7 +97,7 @@ class GetPoliciesResult:
     @pulumi.getter
     def names(self) -> Sequence[_builtins.str]:
         """
-        A list of ram group names.
+        (Available since v1.42.0) A list of Policy names.
         """
         return pulumi.get(self, "names")
 
@@ -107,7 +110,7 @@ class GetPoliciesResult:
     @pulumi.getter
     def policies(self) -> Sequence['outputs.GetPoliciesPolicyResult']:
         """
-        A list of policies. Each element contains the following attributes:
+        A list of Policy. Each element contains the following attributes:
         """
         return pulumi.get(self, "policies")
 
@@ -116,11 +119,19 @@ class GetPoliciesResult:
     def role_name(self) -> Optional[_builtins.str]:
         return pulumi.get(self, "role_name")
 
+    @_builtins.property
+    @pulumi.getter
+    def tags(self) -> Optional[Mapping[str, _builtins.str]]:
+        """
+        (Available since v1.262.1) The tags of the Policy.
+        """
+        return pulumi.get(self, "tags")
+
     @_builtins.property
     @pulumi.getter
     def type(self) -> Optional[_builtins.str]:
         """
-        Type of the policy.
+        The type of the policy.
         """
         return pulumi.get(self, "type")
 
@@ -128,7 +139,7 @@ class GetPoliciesResult:
     @pulumi.getter(name="userName")
     def user_name(self) -> Optional[_builtins.str]:
         """
-        The user name of  policy.
+        (Removed since v1.262.1) Field `user_name` has been removed from provider version 1.262.1.
         """
         return pulumi.get(self, "user_name")
 
@@ -148,6 +159,7 @@ class AwaitableGetPoliciesResult(GetPoliciesResult):
             output_file=self.output_file,
             policies=self.policies,
             role_name=self.role_name,
+            tags=self.tags,
             type=self.type,
             user_name=self.user_name)
 
@@ -158,65 +170,64 @@ def get_policies(enable_details: Optional[_builtins.bool] = None,
                  name_regex: Optional[_builtins.str] = None,
                  output_file: Optional[_builtins.str] = None,
                  role_name: Optional[_builtins.str] = None,
+                 tags: Optional[Mapping[str, _builtins.str]] = None,
                  type: Optional[_builtins.str] = None,
                  user_name: Optional[_builtins.str] = None,
                  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetPoliciesResult:
     """
-    This data source provides a list of RAM policies in an Alibaba Cloud account according to the specified filters.
+    This data source provides the RAM Policies of the current Alibaba Cloud user.
 
-    > **NOTE:** Available since v1.0.0+.
+    > **NOTE:** Available since v1.0.0.
 
     ## Example Usage
 
+    Basic Usage
+
     ```python
     import pulumi
     import pulumi_alicloud as alicloud
     import pulumi_random as random
 
+    config = pulumi.Config()
+    name = config.get("name")
+    if name is None:
+        name = "terraform-example"
     default = random.index.Integer("default",
         min=10000,
         max=99999)
-    group = alicloud.ram.Group("group",
-        name=f"groupName-{default['result']}",
-        comments="this is a group comments.")
-    policy = alicloud.ram.Policy("policy",
-        policy_name=f"tf-example-{default['result']}",
-        policy_document=\"\"\"    {
-          \\"Statement\\": [
-            {
-              \\"Action\\": [
-                \\"oss:ListObjects\\",
-                \\"oss:GetObject\\"
-              ],
-              \\"Effect\\": \\"Allow\\",
-              \\"Resource\\": [
-                \\"acs:oss:*:*:mybucket\\",
-                \\"acs:oss:*:*:mybucket/*\\"
-              ]
-            }
-          ],
-            \\"Version\\": \\"1\\"
-        }
+    default_policy = alicloud.ram.Policy("default",
+        policy_name=f"{name}-{default['result']}",
+        description=f"{name}-{default['result']}",
+        force=True,
+        policy_document=\"\"\"  {
+        \\"Statement\\": [
+          {
+            \\"Effect\\": \\"Allow\\",
+            \\"Action\\": \\"*\\",
+            \\"Resource\\": \\"*\\"
+          }
+        ],
+        \\"Version\\": \\"1\\"
+      }
     \"\"\",
-        description="this is a policy test")
-    attach = alicloud.ram.GroupPolicyAttachment("attach",
-        policy_name=policy.policy_name,
-        policy_type=policy.type,
-        group_name=group.name)
-    policies_ds = alicloud.ram.get_policies_output(group_name=attach.group_name,
-        type="Custom")
-    pulumi.export("firstPolicyName", policies_ds.policies[0].name)
+        tags={
+            "Created": "TF",
+            "For": "Policy",
+        })
+    ids = alicloud.ram.get_policies_output(ids=[default_policy.id])
+    pulumi.export("ramPoliciesId0", ids.policies[0].id)
     ```
 
 
-    :param _builtins.bool enable_details: Default to `true`. Set it to true can output more details.
-    :param _builtins.str group_name: Filter results by a specific group name. Returned policies are attached to the specified group.
-    :param Sequence[_builtins.str] ids: A list of ram group IDs.
-    :param _builtins.str name_regex: A regex string to filter resulting policies by name.
+    :param _builtins.bool enable_details: Whether to query the detailed list of resource attributes. Default value: `true`.
+    :param _builtins.str group_name: The name of the user group.
+    :param Sequence[_builtins.str] ids: A list of Policy IDs.
+    :param _builtins.str name_regex: A regex string to filter results by Policy name.
     :param _builtins.str output_file: File name where to save data source results (after running `pulumi preview`).
-    :param _builtins.str role_name: Filter results by a specific role name. Returned policies are attached to the specified role.
-    :param _builtins.str type: Filter results by a specific policy type. Valid values are `Custom` and `System`.
-    :param _builtins.str user_name: Filter results by a specific user name. Returned policies are attached to the specified user.
+    :param _builtins.str role_name: The name of the RAM role.
+    :param Mapping[str, _builtins.str] tags: A mapping of tags to assign to the resource.
+    :param _builtins.str type: The type of the policy. Valid values: `System` and `Custom`.
+    :param _builtins.str user_name: The name of the RAM user.
     """
     __args__ = dict()
     __args__['enableDetails'] = enable_details
@@ -225,6 +236,7 @@ def get_policies(enable_details: Optional[_builtins.bool] = None,
     __args__['nameRegex'] = name_regex
     __args__['outputFile'] = output_file
     __args__['roleName'] = role_name
+    __args__['tags'] = tags
     __args__['type'] = type
     __args__['userName'] = user_name
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
@@ -240,6 +252,7 @@ def get_policies(enable_details: Optional[_builtins.bool] = None,
         output_file=pulumi.get(__ret__, 'output_file'),
         policies=pulumi.get(__ret__, 'policies'),
         role_name=pulumi.get(__ret__, 'role_name'),
+        tags=pulumi.get(__ret__, 'tags'),
         type=pulumi.get(__ret__, 'type'),
         user_name=pulumi.get(__ret__, 'user_name'))
 def get_policies_output(enable_details: Optional[pulumi.Input[Optional[_builtins.bool]]] = None,
@@ -248,65 +261,64 @@ def get_policies_output(enable_details: Optional[pulumi.Input[Optional[_builtins
                         name_regex: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                         output_file: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                         role_name: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                        tags: Optional[pulumi.Input[Optional[Mapping[str, _builtins.str]]]] = None,
                         type: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                         user_name: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                         opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetPoliciesResult]:
     """
-    This data source provides a list of RAM policies in an Alibaba Cloud account according to the specified filters.
+    This data source provides the RAM Policies of the current Alibaba Cloud user.
 
-    > **NOTE:** Available since v1.0.0+.
+    > **NOTE:** Available since v1.0.0.
 
     ## Example Usage
 
+    Basic Usage
+
     ```python
     import pulumi
     import pulumi_alicloud as alicloud
     import pulumi_random as random
 
+    config = pulumi.Config()
+    name = config.get("name")
+    if name is None:
+        name = "terraform-example"
     default = random.index.Integer("default",
         min=10000,
         max=99999)
-    group = alicloud.ram.Group("group",
-        name=f"groupName-{default['result']}",
-        comments="this is a group comments.")
-    policy = alicloud.ram.Policy("policy",
-        policy_name=f"tf-example-{default['result']}",
-        policy_document=\"\"\"    {
-          \\"Statement\\": [
-            {
-              \\"Action\\": [
-                \\"oss:ListObjects\\",
-                \\"oss:GetObject\\"
-              ],
-              \\"Effect\\": \\"Allow\\",
-              \\"Resource\\": [
-                \\"acs:oss:*:*:mybucket\\",
-                \\"acs:oss:*:*:mybucket/*\\"
-              ]
-            }
-          ],
-            \\"Version\\": \\"1\\"
-        }
+    default_policy = alicloud.ram.Policy("default",
+        policy_name=f"{name}-{default['result']}",
+        description=f"{name}-{default['result']}",
+        force=True,
+        policy_document=\"\"\"  {
+        \\"Statement\\": [
+          {
+            \\"Effect\\": \\"Allow\\",
+            \\"Action\\": \\"*\\",
+            \\"Resource\\": \\"*\\"
+          }
+        ],
+        \\"Version\\": \\"1\\"
+      }
     \"\"\",
-        description="this is a policy test")
-    attach = alicloud.ram.GroupPolicyAttachment("attach",
-        policy_name=policy.policy_name,
-        policy_type=policy.type,
-        group_name=group.name)
-    policies_ds = alicloud.ram.get_policies_output(group_name=attach.group_name,
-        type="Custom")
-    pulumi.export("firstPolicyName", policies_ds.policies[0].name)
+        tags={
+            "Created": "TF",
+            "For": "Policy",
+        })
+    ids = alicloud.ram.get_policies_output(ids=[default_policy.id])
+    pulumi.export("ramPoliciesId0", ids.policies[0].id)
     ```
 
 
-    :param _builtins.bool enable_details: Default to `true`. Set it to true can output more details.
-    :param _builtins.str group_name: Filter results by a specific group name. Returned policies are attached to the specified group.
-    :param Sequence[_builtins.str] ids: A list of ram group IDs.
-    :param _builtins.str name_regex: A regex string to filter resulting policies by name.
+    :param _builtins.bool enable_details: Whether to query the detailed list of resource attributes. Default value: `true`.
+    :param _builtins.str group_name: The name of the user group.
+    :param Sequence[_builtins.str] ids: A list of Policy IDs.
+    :param _builtins.str name_regex: A regex string to filter results by Policy name.
     :param _builtins.str output_file: File name where to save data source results (after running `pulumi preview`).
-    :param _builtins.str role_name: Filter results by a specific role name. Returned policies are attached to the specified role.
-    :param _builtins.str type: Filter results by a specific policy type. Valid values are `Custom` and `System`.
-    :param _builtins.str user_name: Filter results by a specific user name. Returned policies are attached to the specified user.
+    :param _builtins.str role_name: The name of the RAM role.
+    :param Mapping[str, _builtins.str] tags: A mapping of tags to assign to the resource.
+    :param _builtins.str type: The type of the policy. Valid values: `System` and `Custom`.
+    :param _builtins.str user_name: The name of the RAM user.
     """
     __args__ = dict()
     __args__['enableDetails'] = enable_details
@@ -315,6 +327,7 @@ def get_policies_output(enable_details: Optional[pulumi.Input[Optional[_builtins
     __args__['nameRegex'] = name_regex
     __args__['outputFile'] = output_file
     __args__['roleName'] = role_name
+    __args__['tags'] = tags
     __args__['type'] = type
     __args__['userName'] = user_name
     opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
@@ -329,5 +342,6 @@ def get_policies_output(enable_details: Optional[pulumi.Input[Optional[_builtins
         output_file=pulumi.get(__response__, 'output_file'),
         policies=pulumi.get(__response__, 'policies'),
         role_name=pulumi.get(__response__, 'role_name'),
+        tags=pulumi.get(__response__, 'tags'),
         type=pulumi.get(__response__, 'type'),
         user_name=pulumi.get(__response__, 'user_name')))

pulumi_alicloud/ram/get_roles.py

@@ -27,7 +27,7 @@ class GetRolesResult:
     """
     A collection of values returned by getRoles.
     """
-    def __init__(__self__, id=None, ids=None, name_regex=None, names=None, output_file=None, policy_name=None, policy_type=None, roles=None):
+    def __init__(__self__, id=None, ids=None, name_regex=None, names=None, output_file=None, policy_name=None, policy_type=None, roles=None, tags=None):
         if id and not isinstance(id, str):
             raise TypeError("Expected argument 'id' to be a str")
         pulumi.set(__self__, "id", id)
@@ -52,6 +52,9 @@ class GetRolesResult:
         if roles and not isinstance(roles, list):
             raise TypeError("Expected argument 'roles' to be a list")
         pulumi.set(__self__, "roles", roles)
+        if tags and not isinstance(tags, dict):
+            raise TypeError("Expected argument 'tags' to be a dict")
+        pulumi.set(__self__, "tags", tags)
 
     @_builtins.property
     @pulumi.getter
@@ -64,9 +67,6 @@ class GetRolesResult:
     @_builtins.property
     @pulumi.getter
     def ids(self) -> Sequence[_builtins.str]:
-        """
-        A list of ram role IDs.
-        """
         return pulumi.get(self, "ids")
 
     @_builtins.property
@@ -78,7 +78,7 @@ class GetRolesResult:
     @pulumi.getter
     def names(self) -> Sequence[_builtins.str]:
         """
-        A list of ram role names.
+        (Available since v1.42.0) A list of Role names.
         """
         return pulumi.get(self, "names")
 
@@ -101,10 +101,18 @@ class GetRolesResult:
     @pulumi.getter
     def roles(self) -> Sequence['outputs.GetRolesRoleResult']:
         """
-        A list of roles. Each element contains the following attributes:
+        A list of Role. Each element contains the following attributes:
         """
         return pulumi.get(self, "roles")
 
+    @_builtins.property
+    @pulumi.getter
+    def tags(self) -> Optional[Mapping[str, _builtins.str]]:
+        """
+        (Available since v1.262.1) The tags of the RAM role.
+        """
+        return pulumi.get(self, "tags")
+
 
 class AwaitableGetRolesResult(GetRolesResult):
     # pylint: disable=using-constant-test
@@ -119,7 +127,8 @@ class AwaitableGetRolesResult(GetRolesResult):
             output_file=self.output_file,
             policy_name=self.policy_name,
             policy_type=self.policy_type,
-            roles=self.roles)
+            roles=self.roles,
+            tags=self.tags)
 
 
 def get_roles(ids: Optional[Sequence[_builtins.str]] = None,
@@ -127,31 +136,63 @@ def get_roles(ids: Optional[Sequence[_builtins.str]] = None,
               output_file: Optional[_builtins.str] = None,
               policy_name: Optional[_builtins.str] = None,
               policy_type: Optional[_builtins.str] = None,
+              tags: Optional[Mapping[str, _builtins.str]] = None,
               opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetRolesResult:
     """
-    This data source provides a list of RAM Roles in an Alibaba Cloud account according to the specified filters.
+    This data source provides the RAM Roles of the current Alibaba Cloud user.
 
-    > **NOTE:** Available since v1.0.0+.
+    > **NOTE:** Available since v1.0.0.
 
     ## Example Usage
 
+    Basic Usage
+
     ```python
     import pulumi
     import pulumi_alicloud as alicloud
+    import pulumi_random as random
 
-    roles_ds = alicloud.ram.get_roles(output_file="roles.txt",
-        name_regex=".*test.*",
-        policy_name="AliyunACSDefaultAccess",
-        policy_type="Custom")
-    pulumi.export("firstRoleId", roles_ds.roles[0].id)
+    config = pulumi.Config()
+    name = config.get("name")
+    if name is None:
+        name = "terraform-example"
+    default = random.index.Integer("default",
+        min=10000,
+        max=99999)
+    default_role = alicloud.ram.Role("default",
+        role_name=f"{name}-{default['result']}",
+        description=f"{name}-{default['result']}",
+        force=True,
+        assume_role_policy_document=\"\"\"  {
+        \\"Statement\\": [
+          {
+            \\"Action\\": \\"sts:AssumeRole\\",
+            \\"Effect\\": \\"Allow\\",
+            \\"Principal\\": {
+              \\"Service\\": [
+                \\"ecs.aliyuncs.com\\"
+              ]
+            }
+          }
+        ],
+        \\"Version\\": \\"1\\"
+      }
+    \"\"\",
+        tags={
+            "Created": "TF",
+            "For": "Role",
+        })
+    ids = alicloud.ram.get_roles_output(ids=[default_role.role_id])
+    pulumi.export("ramRolesId0", ids.roles[0].id)
     ```
 
 
-    :param Sequence[_builtins.str] ids: A list of ram role IDs.
-    :param _builtins.str name_regex: A regex string to filter results by the role name.
+    :param Sequence[_builtins.str] ids: A list of Role IDs.
+    :param _builtins.str name_regex: A regex string to filter results by Role name.
     :param _builtins.str output_file: File name where to save data source results (after running `pulumi preview`).
-    :param _builtins.str policy_name: Filter results by a specific policy name. If you set this parameter without setting `policy_type`, the later will be automatically set to `System`. The resulting roles will be attached to the specified policy.
-    :param _builtins.str policy_type: Filter results by a specific policy type. Valid values are `Custom` and `System`. If you set this parameter, you must set `policy_name` as well.
+    :param _builtins.str policy_name: The name of the policy.
+    :param _builtins.str policy_type: The type of the policy. Default value: `System`. Valid values: `System`, `Custom`. **Note:** `policy_type` takes effect only when `policy_name` is set.
+    :param Mapping[str, _builtins.str] tags: A mapping of tags to assign to the resource.
     """
     __args__ = dict()
     __args__['ids'] = ids
@@ -159,6 +200,7 @@ def get_roles(ids: Optional[Sequence[_builtins.str]] = None,
     __args__['outputFile'] = output_file
     __args__['policyName'] = policy_name
     __args__['policyType'] = policy_type
+    __args__['tags'] = tags
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('alicloud:ram/getRoles:getRoles', __args__, opts=opts, typ=GetRolesResult).value
 
@@ -170,37 +212,70 @@ def get_roles(ids: Optional[Sequence[_builtins.str]] = None,
         output_file=pulumi.get(__ret__, 'output_file'),
         policy_name=pulumi.get(__ret__, 'policy_name'),
         policy_type=pulumi.get(__ret__, 'policy_type'),
-        roles=pulumi.get(__ret__, 'roles'))
+        roles=pulumi.get(__ret__, 'roles'),
+        tags=pulumi.get(__ret__, 'tags'))
 def get_roles_output(ids: Optional[pulumi.Input[Optional[Sequence[_builtins.str]]]] = None,
                      name_regex: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                      output_file: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                      policy_name: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                      policy_type: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                     tags: Optional[pulumi.Input[Optional[Mapping[str, _builtins.str]]]] = None,
                      opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetRolesResult]:
     """
-    This data source provides a list of RAM Roles in an Alibaba Cloud account according to the specified filters.
+    This data source provides the RAM Roles of the current Alibaba Cloud user.
 
-    > **NOTE:** Available since v1.0.0+.
+    > **NOTE:** Available since v1.0.0.
 
     ## Example Usage
 
+    Basic Usage
+
     ```python
     import pulumi
     import pulumi_alicloud as alicloud
+    import pulumi_random as random
 
-    roles_ds = alicloud.ram.get_roles(output_file="roles.txt",
-        name_regex=".*test.*",
-        policy_name="AliyunACSDefaultAccess",
-        policy_type="Custom")
-    pulumi.export("firstRoleId", roles_ds.roles[0].id)
+    config = pulumi.Config()
+    name = config.get("name")
+    if name is None:
+        name = "terraform-example"
+    default = random.index.Integer("default",
+        min=10000,
+        max=99999)
+    default_role = alicloud.ram.Role("default",
+        role_name=f"{name}-{default['result']}",
+        description=f"{name}-{default['result']}",
+        force=True,
+        assume_role_policy_document=\"\"\"  {
+        \\"Statement\\": [
+          {
+            \\"Action\\": \\"sts:AssumeRole\\",
+            \\"Effect\\": \\"Allow\\",
+            \\"Principal\\": {
+              \\"Service\\": [
+                \\"ecs.aliyuncs.com\\"
+              ]
+            }
+          }
+        ],
+        \\"Version\\": \\"1\\"
+      }
+    \"\"\",
+        tags={
+            "Created": "TF",
+            "For": "Role",
+        })
+    ids = alicloud.ram.get_roles_output(ids=[default_role.role_id])
+    pulumi.export("ramRolesId0", ids.roles[0].id)
     ```
 
 
-    :param Sequence[_builtins.str] ids: A list of ram role IDs.
-    :param _builtins.str name_regex: A regex string to filter results by the role name.
+    :param Sequence[_builtins.str] ids: A list of Role IDs.
+    :param _builtins.str name_regex: A regex string to filter results by Role name.
     :param _builtins.str output_file: File name where to save data source results (after running `pulumi preview`).
-    :param _builtins.str policy_name: Filter results by a specific policy name. If you set this parameter without setting `policy_type`, the later will be automatically set to `System`. The resulting roles will be attached to the specified policy.
-    :param _builtins.str policy_type: Filter results by a specific policy type. Valid values are `Custom` and `System`. If you set this parameter, you must set `policy_name` as well.
+    :param _builtins.str policy_name: The name of the policy.
+    :param _builtins.str policy_type: The type of the policy. Default value: `System`. Valid values: `System`, `Custom`. **Note:** `policy_type` takes effect only when `policy_name` is set.
+    :param Mapping[str, _builtins.str] tags: A mapping of tags to assign to the resource.
     """
     __args__ = dict()
     __args__['ids'] = ids
@@ -208,6 +283,7 @@ def get_roles_output(ids: Optional[pulumi.Input[Optional[Sequence[_builtins.str]
     __args__['outputFile'] = output_file
     __args__['policyName'] = policy_name
     __args__['policyType'] = policy_type
+    __args__['tags'] = tags
     opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke_output('alicloud:ram/getRoles:getRoles', __args__, opts=opts, typ=GetRolesResult)
     return __ret__.apply(lambda __response__: GetRolesResult(
@@ -218,4 +294,5 @@ def get_roles_output(ids: Optional[pulumi.Input[Optional[Sequence[_builtins.str]
         output_file=pulumi.get(__response__, 'output_file'),
         policy_name=pulumi.get(__response__, 'policy_name'),
         policy_type=pulumi.get(__response__, 'policy_type'),
-        roles=pulumi.get(__response__, 'roles')))
+        roles=pulumi.get(__response__, 'roles'),
+        tags=pulumi.get(__response__, 'tags')))