pulumi-gcp 8.42.0a1758133038__py3-none-any.whl → 9.0.0__py3-none-any.whl

pulumi_gcp/workstations/workstation_iam_binding.py

@@ -381,6 +381,142 @@ class WorkstationIamBinding(pulumi.CustomResource):
                  workstation_id: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
+        Three different resources help you manage your IAM policy for Cloud Workstations Workstation. Each of these resources serves a different use case:
+
+        * `workstations.WorkstationIamPolicy`: Authoritative. Sets the IAM policy for the workstation and replaces any existing policy already attached.
+        * `workstations.WorkstationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the workstation are preserved.
+        * `workstations.WorkstationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the workstation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `workstations.WorkstationIamPolicy`: Retrieves the IAM policy for the workstation
+
+        > **Note:** `workstations.WorkstationIamPolicy` **cannot** be used in conjunction with `workstations.WorkstationIamBinding` and `workstations.WorkstationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `workstations.WorkstationIamBinding` resources **can be** used in conjunction with `workstations.WorkstationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## workstations.WorkstationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.workstations.WorkstationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## workstations.WorkstationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.workstations.WorkstationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## workstations.WorkstationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.workstations.WorkstationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
+        ## This resource supports User Project Overrides.
+
+        - 
+
+        # IAM policy for Cloud Workstations Workstation
+
+        Three different resources help you manage your IAM policy for Cloud Workstations Workstation. Each of these resources serves a different use case:
+
+        * `workstations.WorkstationIamPolicy`: Authoritative. Sets the IAM policy for the workstation and replaces any existing policy already attached.
+        * `workstations.WorkstationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the workstation are preserved.
+        * `workstations.WorkstationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the workstation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `workstations.WorkstationIamPolicy`: Retrieves the IAM policy for the workstation
+
+        > **Note:** `workstations.WorkstationIamPolicy` **cannot** be used in conjunction with `workstations.WorkstationIamBinding` and `workstations.WorkstationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `workstations.WorkstationIamBinding` resources **can be** used in conjunction with `workstations.WorkstationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## workstations.WorkstationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.workstations.WorkstationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## workstations.WorkstationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.workstations.WorkstationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## workstations.WorkstationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.workstations.WorkstationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
         ## Import
 
         For all import syntaxes, the "resource in question" can take any of the following forms:
@@ -454,6 +590,142 @@ class WorkstationIamBinding(pulumi.CustomResource):
                  args: WorkstationIamBindingArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        Three different resources help you manage your IAM policy for Cloud Workstations Workstation. Each of these resources serves a different use case:
+
+        * `workstations.WorkstationIamPolicy`: Authoritative. Sets the IAM policy for the workstation and replaces any existing policy already attached.
+        * `workstations.WorkstationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the workstation are preserved.
+        * `workstations.WorkstationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the workstation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `workstations.WorkstationIamPolicy`: Retrieves the IAM policy for the workstation
+
+        > **Note:** `workstations.WorkstationIamPolicy` **cannot** be used in conjunction with `workstations.WorkstationIamBinding` and `workstations.WorkstationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `workstations.WorkstationIamBinding` resources **can be** used in conjunction with `workstations.WorkstationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## workstations.WorkstationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.workstations.WorkstationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## workstations.WorkstationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.workstations.WorkstationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## workstations.WorkstationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.workstations.WorkstationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
+        ## This resource supports User Project Overrides.
+
+        - 
+
+        # IAM policy for Cloud Workstations Workstation
+
+        Three different resources help you manage your IAM policy for Cloud Workstations Workstation. Each of these resources serves a different use case:
+
+        * `workstations.WorkstationIamPolicy`: Authoritative. Sets the IAM policy for the workstation and replaces any existing policy already attached.
+        * `workstations.WorkstationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the workstation are preserved.
+        * `workstations.WorkstationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the workstation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `workstations.WorkstationIamPolicy`: Retrieves the IAM policy for the workstation
+
+        > **Note:** `workstations.WorkstationIamPolicy` **cannot** be used in conjunction with `workstations.WorkstationIamBinding` and `workstations.WorkstationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `workstations.WorkstationIamBinding` resources **can be** used in conjunction with `workstations.WorkstationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## workstations.WorkstationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.workstations.WorkstationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## workstations.WorkstationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.workstations.WorkstationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## workstations.WorkstationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.workstations.WorkstationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
         ## Import
 
         For all import syntaxes, the "resource in question" can take any of the following forms:

pulumi_gcp/workstations/workstation_iam_member.py

@@ -381,6 +381,142 @@ class WorkstationIamMember(pulumi.CustomResource):
                  workstation_id: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
+        Three different resources help you manage your IAM policy for Cloud Workstations Workstation. Each of these resources serves a different use case:
+
+        * `workstations.WorkstationIamPolicy`: Authoritative. Sets the IAM policy for the workstation and replaces any existing policy already attached.
+        * `workstations.WorkstationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the workstation are preserved.
+        * `workstations.WorkstationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the workstation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `workstations.WorkstationIamPolicy`: Retrieves the IAM policy for the workstation
+
+        > **Note:** `workstations.WorkstationIamPolicy` **cannot** be used in conjunction with `workstations.WorkstationIamBinding` and `workstations.WorkstationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `workstations.WorkstationIamBinding` resources **can be** used in conjunction with `workstations.WorkstationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## workstations.WorkstationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.workstations.WorkstationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## workstations.WorkstationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.workstations.WorkstationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## workstations.WorkstationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.workstations.WorkstationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
+        ## This resource supports User Project Overrides.
+
+        - 
+
+        # IAM policy for Cloud Workstations Workstation
+
+        Three different resources help you manage your IAM policy for Cloud Workstations Workstation. Each of these resources serves a different use case:
+
+        * `workstations.WorkstationIamPolicy`: Authoritative. Sets the IAM policy for the workstation and replaces any existing policy already attached.
+        * `workstations.WorkstationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the workstation are preserved.
+        * `workstations.WorkstationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the workstation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `workstations.WorkstationIamPolicy`: Retrieves the IAM policy for the workstation
+
+        > **Note:** `workstations.WorkstationIamPolicy` **cannot** be used in conjunction with `workstations.WorkstationIamBinding` and `workstations.WorkstationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `workstations.WorkstationIamBinding` resources **can be** used in conjunction with `workstations.WorkstationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## workstations.WorkstationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.workstations.WorkstationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## workstations.WorkstationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.workstations.WorkstationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## workstations.WorkstationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.workstations.WorkstationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
         ## Import
 
         For all import syntaxes, the "resource in question" can take any of the following forms:
@@ -454,6 +590,142 @@ class WorkstationIamMember(pulumi.CustomResource):
                  args: WorkstationIamMemberArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        Three different resources help you manage your IAM policy for Cloud Workstations Workstation. Each of these resources serves a different use case:
+
+        * `workstations.WorkstationIamPolicy`: Authoritative. Sets the IAM policy for the workstation and replaces any existing policy already attached.
+        * `workstations.WorkstationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the workstation are preserved.
+        * `workstations.WorkstationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the workstation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `workstations.WorkstationIamPolicy`: Retrieves the IAM policy for the workstation
+
+        > **Note:** `workstations.WorkstationIamPolicy` **cannot** be used in conjunction with `workstations.WorkstationIamBinding` and `workstations.WorkstationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `workstations.WorkstationIamBinding` resources **can be** used in conjunction with `workstations.WorkstationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## workstations.WorkstationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.workstations.WorkstationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## workstations.WorkstationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.workstations.WorkstationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## workstations.WorkstationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.workstations.WorkstationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
+        ## This resource supports User Project Overrides.
+
+        - 
+
+        # IAM policy for Cloud Workstations Workstation
+
+        Three different resources help you manage your IAM policy for Cloud Workstations Workstation. Each of these resources serves a different use case:
+
+        * `workstations.WorkstationIamPolicy`: Authoritative. Sets the IAM policy for the workstation and replaces any existing policy already attached.
+        * `workstations.WorkstationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the workstation are preserved.
+        * `workstations.WorkstationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the workstation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `workstations.WorkstationIamPolicy`: Retrieves the IAM policy for the workstation
+
+        > **Note:** `workstations.WorkstationIamPolicy` **cannot** be used in conjunction with `workstations.WorkstationIamBinding` and `workstations.WorkstationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `workstations.WorkstationIamBinding` resources **can be** used in conjunction with `workstations.WorkstationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## workstations.WorkstationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.workstations.WorkstationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## workstations.WorkstationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.workstations.WorkstationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## workstations.WorkstationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.workstations.WorkstationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            workstation_cluster_id=default["workstationClusterId"],
+            workstation_config_id=default["workstationConfigId"],
+            workstation_id=default["workstationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
         ## Import
 
         For all import syntaxes, the "resource in question" can take any of the following forms: