{ "ownerName": "Google", "protocol": "rest", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "ownerDomain": "google.com", "version_module": true, "resources": { "projects": { "resources": { "locations": { "methods": { "get": { "parameters": { "name": { "description": "Resource name for the location.", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "location": "path", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "httpMethod": "GET", "response": { "$ref": "Location" }, "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", "description": "Gets information about a location.", "id": "clouddeploy.projects.locations.get" }, "list": { "parameters": { "filter": { "location": "query", "type": "string", "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160)." }, "pageToken": { "type": "string", "location": "query", "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page." }, "pageSize": { "description": "The maximum number of results to return. If not set, the service selects a default.", "format": "int32", "location": "query", "type": "integer" }, "name": { "description": "The resource that owns the locations collection, if applicable.", "pattern": "^projects/[^/]+$", "required": true, "type": "string", "location": "path" }, "extraLocationTypes": { "description": "Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.", "repeated": true, "type": "string", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}/locations", "parameterOrder": [ "name" ], "httpMethod": "GET", "response": { "$ref": "ListLocationsResponse" }, "flatPath": "v1/projects/{projectsId}/locations", "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.", "id": "clouddeploy.projects.locations.list" }, "getConfig": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of requested configuration.", "pattern": "^projects/[^/]+/locations/[^/]+/config$" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/config", "description": "Gets the configuration for a location.", "id": "clouddeploy.projects.locations.getConfig", "parameterOrder": [ "name" ], "httpMethod": "GET", "response": { "$ref": "Config" } } }, "resources": { "targets": { "methods": { "getIamPolicy": { "path": "v1/{+resource}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "resource": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/targets/[^/]+$", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." }, "options.requestedPolicyVersion": { "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "location": "query", "type": "integer" } }, "id": "clouddeploy.projects.locations.targets.getIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/targets/{targetsId}:getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "httpMethod": "GET", "response": { "$ref": "Policy" }, "parameterOrder": [ "resource" ] }, "get": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/targets/{targetsId}", "description": "Gets details of a single Target.", "id": "clouddeploy.projects.locations.targets.get", "httpMethod": "GET", "response": { "$ref": "Target" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/targets/[^/]+$", "description": "Required. Name of the `Target`. Format must be `projects/{project_id}/locations/{location_name}/targets/{target_name}`." } } }, "setIamPolicy": { "httpMethod": "POST", "response": { "$ref": "Policy" }, "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" }, "id": "clouddeploy.projects.locations.targets.setIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/targets/{targetsId}:setIamPolicy", "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/targets/[^/]+$", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "type": "string", "required": true } }, "path": "v1/{+resource}:setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "testIamPermissions": { "id": "clouddeploy.projects.locations.targets.testIamPermissions", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/targets/{targetsId}:testIamPermissions", "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "httpMethod": "POST", "response": { "$ref": "TestIamPermissionsResponse" }, "parameterOrder": [ "resource" ], "request": { "$ref": "TestIamPermissionsRequest" }, "path": "v1/{+resource}:testIamPermissions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "resource": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/targets/[^/]+$", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." } } }, "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/targets", "description": "Lists Targets in a given project and location.", "id": "clouddeploy.projects.locations.targets.list", "httpMethod": "GET", "response": { "$ref": "ListTargetsResponse" }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/targets", "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. The parent, which owns this collection of targets. Format must be `projects/{project_id}/locations/{location_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListTargets` call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters match the call that provided the page token.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filter targets to be returned. See https://google.aip.dev/160 for more details.", "type": "string", "location": "query" }, "pageSize": { "format": "int32", "description": "Optional. The maximum number of `Target` objects to return. The service may return fewer than this value. If unspecified, at most 50 `Target` objects will be returned. The maximum value is 1000; values above 1000 will be set to 1000.", "type": "integer", "location": "query" }, "orderBy": { "location": "query", "type": "string", "description": "Optional. Field to sort by. See https://google.aip.dev/132#ordering for more details." } } }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "allowMissing": { "type": "boolean", "location": "query", "description": "Optional. If set to true, then deleting an already deleted or non-existing `Target` will succeed." }, "etag": { "description": "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.", "type": "string", "location": "query" }, "name": { "required": true, "location": "path", "type": "string", "description": "Required. The name of the `Target` to delete. The format is `projects/{project_id}/locations/{location_name}/targets/{target_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+/targets/[^/]+$" }, "requestId": { "description": "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).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request and preview the review, but do not actually post it.", "type": "boolean", "location": "query" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/targets/{targetsId}", "description": "Deletes a single Target.", "id": "clouddeploy.projects.locations.targets.delete", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "response": { "$ref": "Operation" } }, "create": { "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. The parent collection in which the `Target` must be created. The format is `projects/{project_id}/locations/{location_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "targetId": { "description": "Required. ID of the `Target`.", "location": "query", "type": "string" }, "requestId": { "location": "query", "type": "string", "description": "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)." }, "validateOnly": { "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made.", "location": "query", "type": "boolean" } }, "path": "v1/{+parent}/targets", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "request": { "$ref": "Target" }, "httpMethod": "POST", "response": { "$ref": "Operation" }, "id": "clouddeploy.projects.locations.targets.create", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/targets", "description": "Creates a new Target in a given project and location." }, "patch": { "parameters": { "name": { "description": "Identifier. Name of the `Target`. Format is `projects/{project}/locations/{location}/targets/{target}`. The `target` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`", "pattern": "^projects/[^/]+/locations/[^/]+/targets/[^/]+$", "required": true, "type": "string", "location": "path" }, "updateMask": { "type": "string", "location": "query", "format": "google-fieldmask", "description": "Required. Field mask is used to specify the fields to be overwritten by the update in the `Target` 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." }, "requestId": { "location": "query", "type": "string", "description": "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)." }, "validateOnly": { "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made.", "type": "boolean", "location": "query" }, "allowMissing": { "description": "Optional. If set to true, updating a `Target` that does not exist will result in the creation of a new `Target`.", "type": "boolean", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameterOrder": [ "name" ], "request": { "$ref": "Target" }, "httpMethod": "PATCH", "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/targets/{targetsId}", "description": "Updates the parameters of a single Target.", "id": "clouddeploy.projects.locations.targets.patch" } } }, "operations": { "methods": { "list": { "path": "v1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "description": "The standard list page size.", "format": "int32", "location": "query", "type": "integer" } }, "id": "clouddeploy.projects.locations.operations.list", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "response": { "$ref": "ListOperationsResponse" }, "parameterOrder": [ "name" ] }, "delete": { "httpMethod": "DELETE", "response": { "$ref": "Empty" }, "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "clouddeploy.projects.locations.operations.delete", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true, "type": "string", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" }, "get": { "httpMethod": "GET", "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "clouddeploy.projects.locations.operations.get", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" }, "cancel": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "clouddeploy.projects.locations.operations.cancel", "httpMethod": "POST", "response": { "$ref": "Empty" }, "parameterOrder": [ "name" ], "request": { "$ref": "CancelOperationRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}:cancel", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$" } } } } }, "customTargetTypes": { "methods": { "getIamPolicy": { "parameters": { "resource": { "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/customTargetTypes/[^/]+$", "required": true, "type": "string", "location": "path" }, "options.requestedPolicyVersion": { "type": "integer", "location": "query", "format": "int32", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+resource}:getIamPolicy", "httpMethod": "GET", "response": { "$ref": "Policy" }, "parameterOrder": [ "resource" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/customTargetTypes/{customTargetTypesId}:getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "id": "clouddeploy.projects.locations.customTargetTypes.getIamPolicy" }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "name": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/customTargetTypes/[^/]+$", "description": "Required. Name of the `CustomTargetType`. Format must be `projects/{project_id}/locations/{location_name}/customTargetTypes/{custom_target_type}`." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/customTargetTypes/{customTargetTypesId}", "description": "Gets details of a single CustomTargetType.", "id": "clouddeploy.projects.locations.customTargetTypes.get", "httpMethod": "GET", "response": { "$ref": "CustomTargetType" }, "parameterOrder": [ "name" ] }, "setIamPolicy": { "path": "v1/{+resource}:setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "resource": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/customTargetTypes/[^/]+$", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." } }, "id": "clouddeploy.projects.locations.customTargetTypes.setIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/customTargetTypes/{customTargetTypesId}:setIamPolicy", "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" }, "httpMethod": "POST", "response": { "$ref": "Policy" } }, "list": { "id": "clouddeploy.projects.locations.customTargetTypes.list", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/customTargetTypes", "description": "Lists CustomTargetTypes in a given project and location.", "parameterOrder": [ "parent" ], "httpMethod": "GET", "response": { "$ref": "ListCustomTargetTypesResponse" }, "path": "v1/{+parent}/customTargetTypes", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageSize": { "description": "Optional. The maximum number of `CustomTargetType` objects to return. The service may return fewer than this value. If unspecified, at most 50 `CustomTargetType` objects will be returned. The maximum value is 1000; values above 1000 will be set to 1000.", "format": "int32", "location": "query", "type": "integer" }, "filter": { "type": "string", "location": "query", "description": "Optional. Filter custom target types to be returned. See https://google.aip.dev/160 for more details." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The parent that owns this collection of custom target types. Format must be `projects/{project_id}/locations/{location_name}`.", "location": "path", "type": "string", "required": true }, "pageToken": { "location": "query", "type": "string", "description": "Optional. A page token, received from a previous `ListCustomTargetTypes` call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters match the call that provided the page token." }, "orderBy": { "description": "Optional. Field to sort by. See https://google.aip.dev/132#ordering for more details.", "location": "query", "type": "string" } } }, "delete": { "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "requestId": { "location": "query", "type": "string", "description": "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)." }, "validateOnly": { "description": "Optional. If set to true, the request is validated but no actual change is made.", "type": "boolean", "location": "query" }, "name": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/customTargetTypes/[^/]+$", "description": "Required. The name of the `CustomTargetType` to delete. Format must be `projects/{project_id}/locations/{location_name}/customTargetTypes/{custom_target_type}`." }, "allowMissing": { "location": "query", "type": "boolean", "description": "Optional. If set to true, then deleting an already deleted or non-existing `CustomTargetType` will succeed." }, "etag": { "description": "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.", "location": "query", "type": "string" } }, "id": "clouddeploy.projects.locations.customTargetTypes.delete", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/customTargetTypes/{customTargetTypesId}", "description": "Deletes a single CustomTargetType.", "httpMethod": "DELETE", "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ] }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/customTargetTypes", "parameters": { "requestId": { "description": "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).", "type": "string", "location": "query" }, "validateOnly": { "type": "boolean", "location": "query", "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made." }, "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The parent collection in which the `CustomTargetType` must be created. The format is `projects/{project_id}/locations/{location_name}`." }, "customTargetTypeId": { "description": "Required. ID of the `CustomTargetType`.", "type": "string", "location": "query" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/customTargetTypes", "description": "Creates a new CustomTargetType in a given project and location.", "id": "clouddeploy.projects.locations.customTargetTypes.create", "parameterOrder": [ "parent" ], "request": { "$ref": "CustomTargetType" }, "httpMethod": "POST", "response": { "$ref": "Operation" } }, "patch": { "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/customTargetTypes/[^/]+$", "description": "Identifier. Name of the `CustomTargetType`. Format is `projects/{project}/locations/{location}/customTargetTypes/{customTargetType}`. The `customTargetType` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`", "location": "path", "type": "string", "required": true }, "updateMask": { "location": "query", "type": "string", "description": "Required. Field mask is used to specify the fields to be overwritten by the update in the `CustomTargetType` 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.", "format": "google-fieldmask" }, "requestId": { "location": "query", "type": "string", "description": "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)." }, "validateOnly": { "type": "boolean", "location": "query", "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made." }, "allowMissing": { "description": "Optional. If set to true, updating a `CustomTargetType` that does not exist will result in the creation of a new `CustomTargetType`.", "location": "query", "type": "boolean" } }, "id": "clouddeploy.projects.locations.customTargetTypes.patch", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/customTargetTypes/{customTargetTypesId}", "description": "Updates a single CustomTargetType.", "httpMethod": "PATCH", "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ], "request": { "$ref": "CustomTargetType" } } } }, "deliveryPipelines": { "resources": { "releases": { "resources": { "rollouts": { "methods": { "retryJob": { "parameterOrder": [ "rollout" ], "request": { "$ref": "RetryJobRequest" }, "httpMethod": "POST", "response": { "$ref": "RetryJobResponse" }, "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.retryJob", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts/{rolloutsId}:retryJob", "description": "Retries the specified Job in a Rollout.", "parameters": { "rollout": { "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+/rollouts/[^/]+$", "description": "Required. Name of the Rollout. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`.", "location": "path", "type": "string", "required": true } }, "path": "v1/{+rollout}:retryJob", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "advance": { "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.advance", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts/{rolloutsId}:advance", "description": "Advances a Rollout in a given project and location.", "parameterOrder": [ "name" ], "request": { "$ref": "AdvanceRolloutRequest" }, "httpMethod": "POST", "response": { "$ref": "AdvanceRolloutResponse" }, "path": "v1/{+name}:advance", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+/rollouts/[^/]+$", "description": "Required. Name of the Rollout. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`." } } }, "cancel": { "httpMethod": "POST", "response": { "$ref": "CancelRolloutResponse" }, "parameterOrder": [ "name" ], "request": { "$ref": "CancelRolloutRequest" }, "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.cancel", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts/{rolloutsId}:cancel", "description": "Cancels a Rollout in a given project and location.", "parameters": { "name": { "description": "Required. Name of the Rollout. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+/rollouts/[^/]+$", "required": true, "location": "path", "type": "string" } }, "path": "v1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the `Rollout`. Format must be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/releases/{release_name}/rollouts/{rollout_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+/rollouts/[^/]+$", "required": true, "location": "path", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts/{rolloutsId}", "description": "Gets details of a single Rollout.", "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.get", "parameterOrder": [ "name" ], "httpMethod": "GET", "response": { "$ref": "Rollout" } }, "approve": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts/{rolloutsId}:approve", "description": "Approves a Rollout.", "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.approve", "parameterOrder": [ "name" ], "request": { "$ref": "ApproveRolloutRequest" }, "httpMethod": "POST", "response": { "$ref": "ApproveRolloutResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}:approve", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the Rollout. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+/rollouts/[^/]+$" } } }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/rollouts", "parameters": { "startingPhaseId": { "description": "Optional. The starting phase ID for the `Rollout`. If empty the `Rollout` will start at the first phase.", "type": "string", "location": "query" }, "requestId": { "description": "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).", "type": "string", "location": "query" }, "validateOnly": { "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made.", "type": "boolean", "location": "query" }, "overrideDeployPolicy": { "type": "string", "location": "query", "description": "Optional. Deploy policies to override. Format is `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.", "repeated": true }, "parent": { "required": true, "location": "path", "type": "string", "description": "Required. The parent collection in which the `Rollout` must be created. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/releases/{release_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+$" }, "rolloutId": { "description": "Required. ID of the `Rollout`.", "location": "query", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts", "description": "Creates a new Rollout in a given project and location.", "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.create", "httpMethod": "POST", "response": { "$ref": "Operation" }, "parameterOrder": [ "parent" ], "request": { "$ref": "Rollout" } }, "ignoreJob": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts/{rolloutsId}:ignoreJob", "description": "Ignores the specified Job in a Rollout.", "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.ignoreJob", "parameterOrder": [ "rollout" ], "request": { "$ref": "IgnoreJobRequest" }, "httpMethod": "POST", "response": { "$ref": "IgnoreJobResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+rollout}:ignoreJob", "parameters": { "rollout": { "description": "Required. Name of the Rollout. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+/rollouts/[^/]+$", "required": true, "type": "string", "location": "path" } } }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/rollouts", "parameters": { "pageSize": { "description": "Optional. The maximum number of `Rollout` objects to return. The service may return fewer than this value. If unspecified, at most 50 `Rollout` objects will be returned. The maximum value is 1000; values above 1000 will be set to 1000.", "format": "int32", "location": "query", "type": "integer" }, "parent": { "required": true, "location": "path", "type": "string", "description": "Required. The `Release` which owns this collection of `Rollout` objects.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+$" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListRollouts` call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters match the call that provided the page token.", "type": "string", "location": "query" }, "filter": { "type": "string", "location": "query", "description": "Optional. Filter rollouts to be returned. See https://google.aip.dev/160 for more details." }, "orderBy": { "description": "Optional. Field to sort by. See https://google.aip.dev/132#ordering for more details.", "type": "string", "location": "query" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts", "description": "Lists Rollouts in a given project and location.", "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.list", "parameterOrder": [ "parent" ], "httpMethod": "GET", "response": { "$ref": "ListRolloutsResponse" } } }, "resources": { "jobRuns": { "methods": { "terminate": { "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.jobRuns.terminate", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts/{rolloutsId}/jobRuns/{jobRunsId}:terminate", "description": "Terminates a Job Run in a given project and location.", "parameterOrder": [ "name" ], "request": { "$ref": "TerminateJobRunRequest" }, "httpMethod": "POST", "response": { "$ref": "TerminateJobRunResponse" }, "path": "v1/{+name}:terminate", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the `JobRun`. Format must be `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}/jobRuns/{jobRun}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+/rollouts/[^/]+/jobRuns/[^/]+$" } } }, "list": { "parameters": { "orderBy": { "description": "Optional. Field to sort by. See https://google.aip.dev/132#ordering for more details.", "location": "query", "type": "string" }, "parent": { "required": true, "location": "path", "type": "string", "description": "Required. The `Rollout` which owns this collection of `JobRun` objects.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+/rollouts/[^/]+$" }, "pageToken": { "location": "query", "type": "string", "description": "Optional. A page token, received from a previous `ListJobRuns` call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters match the call that provided the page token." }, "filter": { "description": "Optional. Filter results to be returned. See https://google.aip.dev/160 for more details.", "location": "query", "type": "string" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "Optional. The maximum number of `JobRun` objects to return. The service may return fewer than this value. If unspecified, at most 50 `JobRun` objects will be returned. The maximum value is 1000; values above 1000 will be set to 1000." } }, "path": "v1/{+parent}/jobRuns", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "ListJobRunsResponse" }, "parameterOrder": [ "parent" ], "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.jobRuns.list", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts/{rolloutsId}/jobRuns", "description": "Lists JobRuns in a given project and location." }, "get": { "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the `JobRun`. Format must be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/releases/{release_name}/rollouts/{rollout_name}/jobRuns/{job_run_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+/rollouts/[^/]+/jobRuns/[^/]+$" } }, "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "GET", "response": { "$ref": "JobRun" }, "id": "clouddeploy.projects.locations.deliveryPipelines.releases.rollouts.jobRuns.get", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}/rollouts/{rolloutsId}/jobRuns/{jobRunsId}", "description": "Gets details of a single JobRun." } } } } } }, "methods": { "get": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}", "description": "Gets details of a single Release.", "id": "clouddeploy.projects.locations.deliveryPipelines.releases.get", "httpMethod": "GET", "response": { "$ref": "Release" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the `Release`. Format must be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/releases/{release_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+$", "required": true, "location": "path", "type": "string" } } }, "create": { "parameterOrder": [ "parent" ], "request": { "$ref": "Release" }, "httpMethod": "POST", "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases", "description": "Creates a new Release in a given project and location.", "id": "clouddeploy.projects.locations.deliveryPipelines.releases.create", "parameters": { "parent": { "description": "Required. The parent collection in which the `Release` is created. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "required": true, "location": "path", "type": "string" }, "requestId": { "description": "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).", "location": "query", "type": "string" }, "validateOnly": { "location": "query", "type": "boolean", "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made." }, "overrideDeployPolicy": { "location": "query", "type": "string", "description": "Optional. Deploy policies to override. Format is `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.", "repeated": true }, "releaseId": { "description": "Required. ID of the `Release`.", "type": "string", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/releases" }, "list": { "httpMethod": "GET", "response": { "$ref": "ListReleasesResponse" }, "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases", "description": "Lists Releases in a given project and location.", "id": "clouddeploy.projects.locations.deliveryPipelines.releases.list", "parameters": { "orderBy": { "description": "Optional. Field to sort by. See https://google.aip.dev/132#ordering for more details.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filter releases to be returned. See https://google.aip.dev/160 for more details.", "type": "string", "location": "query" }, "parent": { "description": "Required. The `DeliveryPipeline` which owns this collection of `Release` objects.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "required": true, "type": "string", "location": "path" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListReleases` call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters match the call that provided the page token.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "type": "integer", "description": "Optional. The maximum number of `Release` objects to return. The service may return fewer than this value. If unspecified, at most 50 `Release` objects will be returned. The maximum value is 1000; values above 1000 will be set to 1000.", "format": "int32" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/releases" }, "abandon": { "path": "v1/{+name}:abandon", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the Release. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+$" } }, "id": "clouddeploy.projects.locations.deliveryPipelines.releases.abandon", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/releases/{releasesId}:abandon", "description": "Abandons a Release in the Delivery Pipeline.", "parameterOrder": [ "name" ], "request": { "$ref": "AbandonReleaseRequest" }, "httpMethod": "POST", "response": { "$ref": "AbandonReleaseResponse" } } } }, "automations": { "methods": { "create": { "path": "v1/{+parent}/automations", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "requestId": { "location": "query", "type": "string", "description": "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)." }, "validateOnly": { "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made.", "type": "boolean", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "description": "Required. The parent collection in which the `Automation` must be created. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", "location": "path", "type": "string", "required": true }, "automationId": { "location": "query", "type": "string", "description": "Required. ID of the `Automation`." } }, "id": "clouddeploy.projects.locations.deliveryPipelines.automations.create", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/automations", "description": "Creates a new Automation in a given project and location.", "parameterOrder": [ "parent" ], "request": { "$ref": "Automation" }, "httpMethod": "POST", "response": { "$ref": "Operation" } }, "patch": { "parameters": { "updateMask": { "format": "google-fieldmask", "description": "Required. Field mask is used to specify the fields to be overwritten by the update in the `Automation` 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.", "type": "string", "location": "query" }, "requestId": { "description": "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).", "type": "string", "location": "query" }, "validateOnly": { "location": "query", "type": "boolean", "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/automations/[^/]+$", "description": "Output only. Name of the `Automation`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{delivery_pipeline}/automations/{automation}`.", "type": "string", "location": "path", "required": true }, "allowMissing": { "description": "Optional. If set to true, updating a `Automation` that does not exist will result in the creation of a new `Automation`.", "location": "query", "type": "boolean" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameterOrder": [ "name" ], "request": { "$ref": "Automation" }, "httpMethod": "PATCH", "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/automations/{automationsId}", "description": "Updates the parameters of a single Automation resource.", "id": "clouddeploy.projects.locations.deliveryPipelines.automations.patch" }, "delete": { "parameters": { "etag": { "description": "Optional. The weak etag of the request. 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.", "type": "string", "location": "query" }, "allowMissing": { "type": "boolean", "location": "query", "description": "Optional. If set to true, then deleting an already deleted or non-existing `Automation` will succeed." }, "requestId": { "type": "string", "location": "query", "description": "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)." }, "validateOnly": { "location": "query", "type": "boolean", "description": "Optional. If set, validate the request and verify whether the resource exists, but do not actually post it." }, "name": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/automations/[^/]+$", "description": "Required. The name of the `Automation` to delete. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/automations/{automation_name}`." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "httpMethod": "DELETE", "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/automations/{automationsId}", "description": "Deletes a single Automation resource.", "id": "clouddeploy.projects.locations.deliveryPipelines.automations.delete" }, "list": { "parameters": { "orderBy": { "location": "query", "type": "string", "description": "Field to sort by." }, "filter": { "description": "Filter automations to be returned. All fields can be used in the filter.", "type": "string", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "description": "Required. The parent `Delivery Pipeline`, which owns this collection of automations. Format must be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", "location": "path", "type": "string", "required": true }, "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous `ListAutomations` call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters match the call that provided the page token." }, "pageSize": { "format": "int32", "description": "The maximum number of automations to return. The service may return fewer than this value. If unspecified, at most 50 automations will be returned. The maximum value is 1000; values above 1000 will be set to 1000.", "type": "integer", "location": "query" } }, "path": "v1/{+parent}/automations", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "ListAutomationsResponse" }, "parameterOrder": [ "parent" ], "id": "clouddeploy.projects.locations.deliveryPipelines.automations.list", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/automations", "description": "Lists Automations in a given project and location." }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the `Automation`. Format must be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/automations/{automation_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/automations/[^/]+$", "required": true, "type": "string", "location": "path" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/automations/{automationsId}", "description": "Gets details of a single Automation.", "id": "clouddeploy.projects.locations.deliveryPipelines.automations.get", "httpMethod": "GET", "response": { "$ref": "Automation" }, "parameterOrder": [ "name" ] } } }, "automationRuns": { "methods": { "get": { "httpMethod": "GET", "response": { "$ref": "AutomationRun" }, "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/automationRuns/{automationRunsId}", "description": "Gets details of a single AutomationRun.", "id": "clouddeploy.projects.locations.deliveryPipelines.automationRuns.get", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/automationRuns/[^/]+$", "description": "Required. Name of the `AutomationRun`. Format must be `projects/{project}/locations/{location}/deliveryPipelines/{delivery_pipeline}/automationRuns/{automation_run}`.", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" }, "cancel": { "parameterOrder": [ "name" ], "request": { "$ref": "CancelAutomationRunRequest" }, "httpMethod": "POST", "response": { "$ref": "CancelAutomationRunResponse" }, "id": "clouddeploy.projects.locations.deliveryPipelines.automationRuns.cancel", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/automationRuns/{automationRunsId}:cancel", "description": "Cancels an AutomationRun. The `state` of the `AutomationRun` after cancelling is `CANCELLED`. `CancelAutomationRun` can be called on AutomationRun in the state `IN_PROGRESS` and `PENDING`; AutomationRun in a different state returns an `FAILED_PRECONDITION` error.", "parameters": { "name": { "description": "Required. Name of the `AutomationRun`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{delivery_pipeline}/automationRuns/{automation_run}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/automationRuns/[^/]+$", "required": true, "location": "path", "type": "string" } }, "path": "v1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "parameters": { "orderBy": { "location": "query", "type": "string", "description": "Field to sort by." }, "pageSize": { "location": "query", "type": "integer", "description": "The maximum number of automationRuns to return. The service may return fewer than this value. If unspecified, at most 50 automationRuns will be returned. The maximum value is 1000; values above 1000 will be set to 1000.", "format": "int32" }, "filter": { "location": "query", "type": "string", "description": "Filter automationRuns to be returned. All fields can be used in the filter." }, "parent": { "description": "Required. The parent `Delivery Pipeline`, which owns this collection of automationRuns. Format must be `projects/{project}/locations/{location}/deliveryPipelines/{delivery_pipeline}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "required": true, "type": "string", "location": "path" }, "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous `ListAutomationRuns` call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters match the call that provided the page token." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/automationRuns", "httpMethod": "GET", "response": { "$ref": "ListAutomationRunsResponse" }, "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}/automationRuns", "description": "Lists AutomationRuns in a given project and location.", "id": "clouddeploy.projects.locations.deliveryPipelines.automationRuns.list" } } } }, "methods": { "list": { "id": "clouddeploy.projects.locations.deliveryPipelines.list", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines", "description": "Lists DeliveryPipelines in a given project and location.", "parameterOrder": [ "parent" ], "httpMethod": "GET", "response": { "$ref": "ListDeliveryPipelinesResponse" }, "path": "v1/{+parent}/deliveryPipelines", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "filter": { "description": "Filter pipelines to be returned. See https://google.aip.dev/160 for more details.", "location": "query", "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The parent, which owns this collection of pipelines. Format must be `projects/{project_id}/locations/{location_name}`.", "location": "path", "type": "string", "required": true }, "pageToken": { "description": "A page token, received from a previous `ListDeliveryPipelines` call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters match the call that provided the page token.", "type": "string", "location": "query" }, "pageSize": { "format": "int32", "description": "The maximum number of pipelines to return. The service may return fewer than this value. If unspecified, at most 50 pipelines will be returned. The maximum value is 1000; values above 1000 will be set to 1000.", "type": "integer", "location": "query" }, "orderBy": { "description": "Field to sort by. See https://google.aip.dev/132#ordering for more details.", "location": "query", "type": "string" } } }, "delete": { "parameterOrder": [ "name" ], "httpMethod": "DELETE", "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}", "description": "Deletes a single DeliveryPipeline.", "id": "clouddeploy.projects.locations.deliveryPipelines.delete", "parameters": { "allowMissing": { "description": "Optional. If set to true, then deleting an already deleted or non-existing `DeliveryPipeline` will succeed.", "location": "query", "type": "boolean" }, "force": { "location": "query", "type": "boolean", "description": "Optional. If set to true, all child resources under this pipeline will also be deleted. Otherwise, the request will only work if the pipeline has no child resources." }, "etag": { "type": "string", "location": "query", "description": "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." }, "name": { "required": true, "location": "path", "type": "string", "description": "Required. The name of the `DeliveryPipeline` to delete. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$" }, "requestId": { "description": "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).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request and preview the review, but do not actually post it.", "type": "boolean", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" }, "patch": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}", "description": "Updates the parameters of a single DeliveryPipeline.", "id": "clouddeploy.projects.locations.deliveryPipelines.patch", "parameterOrder": [ "name" ], "request": { "$ref": "DeliveryPipeline" }, "httpMethod": "PATCH", "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "allowMissing": { "description": "Optional. If set to true, updating a `DeliveryPipeline` that does not exist will result in the creation of a new `DeliveryPipeline`.", "location": "query", "type": "boolean" }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "description": "Identifier. Name of the `DeliveryPipeline`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}`. The `deliveryPipeline` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`" }, "updateMask": { "description": "Required. Field mask is used to specify the fields to be overwritten by the update in the `DeliveryPipeline` 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.", "format": "google-fieldmask", "location": "query", "type": "string" }, "requestId": { "description": "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).", "location": "query", "type": "string" }, "validateOnly": { "type": "boolean", "location": "query", "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made." } } }, "setIamPolicy": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+resource}:setIamPolicy", "parameters": { "resource": { "required": true, "type": "string", "location": "path", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}:setIamPolicy", "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "id": "clouddeploy.projects.locations.deliveryPipelines.setIamPolicy", "httpMethod": "POST", "response": { "$ref": "Policy" }, "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" } }, "testIamPermissions": { "id": "clouddeploy.projects.locations.deliveryPipelines.testIamPermissions", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}:testIamPermissions", "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "httpMethod": "POST", "response": { "$ref": "TestIamPermissionsResponse" }, "parameterOrder": [ "resource" ], "request": { "$ref": "TestIamPermissionsRequest" }, "path": "v1/{+resource}:testIamPermissions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "resource": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." } } }, "rollbackTarget": { "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. The `DeliveryPipeline` for which the rollback `Rollout` must be created. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}:rollbackTarget", "httpMethod": "POST", "response": { "$ref": "RollbackTargetResponse" }, "parameterOrder": [ "name" ], "request": { "$ref": "RollbackTargetRequest" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}:rollbackTarget", "description": "Creates a `Rollout` to roll back the specified target.", "id": "clouddeploy.projects.locations.deliveryPipelines.rollbackTarget" }, "create": { "id": "clouddeploy.projects.locations.deliveryPipelines.create", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines", "description": "Creates a new DeliveryPipeline in a given project and location.", "parameterOrder": [ "parent" ], "request": { "$ref": "DeliveryPipeline" }, "httpMethod": "POST", "response": { "$ref": "Operation" }, "path": "v1/{+parent}/deliveryPipelines", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "requestId": { "description": "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).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made.", "type": "boolean", "location": "query" }, "deliveryPipelineId": { "description": "Required. ID of the `DeliveryPipeline`.", "type": "string", "location": "query" }, "parent": { "required": true, "location": "path", "type": "string", "description": "Required. The parent collection in which the `DeliveryPipeline` must be created. The format is `projects/{project_id}/locations/{location_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+$" } } }, "getIamPolicy": { "parameterOrder": [ "resource" ], "httpMethod": "GET", "response": { "$ref": "Policy" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}:getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "id": "clouddeploy.projects.locations.deliveryPipelines.getIamPolicy", "parameters": { "resource": { "required": true, "type": "string", "location": "path", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$" }, "options.requestedPolicyVersion": { "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "location": "query", "type": "integer" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+resource}:getIamPolicy" }, "get": { "id": "clouddeploy.projects.locations.deliveryPipelines.get", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deliveryPipelines/{deliveryPipelinesId}", "description": "Gets details of a single DeliveryPipeline.", "httpMethod": "GET", "response": { "$ref": "DeliveryPipeline" }, "parameterOrder": [ "name" ], "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "description": "Required. Name of the `DeliveryPipeline`. Format must be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`." } } } } }, "deployPolicies": { "methods": { "create": { "id": "clouddeploy.projects.locations.deployPolicies.create", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deployPolicies", "description": "Creates a new DeployPolicy in a given project and location.", "parameterOrder": [ "parent" ], "request": { "$ref": "DeployPolicy" }, "httpMethod": "POST", "response": { "$ref": "Operation" }, "path": "v1/{+parent}/deployPolicies", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "deployPolicyId": { "description": "Required. ID of the `DeployPolicy`.", "type": "string", "location": "query" }, "requestId": { "description": "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).", "location": "query", "type": "string" }, "validateOnly": { "location": "query", "type": "boolean", "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made." }, "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The parent collection in which the `DeployPolicy` must be created. The format is `projects/{project_id}/locations/{location_name}`." } } }, "patch": { "id": "clouddeploy.projects.locations.deployPolicies.patch", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deployPolicies/{deployPoliciesId}", "description": "Updates the parameters of a single DeployPolicy.", "parameterOrder": [ "name" ], "request": { "$ref": "DeployPolicy" }, "httpMethod": "PATCH", "response": { "$ref": "Operation" }, "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "allowMissing": { "description": "Optional. If set to true, updating a `DeployPolicy` that does not exist will result in the creation of a new `DeployPolicy`.", "location": "query", "type": "boolean" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/deployPolicies/[^/]+$", "description": "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])?`", "type": "string", "location": "path", "required": true }, "updateMask": { "description": "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.", "format": "google-fieldmask", "location": "query", "type": "string" }, "requestId": { "type": "string", "location": "query", "description": "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)." }, "validateOnly": { "description": "Optional. If set to true, the request is validated and the user is provided with an expected result, but no actual change is made.", "location": "query", "type": "boolean" } } }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "etag": { "description": "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.", "location": "query", "type": "string" }, "allowMissing": { "location": "query", "type": "boolean", "description": "Optional. If set to true, then deleting an already deleted or non-existing `DeployPolicy` will succeed." }, "name": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/deployPolicies/[^/]+$", "description": "Required. The name of the `DeployPolicy` to delete. The format is `projects/{project_id}/locations/{location_name}/deployPolicies/{deploy_policy_name}`." }, "requestId": { "type": "string", "location": "query", "description": "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)." }, "validateOnly": { "location": "query", "type": "boolean", "description": "Optional. If set, validate the request and preview the review, but do not actually post it." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deployPolicies/{deployPoliciesId}", "description": "Deletes a single DeployPolicy.", "id": "clouddeploy.projects.locations.deployPolicies.delete", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "response": { "$ref": "Operation" } }, "list": { "parameters": { "orderBy": { "location": "query", "type": "string", "description": "Field to sort by. See https://google.aip.dev/132#ordering for more details." }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "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." }, "filter": { "location": "query", "type": "string", "description": "Filter deploy policies to be returned. See https://google.aip.dev/160 for more details. All fields can be used in the filter." }, "parent": { "required": true, "location": "path", "type": "string", "description": "Required. The parent, which owns this collection of deploy policies. Format must be `projects/{project_id}/locations/{location_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageToken": { "description": "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.", "location": "query", "type": "string" } }, "path": "v1/{+parent}/deployPolicies", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "httpMethod": "GET", "response": { "$ref": "ListDeployPoliciesResponse" }, "id": "clouddeploy.projects.locations.deployPolicies.list", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deployPolicies", "description": "Lists DeployPolicies in a given project and location." }, "getIamPolicy": { "parameterOrder": [ "resource" ], "httpMethod": "GET", "response": { "$ref": "Policy" }, "id": "clouddeploy.projects.locations.deployPolicies.getIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deployPolicies/{deployPoliciesId}:getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "parameters": { "resource": { "required": true, "type": "string", "location": "path", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/deployPolicies/[^/]+$" }, "options.requestedPolicyVersion": { "format": "int32", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "type": "integer", "location": "query" } }, "path": "v1/{+resource}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "id": "clouddeploy.projects.locations.deployPolicies.get", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deployPolicies/{deployPoliciesId}", "description": "Gets details of a single DeployPolicy.", "httpMethod": "GET", "response": { "$ref": "DeployPolicy" }, "parameterOrder": [ "name" ], "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Name of the `DeployPolicy`. Format must be `projects/{project_id}/locations/{location_name}/deployPolicies/{deploy_policy_name}`.", "pattern": "^projects/[^/]+/locations/[^/]+/deployPolicies/[^/]+$", "required": true, "location": "path", "type": "string" } } }, "setIamPolicy": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+resource}:setIamPolicy", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/deployPolicies/[^/]+$", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "type": "string", "required": true } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/deployPolicies/{deployPoliciesId}:setIamPolicy", "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "id": "clouddeploy.projects.locations.deployPolicies.setIamPolicy", "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" }, "httpMethod": "POST", "response": { "$ref": "Policy" } } } } } } } } }, "baseUrl": "https://clouddeploy.googleapis.com/", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." } } } }, "documentationLink": "https://cloud.google.com/deploy/", "kind": "discovery#restDescription", "batchPath": "batch", "canonicalName": "Cloud Deploy", "id": "clouddeploy:v1", "name": "clouddeploy", "version": "v1", "parameters": { "access_token": { "description": "OAuth access token.", "location": "query", "type": "string" }, "uploadType": { "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query", "type": "string" }, "upload_protocol": { "type": "string", "location": "query", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\")." }, "alt": { "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "type": "string", "default": "json", "location": "query", "enum": [ "json", "media", "proto" ], "description": "Data format for response." }, "prettyPrint": { "description": "Returns response with indentations and line breaks.", "location": "query", "type": "boolean", "default": "true" }, "callback": { "description": "JSONP", "location": "query", "type": "string" }, "key": { "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query", "type": "string" }, "fields": { "description": "Selector specifying which fields to include in a partial response.", "location": "query", "type": "string" }, "oauth_token": { "description": "OAuth 2.0 token for the current user.", "type": "string", "location": "query" }, "quotaUser": { "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "type": "string", "location": "query" }, "$.xgafv": { "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query", "type": "string", "description": "V1 error format.", "enum": [ "1", "2" ] } }, "fullyEncodeReservedExpansion": true, "discoveryVersion": "v1", "description": "", "title": "Cloud Deploy API", "basePath": "", "servicePath": "", "mtlsRootUrl": "https://clouddeploy.mtls.googleapis.com/", "revision": "20260818", "endpoints": [ { "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.asia-south1.rep.googleapis.com/", "location": "asia-south1" }, { "location": "asia-south2", "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.asia-south2.rep.googleapis.com/" }, { "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.us-central1.rep.googleapis.com/", "location": "us-central1" }, { "location": "us-east1", "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.us-east1.rep.googleapis.com/" }, { "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.us-east4.rep.googleapis.com/", "location": "us-east4" }, { "location": "us-east5", "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.us-east5.rep.googleapis.com/" }, { "endpointUrl": "https://clouddeploy.us-east7.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-east7" }, { "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.us-south1.rep.googleapis.com/", "location": "us-south1" }, { "location": "us-west1", "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.us-west1.rep.googleapis.com/" }, { "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.us-west2.rep.googleapis.com/", "location": "us-west2" }, { "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.us-west3.rep.googleapis.com/", "location": "us-west3" }, { "location": "us-west4", "description": "Regional Endpoint", "endpointUrl": "https://clouddeploy.us-west4.rep.googleapis.com/" } ], "schemas": { "GkeCluster": { "type": "object", "id": "GkeCluster", "properties": { "internalIp": { "description": "Optional. If true, `cluster` is accessed using the private IP address of the control plane endpoint. Otherwise, the default IP address of the control plane endpoint is used. The default IP address is the private IP address for clusters with private control-plane endpoints and the public IP address otherwise. 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.", "type": "boolean" }, "proxyUrl": { "description": "Optional. If set, used to configure a [proxy](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/#proxy) to the Kubernetes server.", "type": "string" }, "cluster": { "description": "Optional. Information specifying a GKE Cluster. Format is `projects/{project_id}/locations/{location_id}/clusters/{cluster_id}`.", "type": "string" }, "dnsEndpoint": { "type": "boolean", "description": "Optional. If set, the cluster will be accessed using the DNS endpoint. Note that both `dns_endpoint` and `internal_ip` cannot be set to true." } }, "description": "Information specifying a GKE Cluster." }, "ReleaseReadyCondition": { "id": "ReleaseReadyCondition", "properties": { "status": { "description": "True if the Release is in a valid state. Otherwise at least one condition in `ReleaseCondition` is in an invalid state. Iterate over those conditions and see which condition(s) has status = false to find out what is wrong with the Release.", "type": "boolean" } }, "type": "object", "description": "ReleaseReadyCondition contains information around the status of the Release. If a release is not ready, you cannot create a rollout with the release." }, "Empty": { "type": "object", "id": "Empty", "properties": {}, "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }" }, "AnalysisJob": { "id": "AnalysisJob", "properties": { "googleCloud": { "readOnly": true, "description": "Output only. Google Cloud - based analysis checks that are run as part of the analysis Job.", "$ref": "GoogleCloudAnalysis" }, "customChecks": { "description": "Output only. Custom analysis checks from 3P metric providers that are run as part of the analysis Job.", "items": { "$ref": "CustomCheck" }, "readOnly": true, "type": "array" }, "duration": { "readOnly": true, "type": "string", "description": "Output only. The amount of time in minutes the analysis Job will run, up to a maximum of 48 hours. If any check in this Job is still running when the duration ends, the Job keeps running until that check completes.", "format": "google-duration" } }, "type": "object", "description": "An analysis Job." }, "ListDeployPoliciesResponse": { "description": "The response object from `ListDeployPolicies`.", "type": "object", "id": "ListDeployPoliciesResponse", "properties": { "unreachable": { "items": { "type": "string" }, "description": "Locations that could not be reached.", "type": "array" }, "deployPolicies": { "type": "array", "items": { "$ref": "DeployPolicy" }, "description": "The `DeployPolicy` objects." }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "PhaseArtifact": { "description": "Contains the paths to the artifacts, relative to the URI, for a phase.", "id": "PhaseArtifact", "properties": { "manifestPath": { "description": "Output only. File path of the rendered manifest relative to the URI.", "type": "string", "readOnly": true }, "jobManifestsPath": { "description": "Output only. File path of the directory of rendered job manifests relative to the URI. This is only set if it is applicable.", "readOnly": true, "type": "string" }, "skaffoldConfigPath": { "description": "Output only. File path of the resolved Skaffold configuration relative to the URI.", "readOnly": true, "type": "string" } }, "type": "object" }, "Date": { "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", "type": "object", "id": "Date", "properties": { "year": { "type": "integer", "format": "int32", "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year." }, "month": { "type": "integer", "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "format": "int32" }, "day": { "type": "integer", "format": "int32", "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant." } } }, "AutomationRuleCondition": { "id": "AutomationRuleCondition", "properties": { "targetsPresentCondition": { "$ref": "TargetsPresentCondition", "description": "Optional. Details around targets enumerated in the rule." }, "timedPromoteReleaseCondition": { "$ref": "TimedPromoteReleaseCondition", "description": "Optional. TimedPromoteReleaseCondition contains rule conditions specific to a an Automation with a timed promote release rule defined." } }, "type": "object", "description": "`AutomationRuleCondition` contains conditions relevant to an `Automation` rule." }, "JobRunNotificationEvent": { "description": "Payload proto for \"clouddeploy.googleapis.com/jobrun_notification\" Platform Log event that describes the failure to send JobRun resource update Pub/Sub notification.", "type": "object", "id": "JobRunNotificationEvent", "properties": { "rolloutUid": { "description": "Unique identifier of the `Rollout`.", "type": "string" }, "pipelineUid": { "description": "Unique identifier of the `DeliveryPipeline`.", "type": "string" }, "rollout": { "type": "string", "description": "The name of the `Rollout`." }, "type": { "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ], "description": "Type of this notification, e.g. for a Pub/Sub failure.", "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ], "type": "string" }, "message": { "description": "Debug message for when a notification fails to send.", "type": "string" }, "release": { "type": "string", "description": "The name of the `Release`." }, "releaseUid": { "type": "string", "description": "Unique identifier of the `Release`." }, "jobRun": { "type": "string", "description": "The name of the `JobRun`." }, "targetId": { "type": "string", "description": "ID of the `Target`." } } }, "CloudRunRenderMetadata": { "description": "CloudRunRenderMetadata contains Cloud Run information associated with a `Release` render.", "id": "CloudRunRenderMetadata", "properties": { "job": { "readOnly": true, "type": "string", "description": "Output only. The name of the Cloud Run Job in the rendered manifest. Format is `projects/{project}/locations/{location}/jobs/{job}`." }, "revision": { "description": "Output only. The name of the Cloud Run Revision in the rendered manifest. Format is `projects/{project}/locations/{location}/services/{service}/revisions/{revision}`.", "readOnly": true, "type": "string" }, "workerPool": { "type": "string", "readOnly": true, "description": "Output only. The name of the Cloud Run Worker Pool in the rendered manifest. Format is `projects/{project}/locations/{location}/workerPools/{worker_pool}`." }, "service": { "readOnly": true, "type": "string", "description": "Output only. The name of the Cloud Run Service in the rendered manifest. Format is `projects/{project}/locations/{location}/services/{service}`." } }, "type": "object" }, "SkaffoldGCSSource": { "type": "object", "id": "SkaffoldGCSSource", "properties": { "source": { "type": "string", "description": "Required. Cloud Storage source paths to copy recursively. For example, providing \"gs://my-bucket/dir/configs/*\" will result in Skaffold copying all files within the \"dir/configs\" directory in the bucket \"my-bucket\"." }, "path": { "description": "Optional. Relative path from the source to the Skaffold file.", "type": "string" } }, "description": "Cloud Storage bucket containing Skaffold Config modules." }, "JobRun": { "description": "A `JobRun` resource in the Cloud Deploy API. A `JobRun` contains information of a single `Rollout` job evaluation.", "id": "JobRun", "properties": { "endTime": { "readOnly": true, "type": "string", "description": "Output only. Time at which the `JobRun` ended.", "format": "google-datetime" }, "createTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Time at which the `JobRun` was created." }, "startTime": { "readOnly": true, "type": "string", "description": "Output only. Time at which the `JobRun` was started.", "format": "google-datetime" }, "name": { "description": "Output only. Name of the `JobRun`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{releases}/rollouts/{rollouts}/jobRuns/{uuid}`.", "type": "string", "readOnly": true }, "phaseId": { "type": "string", "readOnly": true, "description": "Output only. ID of the `Rollout` phase this `JobRun` belongs in." }, "verifyJobRun": { "readOnly": true, "description": "Output only. Information specific to a verify `JobRun`.", "$ref": "VerifyJobRun" }, "postdeployJobRun": { "readOnly": true, "$ref": "PostdeployJobRun", "description": "Output only. Information specific to a postdeploy `JobRun`." }, "advanceChildRolloutJobRun": { "readOnly": true, "$ref": "AdvanceChildRolloutJobRun", "description": "Output only. Information specific to an advanceChildRollout `JobRun`" }, "state": { "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "IN_PROGRESS", "SUCCEEDED", "FAILED", "TERMINATING", "TERMINATED" ], "description": "Output only. The current state of the `JobRun`.", "type": "string", "enumDescriptions": [ "The `JobRun` has an unspecified state.", "The `JobRun` is in progress.", "The `JobRun` has succeeded.", "The `JobRun` has failed.", "The `JobRun` is terminating.", "The `JobRun` was terminated." ] }, "analysisJobRun": { "$ref": "AnalysisJobRun", "description": "Output only. Information specific to an analysis `JobRun`.", "readOnly": true }, "predeployJobRun": { "description": "Output only. Information specific to a predeploy `JobRun`.", "$ref": "PredeployJobRun", "readOnly": true }, "jobId": { "readOnly": true, "type": "string", "description": "Output only. ID of the `Rollout` job this `JobRun` corresponds to." }, "deployJobRun": { "readOnly": true, "$ref": "DeployJobRun", "description": "Output only. Information specific to a deploy `JobRun`." }, "uid": { "type": "string", "readOnly": true, "description": "Output only. Unique identifier of the `JobRun`." }, "createChildRolloutJobRun": { "readOnly": true, "description": "Output only. Information specific to a createChildRollout `JobRun`.", "$ref": "CreateChildRolloutJobRun" }, "etag": { "description": "Output only. 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.", "readOnly": true, "type": "string" } }, "type": "object" }, "ContainerTask": { "description": "This task is represented by a container that is executed in the Cloud Build execution environment.", "id": "ContainerTask", "properties": { "image": { "description": "Required. Image is the container image to use.", "type": "string" }, "command": { "type": "array", "description": "Optional. Command is the container entrypoint to use. This overrides the default entrypoint defined in the container image.", "items": { "type": "string" } }, "env": { "description": "Optional. Environment variables that are set in the container.", "additionalProperties": { "type": "string" }, "type": "object" }, "args": { "type": "array", "description": "Optional. Args is the container arguments to use. This overrides the default arguments defined in the container image.", "items": { "type": "string" } } }, "type": "object" }, "PolicyViolation": { "description": "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.", "id": "PolicyViolation", "properties": { "policyViolationDetails": { "items": { "$ref": "PolicyViolationDetails" }, "description": "Policy violation details.", "type": "array" } }, "type": "object" }, "Targets": { "id": "Targets", "properties": { "sourceTargetId": { "description": "Optional. The source target ID.", "type": "string" }, "destinationTargetId": { "type": "string", "description": "Optional. The destination target ID." } }, "type": "object", "description": "The targets involved in a single timed promotion." }, "CustomTargetTasks": { "description": "CustomTargetTasks represents the `CustomTargetType` configuration using tasks.", "type": "object", "id": "CustomTargetTasks", "properties": { "deploy": { "description": "Required. The task responsible for deploy operations.", "$ref": "Task" }, "render": { "$ref": "Task", "description": "Optional. The task responsible for render operations. If not provided then Cloud Deploy will perform its default rendering operation." } } }, "TestIamPermissionsRequest": { "description": "Request message for `TestIamPermissions` method.", "type": "object", "id": "TestIamPermissionsRequest", "properties": { "permissions": { "type": "array", "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" } } } }, "WeeklyWindow": { "id": "WeeklyWindow", "properties": { "startTime": { "description": "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.", "$ref": "TimeOfDay" }, "daysOfWeek": { "items": { "enumDescriptions": [ "The day of the week is unspecified.", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ], "enum": [ "DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ], "type": "string" }, "description": "Optional. Days of week. If left empty, all days of the week will be included.", "type": "array" }, "endTime": { "description": "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.", "$ref": "TimeOfDay" } }, "type": "object", "description": "Weekly windows. For example, blocking actions every Saturday and Sunday. Another example would be blocking actions every weekday from 5pm to midnight." }, "CloudRunMetadata": { "description": "CloudRunMetadata contains information from a Cloud Run deployment.", "type": "object", "id": "CloudRunMetadata", "properties": { "workerPool": { "description": "Output only. The Cloud Run worker pool associated with a `Rollout`. Format is `projects/{project}/locations/{location}/workerPools/{worker_pool}`.", "type": "string", "readOnly": true }, "service": { "description": "Output only. The name of the Cloud Run Service that is associated with a `Rollout`. Format is `projects/{project}/locations/{location}/services/{service}`.", "readOnly": true, "type": "string" }, "revision": { "description": "Output only. The Cloud Run Revision id associated with a `Rollout`.", "readOnly": true, "type": "string" }, "serviceUrls": { "description": "Output only. The Cloud Run Service urls that are associated with a `Rollout`.", "items": { "type": "string" }, "readOnly": true, "type": "array" }, "previousRevision": { "description": "Output only. The previous Cloud Run Revision name associated with a `Rollout`. Only set when a canary deployment strategy is configured. Format for service is projects/{project}/locations/{location}/services/{service}/revisions/{revision}. Format for worker pool is projects/{project}/locations/{location}/workerPools/{workerpool}/revisions/{revision}.", "type": "string", "readOnly": true }, "job": { "type": "string", "readOnly": true, "description": "Output only. The name of the Cloud Run job that is associated with a `Rollout`. Format is `projects/{project}/locations/{location}/jobs/{job_name}`." } } }, "RenderMetadata": { "description": "RenderMetadata includes information associated with a `Release` render.", "type": "object", "id": "RenderMetadata", "properties": { "cloudRun": { "description": "Output only. Metadata associated with rendering for Cloud Run.", "$ref": "CloudRunRenderMetadata", "readOnly": true }, "custom": { "$ref": "CustomMetadata", "description": "Output only. Custom metadata provided by user-defined render operation.", "readOnly": true }, "kubernetes": { "readOnly": true, "$ref": "KubernetesRenderMetadata", "description": "Output only. Metadata associated with rendering for a Kubernetes cluster (GKE or GKE Enterprise target)." } } }, "RepairRolloutRule": { "description": "The `RepairRolloutRule` automation rule will automatically repair a failed `Rollout`.", "type": "object", "id": "RepairRolloutRule", "properties": { "id": { "type": "string", "description": "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])?`." }, "condition": { "readOnly": true, "$ref": "AutomationRuleCondition", "description": "Output only. Information around the state of the 'Automation' rule." }, "phases": { "type": "array", "description": "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])?$`.", "items": { "type": "string" } }, "repairPhases": { "items": { "$ref": "RepairPhaseConfig" }, "description": "Required. Defines the types of automatic repair phases for failed jobs.", "type": "array" }, "jobs": { "description": "Optional. Jobs to repair. Proceeds only after job name matched any one in the list, or for all jobs if unspecified or empty. The phase that includes the job must match the phase ID specified in `source_phase`. 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])?$`.", "items": { "type": "string" }, "type": "array" } } }, "PromoteReleaseRule": { "description": "The `PromoteRelease` rule will automatically promote a release from the current target to a specified target.", "id": "PromoteReleaseRule", "properties": { "id": { "description": "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])?`.", "type": "string" }, "destinationPhase": { "type": "string", "description": "Optional. The starting phase of the rollout created by this operation. Default to the first phase." }, "condition": { "$ref": "AutomationRuleCondition", "description": "Output only. Information around the state of the Automation rule.", "readOnly": true }, "wait": { "description": "Optional. How long the release need to be paused until being promoted to the next target.", "format": "google-duration", "type": "string" }, "destinationTargetId": { "description": "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", "type": "string" } }, "type": "object" }, "RetryAttempt": { "type": "object", "id": "RetryAttempt", "properties": { "state": { "readOnly": true, "enum": [ "REPAIR_STATE_UNSPECIFIED", "REPAIR_STATE_SUCCEEDED", "REPAIR_STATE_CANCELLED", "REPAIR_STATE_FAILED", "REPAIR_STATE_IN_PROGRESS", "REPAIR_STATE_PENDING", "REPAIR_STATE_ABORTED" ], "description": "Output only. Valid state of this retry action.", "type": "string", "enumDescriptions": [ "The `repair` has an unspecified state.", "The `repair` action has succeeded.", "The `repair` action was cancelled.", "The `repair` action has failed.", "The `repair` action is in progress.", "The `repair` action is pending.", "The `repair` action was aborted." ] }, "attempt": { "readOnly": true, "type": "string", "description": "Output only. The index of this retry attempt.", "format": "int64" }, "wait": { "type": "string", "readOnly": true, "format": "google-duration", "description": "Output only. How long the operation will be paused." }, "stateDesc": { "readOnly": true, "type": "string", "description": "Output only. Description of the state of the Retry." } }, "description": "RetryAttempt represents an action of retrying the failed Cloud Deploy job." }, "AutomationRule": { "id": "AutomationRule", "properties": { "promoteReleaseRule": { "$ref": "PromoteReleaseRule", "description": "Optional. `PromoteReleaseRule` will automatically promote a release from the current target to a specified target." }, "advanceRolloutRule": { "description": "Optional. The `AdvanceRolloutRule` will automatically advance a successful Rollout.", "$ref": "AdvanceRolloutRule" }, "timedPromoteReleaseRule": { "$ref": "TimedPromoteReleaseRule", "description": "Optional. The `TimedPromoteReleaseRule` will automatically promote a release from the current target(s) to the specified target(s) on a configured schedule." }, "repairRolloutRule": { "$ref": "RepairRolloutRule", "description": "Optional. The `RepairRolloutRule` will automatically repair a failed rollout." } }, "type": "object", "description": "`AutomationRule` defines the automation activities." }, "AdvanceRolloutRule": { "description": "The `AdvanceRollout` automation rule will automatically advance a successful Rollout to the next phase.", "type": "object", "id": "AdvanceRolloutRule", "properties": { "condition": { "readOnly": true, "$ref": "AutomationRuleCondition", "description": "Output only. Information around the state of the Automation rule." }, "id": { "description": "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])?`.", "type": "string" }, "sourcePhases": { "description": "Optional. Proceeds only after phase name matched any one in the list. 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])?$`.", "items": { "type": "string" }, "type": "array" }, "wait": { "type": "string", "description": "Optional. How long to wait after a rollout is finished.", "format": "google-duration" } } }, "Analysis": { "description": "Analysis contains the configuration for the set of analyses to be performed on the target.", "id": "Analysis", "properties": { "duration": { "description": "Required. The amount of time in minutes the analysis on the target will last. If all analysis checks have successfully completed before the specified duration, the analysis is successful. If a check is still running while the specified duration passes, it will wait for that check to complete to determine if the analysis is successful. The maximum duration is 48 hours.", "format": "google-duration", "type": "string" }, "googleCloud": { "description": "Optional. Google Cloud - based analysis checks.", "$ref": "GoogleCloudAnalysis" }, "customChecks": { "type": "array", "description": "Optional. Custom analysis checks from 3P metric providers.", "items": { "$ref": "CustomCheck" } } }, "type": "object" }, "Rollout": { "description": "A `Rollout` resource in the Cloud Deploy API. A `Rollout` contains information around a specific deployment to a `Target`.", "type": "object", "id": "Rollout", "properties": { "approveTime": { "readOnly": true, "type": "string", "description": "Output only. Time at which the `Rollout` was approved.", "format": "google-datetime" }, "rolledBackByRollouts": { "type": "array", "readOnly": true, "items": { "type": "string" }, "description": "Output only. Names of `Rollouts` that rolled back this `Rollout`." }, "labels": { "description": "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 \u003c= 128 bytes.", "additionalProperties": { "type": "string" }, "type": "object" }, "controllerRollout": { "readOnly": true, "type": "string", "description": "Output only. Name of the `ControllerRollout`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`." }, "activeRepairAutomationRun": { "description": "Output only. The AutomationRun actively repairing the rollout.", "type": "string", "readOnly": true }, "deployStartTime": { "description": "Output only. Time at which the `Rollout` started deploying.", "format": "google-datetime", "readOnly": true, "type": "string" }, "state": { "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "SUCCEEDED", "FAILED", "IN_PROGRESS", "PENDING_APPROVAL", "APPROVAL_REJECTED", "PENDING", "PENDING_RELEASE", "CANCELLING", "CANCELLED", "HALTED" ], "description": "Output only. Current state of the `Rollout`.", "type": "string", "enumDescriptions": [ "The `Rollout` has an unspecified state.", "The `Rollout` has completed successfully.", "The `Rollout` has failed.", "The `Rollout` is being deployed.", "The `Rollout` needs approval.", "An approver rejected the `Rollout`.", "The `Rollout` is waiting for an earlier Rollout(s) to complete on this `Target`.", "The `Rollout` is waiting for the `Release` to be fully rendered.", "The `Rollout` is in the process of being cancelled.", "The `Rollout` has been cancelled.", "The `Rollout` is halted." ] }, "createTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Time at which the `Rollout` was created." }, "approvalState": { "enumDescriptions": [ "The `Rollout` has an unspecified approval state.", "The `Rollout` requires approval.", "The `Rollout` does not require approval.", "The `Rollout` has been approved.", "The `Rollout` has been rejected." ], "type": "string", "description": "Output only. Approval state of the `Rollout`.", "enum": [ "APPROVAL_STATE_UNSPECIFIED", "NEEDS_APPROVAL", "DOES_NOT_NEED_APPROVAL", "APPROVED", "REJECTED" ], "readOnly": true }, "name": { "description": "Identifier. Name of the `Rollout`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`. The `rollout` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`", "type": "string" }, "deployEndTime": { "readOnly": true, "type": "string", "description": "Output only. Time at which the `Rollout` finished deploying.", "format": "google-datetime" }, "deployingBuild": { "description": "Output only. The resource name of the Cloud Build `Build` object that is used to deploy the Rollout. Format is `projects/{project}/locations/{location}/builds/{build}`.", "type": "string", "readOnly": true }, "description": { "type": "string", "description": "Optional. Description of the `Rollout` for user purposes. Max length is 255 characters." }, "enqueueTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Time at which the `Rollout` was enqueued." }, "phases": { "type": "array", "readOnly": true, "items": { "$ref": "Phase" }, "description": "Output only. The phases that represent the workflows of this `Rollout`." }, "annotations": { "description": "Optional. User annotations. These attributes can only be set and used by the user, and not by Cloud Deploy. See https://google.aip.dev/128#annotations for more details such as format and size limitations.", "additionalProperties": { "type": "string" }, "type": "object" }, "targetId": { "type": "string", "description": "Required. The ID of Target to which this `Rollout` is deploying." }, "rollbackOfRollout": { "type": "string", "readOnly": true, "description": "Output only. Name of the `Rollout` that is rolled back by this `Rollout`. Empty if this `Rollout` wasn't created as a rollback." }, "deployFailureCause": { "readOnly": true, "enum": [ "FAILURE_CAUSE_UNSPECIFIED", "CLOUD_BUILD_UNAVAILABLE", "EXECUTION_FAILED", "DEADLINE_EXCEEDED", "RELEASE_FAILED", "RELEASE_ABANDONED", "VERIFICATION_CONFIG_NOT_FOUND", "CLOUD_BUILD_REQUEST_FAILED", "OPERATION_FEATURE_NOT_SUPPORTED" ], "description": "Output only. The reason this rollout failed. This will always be unspecified while the rollout is in progress.", "type": "string", "enumDescriptions": [ "No reason for failure is specified.", "Cloud Build is not available, either because it is not enabled or because Cloud Deploy has insufficient permissions. See [required permission](https://cloud.google.com/deploy/docs/cloud-deploy-service-account#required_permissions).", "The deploy operation did not complete successfully; check Cloud Build logs.", "Deployment did not complete within the allotted time.", "Release is in a failed state.", "Release is abandoned.", "No Skaffold verify configuration was found.", "Cloud Build failed to fulfill Cloud Deploy's request. See failure_message for additional details.", "A Rollout operation had a feature configured that is not supported." ] }, "metadata": { "$ref": "Metadata", "description": "Output only. Metadata contains information about the rollout.", "readOnly": true }, "etag": { "description": "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.", "type": "string" }, "failureReason": { "description": "Output only. Additional information about the rollout failure, if available.", "readOnly": true, "type": "string" }, "uid": { "type": "string", "readOnly": true, "description": "Output only. Unique identifier of the `Rollout`." } } }, "RetryJobResponse": { "description": "The response object from 'RetryJob'.", "id": "RetryJobResponse", "properties": {}, "type": "object" }, "SkaffoldModules": { "id": "SkaffoldModules", "properties": { "googleCloudBuildRepo": { "$ref": "SkaffoldGCBRepoSource", "description": "Optional. Cloud Build V2 repository containing the Skaffold Config modules." }, "configs": { "type": "array", "description": "Optional. The Skaffold Config modules to use from the specified source.", "items": { "type": "string" } }, "git": { "description": "Optional. Remote git repository containing the Skaffold Config modules.", "$ref": "SkaffoldGitSource" }, "googleCloudStorage": { "$ref": "SkaffoldGCSSource", "description": "Optional. Cloud Storage bucket containing the Skaffold Config modules." } }, "type": "object", "description": "Skaffold Config modules and their remote source." }, "AutomationResourceSelector": { "id": "AutomationResourceSelector", "properties": { "targets": { "description": "Optional. Contains attributes about a target.", "items": { "$ref": "TargetAttribute" }, "type": "array" } }, "type": "object", "description": "AutomationResourceSelector contains the information to select the resources to which an Automation is going to be applied." }, "CancelRolloutRequest": { "type": "object", "id": "CancelRolloutRequest", "properties": { "overrideDeployPolicy": { "type": "array", "items": { "type": "string" }, "description": "Optional. Deploy policies to override. Format is `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`." } }, "description": "The request object used by `CancelRollout`." }, "GatewayServiceMesh": { "id": "GatewayServiceMesh", "properties": { "deployment": { "description": "Required. Name of the Kubernetes Deployment whose traffic is managed by the specified HTTPRoute and Service.", "type": "string" }, "httpRoute": { "description": "Required. Name of the Gateway API HTTPRoute.", "type": "string" }, "stableCutbackDuration": { "type": "string", "description": "Optional. The amount of time to migrate traffic back from the canary Service to the original Service during the stable phase deployment. If specified, must be between 15s and 3600s. If unspecified, there is no cutback time.", "format": "google-duration" }, "podSelectorLabel": { "type": "string", "description": "Optional. The label to use when selecting Pods for the Deployment and Service resources. This label must already be present in both resources." }, "service": { "type": "string", "description": "Required. Name of the Kubernetes Service." }, "routeDestinations": { "$ref": "RouteDestinations", "description": "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." }, "routeUpdateWaitTime": { "type": "string", "description": "Optional. The time to wait for route updates to propagate. The maximum configurable time is 3 hours, in seconds format. If unspecified, there is no wait time.", "format": "google-duration" } }, "type": "object", "description": "Information about the Kubernetes Gateway API service mesh configuration." }, "RollbackTargetConfig": { "description": "Configs for the Rollback rollout.", "type": "object", "id": "RollbackTargetConfig", "properties": { "rollout": { "$ref": "Rollout", "description": "Optional. The rollback `Rollout` to create." }, "startingPhaseId": { "description": "Optional. The starting phase ID for the `Rollout`. If unspecified, the `Rollout` will start in the stable phase.", "type": "string" } } }, "PromoteReleaseOperation": { "id": "PromoteReleaseOperation", "properties": { "wait": { "format": "google-duration", "description": "Output only. How long the operation will be paused.", "type": "string", "readOnly": true }, "rollout": { "description": "Output only. The name of the rollout that initiates the `AutomationRun`.", "type": "string", "readOnly": true }, "targetId": { "readOnly": true, "type": "string", "description": "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." }, "phase": { "description": "Output only. The starting phase of the rollout created by this operation.", "type": "string", "readOnly": true } }, "type": "object", "description": "Contains the information of an automated promote-release operation." }, "DeployPolicyResourceSelector": { "id": "DeployPolicyResourceSelector", "properties": { "deliveryPipeline": { "description": "Optional. Contains attributes about a delivery pipeline.", "$ref": "DeliveryPipelineAttribute" }, "target": { "description": "Optional. Contains attributes about a target.", "$ref": "TargetAttribute" } }, "type": "object", "description": "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." }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", "properties": { "policy": { "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them.", "$ref": "Policy" }, "updateMask": { "format": "google-fieldmask", "description": "OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: \"bindings, etag\"`", "type": "string" } }, "type": "object" }, "CustomCanaryDeployment": { "description": "CustomCanaryDeployment represents the custom canary deployment configuration.", "type": "object", "id": "CustomCanaryDeployment", "properties": { "phaseConfigs": { "description": "Required. Configuration for each phase in the canary deployment in the order executed.", "items": { "$ref": "PhaseConfig" }, "type": "array" } } }, "KubernetesRenderMetadata": { "description": "KubernetesRenderMetadata contains Kubernetes information associated with a `Release` render.", "type": "object", "id": "KubernetesRenderMetadata", "properties": { "deployment": { "description": "Output only. Name of the Kubernetes Deployment that will be applied to the GKE cluster. Only set if a single Deployment was provided in the rendered manifest.", "type": "string", "readOnly": true }, "canaryDeployment": { "description": "Output only. Name of the canary version of the Kubernetes Deployment that will be applied to the GKE cluster. Only set if a canary deployment strategy was configured.", "type": "string", "readOnly": true }, "kubernetesNamespace": { "description": "Output only. Namespace the Kubernetes resources will be applied to in the GKE cluster. Only set if applying resources to a single namespace.", "readOnly": true, "type": "string" } } }, "TimedPromoteReleaseOperation": { "description": "Contains the information of an automated timed promote-release operation.", "id": "TimedPromoteReleaseOperation", "properties": { "targetId": { "readOnly": true, "type": "string", "description": "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." }, "phase": { "description": "Output only. The starting phase of the rollout created by this operation.", "readOnly": true, "type": "string" }, "release": { "readOnly": true, "type": "string", "description": "Output only. The name of the release to be promoted." } }, "type": "object" }, "Target": { "description": "A `Target` resource in the Cloud Deploy API. A `Target` defines a location to which a Skaffold configuration can be deployed.", "type": "object", "id": "Target", "properties": { "updateTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Most recent time at which the `Target` was updated." }, "deployParameters": { "type": "object", "description": "Optional. The deploy parameters to use for this target.", "additionalProperties": { "type": "string" } }, "name": { "type": "string", "description": "Identifier. Name of the `Target`. Format is `projects/{project}/locations/{location}/targets/{target}`. The `target` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`" }, "createTime": { "readOnly": true, "type": "string", "description": "Output only. Time at which the `Target` was created.", "format": "google-datetime" }, "customTarget": { "$ref": "CustomTarget", "description": "Optional. Information specifying a Custom Target." }, "anthosCluster": { "description": "Optional. Information specifying an Anthos Cluster.", "$ref": "AnthosCluster" }, "executionConfigs": { "type": "array", "description": "Optional. Configurations for all execution that relates to this `Target`. Each `ExecutionEnvironmentUsage` value may only be used in a single configuration; using the same value multiple times is an error. When one or more configurations are specified, they must include the `RENDER` and `DEPLOY` `ExecutionEnvironmentUsage` values. When no configurations are specified, execution will use the default specified in `DefaultPool`.", "items": { "$ref": "ExecutionConfig" } }, "labels": { "type": "object", "description": "Optional. 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 \u003c= 128 bytes.", "additionalProperties": { "type": "string" } }, "gke": { "$ref": "GkeCluster", "description": "Optional. Information specifying a GKE Cluster." }, "etag": { "type": "string", "description": "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." }, "uid": { "description": "Output only. Unique identifier of the `Target`.", "readOnly": true, "type": "string" }, "run": { "$ref": "CloudRunLocation", "description": "Optional. Information specifying a Cloud Run deployment target." }, "associatedEntities": { "description": "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])?$`.", "additionalProperties": { "$ref": "AssociatedEntities" }, "type": "object" }, "description": { "description": "Optional. Description of the `Target`. Max length is 255 characters.", "type": "string" }, "multiTarget": { "description": "Optional. Information specifying a multiTarget.", "$ref": "MultiTarget" }, "targetId": { "type": "string", "readOnly": true, "description": "Output only. Resource id of the `Target`." }, "requireApproval": { "description": "Optional. Whether or not the `Target` requires approval.", "type": "boolean" }, "annotations": { "type": "object", "description": "Optional. User annotations. These attributes can only be set and used by the user, and not by Cloud Deploy. See https://google.aip.dev/128#annotations for more details such as format and size limitations.", "additionalProperties": { "type": "string" } } } }, "CustomTargetType": { "type": "object", "id": "CustomTargetType", "properties": { "customTargetTypeId": { "description": "Output only. Resource id of the `CustomTargetType`.", "readOnly": true, "type": "string" }, "updateTime": { "description": "Output only. Most recent time at which the `CustomTargetType` was updated.", "format": "google-datetime", "readOnly": true, "type": "string" }, "etag": { "description": "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.", "type": "string" }, "createTime": { "description": "Output only. Time at which the `CustomTargetType` was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "uid": { "readOnly": true, "type": "string", "description": "Output only. Unique identifier of the `CustomTargetType`." }, "name": { "description": "Identifier. Name of the `CustomTargetType`. Format is `projects/{project}/locations/{location}/customTargetTypes/{customTargetType}`. The `customTargetType` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`", "type": "string" }, "customActions": { "$ref": "CustomTargetSkaffoldActions", "description": "Optional. Configures render and deploy for the `CustomTargetType` using Skaffold custom actions." }, "description": { "description": "Optional. Description of the `CustomTargetType`. Max length is 255 characters.", "type": "string" }, "tasks": { "$ref": "CustomTargetTasks", "description": "Optional. Configures render and deploy for the `CustomTargetType` using tasks." }, "annotations": { "description": "Optional. User annotations. These attributes can only be set and used by the user, and not by Cloud Deploy. See https://google.aip.dev/128#annotations for more details such as format and size limitations.", "additionalProperties": { "type": "string" }, "type": "object" }, "labels": { "type": "object", "description": "Optional. 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 \u003c= 128 bytes.", "additionalProperties": { "type": "string" } } }, "description": "A `CustomTargetType` resource in the Cloud Deploy API. A `CustomTargetType` defines a type of custom target that can be referenced in a `Target` in order to facilitate deploying to other systems besides the supported runtimes." }, "RetryJobRequest": { "description": "RetryJobRequest is the request object used by `RetryJob`.", "type": "object", "id": "RetryJobRequest", "properties": { "jobId": { "type": "string", "description": "Required. The job ID for the Job to retry." }, "overrideDeployPolicy": { "items": { "type": "string" }, "description": "Optional. Deploy policies to override. Format is `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.", "type": "array" }, "phaseId": { "description": "Required. The phase ID the Job to retry belongs to.", "type": "string" } } }, "TargetsTypeCondition": { "type": "object", "id": "TargetsTypeCondition", "properties": { "status": { "description": "True if the targets are all a comparable type. For example this is true if all targets are GKE clusters. This is false if some targets are Cloud Run targets and others are GKE clusters.", "type": "boolean" }, "errorDetails": { "type": "string", "description": "Human readable error message." } }, "description": "TargetsTypeCondition contains information on whether the Targets defined in the Delivery Pipeline are of the same type." }, "RolloutNotificationEvent": { "type": "object", "id": "RolloutNotificationEvent", "properties": { "message": { "type": "string", "description": "Debug message for when a notification fails to send." }, "targetId": { "type": "string", "description": "ID of the `Target` that the rollout is deployed to." }, "pipelineUid": { "description": "Unique identifier of the `DeliveryPipeline`.", "type": "string" }, "rollout": { "description": "The name of the `Rollout`.", "type": "string" }, "type": { "type": "string", "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ], "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ], "description": "Type of this notification, e.g. for a Pub/Sub failure." }, "releaseUid": { "description": "Unique identifier of the `Release`.", "type": "string" }, "rolloutUid": { "type": "string", "description": "Unique identifier of the `Rollout`." }, "release": { "type": "string", "description": "The name of the `Release`." } }, "description": "Payload proto for \"clouddeploy.googleapis.com/rollout_notification\" Platform Log event that describes the failure to send rollout status change Pub/Sub notification." }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "type": "object", "id": "CancelOperationRequest", "properties": {} }, "PolicyViolationDetails": { "id": "PolicyViolationDetails", "properties": { "policy": { "description": "Name of the policy that was violated. Policy resource will be in the format of `projects/{project}/locations/{location}/policies/{policy}`.", "type": "string" }, "ruleId": { "type": "string", "description": "Id of the rule that triggered the policy violation." }, "failureMessage": { "type": "string", "description": "User readable message about why the request violated a policy. This is not intended for machine parsing." } }, "type": "object", "description": "Policy violation details." }, "KubernetesConfig": { "id": "KubernetesConfig", "properties": { "gatewayServiceMesh": { "$ref": "GatewayServiceMesh", "description": "Optional. Kubernetes Gateway API service mesh configuration." }, "serviceNetworking": { "$ref": "ServiceNetworking", "description": "Optional. Kubernetes Service networking configuration." } }, "type": "object", "description": "KubernetesConfig contains the Kubernetes runtime configuration." }, "DeliveryPipeline": { "type": "object", "id": "DeliveryPipeline", "properties": { "annotations": { "description": "Optional. User annotations. These attributes can only be set and used by the user, and not by Cloud Deploy.", "additionalProperties": { "type": "string" }, "type": "object" }, "labels": { "type": "object", "description": "Optional. 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 \u003c= 128 bytes.", "additionalProperties": { "type": "string" } }, "suspended": { "description": "Optional. When suspended, no new releases or rollouts can be created, but in-progress ones will complete.", "type": "boolean" }, "description": { "description": "Optional. Description of the `DeliveryPipeline`. Max length is 255 characters.", "type": "string" }, "condition": { "readOnly": true, "description": "Output only. Information around the state of the Delivery Pipeline.", "$ref": "PipelineCondition" }, "createTime": { "description": "Output only. Time at which the pipeline was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "uid": { "description": "Output only. Unique identifier of the `DeliveryPipeline`.", "readOnly": true, "type": "string" }, "name": { "type": "string", "description": "Identifier. Name of the `DeliveryPipeline`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}`. The `deliveryPipeline` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`" }, "serialPipeline": { "$ref": "SerialPipeline", "description": "Optional. SerialPipeline defines a sequential set of stages for a `DeliveryPipeline`." }, "updateTime": { "readOnly": true, "type": "string", "description": "Output only. Most recent time at which the pipeline was updated.", "format": "google-datetime" }, "etag": { "type": "string", "description": "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." } }, "description": "A `DeliveryPipeline` resource in the Cloud Deploy API. A `DeliveryPipeline` defines a pipeline through which a Skaffold configuration can progress." }, "CancelAutomationRunResponse": { "id": "CancelAutomationRunResponse", "properties": {}, "type": "object", "description": "The response object from `CancelAutomationRun`." }, "PipelineReadyCondition": { "description": "PipelineReadyCondition contains information around the status of the Pipeline.", "type": "object", "id": "PipelineReadyCondition", "properties": { "updateTime": { "format": "google-datetime", "description": "Last time the condition was updated.", "type": "string" }, "status": { "type": "boolean", "description": "True if the Pipeline is in a valid state. Otherwise at least one condition in `PipelineCondition` is in an invalid state. Iterate over those conditions and see which condition(s) has status = false to find out what is wrong with the Pipeline." } } }, "CreateChildRolloutJobRun": { "type": "object", "id": "CreateChildRolloutJobRun", "properties": { "rolloutPhaseId": { "type": "string", "readOnly": true, "description": "Output only. The ID of the childRollout Phase initiated by this JobRun." }, "rollout": { "description": "Output only. Name of the `ChildRollout`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`.", "type": "string", "readOnly": true } }, "description": "CreateChildRolloutJobRun contains information specific to a createChildRollout `JobRun`." }, "MultiTarget": { "id": "MultiTarget", "properties": { "targetIds": { "type": "array", "description": "Required. The target_ids of this multiTarget.", "items": { "type": "string" } } }, "type": "object", "description": "Information specifying a multiTarget." }, "DeployJobRunMetadata": { "description": "DeployJobRunMetadata surfaces information associated with a `DeployJobRun` to the user.", "id": "DeployJobRunMetadata", "properties": { "cloudRun": { "description": "Output only. The name of the Cloud Run Service that is associated with a `DeployJobRun`.", "$ref": "CloudRunMetadata", "readOnly": true }, "custom": { "description": "Output only. Custom metadata provided by user-defined deploy operation.", "$ref": "CustomMetadata", "readOnly": true }, "customTarget": { "readOnly": true, "description": "Output only. Custom Target metadata associated with a `DeployJobRun`.", "$ref": "CustomTargetDeployMetadata" } }, "type": "object" }, "TimedPromoteReleaseRule": { "description": "The `TimedPromoteReleaseRule` will automatically promote a release from the current target(s) to the specified target(s) on a configured schedule.", "type": "object", "id": "TimedPromoteReleaseRule", "properties": { "condition": { "description": "Output only. Information around the state of the Automation rule.", "$ref": "AutomationRuleCondition", "readOnly": true }, "id": { "description": "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])?`.", "type": "string" }, "schedule": { "description": "Required. Schedule in crontab format. e.g. \"0 9 * * 1\" for every Monday at 9am.", "type": "string" }, "timeZone": { "description": "Required. The time zone in IANA format [IANA Time Zone Database](https://www.iana.org/time-zones) (e.g. America/New_York).", "type": "string" }, "destinationPhase": { "description": "Optional. The starting phase of the rollout created by this rule. Default to the first phase.", "type": "string" }, "destinationTargetId": { "type": "string", "description": "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" } } }, "ReleaseRenderEvent": { "id": "ReleaseRenderEvent", "properties": { "pipelineUid": { "type": "string", "description": "Unique identifier of the `DeliveryPipeline`." }, "type": { "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ], "type": "string", "description": "Type of this notification, e.g. for a release render state change event.", "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ] }, "message": { "description": "Debug message for when a render transition occurs. Provides further details as rendering progresses through render states.", "type": "string" }, "release": { "type": "string", "description": "The name of the release. release_uid is not in this log message because we write some of these log messages at release creation time, before we've generated the uid." }, "releaseRenderState": { "enumDescriptions": [ "The render state is unspecified.", "All rendering operations have completed successfully.", "All rendering operations have completed, and one or more have failed.", "Rendering has started and is not complete." ], "enum": [ "RENDER_STATE_UNSPECIFIED", "SUCCEEDED", "FAILED", "IN_PROGRESS" ], "description": "The state of the release render.", "type": "string" } }, "type": "object", "description": "Payload proto for \"clouddeploy.googleapis.com/release_render\" Platform Log event that describes the render status change." }, "SkaffoldGitSource": { "id": "SkaffoldGitSource", "properties": { "repo": { "type": "string", "description": "Required. Git repository the package should be cloned from." }, "path": { "type": "string", "description": "Optional. Relative path from the repository root to the Skaffold file." }, "ref": { "type": "string", "description": "Optional. Git branch or tag to use when cloning the repository." } }, "type": "object", "description": "Git repository containing Skaffold Config modules." }, "Expr": { "type": "object", "id": "Expr", "properties": { "expression": { "description": "Textual representation of an expression in Common Expression Language syntax.", "type": "string" }, "description": { "type": "string", "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI." }, "title": { "description": "Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.", "type": "string" }, "location": { "type": "string", "description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file." } }, "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' && document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information." }, "IgnoreJobRequest": { "description": "The request object used by `IgnoreJob`.", "type": "object", "id": "IgnoreJobRequest", "properties": { "jobId": { "description": "Required. The job ID for the Job to ignore.", "type": "string" }, "overrideDeployPolicy": { "items": { "type": "string" }, "description": "Optional. Deploy policies to override. Format is `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.", "type": "array" }, "phaseId": { "description": "Required. The phase ID the Job to ignore belongs to.", "type": "string" } } }, "Metadata": { "description": "Metadata includes information associated with a `Rollout`.", "type": "object", "id": "Metadata", "properties": { "automation": { "readOnly": true, "$ref": "AutomationRolloutMetadata", "description": "Output only. AutomationRolloutMetadata contains the information about the interactions between Automation service and this rollout." }, "cloudRun": { "description": "Output only. The name of the Cloud Run Service that is associated with a `Rollout`.", "$ref": "CloudRunMetadata", "readOnly": true }, "custom": { "readOnly": true, "$ref": "CustomMetadata", "description": "Output only. Custom metadata provided by user-defined `Rollout` operations." } } }, "Operation": { "id": "Operation", "properties": { "metadata": { "type": "object", "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "error": { "$ref": "Status", "description": "The error result of the operation in case of failure or cancellation." }, "done": { "type": "boolean", "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available." }, "response": { "type": "object", "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "name": { "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", "type": "string" } }, "type": "object", "description": "This resource represents a long-running operation that is the result of a network API call." }, "SerialPipeline": { "description": "SerialPipeline defines a sequential set of stages for a `DeliveryPipeline`.", "id": "SerialPipeline", "properties": { "stages": { "type": "array", "description": "Optional. Each stage specifies configuration for a `Target`. The ordering of this list defines the promotion flow.", "items": { "$ref": "Stage" } } }, "type": "object" }, "OneTimeWindow": { "description": "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.", "id": "OneTimeWindow", "properties": { "endDate": { "description": "Required. End date.", "$ref": "Date" }, "startDate": { "$ref": "Date", "description": "Required. Start date." }, "endTime": { "$ref": "TimeOfDay", "description": "Required. End time (exclusive). You may use 24:00 for the end of the day." }, "startTime": { "description": "Required. Start time (inclusive). Use 00:00 for the beginning of the day.", "$ref": "TimeOfDay" } }, "type": "object" }, "ToolVersionSupportedCondition": { "id": "ToolVersionSupportedCondition", "properties": { "status": { "description": "Output only. True if the version of Tool used by this release is supported.", "type": "boolean", "readOnly": true }, "maintenanceModeTime": { "format": "google-datetime", "description": "Output only. The time at which this release's version of the tool will enter maintenance mode.", "type": "string", "readOnly": true }, "toolVersionSupportState": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "This tool version is currently supported.", "This tool version is in maintenance mode.", "This tool version is no longer supported." ], "readOnly": true, "enum": [ "TOOL_VERSION_SUPPORT_STATE_UNSPECIFIED", "TOOL_VERSION_SUPPORT_STATE_SUPPORTED", "TOOL_VERSION_SUPPORT_STATE_MAINTENANCE_MODE", "TOOL_VERSION_SUPPORT_STATE_UNSUPPORTED" ], "description": "Output only. The tool support state for this release's version of the tool." }, "supportExpirationTime": { "description": "Output only. The time at which this release's version of the tool will no longer be supported.", "format": "google-datetime", "readOnly": true, "type": "string" } }, "type": "object", "description": "ToolVersionSupportedCondition contains information about when support for the release's version of a tool ends." }, "VerifyJob": { "id": "VerifyJob", "properties": { "tasks": { "items": { "$ref": "Task" }, "description": "Output only. The tasks that are executed as part of the verify Job.", "type": "array", "readOnly": true } }, "type": "object", "description": "A verify Job." }, "ReleaseCondition": { "type": "object", "id": "ReleaseCondition", "properties": { "skaffoldSupportedCondition": { "$ref": "SkaffoldSupportedCondition", "description": "Details around the support state of the release's Skaffold version." }, "kptVersionSupportedCondition": { "readOnly": true, "description": "Output only. Details around the support state of the release's kpt version.", "$ref": "ToolVersionSupportedCondition" }, "skaffoldVersionSupportedCondition": { "$ref": "ToolVersionSupportedCondition", "description": "Output only. Details around the support state of the release's Skaffold version.", "readOnly": true }, "releaseReadyCondition": { "description": "Details around the Releases's overall status.", "$ref": "ReleaseReadyCondition" }, "kubectlVersionSupportedCondition": { "$ref": "ToolVersionSupportedCondition", "description": "Output only. Details around the support state of the release's Kubectl version.", "readOnly": true }, "helmVersionSupportedCondition": { "readOnly": true, "$ref": "ToolVersionSupportedCondition", "description": "Output only. Details around the support state of the release's Helm version." }, "kustomizeVersionSupportedCondition": { "readOnly": true, "description": "Output only. Details around the support state of the release's Kustomize version.", "$ref": "ToolVersionSupportedCondition" }, "dockerVersionSupportedCondition": { "description": "Output only. Details around the support state of the release's Docker version.", "$ref": "ToolVersionSupportedCondition", "readOnly": true } }, "description": "ReleaseCondition contains all conditions relevant to a Release." }, "TargetsPresentCondition": { "id": "TargetsPresentCondition", "properties": { "missingTargets": { "type": "array", "description": "The list of Target names that do not exist. For example, `projects/{project_id}/locations/{location_name}/targets/{target_name}`.", "items": { "type": "string" } }, "status": { "description": "True if there aren't any missing Targets.", "type": "boolean" }, "updateTime": { "format": "google-datetime", "description": "Last time the condition was updated.", "type": "string" } }, "type": "object", "description": "`TargetsPresentCondition` contains information on any Targets referenced in the Delivery Pipeline that do not actually exist." }, "RetryPhase": { "type": "object", "id": "RetryPhase", "properties": { "attempts": { "description": "Output only. Detail of a retry action.", "items": { "$ref": "RetryAttempt" }, "readOnly": true, "type": "array" }, "totalAttempts": { "description": "Output only. The number of attempts that have been made.", "format": "int64", "readOnly": true, "type": "string" }, "backoffMode": { "readOnly": true, "description": "Output only. The pattern of how the wait time of the retry attempt is calculated.", "enum": [ "BACKOFF_MODE_UNSPECIFIED", "BACKOFF_MODE_LINEAR", "BACKOFF_MODE_EXPONENTIAL" ], "type": "string", "enumDescriptions": [ "No WaitMode is specified.", "Increases the wait time linearly.", "Increases the wait time exponentially." ] } }, "description": "RetryPhase contains the retry attempts and the metadata for initiating a new attempt." }, "SkaffoldVersion": { "type": "object", "id": "SkaffoldVersion", "properties": { "supportEndDate": { "$ref": "Date", "description": "Date when this version is expected to no longer be supported." }, "maintenanceModeTime": { "type": "string", "description": "The time at which this version of Skaffold will enter maintenance mode.", "format": "google-datetime" }, "version": { "type": "string", "description": "Release version number. For example, \"1.20.3\"." }, "supportExpirationTime": { "format": "google-datetime", "description": "The time at which this version of Skaffold will no longer be supported.", "type": "string" } }, "description": "Details of a supported Skaffold version." }, "ApproveRolloutRequest": { "type": "object", "id": "ApproveRolloutRequest", "properties": { "overrideDeployPolicy": { "description": "Optional. Deploy policies to override. Format is `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.", "items": { "type": "string" }, "type": "array" }, "approved": { "description": "Required. True = approve; false = reject", "type": "boolean" } }, "description": "The request object used by `ApproveRollout`." }, "AlertPolicyCheckStatus": { "type": "object", "id": "AlertPolicyCheckStatus", "properties": { "labels": { "description": "Output only. The resolved labels used to filter for specific incidents.", "additionalProperties": { "type": "string" }, "readOnly": true, "type": "object" }, "failedAlertPolicies": { "readOnly": true, "type": "array", "description": "Output only. The alert policies that were found to be firing during this check. This will be empty if no incidents were found.", "items": { "$ref": "FailedAlertPolicy" } }, "id": { "type": "string", "readOnly": true, "description": "Output only. The ID of this analysis." }, "failureMessage": { "description": "Output only. Additional information about the alert policy check failure, if available. This will be empty if the alert policy check succeeded.", "readOnly": true, "type": "string" }, "alertPolicies": { "items": { "type": "string" }, "description": "Output only. The alert policies that this analysis monitors. Format is `projects/{project}/locations/{location}/alertPolicies/{alertPolicy}`.", "type": "array", "readOnly": true } }, "description": "AlertPolicyCheckStatus contains information specific to a single run of an alert policy check." }, "RepairRolloutOperation": { "description": "Contains the information for an automated `repair rollout` operation.", "type": "object", "id": "RepairRolloutOperation", "properties": { "currentRepairPhaseIndex": { "readOnly": true, "type": "string", "description": "Output only. The index of the current repair action in the repair sequence.", "format": "int64" }, "jobId": { "readOnly": true, "type": "string", "description": "Output only. The job ID for the Job to repair." }, "rollout": { "description": "Output only. The name of the rollout that initiates the `AutomationRun`.", "readOnly": true, "type": "string" }, "repairPhases": { "readOnly": true, "type": "array", "description": "Output only. Records of the repair attempts. Each repair phase may have multiple retry attempts or single rollback attempt.", "items": { "$ref": "RepairPhase" } }, "phaseId": { "type": "string", "readOnly": true, "description": "Output only. The phase ID of the phase that includes the job being repaired." } } }, "Task": { "description": "A Task represents a unit of work that is executed as part of a Job.", "type": "object", "id": "Task", "properties": { "container": { "description": "Optional. This task is represented by a container that is executed in the Cloud Build execution environment.", "$ref": "ContainerTask" } } }, "CustomTargetDeployMetadata": { "description": "CustomTargetDeployMetadata contains information from a Custom Target deploy operation.", "id": "CustomTargetDeployMetadata", "properties": { "skipMessage": { "description": "Output only. Skip message provided in the results of a custom deploy operation.", "readOnly": true, "type": "string" } }, "type": "object" }, "Config": { "type": "object", "id": "Config", "properties": { "supportedVersions": { "type": "array", "description": "All supported versions of Skaffold.", "items": { "$ref": "SkaffoldVersion" } }, "defaultToolVersions": { "readOnly": true, "$ref": "ToolVersions", "description": "Output only. Default tool versions. These tool versions are assigned when a Release is created without specifying tool versions." }, "name": { "type": "string", "description": "Name of the configuration." }, "defaultSkaffoldVersion": { "type": "string", "description": "Default Skaffold version that is assigned when a Release is created without specifying a Skaffold version." } }, "description": "Service-wide configuration." }, "RolloutRestriction": { "type": "object", "id": "RolloutRestriction", "properties": { "actions": { "type": "array", "items": { "enumDescriptions": [ "Unspecified.", "Advance the rollout to the next phase.", "Approve the rollout.", "Cancel the rollout.", "Create a rollout.", "Ignore a job result on the rollout.", "Retry a job for a rollout.", "Rollback a rollout.", "Terminate a jobrun." ], "enum": [ "ROLLOUT_ACTIONS_UNSPECIFIED", "ADVANCE", "APPROVE", "CANCEL", "CREATE", "IGNORE_JOB", "RETRY_JOB", "ROLLBACK", "TERMINATE_JOBRUN" ], "type": "string" }, "description": "Optional. Rollout actions to be restricted as part of the policy. If left empty, all actions will be restricted." }, "timeWindows": { "$ref": "TimeWindows", "description": "Required. Time window within which actions are restricted." }, "invokers": { "type": "array", "description": "Optional. What invoked the action. If left empty, all invoker types will be restricted.", "items": { "type": "string", "enumDescriptions": [ "Unspecified.", "The action is user-driven. For example, creating a rollout manually via a gcloud create command.", "Automated action by Cloud Deploy." ], "enum": [ "INVOKER_UNSPECIFIED", "USER", "DEPLOY_AUTOMATION" ] } }, "id": { "description": "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])?`.", "type": "string" } }, "description": "Rollout restrictions." }, "FailedAlertPolicy": { "description": "FailedAlertPolicy contains information about an alert policy that was found to be firing during an alert policy check.", "id": "FailedAlertPolicy", "properties": { "alerts": { "description": "Output only. Open alerts for the alerting policies that matched the alert policy check configuration.", "items": { "type": "string" }, "readOnly": true, "type": "array" }, "alertPolicy": { "description": "Output only. The name of the alert policy that was found to be firing. Format is `projects/{project}/locations/{location}/alertPolicies/{alertPolicy}`.", "readOnly": true, "type": "string" } }, "type": "object" }, "DeployPolicyNotificationEvent": { "description": "Payload proto for \"clouddeploy.googleapis.com/deploypolicy_notification\". Platform Log event that describes the failure to send a pub/sub notification when there is a DeployPolicy status change.", "type": "object", "id": "DeployPolicyNotificationEvent", "properties": { "type": { "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ], "type": "string", "description": "Type of this notification, e.g. for a Pub/Sub failure.", "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ] }, "message": { "type": "string", "description": "Debug message for when a deploy policy fails to send a pub/sub notification." }, "deployPolicyUid": { "type": "string", "description": "Unique identifier of the deploy policy." }, "deployPolicy": { "description": "The name of the `DeployPolicy`.", "type": "string" } } }, "ListDeliveryPipelinesResponse": { "description": "The response object from `ListDeliveryPipelines`.", "type": "object", "id": "ListDeliveryPipelinesResponse", "properties": { "deliveryPipelines": { "items": { "$ref": "DeliveryPipeline" }, "description": "The `DeliveryPipeline` objects.", "type": "array" }, "unreachable": { "type": "array", "description": "Locations that could not be reached.", "items": { "type": "string" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "DeployArtifact": { "description": "The artifacts produced by a deploy operation.", "type": "object", "id": "DeployArtifact", "properties": { "manifestPaths": { "description": "Output only. File paths of the manifests applied during the deploy operation relative to the URI.", "items": { "type": "string" }, "readOnly": true, "type": "array" }, "artifactUri": { "description": "Output only. URI of a directory containing the artifacts. All paths are relative to this location.", "readOnly": true, "type": "string" } } }, "CancelRolloutResponse": { "type": "object", "id": "CancelRolloutResponse", "properties": {}, "description": "The response object from `CancelRollout`." }, "RollbackTargetRequest": { "id": "RollbackTargetRequest", "properties": { "rollbackConfig": { "description": "Optional. Configs for the rollback `Rollout`.", "$ref": "RollbackTargetConfig" }, "targetId": { "type": "string", "description": "Required. ID of the `Target` that is being rolled back." }, "validateOnly": { "type": "boolean", "description": "Optional. If set to true, the request is validated and the user is provided with a `RollbackTargetResponse`." }, "overrideDeployPolicy": { "type": "array", "items": { "type": "string" }, "description": "Optional. Deploy policies to override. Format is `projects/{project}/locations/{location}/deployPolicies/{deploy_policy}`." }, "releaseId": { "type": "string", "description": "Optional. ID of the `Release` to roll back to. If this isn't specified, the previous successful `Rollout` to the specified target will be used to determine the `Release`." }, "rolloutId": { "description": "Required. ID of the rollback `Rollout` to create.", "type": "string" }, "rolloutToRollBack": { "type": "string", "description": "Optional. If provided, this must be the latest `Rollout` that is on the `Target`." } }, "type": "object", "description": "The request object for `RollbackTarget`." }, "TerminateJobRunRequest": { "description": "The request object used by `TerminateJobRun`.", "type": "object", "id": "TerminateJobRunRequest", "properties": { "overrideDeployPolicy": { "description": "Optional. Deploy policies to override. Format is `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.", "items": { "type": "string" }, "type": "array" } } }, "Phase": { "id": "Phase", "properties": { "deploymentJobs": { "readOnly": true, "description": "Output only. Deployment job composition.", "$ref": "DeploymentJobs" }, "state": { "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "PENDING", "IN_PROGRESS", "SUCCEEDED", "FAILED", "ABORTED", "SKIPPED" ], "description": "Output only. Current state of the Phase.", "type": "string", "enumDescriptions": [ "The Phase has an unspecified state.", "The Phase is waiting for an earlier Phase(s) to complete.", "The Phase is in progress.", "The Phase has succeeded.", "The Phase has failed.", "The Phase was aborted.", "The Phase was skipped." ] }, "id": { "type": "string", "readOnly": true, "description": "Output only. The ID of the Phase." }, "skipMessage": { "description": "Output only. Additional information on why the Phase was skipped, if available.", "readOnly": true, "type": "string" }, "childRolloutJobs": { "$ref": "ChildRolloutJobs", "description": "Output only. ChildRollout job composition.", "readOnly": true } }, "type": "object", "description": "Phase represents a collection of jobs that are logically grouped together for a `Rollout`." }, "Predeploy": { "type": "object", "id": "Predeploy", "properties": { "actions": { "type": "array", "description": "Optional. A sequence of Skaffold custom actions to invoke during execution of the predeploy job.", "items": { "type": "string" } }, "tasks": { "description": "Optional. The tasks that will run as a part of the predeploy job. The tasks are executed sequentially in the order specified. Only one of `actions` or `tasks` can be specified.", "items": { "$ref": "Task" }, "type": "array" } }, "description": "Predeploy contains the predeploy job configuration information." }, "CustomCheckStatus": { "id": "CustomCheckStatus", "properties": { "latestBuild": { "readOnly": true, "type": "string", "description": "Output only. The resource name of the Cloud Build `Build` object that was used to execute the latest run of this custom action check. Format is `projects/{project}/locations/{location}/builds/{build}`." }, "frequency": { "format": "google-duration", "description": "Output only. The frequency in minutes at which the custom check is run.", "type": "string", "readOnly": true }, "task": { "readOnly": true, "description": "Output only. The task that ran for this custom check.", "$ref": "Task" }, "failureMessage": { "type": "string", "readOnly": true, "description": "Output only. Additional information about the analysis failure, if available." }, "failureCause": { "enumDescriptions": [ "No reason for failure is specified.", "Cloud Build is not available, either because it is not enabled or because Cloud Deploy has insufficient permissions. See [required permission](https://cloud.google.com/deploy/docs/cloud-deploy-service-account#required_permissions).", "The analysis operation did not complete successfully; check Cloud Build logs.", "The analysis job run did not complete within the alloted time defined in the target's execution environment configuration.", "Cloud Build failed to fulfill Cloud Deploy's request. See failure_message for additional details." ], "type": "string", "description": "Output only. The reason the analysis failed. This will always be unspecified while the analysis is in progress or if it succeeded.", "enum": [ "FAILURE_CAUSE_UNSPECIFIED", "CLOUD_BUILD_UNAVAILABLE", "EXECUTION_FAILED", "DEADLINE_EXCEEDED", "CLOUD_BUILD_REQUEST_FAILED" ], "readOnly": true }, "id": { "type": "string", "readOnly": true, "description": "Output only. The ID of the custom check." }, "metadata": { "description": "Output only. Custom metadata provided by the user-defined custom check operation. result.", "$ref": "CustomMetadata", "readOnly": true } }, "type": "object", "description": "CustomCheckStatus contains information specific to a single iteration of a custom analysis job." }, "CloudRunConfig": { "description": "CloudRunConfig contains the Cloud Run runtime configuration.", "type": "object", "id": "CloudRunConfig", "properties": { "automaticTrafficControl": { "description": "Optional. Whether Cloud Deploy should update the traffic stanza in a Cloud Run Service on the user's behalf to facilitate traffic splitting. This is required to be true for CanaryDeployments, but optional for CustomCanaryDeployments.", "type": "boolean" }, "canaryRevisionTags": { "type": "array", "description": "Optional. A list of tags that are added to the canary revision while the canary phase is in progress.", "items": { "type": "string" } }, "priorRevisionTags": { "type": "array", "items": { "type": "string" }, "description": "Optional. A list of tags that are added to the prior revision while the canary phase is in progress." }, "stableRevisionTags": { "description": "Optional. A list of tags that are added to the final stable revision when the stable phase is applied.", "items": { "type": "string" }, "type": "array" } } }, "PredeployJobRun": { "type": "object", "id": "PredeployJobRun", "properties": { "build": { "type": "string", "readOnly": true, "description": "Output only. The resource name of the Cloud Build `Build` object that is used to execute the custom actions associated with the predeploy Job. Format is `projects/{project}/locations/{location}/builds/{build}`." }, "failureCause": { "readOnly": true, "enum": [ "FAILURE_CAUSE_UNSPECIFIED", "CLOUD_BUILD_UNAVAILABLE", "EXECUTION_FAILED", "DEADLINE_EXCEEDED", "CLOUD_BUILD_REQUEST_FAILED" ], "description": "Output only. The reason the predeploy failed. This will always be unspecified while the predeploy is in progress or if it succeeded.", "type": "string", "enumDescriptions": [ "No reason for failure is specified.", "Cloud Build is not available, either because it is not enabled or because Cloud Deploy has insufficient permissions. See [required permission](https://cloud.google.com/deploy/docs/cloud-deploy-service-account#required_permissions).", "The predeploy operation did not complete successfully; check Cloud Build logs.", "The predeploy job run did not complete within the allotted time.", "Cloud Build failed to fulfill Cloud Deploy's request. See failure_message for additional details." ] }, "metadata": { "readOnly": true, "description": "Output only. Metadata containing information about the predeploy `JobRun`.", "$ref": "PredeployJobRunMetadata" }, "failureMessage": { "type": "string", "readOnly": true, "description": "Output only. Additional information about the predeploy failure, if available." } }, "description": "PredeployJobRun contains information specific to a predeploy `JobRun`." }, "RollbackTargetResponse": { "id": "RollbackTargetResponse", "properties": { "rollbackConfig": { "$ref": "RollbackTargetConfig", "description": "The config of the rollback `Rollout` created or will be created." } }, "type": "object", "description": "The response object from `RollbackTarget`." }, "ExecutionConfig": { "id": "ExecutionConfig", "properties": { "defaultPool": { "$ref": "DefaultPool", "description": "Optional. Use default Cloud Build pool." }, "privatePool": { "description": "Optional. Use private Cloud Build pool.", "$ref": "PrivatePool" }, "workerPool": { "type": "string", "description": "Optional. The resource name of the `WorkerPool`, with the format `projects/{project}/locations/{location}/workerPools/{worker_pool}`. If this optional field is unspecified, the default Cloud Build pool will be used." }, "executionTimeout": { "format": "google-duration", "description": "Optional. Execution timeout for a Cloud Build Execution. This must be between 10m and 24h in seconds format. If unspecified, a default timeout of 1h is used.", "type": "string" }, "serviceAccount": { "type": "string", "description": "Optional. Google service account to use for execution. If unspecified, the project execution service account (-compute@developer.gserviceaccount.com) is used." }, "artifactStorage": { "type": "string", "description": "Optional. Cloud Storage location in which to store execution outputs. This can either be a bucket (\"gs://my-bucket\") or a path within a bucket (\"gs://my-bucket/my-dir\"). If unspecified, a default bucket located in the same region will be used." }, "usages": { "items": { "enumDescriptions": [ "Default value. This value is unused.", "Use for rendering.", "Use for deploying and deployment hooks.", "Use for deployment verification.", "Use for predeploy job execution.", "Use for postdeploy job execution.", "Use for analysis job execution." ], "enum": [ "EXECUTION_ENVIRONMENT_USAGE_UNSPECIFIED", "RENDER", "DEPLOY", "VERIFY", "PREDEPLOY", "POSTDEPLOY", "ANALYSIS" ], "type": "string" }, "description": "Required. Usages when this configuration should be applied.", "type": "array" }, "verbose": { "type": "boolean", "description": "Optional. If true, additional logging will be enabled when running builds in this execution environment." } }, "type": "object", "description": "Configuration of the environment to use when calling Skaffold." }, "SkaffoldSupportedCondition": { "id": "SkaffoldSupportedCondition", "properties": { "supportExpirationTime": { "type": "string", "description": "The time at which this release's version of Skaffold will no longer be supported.", "format": "google-datetime" }, "skaffoldSupportState": { "type": "string", "description": "The Skaffold support state for this release's version of Skaffold.", "enumDescriptions": [ "Default value. This value is unused.", "This Skaffold version is currently supported.", "This Skaffold version is in maintenance mode.", "This Skaffold version is no longer supported." ], "enum": [ "SKAFFOLD_SUPPORT_STATE_UNSPECIFIED", "SKAFFOLD_SUPPORT_STATE_SUPPORTED", "SKAFFOLD_SUPPORT_STATE_MAINTENANCE_MODE", "SKAFFOLD_SUPPORT_STATE_UNSUPPORTED" ] }, "status": { "type": "boolean", "description": "True if the version of Skaffold used by this release is supported." }, "maintenanceModeTime": { "description": "The time at which this release's version of Skaffold will enter maintenance mode.", "format": "google-datetime", "type": "string" } }, "type": "object", "description": "SkaffoldSupportedCondition contains information about when support for the release's version of Skaffold ends." }, "AdvanceRolloutRequest": { "description": "The request object used by `AdvanceRollout`.", "type": "object", "id": "AdvanceRolloutRequest", "properties": { "phaseId": { "description": "Required. The phase ID to advance the `Rollout` to.", "type": "string" }, "overrideDeployPolicy": { "items": { "type": "string" }, "description": "Optional. Deploy policies to override. Format is `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.", "type": "array" } } }, "RepairPhase": { "type": "object", "id": "RepairPhase", "properties": { "retry": { "description": "Output only. Records of the retry attempts for retry repair mode.", "$ref": "RetryPhase", "readOnly": true }, "rollback": { "description": "Output only. Rollback attempt for rollback repair mode .", "$ref": "RollbackAttempt", "readOnly": true } }, "description": "RepairPhase tracks the repair attempts that have been made for each `RepairPhaseConfig` specified in the `Automation` resource." }, "TimeWindows": { "description": "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.", "id": "TimeWindows", "properties": { "oneTimeWindows": { "description": "Optional. One-time windows within which actions are restricted.", "items": { "$ref": "OneTimeWindow" }, "type": "array" }, "timeZone": { "description": "Required. The time zone in IANA format [IANA Time Zone Database](https://www.iana.org/time-zones) (e.g. America/New_York).", "type": "string" }, "weeklyWindows": { "description": "Optional. Recurring weekly windows within which actions are restricted.", "items": { "$ref": "WeeklyWindow" }, "type": "array" } }, "type": "object" }, "ListReleasesResponse": { "id": "ListReleasesResponse", "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "releases": { "type": "array", "description": "The `Release` objects.", "items": { "$ref": "Release" } }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Locations that could not be reached." } }, "type": "object", "description": "The response object from `ListReleases`." }, "TimedPromoteReleaseCondition": { "description": "`TimedPromoteReleaseCondition` contains conditions specific to an Automation with a Timed Promote Release rule defined.", "type": "object", "id": "TimedPromoteReleaseCondition", "properties": { "targetsList": { "type": "array", "readOnly": true, "items": { "$ref": "Targets" }, "description": "Output only. A list of targets involved in the upcoming timed promotion(s)." }, "nextPromotionTime": { "readOnly": true, "type": "string", "description": "Output only. When the next scheduled promotion(s) will occur.", "format": "google-datetime" } } }, "RuntimeConfig": { "type": "object", "id": "RuntimeConfig", "properties": { "kubernetes": { "$ref": "KubernetesConfig", "description": "Optional. Kubernetes runtime configuration." }, "cloudRun": { "description": "Optional. Cloud Run runtime configuration.", "$ref": "CloudRunConfig" } }, "description": "RuntimeConfig contains the runtime specific configurations for a deployment strategy." }, "CloudRunLocation": { "type": "object", "id": "CloudRunLocation", "properties": { "location": { "type": "string", "description": "Required. The location for the Cloud Run Service. Format must be `projects/{project}/locations/{location}`." } }, "description": "Information specifying where to deploy a Cloud Run Service." }, "VerifyJobRunMetadata": { "description": "VerifyJobRunMetadata contains metadata about the verify `JobRun`.", "type": "object", "id": "VerifyJobRunMetadata", "properties": { "custom": { "readOnly": true, "description": "Output only. Custom metadata provided by user-defined verify operation.", "$ref": "CustomMetadata" } } }, "PostdeployJobRun": { "description": "PostdeployJobRun contains information specific to a postdeploy `JobRun`.", "type": "object", "id": "PostdeployJobRun", "properties": { "failureMessage": { "readOnly": true, "type": "string", "description": "Output only. Additional information about the postdeploy failure, if available." }, "build": { "readOnly": true, "type": "string", "description": "Output only. The resource name of the Cloud Build `Build` object that is used to execute the custom actions associated with the postdeploy Job. Format is `projects/{project}/locations/{location}/builds/{build}`." }, "failureCause": { "type": "string", "enumDescriptions": [ "No reason for failure is specified.", "Cloud Build is not available, either because it is not enabled or because Cloud Deploy has insufficient permissions. See [required permission](https://cloud.google.com/deploy/docs/cloud-deploy-service-account#required_permissions).", "The postdeploy operation did not complete successfully; check Cloud Build logs.", "The postdeploy job run did not complete within the allotted time.", "Cloud Build failed to fulfill Cloud Deploy's request. See failure_message for additional details." ], "readOnly": true, "enum": [ "FAILURE_CAUSE_UNSPECIFIED", "CLOUD_BUILD_UNAVAILABLE", "EXECUTION_FAILED", "DEADLINE_EXCEEDED", "CLOUD_BUILD_REQUEST_FAILED" ], "description": "Output only. The reason the postdeploy failed. This will always be unspecified while the postdeploy is in progress or if it succeeded." }, "metadata": { "readOnly": true, "description": "Output only. Metadata containing information about the postdeploy `JobRun`.", "$ref": "PostdeployJobRunMetadata" } } }, "CustomMetadata": { "description": "CustomMetadata contains information from a user-defined operation.", "id": "CustomMetadata", "properties": { "values": { "description": "Output only. Key-value pairs provided by the user-defined operation.", "additionalProperties": { "type": "string" }, "type": "object", "readOnly": true } }, "type": "object" }, "TimeOfDay": { "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "type": "object", "id": "TimeOfDay", "properties": { "hours": { "type": "integer", "format": "int32", "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time." }, "minutes": { "type": "integer", "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", "format": "int32" }, "seconds": { "type": "integer", "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.", "format": "int32" }, "nanos": { "type": "integer", "format": "int32", "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999." } } }, "DeployJobRun": { "type": "object", "id": "DeployJobRun", "properties": { "build": { "description": "Output only. The resource name of the Cloud Build `Build` object that is used to deploy. Format is `projects/{project}/locations/{location}/builds/{build}`.", "type": "string", "readOnly": true }, "failureCause": { "description": "Output only. The reason the deploy failed. This will always be unspecified while the deploy is in progress or if it succeeded.", "enum": [ "FAILURE_CAUSE_UNSPECIFIED", "CLOUD_BUILD_UNAVAILABLE", "EXECUTION_FAILED", "DEADLINE_EXCEEDED", "MISSING_RESOURCES_FOR_CANARY", "CLOUD_BUILD_REQUEST_FAILED", "DEPLOY_FEATURE_NOT_SUPPORTED" ], "readOnly": true, "enumDescriptions": [ "No reason for failure is specified.", "Cloud Build is not available, either because it is not enabled or because Cloud Deploy has insufficient permissions. See [Required permission](https://cloud.google.com/deploy/docs/cloud-deploy-service-account#required_permissions).", "The deploy operation did not complete successfully; check Cloud Build logs.", "The deploy job run did not complete within the allotted time.", "There were missing resources in the runtime environment required for a canary deployment. Check the Cloud Build logs for more information.", "Cloud Build failed to fulfill Cloud Deploy's request. See failure_message for additional details.", "The deploy operation had a feature configured that is not supported." ], "type": "string" }, "artifact": { "$ref": "DeployArtifact", "description": "Output only. The artifact of a deploy job run, if available.", "readOnly": true }, "metadata": { "readOnly": true, "description": "Output only. Metadata containing information about the deploy job run.", "$ref": "DeployJobRunMetadata" }, "failureMessage": { "description": "Output only. Additional information about the deploy failure, if available.", "readOnly": true, "type": "string" } }, "description": "DeployJobRun contains information specific to a deploy `JobRun`." }, "TerminateJobRunResponse": { "type": "object", "id": "TerminateJobRunResponse", "properties": {}, "description": "The response object from `TerminateJobRun`." }, "ListCustomTargetTypesResponse": { "description": "The response object from `ListCustomTargetTypes.`", "type": "object", "id": "ListCustomTargetTypesResponse", "properties": { "customTargetTypes": { "type": "array", "description": "The `CustomTargetType` objects.", "items": { "$ref": "CustomTargetType" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Locations that could not be reached." } } }, "TargetAttribute": { "description": "Contains criteria for selecting Targets. This could be used to select targets for a Deploy Policy or for an Automation.", "type": "object", "id": "TargetAttribute", "properties": { "labels": { "description": "Target labels.", "additionalProperties": { "type": "string" }, "type": "object" }, "id": { "description": "Optional. ID of the `Target`. The value of this field could be one of the following: * The last segment of a target name * \"*\", all targets in a location", "type": "string" } } }, "AutomationRunEvent": { "id": "AutomationRunEvent", "properties": { "destinationTargetId": { "type": "string", "description": "ID of the `Target` to which the `AutomationRun` is created." }, "message": { "description": "Debug message for when there is an update on the AutomationRun. Provides further details about the resource creation or state change.", "type": "string" }, "pipelineUid": { "description": "Unique identifier of the `DeliveryPipeline`.", "type": "string" }, "type": { "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ], "description": "Type of this notification, e.g. for a Pub/Sub failure.", "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ], "type": "string" }, "automationRun": { "description": "The name of the `AutomationRun`.", "type": "string" }, "automationId": { "description": "Identifier of the `Automation`.", "type": "string" }, "ruleId": { "description": "Identifier of the `Automation` rule.", "type": "string" } }, "type": "object", "description": "Payload proto for \"clouddeploy.googleapis.com/automation_run\" Platform Log event that describes the AutomationRun related events." }, "AbandonReleaseRequest": { "description": "The request object used by `AbandonRelease`.", "type": "object", "id": "AbandonReleaseRequest", "properties": {} }, "Strategy": { "description": "Strategy contains deployment strategy information.", "type": "object", "id": "Strategy", "properties": { "standard": { "description": "Optional. Standard deployment strategy executes a single deploy and allows verifying the deployment.", "$ref": "Standard" }, "canary": { "description": "Optional. Canary deployment strategy provides progressive percentage based deployments to a Target.", "$ref": "Canary" } } }, "AlertPolicyCheck": { "description": "AlertPolicyCheck configures a set of Cloud Monitoring alerting policies that will be periodically polled for alerts. If any of the listed policies have an active alert, the analysis check will fail.", "type": "object", "id": "AlertPolicyCheck", "properties": { "alertPolicies": { "items": { "type": "string" }, "description": "Required. The Cloud Monitoring Alert Policies to check for active alerts. Format is `projects/{project}/alertPolicies/{alert_policy}`.", "type": "array" }, "labels": { "type": "object", "description": "Optional. A set of labels to filter active alerts. If set, only alerts having all of the specified labels will be considered. Otherwise, all active alerts will be considered.", "additionalProperties": { "type": "string" } }, "id": { "type": "string", "description": "Required. The ID of the analysis check." } } }, "AdvanceChildRolloutJob": { "type": "object", "id": "AdvanceChildRolloutJob", "properties": {}, "description": "An advanceChildRollout Job." }, "CustomTargetSkaffoldActions": { "type": "object", "id": "CustomTargetSkaffoldActions", "properties": { "deployAction": { "type": "string", "description": "Required. The Skaffold custom action responsible for deploy operations." }, "renderAction": { "description": "Optional. The Skaffold custom action responsible for render operations. If not provided then Cloud Deploy will perform the render operations via `skaffold render`.", "type": "string" }, "includeSkaffoldModules": { "type": "array", "items": { "$ref": "SkaffoldModules" }, "description": "Optional. List of Skaffold modules Cloud Deploy will include in the Skaffold Config as required before performing diagnose." } }, "description": "CustomTargetSkaffoldActions represents the `CustomTargetType` configuration using Skaffold custom actions." }, "DeployPolicyEvaluationEvent": { "description": "Payload proto for \"clouddeploy.googleapis.com/deploypolicy_evaluation\" Platform Log event that describes the deploy policy evaluation event.", "id": "DeployPolicyEvaluationEvent", "properties": { "deployPolicyUid": { "type": "string", "description": "Unique identifier of the `DeployPolicy`." }, "deliveryPipeline": { "description": "The name of the `Delivery Pipeline`.", "type": "string" }, "targetUid": { "type": "string", "description": "Unique identifier of the `Target`. This is an optional field, as a `Target` may not always be applicable to a policy." }, "invoker": { "type": "string", "enumDescriptions": [ "Unspecified.", "The action is user-driven. For example, creating a rollout manually via a gcloud create command.", "Automated action by Cloud Deploy." ], "enum": [ "INVOKER_UNSPECIFIED", "USER", "DEPLOY_AUTOMATION" ], "description": "What invoked the action (e.g. a user or automation)." }, "message": { "type": "string", "description": "Debug message for when a deploy policy event occurs." }, "pipelineUid": { "description": "Unique identifier of the `Delivery Pipeline`.", "type": "string" }, "allowed": { "type": "boolean", "description": "Whether the request is allowed. Allowed is set as true if: (1) the request complies with the policy; or (2) the request doesn't comply with the policy but the policy was overridden; or (3) the request doesn't comply with the policy but the policy was suspended" }, "verdict": { "enumDescriptions": [ "This should never happen.", "Allowed by policy. This enum value is not currently used but may be used in the future. Currently logs are only generated when a request is denied by policy.", "Denied by policy." ], "enum": [ "POLICY_VERDICT_UNSPECIFIED", "ALLOWED_BY_POLICY", "DENIED_BY_POLICY" ], "description": "The policy verdict of the request.", "type": "string" }, "overrides": { "type": "array", "items": { "type": "string", "enumDescriptions": [ "This should never happen.", "The policy was overridden.", "The policy was suspended." ], "enum": [ "POLICY_VERDICT_OVERRIDE_UNSPECIFIED", "POLICY_OVERRIDDEN", "POLICY_SUSPENDED" ] }, "description": "Things that could have overridden the policy verdict. Overrides together with verdict decide whether the request is allowed." }, "ruleType": { "type": "string", "description": "Rule type (e.g. Restrict Rollouts)." }, "rule": { "description": "Rule id.", "type": "string" }, "deployPolicy": { "type": "string", "description": "The name of the `DeployPolicy`." }, "target": { "description": "The name of the `Target`. This is an optional field, as a `Target` may not always be applicable to a policy.", "type": "string" } }, "type": "object" }, "AnthosCluster": { "id": "AnthosCluster", "properties": { "membership": { "type": "string", "description": "Optional. Membership of the GKE Hub-registered cluster to which to apply the Skaffold configuration. Format is `projects/{project}/locations/{location}/memberships/{membership_name}`." } }, "type": "object", "description": "Information specifying an Anthos Cluster." }, "Retry": { "description": "Retries the failed job.", "type": "object", "id": "Retry", "properties": { "attempts": { "type": "string", "format": "int64", "description": "Required. Total number of retries. Retry is skipped if set to 0; The minimum value is 1, and the maximum value is 10." }, "wait": { "type": "string", "description": "Optional. How long to wait for the first retry. Default is 0, and the maximum value is 14d.", "format": "google-duration" }, "backoffMode": { "description": "Optional. The pattern of how wait time will be increased. Default is linear. Backoff mode will be ignored if `wait` is 0.", "enumDescriptions": [ "No WaitMode is specified.", "Increases the wait time linearly.", "Increases the wait time exponentially." ], "enum": [ "BACKOFF_MODE_UNSPECIFIED", "BACKOFF_MODE_LINEAR", "BACKOFF_MODE_EXPONENTIAL" ], "type": "string" } } }, "DefaultPool": { "description": "Execution using the default Cloud Build pool.", "id": "DefaultPool", "properties": { "serviceAccount": { "type": "string", "description": "Optional. Google service account to use for execution. If unspecified, the project execution service account (-compute@developer.gserviceaccount.com) will be used." }, "artifactStorage": { "description": "Optional. Cloud Storage location where execution outputs should be stored. This can either be a bucket (\"gs://my-bucket\") or a path within a bucket (\"gs://my-bucket/my-dir\"). If unspecified, a default bucket located in the same region will be used.", "type": "string" } }, "type": "object" }, "AuditConfig": { "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "type": "object", "id": "AuditConfig", "properties": { "service": { "type": "string", "description": "Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services." }, "auditLogConfigs": { "type": "array", "description": "The configuration for logging of each type of permission.", "items": { "$ref": "AuditLogConfig" } } } }, "AbandonReleaseResponse": { "description": "The response object for `AbandonRelease`.", "id": "AbandonReleaseResponse", "properties": {}, "type": "object" }, "Policy": { "type": "object", "id": "Policy", "properties": { "auditConfigs": { "type": "array", "items": { "$ref": "AuditConfig" }, "description": "Specifies cloud audit logging configuration for this policy." }, "version": { "format": "int32", "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "type": "integer" }, "bindings": { "description": "Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.", "items": { "$ref": "Binding" }, "type": "array" }, "etag": { "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.", "format": "byte", "type": "string" } }, "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/)." }, "Release": { "description": "A `Release` resource in the Cloud Deploy API. A `Release` defines a specific Skaffold configuration instance that can be deployed.", "id": "Release", "properties": { "uid": { "description": "Output only. Unique identifier of the `Release`.", "type": "string", "readOnly": true }, "targetArtifacts": { "type": "object", "readOnly": true, "description": "Output only. Map from target ID to the target artifacts created during the render operation.", "additionalProperties": { "$ref": "TargetArtifact" } }, "etag": { "description": "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.", "type": "string" }, "skaffoldConfigPath": { "description": "Optional. Filepath of the Skaffold config inside of the config URI.", "type": "string" }, "annotations": { "type": "object", "description": "Optional. User annotations. These attributes can only be set and used by the user, and not by Cloud Deploy. See https://google.aip.dev/128#annotations for more details such as format and size limitations.", "additionalProperties": { "type": "string" } }, "abandoned": { "readOnly": true, "type": "boolean", "description": "Output only. Indicates whether this is an abandoned release." }, "deliveryPipelineSnapshot": { "readOnly": true, "description": "Output only. Snapshot of the parent pipeline taken at release creation time.", "$ref": "DeliveryPipeline" }, "description": { "type": "string", "description": "Optional. Description of the `Release`. Max length is 255 characters." }, "condition": { "readOnly": true, "$ref": "ReleaseCondition", "description": "Output only. Information around the state of the Release." }, "customTargetTypeSnapshots": { "type": "array", "readOnly": true, "items": { "$ref": "CustomTargetType" }, "description": "Output only. Snapshot of the custom target types referenced by the targets taken at release creation time." }, "renderEndTime": { "format": "google-datetime", "description": "Output only. Time at which the render completed.", "type": "string", "readOnly": true }, "name": { "description": "Identifier. Name of the `Release`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}`. The `release` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`", "type": "string" }, "buildArtifacts": { "description": "Optional. List of artifacts to pass through to Skaffold command.", "items": { "$ref": "BuildArtifact" }, "type": "array" }, "createTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Time at which the `Release` was created." }, "deployParameters": { "type": "object", "description": "Optional. The deploy parameters to use for all targets in this release.", "additionalProperties": { "type": "string" } }, "targetSnapshots": { "readOnly": true, "type": "array", "description": "Output only. Snapshot of the targets taken at release creation time.", "items": { "$ref": "Target" } }, "skaffoldConfigUri": { "type": "string", "description": "Optional. Cloud Storage URI of tar.gz archive containing Skaffold configuration." }, "skaffoldVersion": { "description": "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.", "type": "string" }, "labels": { "type": "object", "description": "Optional. 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 \u003c= 128 bytes.", "additionalProperties": { "type": "string" } }, "renderStartTime": { "description": "Output only. Time at which the render began.", "format": "google-datetime", "readOnly": true, "type": "string" }, "renderState": { "type": "string", "enumDescriptions": [ "The render state is unspecified.", "All rendering operations have completed successfully.", "All rendering operations have completed, and one or more have failed.", "Rendering has started and is not complete." ], "readOnly": true, "description": "Output only. Current state of the render operation.", "enum": [ "RENDER_STATE_UNSPECIFIED", "SUCCEEDED", "FAILED", "IN_PROGRESS" ] }, "toolVersions": { "$ref": "ToolVersions", "description": "Optional. The tool versions to use for this release and all subsequent operations involving this release. If unset, tool versions are frozen when the release is created." }, "targetRenders": { "description": "Output only. Map from target ID to details of the render operation for that target.", "additionalProperties": { "$ref": "TargetRender" }, "type": "object", "readOnly": true } }, "type": "object" }, "Location": { "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "locationId": { "description": "The canonical id for this location. For example: `\"us-east1\"`.", "type": "string" }, "name": { "type": "string", "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`" }, "labels": { "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "additionalProperties": { "type": "string" }, "type": "object" }, "metadata": { "type": "object", "description": "Service-specific metadata. For example the available capacity at the given location.", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } }, "displayName": { "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" } }, "type": "object" }, "PolicyRule": { "description": "Deploy Policy rule.", "type": "object", "id": "PolicyRule", "properties": { "rolloutRestriction": { "$ref": "RolloutRestriction", "description": "Optional. Rollout restrictions." } } }, "DeploymentJobs": { "type": "object", "id": "DeploymentJobs", "properties": { "predeployJob": { "description": "Output only. The predeploy Job, which is the first job on the phase.", "$ref": "Job", "readOnly": true }, "postdeployJob": { "readOnly": true, "description": "Output only. The postdeploy Job, which is the last job on the phase.", "$ref": "Job" }, "analysisJob": { "description": "Output only. The analysis Job. Runs after a verify if there is a verify job and the verify job succeeds.", "$ref": "Job", "readOnly": true }, "deployJob": { "readOnly": true, "description": "Output only. The deploy Job. This is the deploy job in the phase.", "$ref": "Job" }, "verifyJob": { "$ref": "Job", "description": "Output only. The verify Job. Runs after a deploy if the deploy succeeds.", "readOnly": true } }, "description": "Deployment job composition." }, "GoogleCloudAnalysis": { "id": "GoogleCloudAnalysis", "properties": { "alertPolicyChecks": { "items": { "$ref": "AlertPolicyCheck" }, "description": "Optional. A list of Cloud Monitoring Alert Policy checks to perform as part of the analysis.", "type": "array" } }, "type": "object", "description": "GoogleCloudAnalysis is a set of Google Cloud-based checks to perform on the deployment." }, "PredeployJob": { "type": "object", "id": "PredeployJob", "properties": { "actions": { "description": "Output only. The custom actions that the predeploy Job executes.", "items": { "type": "string" }, "readOnly": true, "type": "array" }, "tasks": { "type": "array", "readOnly": true, "items": { "$ref": "Task" }, "description": "Output only. The tasks that are executed as part of the predeploy Job." } }, "description": "A predeploy Job." }, "SkaffoldGCBRepoSource": { "description": "Cloud Build V2 Repository containing Skaffold Configs.", "type": "object", "id": "SkaffoldGCBRepoSource", "properties": { "path": { "type": "string", "description": "Optional. Relative path from the repository root to the Skaffold Config file." }, "ref": { "description": "Optional. Branch or tag to use when cloning the repository.", "type": "string" }, "repository": { "type": "string", "description": "Required. Name of the Cloud Build V2 Repository. Format is projects/{project}/locations/{location}/connections/{connection}/repositories/{repository}." } } }, "Automation": { "id": "Automation", "properties": { "uid": { "readOnly": true, "type": "string", "description": "Output only. Unique identifier of the `Automation`." }, "serviceAccount": { "type": "string", "description": "Required. Email address of the user-managed IAM service account that creates Cloud Deploy release and rollout resources." }, "createTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Time at which the automation was created." }, "name": { "description": "Output only. Name of the `Automation`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{delivery_pipeline}/automations/{automation}`.", "readOnly": true, "type": "string" }, "updateTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Time at which the automation was updated." }, "etag": { "description": "Optional. 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.", "type": "string" }, "selector": { "description": "Required. Selected resources to which the automation will be applied.", "$ref": "AutomationResourceSelector" }, "annotations": { "description": "Optional. 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.", "additionalProperties": { "type": "string" }, "type": "object" }, "labels": { "type": "object", "description": "Optional. 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 \u003c= 63 characters.", "additionalProperties": { "type": "string" } }, "suspended": { "description": "Optional. When Suspended, automation is deactivated from execution.", "type": "boolean" }, "description": { "description": "Optional. Description of the `Automation`. Max length is 255 characters.", "type": "string" }, "rules": { "items": { "$ref": "AutomationRule" }, "description": "Required. List of Automation rules associated with the Automation resource. Must have at least one rule and limited to 250 rules per Delivery Pipeline. Note: the order of the rules here is not the same as the order of execution.", "type": "array" } }, "type": "object", "description": "An `Automation` resource in the Cloud Deploy API. An `Automation` enables the automation of manually driven actions for a Delivery Pipeline, which includes Release promotion among Targets, Rollout repair and Rollout deployment strategy advancement. The intention of Automation is to reduce manual intervention in the continuous delivery process." }, "AdvanceRolloutResponse": { "type": "object", "id": "AdvanceRolloutResponse", "properties": {}, "description": "The response object from `AdvanceRollout`." }, "PostdeployJobRunMetadata": { "type": "object", "id": "PostdeployJobRunMetadata", "properties": { "custom": { "$ref": "CustomMetadata", "description": "Output only. Custom metadata provided by user-defined postdeploy operation.", "readOnly": true } }, "description": "PostdeployJobRunMetadata contains metadata about the postdeploy `JobRun`." }, "ListAutomationsResponse": { "description": "The response object from `ListAutomations`.", "id": "ListAutomationsResponse", "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "unreachable": { "type": "array", "description": "Locations that could not be reached.", "items": { "type": "string" } }, "automations": { "description": "The `Automation` objects.", "items": { "$ref": "Automation" }, "type": "array" } }, "type": "object" }, "Standard": { "id": "Standard", "properties": { "verify": { "type": "boolean", "description": "Optional. Whether to verify a deployment via `skaffold verify`." }, "analysis": { "$ref": "Analysis", "description": "Optional. Configuration for the analysis job. If this is not configured, the analysis job will not be present." }, "verifyConfig": { "$ref": "Verify", "description": "Optional. Configuration for the verify job. Cannot be set if `verify` is set to true." }, "predeploy": { "description": "Optional. Configuration for the predeploy job. If this is not configured, the predeploy job will not be present.", "$ref": "Predeploy" }, "postdeploy": { "description": "Optional. Configuration for the postdeploy job. If this is not configured, the postdeploy job will not be present.", "$ref": "Postdeploy" } }, "type": "object", "description": "Standard represents the standard deployment strategy." }, "CustomCheck": { "type": "object", "id": "CustomCheck", "properties": { "id": { "type": "string", "description": "Required. The ID of the custom Analysis check." }, "frequency": { "type": "string", "format": "google-duration", "description": "Optional. The frequency at which the custom check will be run, with a minimum and default of 5 minutes." }, "task": { "description": "Required. The Task to be run for this custom check.", "$ref": "Task" } }, "description": "CustomCheck configures a third-party metric provider to run the analysis, via a Task that runs at a specified frequency." }, "AutomationEvent": { "type": "object", "id": "AutomationEvent", "properties": { "message": { "description": "Debug message for when there is an update on the AutomationRun. Provides further details about the resource creation or state change.", "type": "string" }, "automation": { "description": "The name of the `AutomationRun`.", "type": "string" }, "pipelineUid": { "type": "string", "description": "Unique identifier of the `DeliveryPipeline`." }, "type": { "description": "Type of this notification, e.g. for a Pub/Sub failure.", "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ], "type": "string", "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ] } }, "description": "Payload proto for \"clouddeploy.googleapis.com/automation\" Platform Log event that describes the Automation related events." }, "ListRolloutsResponse": { "description": "ListRolloutsResponse is the response object returned by `ListRollouts`.", "id": "ListRolloutsResponse", "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "rollouts": { "type": "array", "items": { "$ref": "Rollout" }, "description": "The `Rollout` objects." }, "unreachable": { "type": "array", "description": "Locations that could not be reached.", "items": { "type": "string" } } }, "type": "object" }, "ListOperationsResponse": { "id": "ListOperationsResponse", "properties": { "unreachable": { "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", "items": { "type": "string" }, "type": "array" }, "operations": { "description": "A list of operations that matches the specified filter in the request.", "items": { "$ref": "Operation" }, "type": "array" }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } }, "type": "object", "description": "The response message for Operations.ListOperations." }, "DeployParameters": { "description": "DeployParameters contains deploy parameters information.", "type": "object", "id": "DeployParameters", "properties": { "values": { "description": "Required. Values are deploy parameters in key-value pairs.", "additionalProperties": { "type": "string" }, "type": "object" }, "matchTargetLabels": { "type": "object", "description": "Optional. Deploy parameters are applied to targets with match labels. If unspecified, deploy parameters are applied to all targets (including child targets of a multi-target).", "additionalProperties": { "type": "string" } } } }, "ListJobRunsResponse": { "description": "ListJobRunsResponse is the response object returned by `ListJobRuns`.", "type": "object", "id": "ListJobRunsResponse", "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "jobRuns": { "items": { "$ref": "JobRun" }, "description": "The `JobRun` objects.", "type": "array" }, "unreachable": { "type": "array", "description": "Locations that could not be reached", "items": { "type": "string" } } } }, "RepairPhaseConfig": { "description": "Configuration of the repair phase.", "type": "object", "id": "RepairPhaseConfig", "properties": { "retry": { "description": "Optional. Retries a failed job.", "$ref": "Retry" }, "rollback": { "$ref": "Rollback", "description": "Optional. Rolls back a `Rollout`." } } }, "PrivatePool": { "id": "PrivatePool", "properties": { "workerPool": { "type": "string", "description": "Required. Resource name of the Cloud Build worker pool to use. The format is `projects/{project}/locations/{location}/workerPools/{pool}`." }, "artifactStorage": { "type": "string", "description": "Optional. Cloud Storage location where execution outputs should be stored. This can either be a bucket (\"gs://my-bucket\") or a path within a bucket (\"gs://my-bucket/my-dir\"). If unspecified, a default bucket located in the same region will be used." }, "serviceAccount": { "description": "Optional. Google service account to use for execution. If unspecified, the project execution service account (-compute@developer.gserviceaccount.com) will be used.", "type": "string" } }, "type": "object", "description": "Execution using a private Cloud Build pool." }, "Canary": { "description": "Canary represents the canary deployment strategy.", "type": "object", "id": "Canary", "properties": { "runtimeConfig": { "description": "Optional. Runtime specific configurations for the deployment strategy. The runtime configuration is used to determine how Cloud Deploy will split traffic to enable a progressive deployment.", "$ref": "RuntimeConfig" }, "customCanaryDeployment": { "$ref": "CustomCanaryDeployment", "description": "Optional. Configures the progressive based deployment for a Target, but allows customizing at the phase level where a phase represents each of the percentage deployments." }, "canaryDeployment": { "$ref": "CanaryDeployment", "description": "Optional. Configures the progressive based deployment for a Target." } } }, "PredeployJobRunMetadata": { "description": "PredeployJobRunMetadata contains metadata about the predeploy `JobRun`.", "id": "PredeployJobRunMetadata", "properties": { "custom": { "readOnly": true, "$ref": "CustomMetadata", "description": "Output only. Custom metadata provided by user-defined predeploy operation." } }, "type": "object" }, "AssociatedEntities": { "type": "object", "id": "AssociatedEntities", "properties": { "anthosClusters": { "type": "array", "description": "Optional. Information specifying Anthos clusters as associated entities.", "items": { "$ref": "AnthosCluster" } }, "gkeClusters": { "description": "Optional. Information specifying GKE clusters as associated entities.", "items": { "$ref": "GkeCluster" }, "type": "array" } }, "description": "Information about entities associated with a `Target`." }, "AnalysisJobRun": { "id": "AnalysisJobRun", "properties": { "alertPolicyAnalyses": { "description": "Output only. The status of the running alert policy checks configured for this analysis.", "items": { "$ref": "AlertPolicyCheckStatus" }, "readOnly": true, "type": "array" }, "customCheckAnalyses": { "items": { "$ref": "CustomCheckStatus" }, "description": "Output only. The status of the running custom checks configured for this analysis.", "type": "array", "readOnly": true }, "failedCheckId": { "description": "Output only. The ID of the configured check that failed. This will always be blank while the analysis is in progress or if it succeeded.", "readOnly": true, "type": "string" } }, "type": "object", "description": "AnalysisJobRun contains information specific to an analysis `JobRun`." }, "AuditLogConfig": { "type": "object", "id": "AuditLogConfig", "properties": { "logType": { "type": "string", "description": "The log type that this config enables.", "enumDescriptions": [ "Default case. Should never be this.", "Admin reads. Example: CloudIAM getIamPolicy", "Data writes. Example: CloudSQL Users create", "Data reads. Example: CloudSQL Users list" ], "enum": [ "LOG_TYPE_UNSPECIFIED", "ADMIN_READ", "DATA_WRITE", "DATA_READ" ] }, "exemptedMembers": { "type": "array", "items": { "type": "string" }, "description": "Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members." } }, "description": "Provides the configuration for logging a type of permissions. Example: { \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging." }, "PipelineCondition": { "description": "PipelineCondition contains all conditions relevant to a Delivery Pipeline.", "id": "PipelineCondition", "properties": { "pipelineReadyCondition": { "$ref": "PipelineReadyCondition", "description": "Details around the Pipeline's overall status." }, "targetsPresentCondition": { "$ref": "TargetsPresentCondition", "description": "Details around targets enumerated in the pipeline." }, "targetsTypeCondition": { "description": "Details on the whether the targets enumerated in the pipeline are of the same type.", "$ref": "TargetsTypeCondition" } }, "type": "object" }, "CustomTarget": { "description": "Information specifying a Custom Target.", "id": "CustomTarget", "properties": { "customTargetType": { "type": "string", "description": "Required. The name of the CustomTargetType. Format must be `projects/{project}/locations/{location}/customTargetTypes/{custom_target_type}`." } }, "type": "object" }, "IgnoreJobResponse": { "type": "object", "id": "IgnoreJobResponse", "properties": {}, "description": "The response object from `IgnoreJob`." }, "Stage": { "id": "Stage", "properties": { "profiles": { "items": { "type": "string" }, "description": "Optional. Skaffold profiles to use when rendering the manifest for this stage's `Target`.", "type": "array" }, "strategy": { "description": "Optional. The strategy to use for a `Rollout` to this stage.", "$ref": "Strategy" }, "targetId": { "type": "string", "description": "Optional. The target_id to which this stage points. This field refers exclusively to the last segment of a target name. For example, this field would just be `my-target` (rather than `projects/project/locations/location/targets/my-target`). The location of the `Target` is inferred to be the same as the location of the `DeliveryPipeline` that contains this `Stage`." }, "deployParameters": { "description": "Optional. The deploy parameters to use for the target in this stage.", "items": { "$ref": "DeployParameters" }, "type": "array" } }, "type": "object", "description": "Stage specifies a location to which to deploy." }, "VerifyJobRun": { "type": "object", "id": "VerifyJobRun", "properties": { "build": { "readOnly": true, "type": "string", "description": "Output only. The resource name of the Cloud Build `Build` object that is used to verify. Format is `projects/{project}/locations/{location}/builds/{build}`." }, "eventLogPath": { "description": "Output only. File path of the Skaffold event log relative to the artifact URI.", "type": "string", "readOnly": true }, "artifactUri": { "readOnly": true, "type": "string", "description": "Output only. URI of a directory containing the verify artifacts. This contains the Skaffold event log." }, "metadata": { "description": "Output only. Metadata containing information about the verify `JobRun`.", "$ref": "VerifyJobRunMetadata", "readOnly": true }, "failureCause": { "enumDescriptions": [ "No reason for failure is specified.", "Cloud Build is not available, either because it is not enabled or because Cloud Deploy has insufficient permissions. See [required permission](https://cloud.google.com/deploy/docs/cloud-deploy-service-account#required_permissions).", "The verify operation did not complete successfully; check Cloud Build logs.", "The verify job run did not complete within the allotted time.", "No Skaffold verify configuration was found.", "Cloud Build failed to fulfill Cloud Deploy's request. See failure_message for additional details." ], "type": "string", "enum": [ "FAILURE_CAUSE_UNSPECIFIED", "CLOUD_BUILD_UNAVAILABLE", "EXECUTION_FAILED", "DEADLINE_EXCEEDED", "VERIFICATION_CONFIG_NOT_FOUND", "CLOUD_BUILD_REQUEST_FAILED" ], "description": "Output only. The reason the verify failed. This will always be unspecified while the verify is in progress or if it succeeded.", "readOnly": true }, "failureMessage": { "description": "Output only. Additional information about the verify failure, if available.", "type": "string", "readOnly": true } }, "description": "VerifyJobRun contains information specific to a verify `JobRun`." }, "ListLocationsResponse": { "id": "ListLocationsResponse", "properties": { "nextPageToken": { "type": "string", "description": "The standard List next-page token." }, "locations": { "type": "array", "description": "A list of locations that matches the specified filter in the request.", "items": { "$ref": "Location" } } }, "type": "object", "description": "The response message for Locations.ListLocations." }, "AdvanceChildRolloutJobRun": { "type": "object", "id": "AdvanceChildRolloutJobRun", "properties": { "rolloutPhaseId": { "description": "Output only. the ID of the ChildRollout's Phase.", "type": "string", "readOnly": true }, "rollout": { "type": "string", "readOnly": true, "description": "Output only. Name of the `ChildRollout`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`." } }, "description": "AdvanceChildRolloutJobRun contains information specific to a advanceChildRollout `JobRun`." }, "ServiceNetworking": { "description": "Information about the Kubernetes Service networking configuration.", "id": "ServiceNetworking", "properties": { "disablePodOverprovisioning": { "type": "boolean", "description": "Optional. Whether to disable Pod overprovisioning. If Pod overprovisioning is disabled then Cloud Deploy will limit the number of total Pods used for the deployment strategy to the number of Pods the Deployment has on the cluster." }, "podSelectorLabel": { "description": "Optional. The label to use when selecting Pods for the Deployment resource. This label must already be present in the Deployment.", "type": "string" }, "service": { "type": "string", "description": "Required. Name of the Kubernetes Service." }, "deployment": { "description": "Required. Name of the Kubernetes Deployment whose traffic is managed by the specified Service.", "type": "string" } }, "type": "object" }, "TargetArtifact": { "description": "The artifacts produced by a target render operation.", "id": "TargetArtifact", "properties": { "phaseArtifacts": { "type": "object", "readOnly": true, "description": "Output only. Map from the phase ID to the phase artifacts for the `Target`.", "additionalProperties": { "$ref": "PhaseArtifact" } }, "skaffoldConfigPath": { "readOnly": true, "type": "string", "description": "Output only. File path of the resolved Skaffold configuration for the stable phase, relative to the URI." }, "artifactUri": { "description": "Output only. URI of a directory containing the artifacts. This contains deployment configuration used by Skaffold during a rollout, and all paths are relative to this location.", "type": "string", "readOnly": true }, "manifestPath": { "readOnly": true, "type": "string", "description": "Output only. File path of the rendered manifest relative to the URI for the stable phase." } }, "type": "object" }, "AdvanceRolloutOperation": { "description": "Contains the information of an automated advance-rollout operation.", "type": "object", "id": "AdvanceRolloutOperation", "properties": { "rollout": { "description": "Output only. The name of the rollout that initiates the `AutomationRun`.", "readOnly": true, "type": "string" }, "sourcePhase": { "description": "Output only. The phase of a deployment that initiated the operation.", "readOnly": true, "type": "string" }, "wait": { "format": "google-duration", "description": "Output only. How long the operation will be paused.", "type": "string", "readOnly": true }, "destinationPhase": { "description": "Output only. The phase the rollout will be advanced to.", "type": "string", "readOnly": true } } }, "TargetNotificationEvent": { "description": "Payload proto for \"clouddeploy.googleapis.com/target_notification\" Platform Log event that describes the failure to send target status change Pub/Sub notification.", "id": "TargetNotificationEvent", "properties": { "target": { "type": "string", "description": "The name of the `Target`." }, "type": { "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ], "type": "string", "description": "Type of this notification, e.g. for a Pub/Sub failure.", "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ] }, "message": { "type": "string", "description": "Debug message for when a notification fails to send." } }, "type": "object" }, "DeployJob": { "description": "A deploy Job.", "id": "DeployJob", "properties": {}, "type": "object" }, "AutomationRolloutMetadata": { "description": "AutomationRolloutMetadata contains Automation-related actions that were performed on a rollout.", "id": "AutomationRolloutMetadata", "properties": { "repairAutomationRuns": { "type": "array", "readOnly": true, "items": { "type": "string" }, "description": "Output only. The names of the AutomationRuns initiated by a repair rollout rule." }, "advanceAutomationRuns": { "items": { "type": "string" }, "description": "Output only. The names of the AutomationRuns initiated by an advance rollout rule.", "type": "array", "readOnly": true }, "promoteAutomationRun": { "description": "Output only. The name of the AutomationRun initiated by a promote release rule.", "readOnly": true, "type": "string" } }, "type": "object" }, "ApproveRolloutResponse": { "description": "The response object from `ApproveRollout`.", "type": "object", "id": "ApproveRolloutResponse", "properties": {} }, "ChildRolloutJobs": { "description": "ChildRollouts job composition", "type": "object", "id": "ChildRolloutJobs", "properties": { "advanceRolloutJobs": { "items": { "$ref": "Job" }, "description": "Output only. List of AdvanceChildRolloutJobs", "type": "array", "readOnly": true }, "createRolloutJobs": { "readOnly": true, "type": "array", "description": "Output only. List of CreateChildRolloutJobs", "items": { "$ref": "Job" } } } }, "BuildArtifact": { "description": "Description of an a image to use during Skaffold rendering.", "id": "BuildArtifact", "properties": { "image": { "type": "string", "description": "Optional. Image name in Skaffold configuration." }, "tag": { "type": "string", "description": "Optional. Image tag to use. This will generally be the full path to an image, such as \"gcr.io/my-project/busybox:1.2.3\" or \"gcr.io/my-project/busybox@sha256:abc123\"." } }, "type": "object" }, "DeliveryPipelineNotificationEvent": { "type": "object", "id": "DeliveryPipelineNotificationEvent", "properties": { "message": { "type": "string", "description": "Debug message for when a notification fails to send." }, "pipelineUid": { "type": "string", "description": "Unique identifier of the `DeliveryPipeline`." }, "deliveryPipeline": { "type": "string", "description": "The name of the `Delivery Pipeline`." }, "type": { "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ], "type": "string", "description": "Type of this notification, e.g. for a Pub/Sub failure.", "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ] } }, "description": "Payload proto for \"clouddeploy.googleapis.com/deliverypipeline_notification\" Platform Log event that describes the failure to send delivery pipeline status change Pub/Sub notification." }, "Postdeploy": { "type": "object", "id": "Postdeploy", "properties": { "actions": { "description": "Optional. A sequence of Skaffold custom actions to invoke during execution of the postdeploy job.", "items": { "type": "string" }, "type": "array" }, "tasks": { "type": "array", "items": { "$ref": "Task" }, "description": "Optional. The tasks that will run as a part of the postdeploy job. The tasks are executed sequentially in the order specified. Only one of `actions` or `tasks` can be specified." } }, "description": "Postdeploy contains the postdeploy job configuration information." }, "ListAutomationRunsResponse": { "id": "ListAutomationRunsResponse", "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "automationRuns": { "type": "array", "items": { "$ref": "AutomationRun" }, "description": "The `AutomationRuns` objects." }, "unreachable": { "items": { "type": "string" }, "description": "Locations that could not be reached.", "type": "array" } }, "type": "object", "description": "The response object from `ListAutomationRuns`." }, "OperationMetadata": { "id": "OperationMetadata", "properties": { "verb": { "description": "Output only. Name of the verb executed by the operation.", "type": "string", "readOnly": true }, "target": { "description": "Output only. Server-defined resource path for the target of the operation.", "type": "string", "readOnly": true }, "requestedCancellation": { "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", "type": "boolean", "readOnly": true }, "endTime": { "format": "google-datetime", "description": "Output only. The time the operation finished running.", "type": "string", "readOnly": true }, "statusMessage": { "description": "Output only. Human-readable status of the operation, if any.", "type": "string", "readOnly": true }, "apiVersion": { "description": "Output only. API version used to start the operation.", "type": "string", "readOnly": true }, "createTime": { "format": "google-datetime", "description": "Output only. The time the operation was created.", "type": "string", "readOnly": true } }, "type": "object", "description": "Represents the metadata of the long-running operation." }, "DeployPolicy": { "description": "A `DeployPolicy` resource in the Cloud Deploy API. A `DeployPolicy` inhibits manual or automation-driven actions within a Delivery Pipeline or Target.", "type": "object", "id": "DeployPolicy", "properties": { "annotations": { "type": "object", "description": "Optional. 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.", "additionalProperties": { "type": "string" } }, "labels": { "description": "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 \u003c= 128 bytes.", "additionalProperties": { "type": "string" }, "type": "object" }, "suspended": { "type": "boolean", "description": "Optional. When suspended, the policy will not prevent actions from occurring, even if the action violates the policy." }, "description": { "type": "string", "description": "Optional. Description of the `DeployPolicy`. Max length is 255 characters." }, "rules": { "type": "array", "description": "Required. Rules to apply. At least one rule must be present.", "items": { "$ref": "PolicyRule" } }, "createTime": { "description": "Output only. Time at which the deploy policy was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "uid": { "description": "Output only. Unique identifier of the `DeployPolicy`.", "readOnly": true, "type": "string" }, "name": { "description": "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])?`", "type": "string", "readOnly": true }, "selectors": { "description": "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.", "items": { "$ref": "DeployPolicyResourceSelector" }, "type": "array" }, "updateTime": { "format": "google-datetime", "description": "Output only. Most recent time at which the deploy policy was updated.", "type": "string", "readOnly": true }, "etag": { "type": "string", "description": "The weak etag of the `DeployPolicy` 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." } } }, "CancelAutomationRunRequest": { "id": "CancelAutomationRunRequest", "properties": {}, "type": "object", "description": "The request object used by `CancelAutomationRun`." }, "RouteDestinations": { "type": "object", "id": "RouteDestinations", "properties": { "propagateService": { "type": "boolean", "description": "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 facilitate successful DNS lookup in the route destination clusters. Can only be set to true if destinations are specified." }, "destinationIds": { "type": "array", "items": { "type": "string" }, "description": "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." } }, "description": "Information about route destinations for the Gateway API service mesh." }, "Verify": { "description": "Verify contains the verify job configuration information.", "id": "Verify", "properties": { "tasks": { "description": "Optional. The tasks that will run as a part of the verify job. The tasks are executed sequentially in the order specified.", "items": { "$ref": "Task" }, "type": "array" } }, "type": "object" }, "AutomationRun": { "id": "AutomationRun", "properties": { "advanceRolloutOperation": { "$ref": "AdvanceRolloutOperation", "description": "Output only. Advances a rollout to the next phase.", "readOnly": true }, "automationSnapshot": { "readOnly": true, "$ref": "Automation", "description": "Output only. Snapshot of the Automation taken at AutomationRun creation time." }, "ruleId": { "description": "Output only. The ID of the automation rule that initiated the operation.", "type": "string", "readOnly": true }, "repairRolloutOperation": { "readOnly": true, "$ref": "RepairRolloutOperation", "description": "Output only. Repairs a failed 'Rollout'." }, "targetId": { "readOnly": true, "type": "string", "description": "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." }, "etag": { "type": "string", "readOnly": true, "description": "Output only. The weak etag of the `AutomationRun` 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." }, "policyViolation": { "$ref": "PolicyViolation", "description": "Output only. Contains information about what policies prevented the `AutomationRun` from proceeding.", "readOnly": true }, "waitUntilTime": { "format": "google-datetime", "description": "Output only. Earliest time the `AutomationRun` will attempt to resume. Wait-time is configured by `wait` in automation rule.", "type": "string", "readOnly": true }, "uid": { "description": "Output only. Unique identifier of the `AutomationRun`.", "readOnly": true, "type": "string" }, "stateDescription": { "readOnly": true, "type": "string", "description": "Output only. Explains the current state of the `AutomationRun`. Present only when an explanation is needed." }, "expireTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Time the `AutomationRun` expires. An `AutomationRun` expires after 14 days from its creation date." }, "promoteReleaseOperation": { "$ref": "PromoteReleaseOperation", "description": "Output only. Promotes a release to a specified 'Target'.", "readOnly": true }, "updateTime": { "format": "google-datetime", "description": "Output only. Time at which the automationRun was updated.", "type": "string", "readOnly": true }, "state": { "type": "string", "enumDescriptions": [ "The `AutomationRun` has an unspecified state.", "The `AutomationRun` has succeeded.", "The `AutomationRun` was cancelled.", "The `AutomationRun` has failed.", "The `AutomationRun` is in progress.", "The `AutomationRun` is pending.", "The `AutomationRun` was aborted." ], "readOnly": true, "description": "Output only. Current state of the `AutomationRun`.", "enum": [ "STATE_UNSPECIFIED", "SUCCEEDED", "CANCELLED", "FAILED", "IN_PROGRESS", "PENDING", "ABORTED" ] }, "automationId": { "type": "string", "readOnly": true, "description": "Output only. The ID of the automation that initiated the operation." }, "timedPromoteReleaseOperation": { "description": "Output only. Promotes a release to a specified 'Target' as defined in a Timed Promote Release rule.", "$ref": "TimedPromoteReleaseOperation", "readOnly": true }, "name": { "type": "string", "readOnly": true, "description": "Output only. Name of the `AutomationRun`. Format is `projects/{project}/locations/{location}/deliveryPipelines/{delivery_pipeline}/automationRuns/{automation_run}`." }, "serviceAccount": { "description": "Output only. Email address of the user-managed IAM service account that performs the operations against Cloud Deploy resources.", "type": "string", "readOnly": true }, "createTime": { "description": "Output only. Time at which the `AutomationRun` was created.", "format": "google-datetime", "readOnly": true, "type": "string" } }, "type": "object", "description": "An `AutomationRun` resource in the Cloud Deploy API. An `AutomationRun` represents an execution instance of an automation rule." }, "PhaseConfig": { "type": "object", "id": "PhaseConfig", "properties": { "phaseId": { "description": "Required. The ID to assign to the `Rollout` phase. 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])?$`.", "type": "string" }, "percentage": { "format": "int32", "description": "Required. Percentage deployment for the phase.", "type": "integer" }, "predeploy": { "description": "Optional. Configuration for the predeploy job of this phase. If this is not configured, there will be no predeploy job for this phase.", "$ref": "Predeploy" }, "postdeploy": { "$ref": "Postdeploy", "description": "Optional. Configuration for the postdeploy job of this phase. If this is not configured, there will be no postdeploy job for this phase." }, "verifyConfig": { "description": "Optional. Configuration for the verify job. Cannot be set if `verify` is set to true.", "$ref": "Verify" }, "profiles": { "type": "array", "description": "Optional. Skaffold profiles to use when rendering the manifest for this phase. These are in addition to the profiles list specified in the `DeliveryPipeline` stage.", "items": { "type": "string" } }, "verify": { "description": "Optional. Whether to run verify tests after the deployment via `skaffold verify`.", "type": "boolean" }, "analysis": { "$ref": "Analysis", "description": "Optional. Configuration for the analysis job of this phase. If this is not configured, there will be no analysis job for this phase." } }, "description": "PhaseConfig represents the configuration for a phase in the custom canary deployment." }, "PostdeployJob": { "id": "PostdeployJob", "properties": { "actions": { "readOnly": true, "type": "array", "description": "Output only. The custom actions that the postdeploy Job executes.", "items": { "type": "string" } }, "tasks": { "items": { "$ref": "Task" }, "description": "Output only. The tasks that are executed as part of the postdeploy Job.", "type": "array", "readOnly": true } }, "type": "object", "description": "A postdeploy Job." }, "CanaryDeployment": { "description": "CanaryDeployment represents the canary deployment configuration", "type": "object", "id": "CanaryDeployment", "properties": { "predeploy": { "$ref": "Predeploy", "description": "Optional. Configuration for the predeploy job of the first phase. If this is not configured, there will be no predeploy job for this phase." }, "postdeploy": { "$ref": "Postdeploy", "description": "Optional. Configuration for the postdeploy job of the last phase. If this is not configured, there will be no postdeploy job for this phase." }, "verifyConfig": { "description": "Optional. Configuration for the verify job. Cannot be set if `verify` is set to true.", "$ref": "Verify" }, "percentages": { "type": "array", "description": "Required. The percentage based deployments that will occur as a part of a `Rollout`. List is expected in ascending order and each integer n is 0 \u003c= n \u003c 100. If the GatewayServiceMesh is configured for Kubernetes, then the range for n is 0 \u003c= n \u003c= 100.", "items": { "type": "integer", "format": "int32" } }, "verify": { "description": "Optional. Whether to run verify tests after each percentage deployment via `skaffold verify`.", "type": "boolean" }, "analysis": { "$ref": "Analysis", "description": "Optional. Configuration for the analysis job. If configured, the analysis will run after each percentage deployment." } } }, "Rollback": { "type": "object", "id": "Rollback", "properties": { "disableRollbackIfRolloutPending": { "description": "Optional. If pending rollout exists on the target, the rollback operation will be aborted.", "type": "boolean" }, "destinationPhase": { "description": "Optional. The starting phase ID for the `Rollout`. If unspecified, the `Rollout` will start in the stable phase.", "type": "string" } }, "description": "Rolls back a `Rollout`." }, "Job": { "description": "Job represents an operation for a `Rollout`.", "id": "Job", "properties": { "advanceChildRolloutJob": { "readOnly": true, "description": "Output only. An advanceChildRollout Job.", "$ref": "AdvanceChildRolloutJob" }, "state": { "type": "string", "enumDescriptions": [ "The Job has an unspecified state.", "The Job is waiting for an earlier Phase(s) or Job(s) to complete.", "The Job is disabled.", "The Job is in progress.", "The Job succeeded.", "The Job failed.", "The Job was aborted.", "The Job was skipped.", "The Job was ignored." ], "readOnly": true, "description": "Output only. The current state of the Job.", "enum": [ "STATE_UNSPECIFIED", "PENDING", "DISABLED", "IN_PROGRESS", "SUCCEEDED", "FAILED", "ABORTED", "SKIPPED", "IGNORED" ] }, "deployJob": { "description": "Output only. A deploy Job.", "$ref": "DeployJob", "readOnly": true }, "skipMessage": { "type": "string", "readOnly": true, "description": "Output only. Additional information on why the Job was skipped, if available." }, "analysisJob": { "readOnly": true, "description": "Output only. An analysis Job.", "$ref": "AnalysisJob" }, "predeployJob": { "readOnly": true, "description": "Output only. A predeploy Job.", "$ref": "PredeployJob" }, "verifyJob": { "$ref": "VerifyJob", "description": "Output only. A verify Job.", "readOnly": true }, "id": { "readOnly": true, "type": "string", "description": "Output only. The ID of the Job." }, "createChildRolloutJob": { "$ref": "CreateChildRolloutJob", "description": "Output only. A createChildRollout Job.", "readOnly": true }, "jobRun": { "description": "Output only. The name of the `JobRun` responsible for the most recent invocation of this Job.", "readOnly": true, "type": "string" }, "postdeployJob": { "readOnly": true, "description": "Output only. A postdeploy Job.", "$ref": "PostdeployJob" } }, "type": "object" }, "TargetRender": { "description": "Details of rendering for a single target.", "id": "TargetRender", "properties": { "failureMessage": { "description": "Output only. Additional information about the render failure, if available.", "type": "string", "readOnly": true }, "metadata": { "readOnly": true, "$ref": "RenderMetadata", "description": "Output only. Metadata related to the `Release` render for this Target." }, "failureCause": { "readOnly": true, "description": "Output only. Reason this render failed. This will always be unspecified while the render in progress.", "enum": [ "FAILURE_CAUSE_UNSPECIFIED", "CLOUD_BUILD_UNAVAILABLE", "EXECUTION_FAILED", "CLOUD_BUILD_REQUEST_FAILED", "VERIFICATION_CONFIG_NOT_FOUND", "CUSTOM_ACTION_NOT_FOUND", "DEPLOYMENT_STRATEGY_NOT_SUPPORTED", "RENDER_FEATURE_NOT_SUPPORTED" ], "type": "string", "enumDescriptions": [ "No reason for failure is specified.", "Cloud Build is not available, either because it is not enabled or because Cloud Deploy has insufficient permissions. See [required permission](https://cloud.google.com/deploy/docs/cloud-deploy-service-account#required_permissions).", "The render operation did not complete successfully; check Cloud Build logs.", "Cloud Build failed to fulfill Cloud Deploy's request. See failure_message for additional details.", "The render operation did not complete successfully because the verification stanza required for verify was not found on the Skaffold configuration.", "The render operation did not complete successfully because the custom action(s) required for Rollout jobs were not found in the Skaffold configuration. See failure_message for additional details.", "Release failed during rendering because the release configuration is not supported with the specified deployment strategy.", "The render operation had a feature configured that is not supported." ] }, "renderingState": { "enumDescriptions": [ "The render operation state is unspecified.", "The render operation has completed successfully.", "The render operation has failed.", "The render operation is in progress." ], "type": "string", "enum": [ "TARGET_RENDER_STATE_UNSPECIFIED", "SUCCEEDED", "FAILED", "IN_PROGRESS" ], "description": "Output only. Current state of the render operation for this Target.", "readOnly": true }, "renderingBuild": { "description": "Output only. The resource name of the Cloud Build `Build` object that is used to render the manifest for this target. Format is `projects/{project}/locations/{location}/builds/{build}`.", "readOnly": true, "type": "string" } }, "type": "object" }, "ToolVersions": { "description": "Details of ToolVersions for the release.", "id": "ToolVersions", "properties": { "kubectl": { "type": "string", "description": "Optional. The Kubectl version to use for Cloud Deploy operations." }, "skaffold": { "description": "Optional. The Skaffold version to use for Cloud Deploy operations.", "type": "string" }, "kpt": { "description": "Optional. The kpt version to use for Cloud Deploy operations.", "type": "string" }, "kustomize": { "type": "string", "description": "Optional. The Kustomize version to use for Cloud Deploy operations." }, "docker": { "description": "Optional. The Docker version to use for Cloud Deploy operations.", "type": "string" }, "helm": { "type": "string", "description": "Optional. The Helm version to use for Cloud Deploy operations." } }, "type": "object" }, "RollbackAttempt": { "description": "RollbackAttempt represents an action of rolling back a Cloud Deploy 'Target'.", "id": "RollbackAttempt", "properties": { "rolloutId": { "description": "Output only. ID of the rollback `Rollout` to create.", "readOnly": true, "type": "string" }, "state": { "enumDescriptions": [ "The `repair` has an unspecified state.", "The `repair` action has succeeded.", "The `repair` action was cancelled.", "The `repair` action has failed.", "The `repair` action is in progress.", "The `repair` action is pending.", "The `repair` action was aborted." ], "type": "string", "description": "Output only. Valid state of this rollback action.", "enum": [ "REPAIR_STATE_UNSPECIFIED", "REPAIR_STATE_SUCCEEDED", "REPAIR_STATE_CANCELLED", "REPAIR_STATE_FAILED", "REPAIR_STATE_IN_PROGRESS", "REPAIR_STATE_PENDING", "REPAIR_STATE_ABORTED" ], "readOnly": true }, "stateDesc": { "readOnly": true, "type": "string", "description": "Output only. Description of the state of the Rollback." }, "destinationPhase": { "description": "Output only. The phase to which the rollout will be rolled back to.", "type": "string", "readOnly": true }, "disableRollbackIfRolloutPending": { "description": "Output only. If active rollout exists on the target, abort this rollback.", "readOnly": true, "type": "boolean" } }, "type": "object" }, "Binding": { "type": "object", "id": "Binding", "properties": { "members": { "items": { "type": "string" }, "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", "type": "array" }, "condition": { "$ref": "Expr", "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "role": { "type": "string", "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles)." } }, "description": "Associates `members`, or principals, with a `role`." }, "TestIamPermissionsResponse": { "description": "Response message for `TestIamPermissions` method.", "id": "TestIamPermissionsResponse", "properties": { "permissions": { "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "CustomTargetTypeNotificationEvent": { "id": "CustomTargetTypeNotificationEvent", "properties": { "customTargetType": { "description": "The name of the `CustomTargetType`.", "type": "string" }, "message": { "description": "Debug message for when a notification fails to send.", "type": "string" }, "type": { "type": "string", "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ], "description": "Type of this notification, e.g. for a Pub/Sub failure.", "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ] }, "customTargetTypeUid": { "type": "string", "description": "Unique identifier of the `CustomTargetType`." } }, "type": "object", "description": "Payload proto for \"clouddeploy.googleapis.com/customtargettype_notification\" Platform Log event that describes the failure to send a custom target type status change Pub/Sub notification." }, "ListTargetsResponse": { "description": "The response object from `ListTargets`.", "id": "ListTargetsResponse", "properties": { "targets": { "type": "array", "description": "The `Target` objects.", "items": { "$ref": "Target" } }, "unreachable": { "items": { "type": "string" }, "description": "Locations that could not be reached.", "type": "array" }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "type": "object" }, "CreateChildRolloutJob": { "description": "A createChildRollout Job.", "type": "object", "id": "CreateChildRolloutJob", "properties": {} }, "RolloutUpdateEvent": { "type": "object", "id": "RolloutUpdateEvent", "properties": { "releaseUid": { "type": "string", "description": "Unique identifier of the release." }, "pipelineUid": { "description": "Unique identifier of the pipeline.", "type": "string" }, "rollout": { "type": "string", "description": "The name of the rollout. rollout_uid is not in this log message because we write some of these log messages at rollout creation time, before we've generated the uid." }, "type": { "type": "string", "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ], "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ], "description": "Type of this notification, e.g. for a rollout update event." }, "message": { "type": "string", "description": "Debug message for when a rollout update event occurs." }, "targetId": { "type": "string", "description": "ID of the target." }, "release": { "type": "string", "description": "The name of the `Release`." }, "rolloutUpdateType": { "type": "string", "enumDescriptions": [ "Rollout update type unspecified.", "Rollout state updated to pending (release has succeeded, waiting on the rollout to start).", "Rollout state updated to pending release.", "Rollout state updated to in progress.", "Rollout state updated to cancelling.", "Rollout state updated to cancelled.", "Rollout state updated to halted.", "Rollout state updated to succeeded.", "Rollout state updated to failed.", "Rollout requires approval.", "Rollout has been approved.", "Rollout has been rejected.", "Rollout requires advance to the next phase.", "Rollout has been advanced." ], "enum": [ "ROLLOUT_UPDATE_TYPE_UNSPECIFIED", "PENDING", "PENDING_RELEASE", "IN_PROGRESS", "CANCELLING", "CANCELLED", "HALTED", "SUCCEEDED", "FAILED", "APPROVAL_REQUIRED", "APPROVED", "REJECTED", "ADVANCE_REQUIRED", "ADVANCED" ], "description": "The type of the rollout update." } }, "description": "Payload proto for \"clouddeploy.googleapis.com/rollout_update\" Platform Log event that describes the rollout update event." }, "ReleaseNotificationEvent": { "description": "Payload proto for \"clouddeploy.googleapis.com/release_notification\" Platform Log event that describes the failure to send release status change Pub/Sub notification.", "type": "object", "id": "ReleaseNotificationEvent", "properties": { "releaseUid": { "type": "string", "description": "Unique identifier of the `Release`." }, "pipelineUid": { "description": "Unique identifier of the `DeliveryPipeline`.", "type": "string" }, "type": { "enumDeprecated": [ false, false, false, false, false, false, false, false, true ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PUBSUB_NOTIFICATION_FAILURE", "TYPE_RESOURCE_STATE_CHANGE", "TYPE_PROCESS_ABORTED", "TYPE_RESTRICTION_VIOLATED", "TYPE_RESOURCE_DELETED", "TYPE_ROLLOUT_UPDATE", "TYPE_DEPLOY_POLICY_EVALUATION", "TYPE_RENDER_STATUES_CHANGE" ], "description": "Type of this notification, e.g. for a Pub/Sub failure.", "enumDescriptions": [ "Type is unspecified.", "A Pub/Sub notification failed to be sent.", "Resource state changed.", "A process aborted.", "Restriction check failed.", "Resource deleted.", "Rollout updated.", "Deploy Policy evaluation.", "Deprecated: This field is never used. Use release_render log type instead." ], "type": "string" }, "message": { "type": "string", "description": "Debug message for when a notification fails to send." }, "release": { "description": "The name of the `Release`.", "type": "string" } } }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "type": "object", "id": "Status", "properties": { "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "details": { "type": "array", "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" } }, "code": { "format": "int32", "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer" } } }, "DeliveryPipelineAttribute": { "type": "object", "id": "DeliveryPipelineAttribute", "properties": { "id": { "description": "Optional. 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", "type": "string" }, "labels": { "type": "object", "description": "DeliveryPipeline labels.", "additionalProperties": { "type": "string" } } }, "description": "Contains criteria for selecting DeliveryPipelines." } }, "rootUrl": "https://clouddeploy.googleapis.com/" }