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

pulumi_gcp/compute/region_backend_service_iam_policy.py

@@ -211,6 +211,250 @@ class RegionBackendServiceIamPolicy(pulumi.CustomResource):
                  region: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
+        Three different resources help you manage your IAM policy for Compute Engine RegionBackendService. Each of these resources serves a different use case:
+
+        * `compute.RegionBackendServiceIamPolicy`: Authoritative. Sets the IAM policy for the regionbackendservice and replaces any existing policy already attached.
+        * `compute.RegionBackendServiceIamBinding`: 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 regionbackendservice are preserved.
+        * `compute.RegionBackendServiceIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the regionbackendservice are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `compute.RegionBackendServiceIamPolicy`: Retrieves the IAM policy for the regionbackendservice
+
+        > **Note:** `compute.RegionBackendServiceIamPolicy` **cannot** be used in conjunction with `compute.RegionBackendServiceIamBinding` and `compute.RegionBackendServiceIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `compute.RegionBackendServiceIamBinding` resources **can be** used in conjunction with `compute.RegionBackendServiceIamMember` resources **only if** they do not grant privilege to the same role.
+
+        > **Note:**  This resource supports IAM Conditions but they have some known limitations which can be found [here](https://cloud.google.com/iam/docs/conditions-overview#limitations). Please review this article if you are having issues with IAM Conditions.
+
+        ## compute.RegionBackendServiceIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/compute.admin",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.compute.RegionBackendServiceIamPolicy("policy",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            policy_data=admin.policy_data)
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/compute.admin",
+            "members": ["user:jane@example.com"],
+            "condition": {
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            },
+        }])
+        policy = gcp.compute.RegionBackendServiceIamPolicy("policy",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            policy_data=admin.policy_data)
+        ```
+        ## compute.RegionBackendServiceIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.compute.RegionBackendServiceIamBinding("binding",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            members=["user:jane@example.com"])
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.compute.RegionBackendServiceIamBinding("binding",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            members=["user:jane@example.com"],
+            condition={
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            })
+        ```
+        ## compute.RegionBackendServiceIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.compute.RegionBackendServiceIamMember("member",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            member="user:jane@example.com")
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.compute.RegionBackendServiceIamMember("member",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            member="user:jane@example.com",
+            condition={
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            })
+        ```
+
+        ## This resource supports User Project Overrides.
+
+        - 
+
+        # IAM policy for Compute Engine RegionBackendService
+
+        Three different resources help you manage your IAM policy for Compute Engine RegionBackendService. Each of these resources serves a different use case:
+
+        * `compute.RegionBackendServiceIamPolicy`: Authoritative. Sets the IAM policy for the regionbackendservice and replaces any existing policy already attached.
+        * `compute.RegionBackendServiceIamBinding`: 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 regionbackendservice are preserved.
+        * `compute.RegionBackendServiceIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the regionbackendservice are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `compute.RegionBackendServiceIamPolicy`: Retrieves the IAM policy for the regionbackendservice
+
+        > **Note:** `compute.RegionBackendServiceIamPolicy` **cannot** be used in conjunction with `compute.RegionBackendServiceIamBinding` and `compute.RegionBackendServiceIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `compute.RegionBackendServiceIamBinding` resources **can be** used in conjunction with `compute.RegionBackendServiceIamMember` resources **only if** they do not grant privilege to the same role.
+
+        > **Note:**  This resource supports IAM Conditions but they have some known limitations which can be found [here](https://cloud.google.com/iam/docs/conditions-overview#limitations). Please review this article if you are having issues with IAM Conditions.
+
+        ## compute.RegionBackendServiceIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/compute.admin",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.compute.RegionBackendServiceIamPolicy("policy",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            policy_data=admin.policy_data)
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/compute.admin",
+            "members": ["user:jane@example.com"],
+            "condition": {
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            },
+        }])
+        policy = gcp.compute.RegionBackendServiceIamPolicy("policy",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            policy_data=admin.policy_data)
+        ```
+        ## compute.RegionBackendServiceIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.compute.RegionBackendServiceIamBinding("binding",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            members=["user:jane@example.com"])
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.compute.RegionBackendServiceIamBinding("binding",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            members=["user:jane@example.com"],
+            condition={
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            })
+        ```
+        ## compute.RegionBackendServiceIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.compute.RegionBackendServiceIamMember("member",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            member="user:jane@example.com")
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.compute.RegionBackendServiceIamMember("member",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            member="user:jane@example.com",
+            condition={
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            })
+        ```
+
         ## Import
 
         For all import syntaxes, the "resource in question" can take any of the following forms:
@@ -269,6 +513,250 @@ class RegionBackendServiceIamPolicy(pulumi.CustomResource):
                  args: RegionBackendServiceIamPolicyArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        Three different resources help you manage your IAM policy for Compute Engine RegionBackendService. Each of these resources serves a different use case:
+
+        * `compute.RegionBackendServiceIamPolicy`: Authoritative. Sets the IAM policy for the regionbackendservice and replaces any existing policy already attached.
+        * `compute.RegionBackendServiceIamBinding`: 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 regionbackendservice are preserved.
+        * `compute.RegionBackendServiceIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the regionbackendservice are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `compute.RegionBackendServiceIamPolicy`: Retrieves the IAM policy for the regionbackendservice
+
+        > **Note:** `compute.RegionBackendServiceIamPolicy` **cannot** be used in conjunction with `compute.RegionBackendServiceIamBinding` and `compute.RegionBackendServiceIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `compute.RegionBackendServiceIamBinding` resources **can be** used in conjunction with `compute.RegionBackendServiceIamMember` resources **only if** they do not grant privilege to the same role.
+
+        > **Note:**  This resource supports IAM Conditions but they have some known limitations which can be found [here](https://cloud.google.com/iam/docs/conditions-overview#limitations). Please review this article if you are having issues with IAM Conditions.
+
+        ## compute.RegionBackendServiceIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/compute.admin",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.compute.RegionBackendServiceIamPolicy("policy",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            policy_data=admin.policy_data)
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/compute.admin",
+            "members": ["user:jane@example.com"],
+            "condition": {
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            },
+        }])
+        policy = gcp.compute.RegionBackendServiceIamPolicy("policy",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            policy_data=admin.policy_data)
+        ```
+        ## compute.RegionBackendServiceIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.compute.RegionBackendServiceIamBinding("binding",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            members=["user:jane@example.com"])
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.compute.RegionBackendServiceIamBinding("binding",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            members=["user:jane@example.com"],
+            condition={
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            })
+        ```
+        ## compute.RegionBackendServiceIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.compute.RegionBackendServiceIamMember("member",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            member="user:jane@example.com")
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.compute.RegionBackendServiceIamMember("member",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            member="user:jane@example.com",
+            condition={
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            })
+        ```
+
+        ## This resource supports User Project Overrides.
+
+        - 
+
+        # IAM policy for Compute Engine RegionBackendService
+
+        Three different resources help you manage your IAM policy for Compute Engine RegionBackendService. Each of these resources serves a different use case:
+
+        * `compute.RegionBackendServiceIamPolicy`: Authoritative. Sets the IAM policy for the regionbackendservice and replaces any existing policy already attached.
+        * `compute.RegionBackendServiceIamBinding`: 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 regionbackendservice are preserved.
+        * `compute.RegionBackendServiceIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the regionbackendservice are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `compute.RegionBackendServiceIamPolicy`: Retrieves the IAM policy for the regionbackendservice
+
+        > **Note:** `compute.RegionBackendServiceIamPolicy` **cannot** be used in conjunction with `compute.RegionBackendServiceIamBinding` and `compute.RegionBackendServiceIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `compute.RegionBackendServiceIamBinding` resources **can be** used in conjunction with `compute.RegionBackendServiceIamMember` resources **only if** they do not grant privilege to the same role.
+
+        > **Note:**  This resource supports IAM Conditions but they have some known limitations which can be found [here](https://cloud.google.com/iam/docs/conditions-overview#limitations). Please review this article if you are having issues with IAM Conditions.
+
+        ## compute.RegionBackendServiceIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/compute.admin",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.compute.RegionBackendServiceIamPolicy("policy",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            policy_data=admin.policy_data)
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/compute.admin",
+            "members": ["user:jane@example.com"],
+            "condition": {
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            },
+        }])
+        policy = gcp.compute.RegionBackendServiceIamPolicy("policy",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            policy_data=admin.policy_data)
+        ```
+        ## compute.RegionBackendServiceIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.compute.RegionBackendServiceIamBinding("binding",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            members=["user:jane@example.com"])
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.compute.RegionBackendServiceIamBinding("binding",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            members=["user:jane@example.com"],
+            condition={
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            })
+        ```
+        ## compute.RegionBackendServiceIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.compute.RegionBackendServiceIamMember("member",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            member="user:jane@example.com")
+        ```
+
+        With IAM Conditions:
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.compute.RegionBackendServiceIamMember("member",
+            project=default["project"],
+            region=default["region"],
+            name=default["name"],
+            role="roles/compute.admin",
+            member="user:jane@example.com",
+            condition={
+                "title": "expires_after_2019_12_31",
+                "description": "Expiring at midnight of 2019-12-31",
+                "expression": "request.time < timestamp(\\"2020-01-01T00:00:00Z\\")",
+            })
+        ```
+
         ## Import
 
         For all import syntaxes, the "resource in question" can take any of the following forms:

pulumi_gcp/compute/region_network_endpoint_group.py

@@ -807,7 +807,6 @@ class RegionNetworkEndpointGroup(pulumi.CustomResource):
             psc_data={
                 "producer_port": "88",
             },
-            network=default.self_link,
             subnetwork=default_subnetwork.self_link)
         ```
         ### Region Network Endpoint Group Internet Ip Port
@@ -1158,7 +1157,6 @@ class RegionNetworkEndpointGroup(pulumi.CustomResource):
             psc_data={
                 "producer_port": "88",
             },
-            network=default.self_link,
             subnetwork=default_subnetwork.self_link)
         ```
         ### Region Network Endpoint Group Internet Ip Port
@@ -1435,7 +1433,7 @@ class RegionNetworkEndpointGroup(pulumi.CustomResource):
 
     @_builtins.property
     @pulumi.getter
-    def network(self) -> pulumi.Output[Optional[_builtins.str]]:
+    def network(self) -> pulumi.Output[_builtins.str]:
         """
         This field is only used for PSC and INTERNET NEGs.
         The URL of the network to which all network endpoints in the NEG belong. Uses

pulumi_gcp/compute/region_resize_request.py

@@ -329,6 +329,18 @@ class RegionResizeRequest(pulumi.CustomResource):
                  resize_by: Optional[pulumi.Input[_builtins.int]] = None,
                  __props__=None):
         """
+        Represents a Regional Managed Instance Group Resize Request
+
+        Resize Requests are the Managed Instance Group implementation of Dynamic Workload Scheduler Flex Start.
+
+        With Dynamic Workload Scheduler in Flex Start mode, you submit a GPU capacity request for your AI/ML jobs by indicating how many you need, a duration, and your preferred region. Dynamic Workload Scheduler intelligently persists the request; once the capacity becomes available, it automatically provisions your VMs enabling your workloads to run continuously for the entire duration of the capacity allocation.
+
+        To get more information about RegionResizeRequest, see:
+
+        * [API documentation](https://cloud.google.com/compute/docs/reference/rest/beta/regionInstanceGroupManagerResizeRequests)
+        * How-to Guides
+            * [About resize requests in a MIG](https://cloud.google.com/compute/docs/instance-groups/about-resize-requests-mig)
+
         ## Example Usage
 
         ### Compute Rmig Resize Request
@@ -456,6 +468,18 @@ class RegionResizeRequest(pulumi.CustomResource):
                  args: RegionResizeRequestArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        Represents a Regional Managed Instance Group Resize Request
+
+        Resize Requests are the Managed Instance Group implementation of Dynamic Workload Scheduler Flex Start.
+
+        With Dynamic Workload Scheduler in Flex Start mode, you submit a GPU capacity request for your AI/ML jobs by indicating how many you need, a duration, and your preferred region. Dynamic Workload Scheduler intelligently persists the request; once the capacity becomes available, it automatically provisions your VMs enabling your workloads to run continuously for the entire duration of the capacity allocation.
+
+        To get more information about RegionResizeRequest, see:
+
+        * [API documentation](https://cloud.google.com/compute/docs/reference/rest/beta/regionInstanceGroupManagerResizeRequests)
+        * How-to Guides
+            * [About resize requests in a MIG](https://cloud.google.com/compute/docs/instance-groups/about-resize-requests-mig)
+
         ## Example Usage
 
         ### Compute Rmig Resize Request