google-cloud-deploy-v1 1.2.2 → 1.4.0

data/proto_docs/google/cloud/deploy/v1/cloud_deploy.rb

@@ -340,9 +340,35 @@ module Google
           #   @return [::String]
           #     Optional. The label to use when selecting Pods for the Deployment and
           #     Service resources. This label must already be present in both resources.
+          # @!attribute [rw] route_destinations
+          #   @return [::Google::Cloud::Deploy::V1::KubernetesConfig::GatewayServiceMesh::RouteDestinations]
+          #     Optional. Route destinations allow configuring the Gateway API HTTPRoute
+          #     to be deployed to additional clusters. This option is available for
+          #     multi-cluster service mesh set ups that require the route to exist in the
+          #     clusters that call the service. If unspecified, the HTTPRoute will only
+          #     be deployed to the Target cluster.
           class GatewayServiceMesh
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Information about route destinations for the Gateway API service mesh.
+            # @!attribute [rw] destination_ids
+            #   @return [::Array<::String>]
+            #     Required. The clusters where the Gateway API HTTPRoute resource will be
+            #     deployed to. Valid entries include the associated entities IDs
+            #     configured in the Target resource and "@self" to include the Target
+            #     cluster.
+            # @!attribute [rw] propagate_service
+            #   @return [::Boolean]
+            #     Optional. Whether to propagate the Kubernetes Service to the route
+            #     destination clusters. The Service will always be deployed to the Target
+            #     cluster even if the HTTPRoute is not. This option may be used to
+            #     facilitiate successful DNS lookup in the route destination clusters.
+            #     Can only be set to true if destinations are specified.
+            class RouteDestinations
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
 
           # Information about the Kubernetes Service networking configuration.
@@ -684,6 +710,10 @@ module Google
         #   @return [::Boolean]
         #     Optional. If set to true, the request is validated and the user is provided
         #     with a `RollbackTargetResponse`.
+        # @!attribute [rw] override_deploy_policy
+        #   @return [::Array<::String>]
+        #     Optional. Deploy policies to override. Format is
+        #     `projects/{project}/locations/{location}/deployPolicies/{deploy_policy}`.
         class RollbackTargetRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -759,6 +789,16 @@ module Google
         # @!attribute [rw] custom_target
         #   @return [::Google::Cloud::Deploy::V1::CustomTarget]
         #     Optional. Information specifying a Custom Target.
+        # @!attribute [rw] associated_entities
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Deploy::V1::AssociatedEntities}]
+        #     Optional. Map of entity IDs to their associated entities. Associated
+        #     entities allows specifying places other than the deployment target for
+        #     specific features. For example, the Gateway API canary can be configured to
+        #     deploy the HTTPRoute to a different cluster(s) than the deployment cluster
+        #     using associated entities. An entity ID must consist of lower-case letters,
+        #     numbers, and hyphens, start with a letter and end with a letter or a
+        #     number, and have a max length of 63 characters. In other words, it must
+        #     match the following regex: `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`.
         # @!attribute [rw] etag
         #   @return [::String]
         #     Optional. This checksum is computed by the server based on the value of
@@ -798,6 +838,15 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::Deploy::V1::AssociatedEntities]
+          class AssociatedEntitiesEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # @!attribute [rw] key
           #   @return [::String]
           # @!attribute [rw] value
@@ -923,11 +972,16 @@ module Google
         #
         #     Only specify this option when `cluster` is a [private GKE
         #     cluster](https://cloud.google.com/kubernetes-engine/docs/concepts/private-cluster-concept).
+        #     Note that `internal_ip` and `dns_endpoint` cannot both be set to true.
         # @!attribute [rw] proxy_url
         #   @return [::String]
         #     Optional. If set, used to configure a
         #     [proxy](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/#proxy)
         #     to the Kubernetes server.
+        # @!attribute [rw] dns_endpoint
+        #   @return [::Boolean]
+        #     Optional. If set, the cluster will be accessed using the DNS endpoint. Note
+        #     that `dns_endpoint` and `internal_ip` cannot both be set to true.
         class GkeCluster
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -973,6 +1027,18 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Information about entities associated with a `Target`.
+        # @!attribute [rw] gke_clusters
+        #   @return [::Array<::Google::Cloud::Deploy::V1::GkeCluster>]
+        #     Optional. Information specifying GKE clusters as associated entities.
+        # @!attribute [rw] anthos_clusters
+        #   @return [::Array<::Google::Cloud::Deploy::V1::AnthosCluster>]
+        #     Optional. Information specifying Anthos clusters as associated entities.
+        class AssociatedEntities
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The request object for `ListTargets`.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -1474,7 +1540,158 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Contains criteria for selecting Targets.
+        # A `DeployPolicy` resource in the Cloud Deploy API.
+        #
+        # A `DeployPolicy` inhibits manual or automation-driven actions within a
+        # Delivery Pipeline or Target.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. Name of the `DeployPolicy`. Format is
+        #     `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
+        #     The `deployPolicy` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`
+        # @!attribute [r] uid
+        #   @return [::String]
+        #     Output only. Unique identifier of the `DeployPolicy`.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Description of the `DeployPolicy`. Max length is 255 characters.
+        # @!attribute [rw] annotations
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     User annotations. These attributes can only be set and used by the
+        #     user, and not by Cloud Deploy. Annotations must meet the following
+        #     constraints:
+        #
+        #     * Annotations are key/value pairs.
+        #     * Valid annotation keys have two segments: an optional prefix and name,
+        #     separated by a slash (`/`).
+        #     * The name segment is required and must be 63 characters or less,
+        #     beginning and ending with an alphanumeric character (`[a-z0-9A-Z]`) with
+        #     dashes (`-`), underscores (`_`), dots (`.`), and alphanumerics between.
+        #     * The prefix is optional. If specified, the prefix must be a DNS subdomain:
+        #     a series of DNS labels separated by dots(`.`), not longer than 253
+        #     characters in total, followed by a slash (`/`).
+        #
+        #     See
+        #     https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/#syntax-and-character-set
+        #     for more details.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Labels are attributes that can be set and used by both the
+        #     user and by Cloud Deploy. Labels must meet the following constraints:
+        #
+        #     * Keys and values can contain only lowercase letters, numeric characters,
+        #     underscores, and dashes.
+        #     * All characters must use UTF-8 encoding, and international characters are
+        #     allowed.
+        #     * Keys must start with a lowercase letter or international character.
+        #     * Each resource is limited to a maximum of 64 labels.
+        #
+        #     Both keys and values are additionally constrained to be <= 128 bytes.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Time at which the deploy policy was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Most recent time at which the deploy policy was updated.
+        # @!attribute [rw] suspended
+        #   @return [::Boolean]
+        #     When suspended, the policy will not prevent actions from occurring, even
+        #     if the action violates the policy.
+        # @!attribute [rw] selectors
+        #   @return [::Array<::Google::Cloud::Deploy::V1::DeployPolicyResourceSelector>]
+        #     Required. Selected resources to which the policy will be applied. At least
+        #     one selector is required. If one selector matches the resource the policy
+        #     applies. For example, if there are two selectors and the action being
+        #     attempted matches one of them, the policy will apply to that action.
+        # @!attribute [rw] rules
+        #   @return [::Array<::Google::Cloud::Deploy::V1::PolicyRule>]
+        #     Required. Rules to apply. At least one rule must be present.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     The weak etag of the `Automation` resource.
+        #     This checksum is computed by the server based on the value of other
+        #     fields, and may be sent on update and delete requests to ensure the
+        #     client has an up-to-date value before proceeding.
+        class DeployPolicy
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class AnnotationsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # What invoked the action. Filters enforcing the policy depending on what
+          # invoked the action.
+          module Invoker
+            # Unspecified.
+            INVOKER_UNSPECIFIED = 0
+
+            # The action is user-driven. For example, creating a rollout manually via a
+            # gcloud create command.
+            USER = 1
+
+            # Automated action by Cloud Deploy.
+            DEPLOY_AUTOMATION = 2
+          end
+        end
+
+        # Contains information on the resources to select for a deploy policy.
+        # Attributes provided must all match the resource in order for policy
+        # restrictions to apply. For example, if delivery pipelines attributes given
+        # are an id "prod" and labels "foo: bar", a delivery pipeline resource must
+        # match both that id and have that label in order to be subject to the policy.
+        # @!attribute [rw] delivery_pipeline
+        #   @return [::Google::Cloud::Deploy::V1::DeliveryPipelineAttribute]
+        #     Optional. Contains attributes about a delivery pipeline.
+        # @!attribute [rw] target
+        #   @return [::Google::Cloud::Deploy::V1::TargetAttribute]
+        #     Optional. Contains attributes about a target.
+        class DeployPolicyResourceSelector
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Contains criteria for selecting DeliveryPipelines.
+        # @!attribute [rw] id
+        #   @return [::String]
+        #     ID of the `DeliveryPipeline`. The value of this field could be one of the
+        #     following:
+        #
+        #     * The last segment of a pipeline name
+        #     * "*", all delivery pipelines in a location
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     DeliveryPipeline labels.
+        class DeliveryPipelineAttribute
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Contains criteria for selecting Targets. This could be used to select targets
+        # for a Deploy Policy or for an Automation.
         # @!attribute [rw] id
         #   @return [::String]
         #     ID of the `Target`. The value of this field could be one of the
@@ -1499,6 +1716,153 @@ module Google
           end
         end
 
+        # Deploy Policy rule.
+        # @!attribute [rw] rollout_restriction
+        #   @return [::Google::Cloud::Deploy::V1::RolloutRestriction]
+        #     Rollout restrictions.
+        class PolicyRule
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Rollout restrictions.
+        # @!attribute [rw] id
+        #   @return [::String]
+        #     Required. Restriction rule ID. Required and must be unique within a
+        #     DeployPolicy. The format is `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.
+        # @!attribute [rw] invokers
+        #   @return [::Array<::Google::Cloud::Deploy::V1::DeployPolicy::Invoker>]
+        #     Optional. What invoked the action. If left empty, all invoker types will be
+        #     restricted.
+        # @!attribute [rw] actions
+        #   @return [::Array<::Google::Cloud::Deploy::V1::RolloutRestriction::RolloutActions>]
+        #     Optional. Rollout actions to be restricted as part of the policy. If left
+        #     empty, all actions will be restricted.
+        # @!attribute [rw] time_windows
+        #   @return [::Google::Cloud::Deploy::V1::TimeWindows]
+        #     Required. Time window within which actions are restricted.
+        class RolloutRestriction
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Rollout actions to be restricted as part of the policy.
+          module RolloutActions
+            # Unspecified.
+            ROLLOUT_ACTIONS_UNSPECIFIED = 0
+
+            # Advance the rollout to the next phase.
+            ADVANCE = 1
+
+            # Approve the rollout.
+            APPROVE = 2
+
+            # Cancel the rollout.
+            CANCEL = 3
+
+            # Create a rollout.
+            CREATE = 4
+
+            # Ignore a job result on the rollout.
+            IGNORE_JOB = 5
+
+            # Retry a job for a rollout.
+            RETRY_JOB = 6
+
+            # Rollback a rollout.
+            ROLLBACK = 7
+
+            # Terminate a jobrun.
+            TERMINATE_JOBRUN = 8
+          end
+        end
+
+        # Time windows within which actions are restricted. See the
+        # [documentation](https://cloud.google.com/deploy/docs/deploy-policy#dates_times)
+        # for more information on how to configure dates/times.
+        # @!attribute [rw] time_zone
+        #   @return [::String]
+        #     Required. The time zone in IANA format [IANA Time Zone
+        #     Database](https://www.iana.org/time-zones) (e.g. America/New_York).
+        # @!attribute [rw] one_time_windows
+        #   @return [::Array<::Google::Cloud::Deploy::V1::OneTimeWindow>]
+        #     Optional. One-time windows within which actions are restricted.
+        # @!attribute [rw] weekly_windows
+        #   @return [::Array<::Google::Cloud::Deploy::V1::WeeklyWindow>]
+        #     Optional. Recurring weekly windows within which actions are restricted.
+        class TimeWindows
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # One-time window within which actions are restricted. For example, blocking
+        # actions over New Year's Eve from December 31st at 5pm to January 1st at 9am.
+        # @!attribute [rw] start_date
+        #   @return [::Google::Type::Date]
+        #     Required. Start date.
+        # @!attribute [rw] start_time
+        #   @return [::Google::Type::TimeOfDay]
+        #     Required. Start time (inclusive). Use 00:00 for the beginning of the day.
+        # @!attribute [rw] end_date
+        #   @return [::Google::Type::Date]
+        #     Required. End date.
+        # @!attribute [rw] end_time
+        #   @return [::Google::Type::TimeOfDay]
+        #     Required. End time (exclusive). You may use 24:00 for the end of the day.
+        class OneTimeWindow
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Weekly windows. For example, blocking actions every Saturday and Sunday.
+        # Another example would be blocking actions every weekday from 5pm to midnight.
+        # @!attribute [rw] days_of_week
+        #   @return [::Array<::Google::Type::DayOfWeek>]
+        #     Optional. Days of week. If left empty, all days of the week will be
+        #     included.
+        # @!attribute [rw] start_time
+        #   @return [::Google::Type::TimeOfDay]
+        #     Optional. Start time (inclusive). Use 00:00 for the beginning of the day.
+        #     If you specify start_time you must also specify end_time. If left empty,
+        #     this will block for the entire day for the days specified in days_of_week.
+        # @!attribute [rw] end_time
+        #   @return [::Google::Type::TimeOfDay]
+        #     Optional. End time (exclusive). Use 24:00 to indicate midnight. If you
+        #     specify end_time you must also specify start_time. If left empty, this will
+        #     block for the entire day for the days specified in days_of_week.
+        class WeeklyWindow
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Returned from an action if one or more policies were
+        # violated, and therefore the action was prevented. Contains information about
+        # what policies were violated and why.
+        # @!attribute [rw] policy_violation_details
+        #   @return [::Array<::Google::Cloud::Deploy::V1::PolicyViolationDetails>]
+        #     Policy violation details.
+        class PolicyViolation
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Policy violation details.
+        # @!attribute [rw] policy
+        #   @return [::String]
+        #     Name of the policy that was violated.
+        #     Policy resource will be in the format of
+        #     `projects/{project}/locations/{location}/policies/{policy}`.
+        # @!attribute [rw] rule_id
+        #   @return [::String]
+        #     Id of the rule that triggered the policy violation.
+        # @!attribute [rw] failure_message
+        #   @return [::String]
+        #     User readable message about why the request violated a policy. This is not
+        #     intended for machine parsing.
+        class PolicyViolationDetails
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A `Release` resource in the Cloud Deploy API.
         #
         # A `Release` defines a specific Skaffold configuration instance
@@ -1574,9 +1938,9 @@ module Google
         #     client has an up-to-date value before proceeding.
         # @!attribute [rw] skaffold_version
         #   @return [::String]
-        #     The Skaffold version to use when operating on this release, such as
-        #     "1.20.0". Not all versions are valid; Cloud Deploy supports a specific set
-        #     of versions.
+        #     Optional. The Skaffold version to use when operating on this release, such
+        #     as "1.20.0". Not all versions are valid; Cloud Deploy supports a specific
+        #     set of versions.
         #
         #     If unset, the most recent supported Skaffold version will be used.
         # @!attribute [r] target_artifacts
@@ -1782,6 +2146,174 @@ module Google
           end
         end
 
+        # The request object for `CreateDeployPolicy`.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent collection in which the `DeployPolicy` must be
+        #     created. The format is `projects/{project_id}/locations/{location_name}`.
+        # @!attribute [rw] deploy_policy_id
+        #   @return [::String]
+        #     Required. ID of the `DeployPolicy`.
+        # @!attribute [rw] deploy_policy
+        #   @return [::Google::Cloud::Deploy::V1::DeployPolicy]
+        #     Required. The `DeployPolicy` to create.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. A request ID to identify requests. Specify a unique request ID
+        #     so that if you must retry your request, the server knows to ignore the
+        #     request if it has already been completed. The server guarantees that for
+        #     at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and the
+        #     request times out. If you make the request again with the same request ID,
+        #     the server can check if original operation with the same request ID was
+        #     received, and if so, will ignore the second request. This prevents clients
+        #     from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set to true, the request is validated and the user is provided
+        #     with an expected result, but no actual change is made.
+        class CreateDeployPolicyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request object for `UpdateDeployPolicy`.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. Field mask is used to specify the fields to be overwritten by the
+        #     update in the `DeployPolicy` resource. The fields specified in the
+        #     update_mask are relative to the resource, not the full request. A field
+        #     will be overwritten if it's in the mask. If the user doesn't provide a mask
+        #     then all fields are overwritten.
+        # @!attribute [rw] deploy_policy
+        #   @return [::Google::Cloud::Deploy::V1::DeployPolicy]
+        #     Required. The `DeployPolicy` to update.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. A request ID to identify requests. Specify a unique request ID
+        #     so that if you must retry your request, the server knows to ignore the
+        #     request if it has already been completed. The server guarantees that for
+        #     at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and the
+        #     request times out. If you make the request again with the same request ID,
+        #     the server can check if original operation with the same request ID was
+        #     received, and if so, will ignore the second request. This prevents clients
+        #     from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] allow_missing
+        #   @return [::Boolean]
+        #     Optional. If set to true, updating a `DeployPolicy` that does not exist
+        #     will result in the creation of a new `DeployPolicy`.
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set to true, the request is validated and the user is provided
+        #     with an expected result, but no actual change is made.
+        class UpdateDeployPolicyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request object for `DeleteDeployPolicy`.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the `DeployPolicy` to delete. The format is
+        #     `projects/{project_id}/locations/{location_name}/deployPolicies/{deploy_policy_name}`.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. A request ID to identify requests. Specify a unique request ID
+        #     so that if you must retry your request, the server knows to ignore the
+        #     request if it has already been completed. The server guarantees that for
+        #     at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and the
+        #     request times out. If you make the request again with the same request ID,
+        #     the server can check if original operation with the same request ID was
+        #     received, and if so, will ignore the second request. This prevents clients
+        #     from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] allow_missing
+        #   @return [::Boolean]
+        #     Optional. If set to true, then deleting an already deleted or non-existing
+        #     `DeployPolicy` will succeed.
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set, validate the request and preview the review, but do not
+        #     actually post it.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Optional. This checksum is computed by the server based on the value of
+        #     other fields, and may be sent on update and delete requests to ensure the
+        #     client has an up-to-date value before proceeding.
+        class DeleteDeployPolicyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request object for `ListDeployPolicies`.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent, which owns this collection of deploy policies. Format
+        #     must be `projects/{project_id}/locations/{location_name}`.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of deploy policies to return. The service may return
+        #     fewer than this value. If unspecified, at most 50 deploy policies will
+        #     be returned. The maximum value is 1000; values above 1000 will be set
+        #     to 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     A page token, received from a previous `ListDeployPolicies` call.
+        #     Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other provided parameters match
+        #     the call that provided the page token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Filter deploy policies to be returned. See https://google.aip.dev/160 for
+        #     more details. All fields can be used in the filter.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Field to sort by. See https://google.aip.dev/132#ordering for more details.
+        class ListDeployPoliciesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response object from `ListDeployPolicies`.
+        # @!attribute [rw] deploy_policies
+        #   @return [::Array<::Google::Cloud::Deploy::V1::DeployPolicy>]
+        #     The `DeployPolicy` objects.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token, which 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>]
+        #     Locations that could not be reached.
+        class ListDeployPoliciesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request object for `GetDeployPolicy`
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the `DeployPolicy`. Format must be
+        #     `projects/{project_id}/locations/{location_name}/deployPolicies/{deploy_policy_name}`.
+        class GetDeployPolicyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Description of an a image to use during Skaffold rendering.
         # @!attribute [rw] image
         #   @return [::String]
@@ -1968,6 +2500,10 @@ module Google
         #   @return [::Boolean]
         #     Optional. If set to true, the request is validated and the user is provided
         #     with an expected result, but no actual change is made.
+        # @!attribute [rw] override_deploy_policy
+        #   @return [::Array<::String>]
+        #     Optional. Deploy policies to override. Format is
+        #     `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
         class CreateReleaseRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -2065,6 +2601,9 @@ module Google
         # @!attribute [r] rolled_back_by_rollouts
         #   @return [::Array<::String>]
         #     Output only. Names of `Rollouts` that rolled back this `Rollout`.
+        # @!attribute [r] active_repair_automation_run
+        #   @return [::String]
+        #     Output only. The AutomationRun actively repairing the rollout.
         class Rollout
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -2556,6 +3095,10 @@ module Google
         #   @return [::Boolean]
         #     Optional. If set to true, the request is validated and the user is provided
         #     with an expected result, but no actual change is made.
+        # @!attribute [rw] override_deploy_policy
+        #   @return [::Array<::String>]
+        #     Optional. Deploy policies to override. Format is
+        #     `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
         # @!attribute [rw] starting_phase_id
         #   @return [::String]
         #     Optional. The starting phase ID for the `Rollout`. If empty the `Rollout`
@@ -2585,9 +3128,10 @@ module Google
         #   @return [::Boolean]
         #     Output only. Identifies whether the user has requested cancellation
         #     of the operation. Operations that have successfully been cancelled
-        #     have [Operation.error][] value with a
-        #     {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
-        #     `Code.CANCELLED`.
+        #     have
+        #     {::Google::Longrunning::Operation#error google.longrunning.Operation.error}
+        #     value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
+        #     corresponding to `Code.CANCELLED`.
         # @!attribute [r] api_version
         #   @return [::String]
         #     Output only. API version used to start the operation.
@@ -2604,6 +3148,10 @@ module Google
         # @!attribute [rw] approved
         #   @return [::Boolean]
         #     Required. True = approve; false = reject
+        # @!attribute [rw] override_deploy_policy
+        #   @return [::Array<::String>]
+        #     Optional. Deploy policies to override. Format is
+        #     `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
         class ApproveRolloutRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -2623,6 +3171,10 @@ module Google
         # @!attribute [rw] phase_id
         #   @return [::String]
         #     Required. The phase ID to advance the `Rollout` to.
+        # @!attribute [rw] override_deploy_policy
+        #   @return [::Array<::String>]
+        #     Optional. Deploy policies to override. Format is
+        #     `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
         class AdvanceRolloutRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -2639,6 +3191,10 @@ module Google
         #   @return [::String]
         #     Required. Name of the Rollout. Format is
         #     `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`.
+        # @!attribute [rw] override_deploy_policy
+        #   @return [::Array<::String>]
+        #     Optional. Deploy policies to override. Format is
+        #     `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
         class CancelRolloutRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -2661,6 +3217,10 @@ module Google
         # @!attribute [rw] job_id
         #   @return [::String]
         #     Required. The job ID for the Job to ignore.
+        # @!attribute [rw] override_deploy_policy
+        #   @return [::Array<::String>]
+        #     Optional. Deploy policies to override. Format is
+        #     `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
         class IgnoreJobRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -2683,6 +3243,10 @@ module Google
         # @!attribute [rw] job_id
         #   @return [::String]
         #     Required. The job ID for the Job to retry.
+        # @!attribute [rw] override_deploy_policy
+        #   @return [::Array<::String>]
+        #     Optional. Deploy policies to override. Format is
+        #     `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
         class RetryJobRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3062,6 +3626,10 @@ module Google
         #   @return [::String]
         #     Required. Name of the `JobRun`. Format must be
         #     `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}/jobRuns/{jobRun}`.
+        # @!attribute [rw] override_deploy_policy
+        #   @return [::Array<::String>]
+        #     Optional. Deploy policies to override. Format is
+        #     `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
         class TerminateJobRunRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3239,11 +3807,51 @@ module Google
         #   @return [::Google::Cloud::Deploy::V1::RepairRolloutRule]
         #     Optional. The `RepairRolloutRule` will automatically repair a failed
         #     rollout.
+        # @!attribute [rw] timed_promote_release_rule
+        #   @return [::Google::Cloud::Deploy::V1::TimedPromoteReleaseRule]
+        #     Optional. The `TimedPromoteReleaseRule` will automatically promote a
+        #     release from the current target(s) to the specified target(s) on a
+        #     configured schedule.
         class AutomationRule
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # The `TimedPromoteReleaseRule` will automatically promote a release from the
+        # current target(s) to the specified target(s) on a configured schedule.
+        # @!attribute [rw] id
+        #   @return [::String]
+        #     Required. ID of the rule. This ID must be unique in the `Automation`
+        #     resource to which this rule belongs. The format is
+        #     `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.
+        # @!attribute [rw] destination_target_id
+        #   @return [::String]
+        #     Optional. The ID of the stage in the pipeline to which this `Release` is
+        #     deploying. If unspecified, default it to the next stage in the promotion
+        #     flow. The value of this field could be one of the following:
+        #
+        #     * The last segment of a target name
+        #     * "@next", the next target in the promotion sequence
+        # @!attribute [rw] schedule
+        #   @return [::String]
+        #     Required. Schedule in crontab format. e.g. "0 9 * * 1" for every Monday at
+        #     9am.
+        # @!attribute [rw] time_zone
+        #   @return [::String]
+        #     Required. The time zone in IANA format [IANA Time Zone
+        #     Database](https://www.iana.org/time-zones) (e.g. America/New_York).
+        # @!attribute [r] condition
+        #   @return [::Google::Cloud::Deploy::V1::AutomationRuleCondition]
+        #     Output only. Information around the state of the Automation rule.
+        # @!attribute [rw] destination_phase
+        #   @return [::String]
+        #     Optional. The starting phase of the rollout created by this rule. Default
+        #     to the first phase.
+        class TimedPromoteReleaseRule
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The `PromoteRelease` rule will automatically promote a release from the
         # current target to a specified target.
         # @!attribute [rw] id
@@ -3307,6 +3915,14 @@ module Google
         #     Required. ID of the rule. This id must be unique in the `Automation`
         #     resource to which this rule belongs. The format is
         #     `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.
+        # @!attribute [rw] phases
+        #   @return [::Array<::String>]
+        #     Optional. Phases within which jobs are subject to automatic repair actions
+        #     on failure. Proceeds only after phase name matched any one in the list, or
+        #     for all phases if unspecified. This value must consist of lower-case
+        #     letters, numbers, and hyphens, start with a letter and end with a letter or
+        #     a number, and have a max length of 63 characters. In other words, it must
+        #     match the following regex: `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`.
         # @!attribute [rw] jobs
         #   @return [::Array<::String>]
         #     Optional. Jobs to repair. Proceeds only after job name matched any one in
@@ -3319,21 +3935,97 @@ module Google
         # @!attribute [r] condition
         #   @return [::Google::Cloud::Deploy::V1::AutomationRuleCondition]
         #     Output only. Information around the state of the 'Automation' rule.
+        # @!attribute [rw] repair_phases
+        #   @return [::Array<::Google::Cloud::Deploy::V1::RepairPhaseConfig>]
+        #     Required. Defines the types of automatic repair phases for failed jobs.
         class RepairRolloutRule
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Configuration of the repair phase.
+        # @!attribute [rw] retry
+        #   @return [::Google::Cloud::Deploy::V1::Retry]
+        #     Optional. Retries a failed job.
+        # @!attribute [rw] rollback
+        #   @return [::Google::Cloud::Deploy::V1::Rollback]
+        #     Optional. Rolls back a `Rollout`.
+        class RepairPhaseConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Retries the failed job.
+        # @!attribute [rw] attempts
+        #   @return [::Integer]
+        #     Required. Total number of retries. Retry is skipped if set to 0; The
+        #     minimum value is 1, and the maximum value is 10.
+        # @!attribute [rw] wait
+        #   @return [::Google::Protobuf::Duration]
+        #     Optional. How long to wait for the first retry. Default is 0, and the
+        #     maximum value is 14d.
+        # @!attribute [rw] backoff_mode
+        #   @return [::Google::Cloud::Deploy::V1::BackoffMode]
+        #     Optional. The pattern of how wait time will be increased. Default is
+        #     linear. Backoff mode will be ignored if `wait` is 0.
+        class Retry
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Rolls back a `Rollout`.
+        # @!attribute [rw] destination_phase
+        #   @return [::String]
+        #     Optional. The starting phase ID for the `Rollout`. If unspecified, the
+        #     `Rollout` will start in the stable phase.
+        # @!attribute [rw] disable_rollback_if_rollout_pending
+        #   @return [::Boolean]
+        #     Optional. If pending rollout exists on the target, the rollback operation
+        #     will be aborted.
+        class Rollback
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # `AutomationRuleCondition` contains conditions relevant to an
         # `Automation` rule.
         # @!attribute [rw] targets_present_condition
         #   @return [::Google::Cloud::Deploy::V1::TargetsPresentCondition]
         #     Optional. Details around targets enumerated in the rule.
+        # @!attribute [rw] timed_promote_release_condition
+        #   @return [::Google::Cloud::Deploy::V1::TimedPromoteReleaseCondition]
+        #     Optional. TimedPromoteReleaseCondition contains rule conditions specific
+        #     to a an Automation with a timed promote release rule defined.
         class AutomationRuleCondition
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # `TimedPromoteReleaseCondition` contains conditions specific to an Automation
+        # with a Timed Promote Release rule defined.
+        # @!attribute [r] next_promotion_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. When the next scheduled promotion(s) will occur.
+        # @!attribute [r] targets_list
+        #   @return [::Array<::Google::Cloud::Deploy::V1::TimedPromoteReleaseCondition::Targets>]
+        #     Output only. A list of targets involved in the upcoming timed promotion(s).
+        class TimedPromoteReleaseCondition
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The targets involved in a single timed promotion.
+          # @!attribute [rw] source_target_id
+          #   @return [::String]
+          #     Optional. The source target ID.
+          # @!attribute [rw] destination_target_id
+          #   @return [::String]
+          #     Optional. The destination target ID.
+          class Targets
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
         # The request object for `CreateAutomation`.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -3535,9 +4227,9 @@ module Google
         #     time.
         # @!attribute [r] target_id
         #   @return [::String]
-        #     Output only. The ID of the target that represents the promotion stage that
-        #     initiates the `AutomationRun`. The value of this field is the last segment
-        #     of a target name.
+        #     Output only. The ID of the source target that initiates the
+        #     `AutomationRun`. The value of this field is the last segment of a target
+        #     name.
         # @!attribute [r] state
         #   @return [::Google::Cloud::Deploy::V1::AutomationRun::State]
         #     Output only. Current state of the `AutomationRun`.
@@ -3545,6 +4237,10 @@ module Google
         #   @return [::String]
         #     Output only. Explains the current state of the `AutomationRun`. Present
         #     only when an explanation is needed.
+        # @!attribute [r] policy_violation
+        #   @return [::Google::Cloud::Deploy::V1::PolicyViolation]
+        #     Output only. Contains information about what policies prevented the
+        #     `AutomationRun` from proceeding.
         # @!attribute [r] expire_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Time the `AutomationRun` expires. An `AutomationRun` expires
@@ -3564,6 +4260,10 @@ module Google
         # @!attribute [r] repair_rollout_operation
         #   @return [::Google::Cloud::Deploy::V1::RepairRolloutOperation]
         #     Output only. Repairs a failed 'Rollout'.
+        # @!attribute [r] timed_promote_release_operation
+        #   @return [::Google::Cloud::Deploy::V1::TimedPromoteReleaseOperation]
+        #     Output only. Promotes a release to a specified 'Target' as defined in a
+        #     Timed Promote Release rule.
         # @!attribute [r] wait_until_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Earliest time the `AutomationRun` will attempt to resume.
@@ -3639,6 +4339,9 @@ module Google
         # @!attribute [r] rollout
         #   @return [::String]
         #     Output only. The name of the rollout that initiates the `AutomationRun`.
+        # @!attribute [r] current_repair_phase_index
+        #   @return [::Integer]
+        #     Output only. The index of the current repair action in the repair sequence.
         # @!attribute [r] repair_phases
         #   @return [::Array<::Google::Cloud::Deploy::V1::RepairPhase>]
         #     Output only. Records of the repair attempts. Each repair phase may have
@@ -3655,6 +4358,23 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Contains the information of an automated timed promote-release operation.
+        # @!attribute [r] target_id
+        #   @return [::String]
+        #     Output only. The ID of the target that represents the promotion stage to
+        #     which the release will be promoted. The value of this field is the last
+        #     segment of a target name.
+        # @!attribute [r] release
+        #   @return [::String]
+        #     Output only. The name of the release to be promoted.
+        # @!attribute [r] phase
+        #   @return [::String]
+        #     Output only. The starting phase of the rollout created by this operation.
+        class TimedPromoteReleaseOperation
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # RepairPhase tracks the repair attempts that have been made for
         # each `RepairPhaseConfig` specified in the `Automation` resource.
         # @!attribute [r] retry
@@ -3716,6 +4436,9 @@ module Google
         # @!attribute [r] state_desc
         #   @return [::String]
         #     Output only. Description of the state of the Rollback.
+        # @!attribute [r] disable_rollback_if_rollout_pending
+        #   @return [::Boolean]
+        #     Output only. If active rollout exists on the target, abort this rollback.
         class RollbackAttempt
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods