google-cloud-backupdr-v1 1.12.0 → 1.13.0

data/proto_docs/google/cloud/backupdr/v1/autoprotectionpolicybinding.rb

@@ -0,0 +1,207 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module BackupDR
+      module V1
+        # An AutoProtectionPolicyBinding (APPA) acts as the bridge between an
+        # AutoProtectionPolicy and the scope (Project) where
+        # the policy should be applied.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. Identifier. The resource name of the
+        #     AutoProtectionPolicyBinding. Format:
+        #     `projects/{project}/locations/{location}/autoProtectionPolicies/{auto_protection_policy}/bindings/{binding}`
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. A description of the binding. The description must be at most
+        #     2048 characters.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::BackupDR::V1::AutoProtectionPolicyBinding::State]
+        #     Output only. The current state of the AutoProtectionPolicyBinding.
+        # @!attribute [rw] scope
+        #   @return [::String]
+        #     Required. Immutable. Resource Id of target container on which policy will
+        #     be applied. Format: projects/\\{project_id}
+        # @!attribute [r] binding_evaluation_summary
+        #   @return [::Google::Cloud::BackupDR::V1::BindingEvaluationSummary]
+        #     Output only. Summaries of the last policy application when the job has run,
+        #     with one entry per resource type specified in the AutoProtectionPolicy.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the binding was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the binding was last updated.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Output only. The etag for the binding.
+        #     If this is provided on update, it must match the server's etag.
+        class AutoProtectionPolicyBinding
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The state of an AutoProtectionPolicyBinding.
+          module State
+            # The state of the binding is unspecified.
+            STATE_UNSPECIFIED = 0
+
+            # The binding is being created.
+            CREATING = 1
+
+            # The binding is active.
+            ACTIVE = 2
+
+            # The binding deletion is initiated.
+            DELETION_INITIATED = 3
+          end
+        end
+
+        # BindingEvaluationSummary contains the summary of the last run of job
+        # that applies policy to matching resources for a given binding.
+        # @!attribute [r] matching_resource_count
+        #   @return [::Integer]
+        #     Output only. The number of resources that currently match the policy's
+        #     criteria.
+        # @!attribute [r] protected_resource_count
+        #   @return [::Integer]
+        #     Output only. The number of matching resources that are successfully
+        #     protected.
+        # @!attribute [r] failed_resource_count
+        #   @return [::Integer]
+        #     Output only. The number of matching resources whose protection failed
+        #     during job run.
+        class BindingEvaluationSummary
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for creating an AutoProtectionPolicyBinding.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource where this binding will be created.
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}/autoProtectionPolicies/\\{auto_protection_policy}
+        # @!attribute [rw] auto_protection_policy_binding_id
+        #   @return [::String]
+        #     Required. The ID to use for the binding.
+        #     This will become the final component of the binding's resource name.
+        #
+        #     This value must start with a lowercase letter followed by up to 62
+        #     lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
+        # @!attribute [rw] auto_protection_policy_binding
+        #   @return [::Google::Cloud::BackupDR::V1::AutoProtectionPolicyBinding]
+        #     Required. The AutoProtectionPolicyBinding resource to create.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes since the first request.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class CreateAutoProtectionPolicyBindingRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for getting an AutoProtectionPolicyBinding.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the binding to retrieve.
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}/autoProtectionPolicies/\\{auto_protection_policy}/bindings/\\{binding}
+        class GetAutoProtectionPolicyBindingRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for ListAutoProtectionPolicyBindings.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The project and location for which to retrieve the list of
+        #     policies. Format: projects/\\{project}/locations/\\{location}
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of policies to return in a single page is 500.
+        #     If unspecified, a server-default value will be used.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous
+        #     `ListAutoProtectionPolicies` call. Provide this to retrieve the subsequent
+        #     page.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. A filter expression that filters resources listed in the
+        #     response. The following fields are filterable:
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. An expression that sorts the results in the response. The
+        #     following fields are sortable:
+        class ListAutoProtectionPolicyBindingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for ListAutoProtectionPolicyBindings.
+        # @!attribute [rw] auto_protection_policy_bindings
+        #   @return [::Array<::Google::Cloud::BackupDR::V1::AutoProtectionPolicyBinding>]
+        #     A list of the AutoProtectionPolicyBindings resources found.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token that can be sent as `page_token` to retrieve the next page.
+        #     If this field is omitted, there are no subsequent pages.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Unordered list. Locations that could not be reached.
+        class ListAutoProtectionPolicyBindingsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for initiating delete of an AutoProtectionPolicyBinding.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the binding to delete.
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}/autoProtectionPolicies/\\{auto_protection_policy}/bindings/\\{binding}
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Optional. The current etag of the AutoProtectionPolicyBinding.
+        #     If an etag is provided and does not match the current etag of the
+        #     binding, deletion will be blocked and an ABORTED error will be returned.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes since the first request.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class InitiateDeleteAutoProtectionPolicyBindingRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/backupdr/v1/backupplanassociation.rb

@@ -26,7 +26,7 @@ module Google
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. Identifier. The resource name of BackupPlanAssociation in
-        #     below format Format :
+        #     below format Format:
         #     projects/\\{project}/locations/\\{location}/backupPlanAssociations/\\{backupPlanAssociationId}
         # @!attribute [rw] resource_type
         #   @return [::String]
@@ -84,6 +84,11 @@ module Google
         #
         #     Format:
         #     `projects/{project}/locations/{location}/backupPlans/{backup_plan}/revisions/{revision_id}`
+        # @!attribute [r] auto_protection_policy_binding
+        #   @return [::String]
+        #     Output only. The resource name of the `AutoProtectionPolicyBinding` that
+        #     manages this association, if any. Format:
+        #     `projects/{project}/locations/{location}/autoProtectionPolicies/{policy}/bindings/{binding}`.
         class BackupPlanAssociation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -317,6 +322,13 @@ module Google
         #
         #     The request ID must be a valid UUID with the exception that zero UUID is
         #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] auto_protection_policy_binding
+        #   @return [::String]
+        #     Optional. This field is exclusively used by Backup and DR's auto-protection
+        #     feature. The resource name of the `AutoProtectionPolicyBinding` that
+        #     triggered the deletion of this association.
+        #     Format:
+        #     `projects/{project}/locations/{location}/autoProtectionPolicies/{policy}/bindings/{binding}`.
         class DeleteBackupPlanAssociationRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/backupdr/v1/backupvault.rb

@@ -348,6 +348,12 @@ module Google
         #   @return [::String]
         #     The user friendly id of the backup plan revision.
         #     E.g. v0, v1 etc.
+        # @!attribute [r] auto_protection_policy_binding
+        #   @return [::String]
+        #     Output only. The resource name of the `AutoProtectionPolicyBinding` that
+        #     manages this datasource, if any.
+        #     Format:
+        #     `projects/{project}/locations/{location}/autoProtectionPolicies/{policy}/bindings/{binding}`.
         class GcpBackupConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -616,6 +622,9 @@ module Google
         #   @return [::Array<::String>]
         #     Optional. Output only. The list of KMS key versions used to encrypt the
         #     backup.
+        # @!attribute [r] verification_summary
+        #   @return [::Google::Cloud::BackupDR::V1::VerificationSummary]
+        #     Output only. The restore verification status of the backup.
         class Backup
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -693,6 +702,34 @@ module Google
           end
         end
 
+        # VerificationSummary contains the status and timestamp of the
+        # latest Automated Verification test.
+        # @!attribute [r] last_verification_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when the backup was last verified.
+        # @!attribute [r] last_verification_state
+        #   @return [::Google::Cloud::BackupDR::V1::VerificationSummary::LastVerificationState]
+        #     Output only. The state of the last verification.
+        # @!attribute [r] last_verification_execution
+        #   @return [::String]
+        #     Output only. The last verification execution.
+        class VerificationSummary
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # LastVerificationState represents the state of the verification.
+          module LastVerificationState
+            # Verification state is unspecified.
+            STATE_UNSPECIFIED = 0
+
+            # Verification succeeded.
+            SUCCEEDED = 1
+
+            # Verification failed.
+            FAILED = 2
+          end
+        end
+
         # Message for creating a BackupVault.
         # @!attribute [rw] parent
         #   @return [::String]

data/proto_docs/google/cloud/backupdr/v1/bindingmatchingresource.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module BackupDR
+      module V1
+        # Request message for List BindingMatchingResources.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The project, location, auto protection policy and binding for
+        #     which to retrieve `BindingMatchingResources` information. Format:
+        #     `projects/{project}/locations/{location}/autoProtectionPolicies/{auto_protection_policy}/bindings/{binding}`.
+        #     In Google Cloud Backup and DR, locations map to Google Cloud regions, for
+        #     example **us-central1**.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of `BindingMatchingResources` to return in a
+        #     single response. The default page size is 100 and maximum page size is 200.
+        #     Note that the response may include a partial list and a caller should
+        #     only rely on the response's
+        #     {::Google::Cloud::BackupDR::V1::ListBindingMatchingResourcesResponse#next_page_token next_page_token}
+        #     to determine if there are more instances left to be queried.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. The value of
+        #     {::Google::Cloud::BackupDR::V1::ListBindingMatchingResourcesResponse#next_page_token next_page_token}
+        #     received from a previous `ListBindingMatchingResources` call. Provide this
+        #     to retrieve the subsequent page in a multi-page list of results. When
+        #     paginating, all other parameters provided to `ListBindingMatchingResources`
+        #     must match the call that provided the page token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Field match expression used to filter the results.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Field by which to sort the results.
+        class ListBindingMatchingResourcesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response message for getting a list of `BindingMatchingResources`.
+        # @!attribute [rw] matching_resources
+        #   @return [::Array<::Google::Cloud::BackupDR::V1::BindingMatchingResource>]
+        #     The list of `BindingMatchingResources` in the project,location for the
+        #     specified binding.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token which may be sent as
+        #     {::Google::Cloud::BackupDR::V1::ListBindingMatchingResourcesRequest#page_token page_token}
+        #     in a subsequent `ListBindingMatchingResources` call to retrieve the next
+        #     page of results. If this field is omitted or empty, then there are no more
+        #     results to return.
+        class ListBindingMatchingResourcesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # BindingMatchingResource contains the details of a resource that matches the
+        # criteria of a binding.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. Identifier. The resource name of the
+        #     `BindingMatchingResource`. Format:
+        #     `projects/{project}/locations/{location}/autoProtectionPolicies/{auto_protection_policy}/bindings/{binding}/matchingResources/{matching_resource}`
+        # @!attribute [r] resource
+        #   @return [::String]
+        #     Output only. Resource name of the workload that matches the criteria of the
+        #     binding.
+        #
+        #     The format can be either a relative resource name (e.g.,
+        #     `projects/my-project/zones/us-central1-a/instances/my-instance`) or a
+        #     schemeless full resource name (e.g.,
+        #     `//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance`).
+        # @!attribute [r] last_evaluation_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the resource was last evaluated for
+        #     protection.
+        # @!attribute [r] auto_protection_details
+        #   @return [::Google::Cloud::BackupDR::V1::AutoProtectionDetails]
+        #     Output only. The auto protection details of the resource from the current
+        #     binding's perspective.
+        class BindingMatchingResource
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # AutoProtectionDetails contains the protection details of a resource from the
+        # current binding's perspective.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::BackupDR::V1::AutoProtectionDetails::State]
+        #     Output only. Protection state of the resource from the current binding's
+        #     perspective. Output only.
+        # @!attribute [r] backup_plan_association
+        #   @return [::String]
+        #     Output only. Resource name of backup plan association linked to the
+        #     resource, if any. Format:
+        #     projects/\\{project}/locations/\\{location}/backupPlanAssociations/\\{backupPlanAssociationId}
+        # @!attribute [r] data_source
+        #   @return [::String]
+        #     Output only. Resource name of the datasource linked to the resource, if
+        #     any. Format:
+        #     projects/\\{project}/locations/\\{location}/backupVaults/\\{backupVaultId}/dataSources/\\{dataSourceId}
+        # @!attribute [r] error
+        #   @return [::Google::Rpc::Status]
+        #     Output only. Error during last sync for protection/unprotection, if any.
+        class AutoProtectionDetails
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Enum for protection state of the resource.
+          module State
+            # State unspecified.
+            STATE_UNSPECIFIED = 0
+
+            # Resource is protected.
+            PROTECTED = 1
+
+            # Resource protection failed.
+            PROTECTION_FAILED = 2
+
+            # Resource is being unprotected.
+            UNPROTECTING = 3
+
+            # Resource unprotection failed.
+            UNPROTECTION_FAILED = 4
+          end
+        end
+      end
+    end
+  end
+end