pulumi-gcp 7.29.0a1719417555__py3-none-any.whl → 7.30.0__py3-none-any.whl

pulumi_gcp/gkebackup/restore_plan_iam_policy.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from .. import _utilities
 
 __all__ = ['RestorePlanIamPolicyArgs', 'RestorePlanIamPolicy']
@@ -20,8 +25,15 @@ class RestorePlanIamPolicyArgs:
                  project: Optional[pulumi.Input[str]] = None):
         """
         The set of arguments for constructing a RestorePlanIamPolicy resource.
+        :param pulumi.Input[str] policy_data: The policy data generated by
+               a `organizations_get_iam_policy` data source.
         :param pulumi.Input[str] location: The region of the Restore Plan.
-        :param pulumi.Input[str] name: The full name of the BackupPlan Resource.
+               Used to find the parent resource to bind the IAM policy to. If not specified,
+               the value will be parsed from the identifier of the parent resource. If no location is provided in the parent identifier and no
+               location is specified, it is taken from the provider configuration.
+        :param pulumi.Input[str] name: Used to find the parent resource to bind the IAM policy to
+        :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
+               If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
         """
         pulumi.set(__self__, "policy_data", policy_data)
         if location is not None:
@@ -34,6 +46,10 @@ class RestorePlanIamPolicyArgs:
     @property
     @pulumi.getter(name="policyData")
     def policy_data(self) -> pulumi.Input[str]:
+        """
+        The policy data generated by
+        a `organizations_get_iam_policy` data source.
+        """
         return pulumi.get(self, "policy_data")
 
     @policy_data.setter
@@ -45,6 +61,9 @@ class RestorePlanIamPolicyArgs:
     def location(self) -> Optional[pulumi.Input[str]]:
         """
         The region of the Restore Plan.
+        Used to find the parent resource to bind the IAM policy to. If not specified,
+        the value will be parsed from the identifier of the parent resource. If no location is provided in the parent identifier and no
+        location is specified, it is taken from the provider configuration.
         """
         return pulumi.get(self, "location")
 
@@ -56,7 +75,7 @@ class RestorePlanIamPolicyArgs:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        The full name of the BackupPlan Resource.
+        Used to find the parent resource to bind the IAM policy to
         """
         return pulumi.get(self, "name")
 
@@ -67,6 +86,10 @@ class RestorePlanIamPolicyArgs:
     @property
     @pulumi.getter
     def project(self) -> Optional[pulumi.Input[str]]:
+        """
+        The ID of the project in which the resource belongs.
+        If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
+        """
         return pulumi.get(self, "project")
 
     @project.setter
@@ -84,8 +107,16 @@ class _RestorePlanIamPolicyState:
                  project: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering RestorePlanIamPolicy resources.
+        :param pulumi.Input[str] etag: (Computed) The etag of the IAM policy.
         :param pulumi.Input[str] location: The region of the Restore Plan.
-        :param pulumi.Input[str] name: The full name of the BackupPlan Resource.
+               Used to find the parent resource to bind the IAM policy to. If not specified,
+               the value will be parsed from the identifier of the parent resource. If no location is provided in the parent identifier and no
+               location is specified, it is taken from the provider configuration.
+        :param pulumi.Input[str] name: Used to find the parent resource to bind the IAM policy to
+        :param pulumi.Input[str] policy_data: The policy data generated by
+               a `organizations_get_iam_policy` data source.
+        :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
+               If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
         """
         if etag is not None:
             pulumi.set(__self__, "etag", etag)
@@ -101,6 +132,9 @@ class _RestorePlanIamPolicyState:
     @property
     @pulumi.getter
     def etag(self) -> Optional[pulumi.Input[str]]:
+        """
+        (Computed) The etag of the IAM policy.
+        """
         return pulumi.get(self, "etag")
 
     @etag.setter
@@ -112,6 +146,9 @@ class _RestorePlanIamPolicyState:
     def location(self) -> Optional[pulumi.Input[str]]:
         """
         The region of the Restore Plan.
+        Used to find the parent resource to bind the IAM policy to. If not specified,
+        the value will be parsed from the identifier of the parent resource. If no location is provided in the parent identifier and no
+        location is specified, it is taken from the provider configuration.
         """
         return pulumi.get(self, "location")
 
@@ -123,7 +160,7 @@ class _RestorePlanIamPolicyState:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        The full name of the BackupPlan Resource.
+        Used to find the parent resource to bind the IAM policy to
         """
         return pulumi.get(self, "name")
 
@@ -134,6 +171,10 @@ class _RestorePlanIamPolicyState:
     @property
     @pulumi.getter(name="policyData")
     def policy_data(self) -> Optional[pulumi.Input[str]]:
+        """
+        The policy data generated by
+        a `organizations_get_iam_policy` data source.
+        """
         return pulumi.get(self, "policy_data")
 
     @policy_data.setter
@@ -143,6 +184,10 @@ class _RestorePlanIamPolicyState:
     @property
     @pulumi.getter
     def project(self) -> Optional[pulumi.Input[str]]:
+        """
+        The ID of the project in which the resource belongs.
+        If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
+        """
         return pulumi.get(self, "project")
 
     @project.setter
@@ -161,544 +206,159 @@ class RestorePlanIamPolicy(pulumi.CustomResource):
                  project: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Represents a Restore Plan instance.
+        Three different resources help you manage your IAM policy for Backup for GKE RestorePlan. Each of these resources serves a different use case:
 
-        To get more information about RestorePlan, see:
+        * `gkebackup.RestorePlanIamPolicy`: Authoritative. Sets the IAM policy for the restoreplan and replaces any existing policy already attached.
+        * `gkebackup.RestorePlanIamBinding`: 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 restoreplan are preserved.
+        * `gkebackup.RestorePlanIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the restoreplan are preserved.
 
-        * [API documentation](https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke/reference/rest/v1/projects.locations.restorePlans)
-        * How-to Guides
-            * [Official Documentation](https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke)
+        A data source can be used to retrieve policy data in advent you do not need creation
 
-        ## Example Usage
+        * `gkebackup.RestorePlanIamPolicy`: Retrieves the IAM policy for the restoreplan
 
-        ### Gkebackup Restoreplan All Namespaces
+        > **Note:** `gkebackup.RestorePlanIamPolicy` **cannot** be used in conjunction with `gkebackup.RestorePlanIamBinding` and `gkebackup.RestorePlanIamMember` or they will fight over what your policy should be.
 
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
+        > **Note:** `gkebackup.RestorePlanIamBinding` resources **can be** used in conjunction with `gkebackup.RestorePlanIamMember` resources **only if** they do not grant privilege to the same role.
 
-        primary = gcp.container.Cluster("primary",
-            name="restore-all-ns-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="restore-all-ns",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        all_ns = gcp.gkebackup.RestorePlan("all_ns",
-            name="restore-all-ns",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                all_namespaces=True,
-                namespaced_resource_restore_mode="FAIL_ON_CONFLICT",
-                volume_data_restore_policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    all_group_kinds=True,
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-            ))
-        ```
-        ### Gkebackup Restoreplan Rollback Namespace
+        ## gkebackup.RestorePlanIamPolicy
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="rollback-ns-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="rollback-ns",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        rollback_ns = gcp.gkebackup.RestorePlan("rollback_ns",
-            name="rollback-ns-rp",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                selected_namespaces=gcp.gkebackup.RestorePlanRestoreConfigSelectedNamespacesArgs(
-                    namespaces=["my-ns"],
-                ),
-                namespaced_resource_restore_mode="DELETE_AND_RESTORE",
-                volume_data_restore_policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    selected_group_kinds=[
-                        gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeSelectedGroupKindArgs(
-                            resource_group="apiextension.k8s.io",
-                            resource_kind="CustomResourceDefinition",
-                        ),
-                        gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeSelectedGroupKindArgs(
-                            resource_group="storage.k8s.io",
-                            resource_kind="StorageClass",
-                        ),
-                    ],
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-            ))
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.gkebackup.RestorePlanIamPolicy("policy",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            policy_data=admin.policy_data)
         ```
-        ### Gkebackup Restoreplan Protected Application
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="rollback-app-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="rollback-app",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        rollback_app = gcp.gkebackup.RestorePlan("rollback_app",
-            name="rollback-app-rp",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                selected_applications=gcp.gkebackup.RestorePlanRestoreConfigSelectedApplicationsArgs(
-                    namespaced_names=[gcp.gkebackup.RestorePlanRestoreConfigSelectedApplicationsNamespacedNameArgs(
-                        name="my-app",
-                        namespace="my-ns",
-                    )],
-                ),
-                namespaced_resource_restore_mode="DELETE_AND_RESTORE",
-                volume_data_restore_policy="REUSE_VOLUME_HANDLE_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    no_group_kinds=True,
-                ),
-            ))
-        ```
-        ### Gkebackup Restoreplan All Cluster Resources
+        ## gkebackup.RestorePlanIamBinding
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="all-groupkinds-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="all-groupkinds",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        all_cluster_resources = gcp.gkebackup.RestorePlan("all_cluster_resources",
-            name="all-groupkinds-rp",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                no_namespaces=True,
-                namespaced_resource_restore_mode="FAIL_ON_CONFLICT",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    all_group_kinds=True,
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-            ))
+        binding = gcp.gkebackup.RestorePlanIamBinding("binding",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
         ```
-        ### Gkebackup Restoreplan Rename Namespace
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="rename-ns-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="rename-ns",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        rename_ns = gcp.gkebackup.RestorePlan("rename_ns",
-            name="rename-ns-rp",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                selected_namespaces=gcp.gkebackup.RestorePlanRestoreConfigSelectedNamespacesArgs(
-                    namespaces=["ns1"],
-                ),
-                namespaced_resource_restore_mode="FAIL_ON_CONFLICT",
-                volume_data_restore_policy="REUSE_VOLUME_HANDLE_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    no_group_kinds=True,
-                ),
-                transformation_rules=[
-                    gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleArgs(
-                        description="rename namespace from ns1 to ns2",
-                        resource_filter=gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleResourceFilterArgs(
-                            group_kinds=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleResourceFilterGroupKindArgs(
-                                resource_kind="Namespace",
-                            )],
-                            json_path=".metadata[?(@.name == 'ns1')]",
-                        ),
-                        field_actions=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleFieldActionArgs(
-                            op="REPLACE",
-                            path="/metadata/name",
-                            value="ns2",
-                        )],
-                    ),
-                    gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleArgs(
-                        description="move all resources from ns1 to ns2",
-                        resource_filter=gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleResourceFilterArgs(
-                            namespaces=["ns1"],
-                        ),
-                        field_actions=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleFieldActionArgs(
-                            op="REPLACE",
-                            path="/metadata/namespace",
-                            value="ns2",
-                        )],
-                    ),
-                ],
-            ))
-        ```
-        ### Gkebackup Restoreplan Second Transformation
+        ## gkebackup.RestorePlanIamMember
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="transform-rule-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="transform-rule",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        transform_rule = gcp.gkebackup.RestorePlan("transform_rule",
-            name="transform-rule-rp",
-            description="copy nginx env variables",
-            labels={
-                "app": "nginx",
-            },
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                excluded_namespaces=gcp.gkebackup.RestorePlanRestoreConfigExcludedNamespacesArgs(
-                    namespaces=["my-ns"],
-                ),
-                namespaced_resource_restore_mode="DELETE_AND_RESTORE",
-                volume_data_restore_policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    excluded_group_kinds=[gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeExcludedGroupKindArgs(
-                        resource_group="apiextension.k8s.io",
-                        resource_kind="CustomResourceDefinition",
-                    )],
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-                transformation_rules=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleArgs(
-                    description="Copy environment variables from the nginx container to the install init container.",
-                    resource_filter=gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleResourceFilterArgs(
-                        group_kinds=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleResourceFilterGroupKindArgs(
-                            resource_kind="Pod",
-                            resource_group="",
-                        )],
-                        json_path=".metadata[?(@.name == 'nginx')]",
-                    ),
-                    field_actions=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleFieldActionArgs(
-                        op="COPY",
-                        path="/spec/initContainers/0/env",
-                        from_path="/spec/containers/0/env",
-                    )],
-                )],
-            ))
+        member = gcp.gkebackup.RestorePlanIamMember("member",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            role="roles/viewer",
+            member="user:jane@example.com")
         ```
-        ### Gkebackup Restoreplan Gitops Mode
+
+        ## gkebackup.RestorePlanIamPolicy
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="gitops-mode-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="gitops-mode",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        gitops_mode = gcp.gkebackup.RestorePlan("gitops_mode",
-            name="gitops-mode",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                all_namespaces=True,
-                namespaced_resource_restore_mode="MERGE_SKIP_ON_CONFLICT",
-                volume_data_restore_policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    all_group_kinds=True,
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-            ))
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.gkebackup.RestorePlanIamPolicy("policy",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            policy_data=admin.policy_data)
         ```
-        ### Gkebackup Restoreplan Restore Order
+
+        ## gkebackup.RestorePlanIamBinding
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="restore-order-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="restore-order",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        restore_order = gcp.gkebackup.RestorePlan("restore_order",
-            name="restore-order",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                all_namespaces=True,
-                namespaced_resource_restore_mode="FAIL_ON_CONFLICT",
-                volume_data_restore_policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    all_group_kinds=True,
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-                restore_order=gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderArgs(
-                    group_kind_dependencies=[
-                        gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencyArgs(
-                            satisfying=gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencySatisfyingArgs(
-                                resource_group="stable.example.com",
-                                resource_kind="kindA",
-                            ),
-                            requiring=gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencyRequiringArgs(
-                                resource_group="stable.example.com",
-                                resource_kind="kindB",
-                            ),
-                        ),
-                        gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencyArgs(
-                            satisfying=gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencySatisfyingArgs(
-                                resource_group="stable.example.com",
-                                resource_kind="kindB",
-                            ),
-                            requiring=gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencyRequiringArgs(
-                                resource_group="stable.example.com",
-                                resource_kind="kindC",
-                            ),
-                        ),
-                    ],
-                ),
-            ))
+        binding = gcp.gkebackup.RestorePlanIamBinding("binding",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
         ```
-        ### Gkebackup Restoreplan Volume Res
+
+        ## gkebackup.RestorePlanIamMember
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="volume-res-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="volume-res",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        volume_res = gcp.gkebackup.RestorePlan("volume_res",
-            name="volume-res",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                all_namespaces=True,
-                namespaced_resource_restore_mode="FAIL_ON_CONFLICT",
-                volume_data_restore_policy="NO_VOLUME_DATA_RESTORATION",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    all_group_kinds=True,
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-                volume_data_restore_policy_bindings=[gcp.gkebackup.RestorePlanRestoreConfigVolumeDataRestorePolicyBindingArgs(
-                    policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                    volume_type="GCE_PERSISTENT_DISK",
-                )],
-            ))
+        member = gcp.gkebackup.RestorePlanIamMember("member",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            role="roles/viewer",
+            member="user:jane@example.com")
         ```
 
         ## Import
 
-        RestorePlan can be imported using any of these accepted formats:
+        For all import syntaxes, the "resource in question" can take any of the following forms:
+
+        * projects/{{project}}/locations/{{location}}/restorePlans/{{name}}
 
-        * `projects/{{project}}/locations/{{location}}/restorePlans/{{name}}`
+        * {{project}}/{{location}}/{{name}}
 
-        * `{{project}}/{{location}}/{{name}}`
+        * {{location}}/{{name}}
 
-        * `{{location}}/{{name}}`
+        * {{name}}
 
-        When using the `pulumi import` command, RestorePlan can be imported using one of the formats above. For example:
+        Any variables not passed in the import command will be taken from the provider configuration.
+
+        Backup for GKE restoreplan IAM resources can be imported using the resource identifiers, role, and member.
+
+        IAM member imports use space-delimited identifiers: the resource in question, the role, and the member identity, e.g.
 
         ```sh
-        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy default projects/{{project}}/locations/{{location}}/restorePlans/{{name}}
+        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy editor "projects/{{project}}/locations/{{location}}/restorePlans/{{restore_plan}} roles/viewer user:jane@example.com"
         ```
 
+        IAM binding imports use space-delimited identifiers: the resource in question and the role, e.g.
+
         ```sh
-        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy default {{project}}/{{location}}/{{name}}
+        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy editor "projects/{{project}}/locations/{{location}}/restorePlans/{{restore_plan}} roles/viewer"
         ```
 
+        IAM policy imports use the identifier of the resource in question, e.g.
+
         ```sh
-        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy default {{location}}/{{name}}
+        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy editor projects/{{project}}/locations/{{location}}/restorePlans/{{restore_plan}}
         ```
 
+        -> **Custom Roles**: If you're importing a IAM resource with a custom role, make sure to use the
+
+         full name of the custom role, e.g. `[projects/my-project|organizations/my-org]/roles/my-custom-role`.
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] location: The region of the Restore Plan.
-        :param pulumi.Input[str] name: The full name of the BackupPlan Resource.
+               Used to find the parent resource to bind the IAM policy to. If not specified,
+               the value will be parsed from the identifier of the parent resource. If no location is provided in the parent identifier and no
+               location is specified, it is taken from the provider configuration.
+        :param pulumi.Input[str] name: Used to find the parent resource to bind the IAM policy to
+        :param pulumi.Input[str] policy_data: The policy data generated by
+               a `organizations_get_iam_policy` data source.
+        :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
+               If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
         """
         ...
     @overload
@@ -707,540 +367,148 @@ class RestorePlanIamPolicy(pulumi.CustomResource):
                  args: RestorePlanIamPolicyArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Represents a Restore Plan instance.
+        Three different resources help you manage your IAM policy for Backup for GKE RestorePlan. Each of these resources serves a different use case:
 
-        To get more information about RestorePlan, see:
+        * `gkebackup.RestorePlanIamPolicy`: Authoritative. Sets the IAM policy for the restoreplan and replaces any existing policy already attached.
+        * `gkebackup.RestorePlanIamBinding`: 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 restoreplan are preserved.
+        * `gkebackup.RestorePlanIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the restoreplan are preserved.
 
-        * [API documentation](https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke/reference/rest/v1/projects.locations.restorePlans)
-        * How-to Guides
-            * [Official Documentation](https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke)
+        A data source can be used to retrieve policy data in advent you do not need creation
 
-        ## Example Usage
+        * `gkebackup.RestorePlanIamPolicy`: Retrieves the IAM policy for the restoreplan
 
-        ### Gkebackup Restoreplan All Namespaces
+        > **Note:** `gkebackup.RestorePlanIamPolicy` **cannot** be used in conjunction with `gkebackup.RestorePlanIamBinding` and `gkebackup.RestorePlanIamMember` or they will fight over what your policy should be.
 
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
+        > **Note:** `gkebackup.RestorePlanIamBinding` resources **can be** used in conjunction with `gkebackup.RestorePlanIamMember` resources **only if** they do not grant privilege to the same role.
 
-        primary = gcp.container.Cluster("primary",
-            name="restore-all-ns-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="restore-all-ns",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        all_ns = gcp.gkebackup.RestorePlan("all_ns",
-            name="restore-all-ns",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                all_namespaces=True,
-                namespaced_resource_restore_mode="FAIL_ON_CONFLICT",
-                volume_data_restore_policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    all_group_kinds=True,
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-            ))
-        ```
-        ### Gkebackup Restoreplan Rollback Namespace
+        ## gkebackup.RestorePlanIamPolicy
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="rollback-ns-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="rollback-ns",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        rollback_ns = gcp.gkebackup.RestorePlan("rollback_ns",
-            name="rollback-ns-rp",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                selected_namespaces=gcp.gkebackup.RestorePlanRestoreConfigSelectedNamespacesArgs(
-                    namespaces=["my-ns"],
-                ),
-                namespaced_resource_restore_mode="DELETE_AND_RESTORE",
-                volume_data_restore_policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    selected_group_kinds=[
-                        gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeSelectedGroupKindArgs(
-                            resource_group="apiextension.k8s.io",
-                            resource_kind="CustomResourceDefinition",
-                        ),
-                        gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeSelectedGroupKindArgs(
-                            resource_group="storage.k8s.io",
-                            resource_kind="StorageClass",
-                        ),
-                    ],
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-            ))
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.gkebackup.RestorePlanIamPolicy("policy",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            policy_data=admin.policy_data)
         ```
-        ### Gkebackup Restoreplan Protected Application
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="rollback-app-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="rollback-app",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        rollback_app = gcp.gkebackup.RestorePlan("rollback_app",
-            name="rollback-app-rp",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                selected_applications=gcp.gkebackup.RestorePlanRestoreConfigSelectedApplicationsArgs(
-                    namespaced_names=[gcp.gkebackup.RestorePlanRestoreConfigSelectedApplicationsNamespacedNameArgs(
-                        name="my-app",
-                        namespace="my-ns",
-                    )],
-                ),
-                namespaced_resource_restore_mode="DELETE_AND_RESTORE",
-                volume_data_restore_policy="REUSE_VOLUME_HANDLE_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    no_group_kinds=True,
-                ),
-            ))
-        ```
-        ### Gkebackup Restoreplan All Cluster Resources
+        ## gkebackup.RestorePlanIamBinding
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="all-groupkinds-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="all-groupkinds",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        all_cluster_resources = gcp.gkebackup.RestorePlan("all_cluster_resources",
-            name="all-groupkinds-rp",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                no_namespaces=True,
-                namespaced_resource_restore_mode="FAIL_ON_CONFLICT",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    all_group_kinds=True,
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-            ))
+        binding = gcp.gkebackup.RestorePlanIamBinding("binding",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
         ```
-        ### Gkebackup Restoreplan Rename Namespace
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="rename-ns-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="rename-ns",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        rename_ns = gcp.gkebackup.RestorePlan("rename_ns",
-            name="rename-ns-rp",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                selected_namespaces=gcp.gkebackup.RestorePlanRestoreConfigSelectedNamespacesArgs(
-                    namespaces=["ns1"],
-                ),
-                namespaced_resource_restore_mode="FAIL_ON_CONFLICT",
-                volume_data_restore_policy="REUSE_VOLUME_HANDLE_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    no_group_kinds=True,
-                ),
-                transformation_rules=[
-                    gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleArgs(
-                        description="rename namespace from ns1 to ns2",
-                        resource_filter=gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleResourceFilterArgs(
-                            group_kinds=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleResourceFilterGroupKindArgs(
-                                resource_kind="Namespace",
-                            )],
-                            json_path=".metadata[?(@.name == 'ns1')]",
-                        ),
-                        field_actions=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleFieldActionArgs(
-                            op="REPLACE",
-                            path="/metadata/name",
-                            value="ns2",
-                        )],
-                    ),
-                    gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleArgs(
-                        description="move all resources from ns1 to ns2",
-                        resource_filter=gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleResourceFilterArgs(
-                            namespaces=["ns1"],
-                        ),
-                        field_actions=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleFieldActionArgs(
-                            op="REPLACE",
-                            path="/metadata/namespace",
-                            value="ns2",
-                        )],
-                    ),
-                ],
-            ))
-        ```
-        ### Gkebackup Restoreplan Second Transformation
+        ## gkebackup.RestorePlanIamMember
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="transform-rule-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="transform-rule",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        transform_rule = gcp.gkebackup.RestorePlan("transform_rule",
-            name="transform-rule-rp",
-            description="copy nginx env variables",
-            labels={
-                "app": "nginx",
-            },
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                excluded_namespaces=gcp.gkebackup.RestorePlanRestoreConfigExcludedNamespacesArgs(
-                    namespaces=["my-ns"],
-                ),
-                namespaced_resource_restore_mode="DELETE_AND_RESTORE",
-                volume_data_restore_policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    excluded_group_kinds=[gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeExcludedGroupKindArgs(
-                        resource_group="apiextension.k8s.io",
-                        resource_kind="CustomResourceDefinition",
-                    )],
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-                transformation_rules=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleArgs(
-                    description="Copy environment variables from the nginx container to the install init container.",
-                    resource_filter=gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleResourceFilterArgs(
-                        group_kinds=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleResourceFilterGroupKindArgs(
-                            resource_kind="Pod",
-                            resource_group="",
-                        )],
-                        json_path=".metadata[?(@.name == 'nginx')]",
-                    ),
-                    field_actions=[gcp.gkebackup.RestorePlanRestoreConfigTransformationRuleFieldActionArgs(
-                        op="COPY",
-                        path="/spec/initContainers/0/env",
-                        from_path="/spec/containers/0/env",
-                    )],
-                )],
-            ))
+        member = gcp.gkebackup.RestorePlanIamMember("member",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            role="roles/viewer",
+            member="user:jane@example.com")
         ```
-        ### Gkebackup Restoreplan Gitops Mode
+
+        ## gkebackup.RestorePlanIamPolicy
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="gitops-mode-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="gitops-mode",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        gitops_mode = gcp.gkebackup.RestorePlan("gitops_mode",
-            name="gitops-mode",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                all_namespaces=True,
-                namespaced_resource_restore_mode="MERGE_SKIP_ON_CONFLICT",
-                volume_data_restore_policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    all_group_kinds=True,
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-            ))
+        admin = gcp.organizations.get_iam_policy(bindings=[{
+            "role": "roles/viewer",
+            "members": ["user:jane@example.com"],
+        }])
+        policy = gcp.gkebackup.RestorePlanIamPolicy("policy",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            policy_data=admin.policy_data)
         ```
-        ### Gkebackup Restoreplan Restore Order
+
+        ## gkebackup.RestorePlanIamBinding
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="restore-order-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="restore-order",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        restore_order = gcp.gkebackup.RestorePlan("restore_order",
-            name="restore-order",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                all_namespaces=True,
-                namespaced_resource_restore_mode="FAIL_ON_CONFLICT",
-                volume_data_restore_policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    all_group_kinds=True,
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-                restore_order=gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderArgs(
-                    group_kind_dependencies=[
-                        gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencyArgs(
-                            satisfying=gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencySatisfyingArgs(
-                                resource_group="stable.example.com",
-                                resource_kind="kindA",
-                            ),
-                            requiring=gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencyRequiringArgs(
-                                resource_group="stable.example.com",
-                                resource_kind="kindB",
-                            ),
-                        ),
-                        gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencyArgs(
-                            satisfying=gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencySatisfyingArgs(
-                                resource_group="stable.example.com",
-                                resource_kind="kindB",
-                            ),
-                            requiring=gcp.gkebackup.RestorePlanRestoreConfigRestoreOrderGroupKindDependencyRequiringArgs(
-                                resource_group="stable.example.com",
-                                resource_kind="kindC",
-                            ),
-                        ),
-                    ],
-                ),
-            ))
+        binding = gcp.gkebackup.RestorePlanIamBinding("binding",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
         ```
-        ### Gkebackup Restoreplan Volume Res
+
+        ## gkebackup.RestorePlanIamMember
 
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
-        primary = gcp.container.Cluster("primary",
-            name="volume-res-cluster",
-            location="us-central1",
-            initial_node_count=1,
-            workload_identity_config=gcp.container.ClusterWorkloadIdentityConfigArgs(
-                workload_pool="my-project-name.svc.id.goog",
-            ),
-            addons_config=gcp.container.ClusterAddonsConfigArgs(
-                gke_backup_agent_config=gcp.container.ClusterAddonsConfigGkeBackupAgentConfigArgs(
-                    enabled=True,
-                ),
-            ),
-            deletion_protection="",
-            network="default",
-            subnetwork="default")
-        basic = gcp.gkebackup.BackupPlan("basic",
-            name="volume-res",
-            cluster=primary.id,
-            location="us-central1",
-            backup_config=gcp.gkebackup.BackupPlanBackupConfigArgs(
-                include_volume_data=True,
-                include_secrets=True,
-                all_namespaces=True,
-            ))
-        volume_res = gcp.gkebackup.RestorePlan("volume_res",
-            name="volume-res",
-            location="us-central1",
-            backup_plan=basic.id,
-            cluster=primary.id,
-            restore_config=gcp.gkebackup.RestorePlanRestoreConfigArgs(
-                all_namespaces=True,
-                namespaced_resource_restore_mode="FAIL_ON_CONFLICT",
-                volume_data_restore_policy="NO_VOLUME_DATA_RESTORATION",
-                cluster_resource_restore_scope=gcp.gkebackup.RestorePlanRestoreConfigClusterResourceRestoreScopeArgs(
-                    all_group_kinds=True,
-                ),
-                cluster_resource_conflict_policy="USE_EXISTING_VERSION",
-                volume_data_restore_policy_bindings=[gcp.gkebackup.RestorePlanRestoreConfigVolumeDataRestorePolicyBindingArgs(
-                    policy="RESTORE_VOLUME_DATA_FROM_BACKUP",
-                    volume_type="GCE_PERSISTENT_DISK",
-                )],
-            ))
+        member = gcp.gkebackup.RestorePlanIamMember("member",
+            project=all_ns["project"],
+            location=all_ns["location"],
+            name=all_ns["name"],
+            role="roles/viewer",
+            member="user:jane@example.com")
         ```
 
         ## Import
 
-        RestorePlan can be imported using any of these accepted formats:
+        For all import syntaxes, the "resource in question" can take any of the following forms:
+
+        * projects/{{project}}/locations/{{location}}/restorePlans/{{name}}
 
-        * `projects/{{project}}/locations/{{location}}/restorePlans/{{name}}`
+        * {{project}}/{{location}}/{{name}}
 
-        * `{{project}}/{{location}}/{{name}}`
+        * {{location}}/{{name}}
 
-        * `{{location}}/{{name}}`
+        * {{name}}
 
-        When using the `pulumi import` command, RestorePlan can be imported using one of the formats above. For example:
+        Any variables not passed in the import command will be taken from the provider configuration.
+
+        Backup for GKE restoreplan IAM resources can be imported using the resource identifiers, role, and member.
+
+        IAM member imports use space-delimited identifiers: the resource in question, the role, and the member identity, e.g.
 
         ```sh
-        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy default projects/{{project}}/locations/{{location}}/restorePlans/{{name}}
+        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy editor "projects/{{project}}/locations/{{location}}/restorePlans/{{restore_plan}} roles/viewer user:jane@example.com"
         ```
 
+        IAM binding imports use space-delimited identifiers: the resource in question and the role, e.g.
+
         ```sh
-        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy default {{project}}/{{location}}/{{name}}
+        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy editor "projects/{{project}}/locations/{{location}}/restorePlans/{{restore_plan}} roles/viewer"
         ```
 
+        IAM policy imports use the identifier of the resource in question, e.g.
+
         ```sh
-        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy default {{location}}/{{name}}
+        $ pulumi import gcp:gkebackup/restorePlanIamPolicy:RestorePlanIamPolicy editor projects/{{project}}/locations/{{location}}/restorePlans/{{restore_plan}}
         ```
 
+        -> **Custom Roles**: If you're importing a IAM resource with a custom role, make sure to use the
+
+         full name of the custom role, e.g. `[projects/my-project|organizations/my-org]/roles/my-custom-role`.
+
         :param str resource_name: The name of the resource.
         :param RestorePlanIamPolicyArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -1298,8 +566,16 @@ class RestorePlanIamPolicy(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[str] etag: (Computed) The etag of the IAM policy.
         :param pulumi.Input[str] location: The region of the Restore Plan.
-        :param pulumi.Input[str] name: The full name of the BackupPlan Resource.
+               Used to find the parent resource to bind the IAM policy to. If not specified,
+               the value will be parsed from the identifier of the parent resource. If no location is provided in the parent identifier and no
+               location is specified, it is taken from the provider configuration.
+        :param pulumi.Input[str] name: Used to find the parent resource to bind the IAM policy to
+        :param pulumi.Input[str] policy_data: The policy data generated by
+               a `organizations_get_iam_policy` data source.
+        :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
+               If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -1315,6 +591,9 @@ class RestorePlanIamPolicy(pulumi.CustomResource):
     @property
     @pulumi.getter
     def etag(self) -> pulumi.Output[str]:
+        """
+        (Computed) The etag of the IAM policy.
+        """
         return pulumi.get(self, "etag")
 
     @property
@@ -1322,6 +601,9 @@ class RestorePlanIamPolicy(pulumi.CustomResource):
     def location(self) -> pulumi.Output[str]:
         """
         The region of the Restore Plan.
+        Used to find the parent resource to bind the IAM policy to. If not specified,
+        the value will be parsed from the identifier of the parent resource. If no location is provided in the parent identifier and no
+        location is specified, it is taken from the provider configuration.
         """
         return pulumi.get(self, "location")
 
@@ -1329,17 +611,25 @@ class RestorePlanIamPolicy(pulumi.CustomResource):
     @pulumi.getter
     def name(self) -> pulumi.Output[str]:
         """
-        The full name of the BackupPlan Resource.
+        Used to find the parent resource to bind the IAM policy to
         """
         return pulumi.get(self, "name")
 
     @property
     @pulumi.getter(name="policyData")
     def policy_data(self) -> pulumi.Output[str]:
+        """
+        The policy data generated by
+        a `organizations_get_iam_policy` data source.
+        """
         return pulumi.get(self, "policy_data")
 
     @property
     @pulumi.getter
     def project(self) -> pulumi.Output[str]:
+        """
+        The ID of the project in which the resource belongs.
+        If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
+        """
         return pulumi.get(self, "project")