Updates a Service.
This method waits—the workflow execution is paused—until the operation is
complete, fails, or times out. The default timeout value is 1800 seconds (30
minutes) and can be changed to a maximum value of 31536000 seconds (one year)
for long-running operations using the connector_params field. See the
Connectors reference.
The connector uses polling to monitor the long-running operation, which might generate additional billable steps. For more information about retries and long-running operations, refer to Understand connectors.
The polling policy for the long-running operation can be configured. To set the
connector-specific parameters (connector_params), refer to
Invoke a connector call.
Arguments
| Parameters | |
|---|---|
name |
Required. The fully qualified name of this Service. In CreateServiceRequest, this field is ignored, and instead composed from CreateServiceRequest.parent and CreateServiceRequest.service_id. Format: projects/{project}/locations/{location}/services/{service_id} |
allowMissing |
Optional. If set to true, and if the Service does not exist, it will create a new one. The caller must have 'run.services.create' permissions if this is set to true and the Service does not exist. |
updateMask |
Optional. The list of fields to be updated. |
validateOnly |
Indicates that the request should be validated and default values populated, without persisting the request or updating any resources. |
body |
Required. |
Raised exceptions
| Exceptions | |
|---|---|
ConnectionError |
In case of a network problem (such as DNS failure or refused connection). |
HttpError |
If the response status is >= 400 (excluding 429 and 503). |
TimeoutError |
If a long-running operation takes longer to finish than the specified timeout limit. |
TypeError |
If an operation or function receives an argument of the wrong type. |
ValueError |
If an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout. |
OperationError |
If the long-running operation finished unsuccessfully. |
ResponseTypeError |
If the long-running operation returned a response of the wrong type. |
Response
If successful, the response contains an instance of GoogleLongrunningOperation.
Subworkflow snippet
Some fields might be optional or required. To identify required fields, refer to the API documentation.
YAML
- patch: call: googleapis.run.v2.projects.locations.services.patch args: name: ... allowMissing: ... updateMask: ... validateOnly: ... body: annotations: ... binaryAuthorization: breakglassJustification: ... policy: ... useDefault: ... client: ... clientVersion: ... customAudiences: ... defaultUriDisabled: ... description: ... ingress: ... labels: ... launchStage: ... name: ... scaling: minInstanceCount: ... template: annotations: ... containers: ... encryptionKey: ... executionEnvironment: ... healthCheckDisabled: ... labels: ... maxInstanceRequestConcurrency: ... nodeSelector: accelerator: ... revision: ... scaling: maxInstanceCount: ... minInstanceCount: ... serviceAccount: ... sessionAffinity: ... timeout: ... volumes: ... vpcAccess: connector: ... egress: ... networkInterfaces: ... traffic: ... result: patchResult
JSON
[ { "patch": { "call": "googleapis.run.v2.projects.locations.services.patch", "args": { "name": "...", "allowMissing": "...", "updateMask": "...", "validateOnly": "...", "body": { "annotations": "...", "binaryAuthorization": { "breakglassJustification": "...", "policy": "...", "useDefault": "..." }, "client": "...", "clientVersion": "...", "customAudiences": "...", "defaultUriDisabled": "...", "description": "...", "ingress": "...", "labels": "...", "launchStage": "...", "name": "...", "scaling": { "minInstanceCount": "..." }, "template": { "annotations": "...", "containers": "...", "encryptionKey": "...", "executionEnvironment": "...", "healthCheckDisabled": "...", "labels": "...", "maxInstanceRequestConcurrency": "...", "nodeSelector": { "accelerator": "..." }, "revision": "...", "scaling": { "maxInstanceCount": "...", "minInstanceCount": "..." }, "serviceAccount": "...", "sessionAffinity": "...", "timeout": "...", "volumes": "...", "vpcAccess": { "connector": "...", "egress": "...", "networkInterfaces": "..." } }, "traffic": "..." } }, "result": "patchResult" } } ]