update all APIs

Like documented in the README

```
rm -f .api.deps .cli.deps && FETCH_APIS=1 make update-json -j8
```
This commit is contained in:
Sebastian Thiel
2024-03-05 18:54:36 +01:00
parent 8a12e9d47e
commit ca974aa0a5
347 changed files with 202580 additions and 50157 deletions

View File

@@ -172,7 +172,7 @@
]
},
"create": {
"description": "Creates a new execution using the latest revision of the given workflow.",
"description": "Creates a new execution using the latest revision of the given workflow. For more information, see Execute a workflow.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/workflows/{workflowsId}/executions",
"httpMethod": "POST",
"id": "workflowexecutions.projects.locations.workflows.executions.create",
@@ -199,6 +199,31 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
"exportData": {
"description": "Returns all metadata stored about an execution, excluding most data that is already accessible using other API methods.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/workflows/{workflowsId}/executions/{executionsId}:exportData",
"httpMethod": "GET",
"id": "workflowexecutions.projects.locations.workflows.executions.exportData",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. Name of the execution for which data is to be exported. Format: projects/{project}/locations/{location}/workflows/{workflow}/executions/{execution}",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/workflows/[^/]+/executions/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+name}:exportData",
"response": {
"$ref": "ExportDataResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"get": {
"description": "Returns an execution of the given name.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/workflows/{workflowsId}/executions/{executionsId}",
@@ -224,7 +249,7 @@
],
"enumDescriptions": [
"The default / unset value.",
"Includes only basic metadata about the execution. Following fields are returned: name, start_time, end_time, duration, state and workflow_revision_id.",
"Includes only basic metadata about the execution. The following fields are returned: name, start_time, end_time, duration, state, and workflow_revision_id.",
"Includes all data."
],
"location": "query",
@@ -248,6 +273,16 @@
"parent"
],
"parameters": {
"filter": {
"description": "Optional. Filters applied to the `[Executions.ListExecutions]` results. The following fields are supported for filtering: `executionId`, `state`, `createTime`, `startTime`, `endTime`, `duration`, `workflowRevisionId`, `stepName`, and `label`. For details, see AIP-160. For example, if you are using the Google APIs Explorer: `state=\"SUCCEEDED\"` or `startTime>\"2023-08-01\" AND state=\"FAILED\"`",
"location": "query",
"type": "string"
},
"orderBy": {
"description": "Optional. Comma-separated list of fields that specify the ordering applied to the `[Executions.ListExecutions]` results. By default the ordering is based on descending `createTime`. The following fields are supported for ordering: `executionId`, `state`, `createTime`, `startTime`, `endTime`, `duration`, and `workflowRevisionId`. For details, see AIP-132.",
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Maximum number of executions to return per call. Max supported value depends on the selected Execution view: it's 1000 for BASIC and 100 for FULL. The default value used if the field is not specified is 100, regardless of the selected view. Values greater than the max value will be coerced down to it.",
"format": "int32",
@@ -255,7 +290,7 @@
"type": "integer"
},
"pageToken": {
"description": "A page token, received from a previous `ListExecutions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListExecutions` must match the call that provided the page token.",
"description": "A page token, received from a previous `ListExecutions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListExecutions` must match the call that provided the page token. Note that pagination is applied to dynamic data. The list of executions returned can change between page requests.",
"location": "query",
"type": "string"
},
@@ -275,7 +310,7 @@
],
"enumDescriptions": [
"The default / unset value.",
"Includes only basic metadata about the execution. Following fields are returned: name, start_time, end_time, duration, state and workflow_revision_id.",
"Includes only basic metadata about the execution. The following fields are returned: name, start_time, end_time, duration, state, and workflow_revision_id.",
"Includes all data."
],
"location": "query",
@@ -290,6 +325,129 @@
"https://www.googleapis.com/auth/cloud-platform"
]
}
},
"resources": {
"callbacks": {
"methods": {
"list": {
"description": "Returns a list of active callbacks that belong to the execution with the given name. The returned callbacks are ordered by callback ID.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/workflows/{workflowsId}/executions/{executionsId}/callbacks",
"httpMethod": "GET",
"id": "workflowexecutions.projects.locations.workflows.executions.callbacks.list",
"parameterOrder": [
"parent"
],
"parameters": {
"pageSize": {
"description": "Maximum number of callbacks to return per call. The default value is 100 and is also the maximum value.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "A page token, received from a previous `ListCallbacks` call. Provide this to retrieve the subsequent page. Note that pagination is applied to dynamic data. The list of callbacks returned can change between page requests if callbacks are created or deleted.",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. Name of the execution for which the callbacks should be listed. Format: projects/{project}/locations/{location}/workflows/{workflow}/executions/{execution}",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/workflows/[^/]+/executions/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+parent}/callbacks",
"response": {
"$ref": "ListCallbacksResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
},
"stepEntries": {
"methods": {
"get": {
"description": "Gets a step entry.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/workflows/{workflowsId}/executions/{executionsId}/stepEntries/{stepEntriesId}",
"httpMethod": "GET",
"id": "workflowexecutions.projects.locations.workflows.executions.stepEntries.get",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the step entry to retrieve. Format: projects/{project}/locations/{location}/workflows/{workflow}/executions/{execution}/stepEntries/{step_entry}",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/workflows/[^/]+/executions/[^/]+/stepEntries/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+name}",
"response": {
"$ref": "StepEntry"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"list": {
"description": "Lists step entries for the corresponding workflow execution. Returned entries are ordered by their create_time.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/workflows/{workflowsId}/executions/{executionsId}/stepEntries",
"httpMethod": "GET",
"id": "workflowexecutions.projects.locations.workflows.executions.stepEntries.list",
"parameterOrder": [
"parent"
],
"parameters": {
"filter": {
"description": "Optional. Filters applied to the `[StepEntries.ListStepEntries]` results. The following fields are supported for filtering: `entryId`, `createTime`, `updateTime`, `routine`, `step`, `stepType`, `state`. For details, see AIP-160. For example, if you are using the Google APIs Explorer: `state=\"SUCCEEDED\"` or `createTime>\"2023-08-01\" AND state=\"FAILED\"`",
"location": "query",
"type": "string"
},
"orderBy": {
"description": "Optional. Comma-separated list of fields that specify the ordering applied to the `[StepEntries.ListStepEntries]` results. By default the ordering is based on ascending `entryId`. The following fields are supported for ordering: `entryId`, `createTime`, `updateTime`, `routine`, `step`, `stepType`, `state`. For details, see AIP-132.",
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Optional. Number of step entries to return per call. The default max is 1000.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Optional. A page token, received from a previous `ListStepEntries` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListStepEntries` must match the call that provided the page token.",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. Name of the workflow execution to list entries for. Format: projects/{project}/locations/{location}/workflows/{workflow}/executions/{execution}/stepEntries/",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/workflows/[^/]+/executions/[^/]+$",
"required": true,
"type": "string"
},
"skip": {
"description": "Optional. The number of step entries to skip. It can be used with or without a pageToken. If used with a pageToken, then it indicates the number of step entries to skip starting from the requested page.",
"format": "int32",
"location": "query",
"type": "integer"
}
},
"path": "v1/{+parent}/stepEntries",
"response": {
"$ref": "ListStepEntriesResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
}
}
}
}
@@ -299,9 +457,40 @@
}
}
},
"revision": "20230110",
"revision": "20240220",
"rootUrl": "https://workflowexecutions.googleapis.com/",
"schemas": {
"Callback": {
"description": "An instance of a Callback created by an execution.",
"id": "Callback",
"properties": {
"availablePayloads": {
"description": "Output only. The payloads received by the callback that have not been processed by a waiting execution step.",
"items": {
"type": "string"
},
"readOnly": true,
"type": "array"
},
"method": {
"description": "Output only. The method accepted by the callback. For example: GET, POST, PUT.",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Output only. The resource name of the callback. Format: projects/{project}/locations/{location}/workflows/{workflow}/executions/{execution}/callback/{callback}",
"readOnly": true,
"type": "string"
},
"waiters": {
"description": "Output only. Number of execution steps waiting on this callback.",
"format": "int64",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"CancelExecutionRequest": {
"description": "Request for the CancelExecution method.",
"id": "CancelExecutionRequest",
@@ -327,6 +516,17 @@
},
"type": "object"
},
"Exception": {
"description": "Exception describes why the step entry failed.",
"id": "Exception",
"properties": {
"payload": {
"description": "Error message represented as a JSON string.",
"type": "string"
}
},
"type": "object"
},
"Execution": {
"description": "A running instance of a [Workflow](/workflows/docs/reference/rest/v1/projects.locations.workflows).",
"id": "Execution",
@@ -340,15 +540,27 @@
"enum": [
"CALL_LOG_LEVEL_UNSPECIFIED",
"LOG_ALL_CALLS",
"LOG_ERRORS_ONLY"
"LOG_ERRORS_ONLY",
"LOG_NONE"
],
"enumDescriptions": [
"No call logging level specified.",
"Log all call steps within workflows, all call returns, and all exceptions raised.",
"Log only exceptions that are raised from call steps within workflows."
"Log only exceptions that are raised from call steps within workflows.",
"Explicitly log nothing."
],
"type": "string"
},
"createTime": {
"description": "Output only. Marks the creation of the execution.",
"format": "google-datetime",
"readOnly": true,
"type": "string"
},
"disableConcurrencyQuotaOverflowBuffering": {
"description": "Optional. If set to true, the execution will not be backlogged when the concurrency quota is exhausted. The backlog execution starts when the concurrency quota becomes available.",
"type": "boolean"
},
"duration": {
"description": "Output only. Measures the duration of the execution.",
"format": "google-duration",
@@ -366,6 +578,13 @@
"description": "Output only. The error which caused the execution to finish prematurely. The value is only present if the execution's state is `FAILED` or `CANCELLED`.",
"readOnly": true
},
"labels": {
"additionalProperties": {
"type": "string"
},
"description": "Labels associated with this execution. Labels can contain at most 64 entries. Keys and values can be no longer than 63 characters and can only contain lowercase letters, numeric characters, underscores, and dashes. Label keys must start with a letter. International characters are allowed. By default, labels are inherited from the workflow but are overridden by any labels associated with the execution.",
"type": "object"
},
"name": {
"description": "Output only. The resource name of the execution. Format: projects/{project}/locations/{location}/workflows/{workflow}/executions/{execution}",
"readOnly": true,
@@ -389,18 +608,27 @@
"ACTIVE",
"SUCCEEDED",
"FAILED",
"CANCELLED"
"CANCELLED",
"UNAVAILABLE",
"QUEUED"
],
"enumDescriptions": [
"Invalid state.",
"The execution is in progress.",
"The execution finished successfully.",
"The execution failed with an error.",
"The execution was stopped intentionally."
"The execution was stopped intentionally.",
"Execution data is unavailable. See the `state_error` field.",
"Request has been placed in the backlog for processing at a later time."
],
"readOnly": true,
"type": "string"
},
"stateError": {
"$ref": "StateError",
"description": "Output only. Error regarding the state of the Execution resource. For example, this field will have error details if the execution data is unavailable due to revoked KMS key permissions.",
"readOnly": true
},
"status": {
"$ref": "Status",
"description": "Output only. Status tracks the current steps and progress data of this execution.",
@@ -414,6 +642,35 @@
},
"type": "object"
},
"ExportDataResponse": {
"description": "Response for the ExportData method.",
"id": "ExportDataResponse",
"properties": {
"data": {
"description": "The JSON string with customer data and metadata for an execution with the given name",
"type": "string"
}
},
"type": "object"
},
"ListCallbacksResponse": {
"description": "RPC response object for the ListCallbacks method.",
"id": "ListCallbacksResponse",
"properties": {
"callbacks": {
"description": "The callbacks which match the request.",
"items": {
"$ref": "Callback"
},
"type": "array"
},
"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"
}
},
"type": "object"
},
"ListExecutionsResponse": {
"description": "Response for the ListExecutions method.",
"id": "ListExecutionsResponse",
@@ -432,6 +689,59 @@
},
"type": "object"
},
"ListStepEntriesResponse": {
"description": "Response message for ExecutionHistory.ListStepEntries.",
"id": "ListStepEntriesResponse",
"properties": {
"nextPageToken": {
"description": "A token to retrieve next page of results. Pass this value in the ListStepEntriesRequest.page_token field in the subsequent call to `ListStepEntries` method to retrieve the next page of results.",
"type": "string"
},
"stepEntries": {
"description": "The list of entries.",
"items": {
"$ref": "StepEntry"
},
"type": "array"
},
"totalSize": {
"description": "Indicates the total number of StepEntries that matched the request filter. For running executions, this number shows the number of StepEntries that are executed thus far.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"NavigationInfo": {
"description": "NavigationInfo describes what steps if any come before or after this step, or what steps are parents or children of this step.",
"id": "NavigationInfo",
"properties": {
"children": {
"description": "Step entries that can be reached by \"stepping into\" e.g. a subworkflow call.",
"items": {
"format": "int64",
"type": "string"
},
"type": "array"
},
"next": {
"description": "The index of the next step in the current workflow, if any.",
"format": "int64",
"type": "string"
},
"parent": {
"description": "The step entry, if any, that can be reached by \"stepping out\" of the current workflow being executed.",
"format": "int64",
"type": "string"
},
"previous": {
"description": "The index of the previous step in the current workflow, if any.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"Position": {
"description": "Position contains source position information about the stack trace element such as line number, column number and length of the code block in bytes.",
"id": "Position",
@@ -462,11 +772,11 @@
"additionalProperties": {
"type": "string"
},
"description": "Attributes for this message. If this field is empty, the message must contain non-empty data. This can be used to filter messages on the subscription.",
"description": "Optional. Attributes for this message. If this field is empty, the message must contain non-empty data. This can be used to filter messages on the subscription.",
"type": "object"
},
"data": {
"description": "The message data field. If this field is empty, the message must contain at least one attribute.",
"description": "Optional. The message data field. If this field is empty, the message must contain at least one attribute.",
"format": "byte",
"type": "string"
},
@@ -475,7 +785,7 @@
"type": "string"
},
"orderingKey": {
"description": "If non-empty, identifies related messages for which publish order should be respected. If a `Subscription` has `enable_message_ordering` set to `true`, messages published with the same non-empty `ordering_key` value will be delivered to subscribers in the order in which they are received by the Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` must specify the same `ordering_key` value. For more information, see [ordering messages](https://cloud.google.com/pubsub/docs/ordering).",
"description": "Optional. If non-empty, identifies related messages for which publish order should be respected. If a `Subscription` has `enable_message_ordering` set to `true`, messages published with the same non-empty `ordering_key` value will be delivered to subscribers in the order in which they are received by the Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` must specify the same `ordering_key` value. For more information, see [ordering messages](https://cloud.google.com/pubsub/docs/ordering).",
"type": "string"
},
"publishTime": {
@@ -519,6 +829,29 @@
},
"type": "object"
},
"StateError": {
"description": "Describes an error related to the current state of the Execution resource.",
"id": "StateError",
"properties": {
"details": {
"description": "Provides specifics about the error.",
"type": "string"
},
"type": {
"description": "The type of this state error.",
"enum": [
"TYPE_UNSPECIFIED",
"KMS_ERROR"
],
"enumDescriptions": [
"No type specified.",
"Caused by an issue with KMS."
],
"type": "string"
}
},
"type": "object"
},
"Status": {
"description": "Represents the current status of this execution.",
"id": "Status",
@@ -548,6 +881,163 @@
},
"type": "object"
},
"StepEntry": {
"description": "An StepEntry contains debugging information for a step transition in a workflow execution.",
"id": "StepEntry",
"properties": {
"createTime": {
"description": "Output only. The creation time of the step entry.",
"format": "google-datetime",
"readOnly": true,
"type": "string"
},
"entryId": {
"description": "Output only. The numeric ID of this step entry, used for navigation.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"exception": {
"$ref": "Exception",
"description": "Output only. The exception thrown by the step entry.",
"readOnly": true
},
"name": {
"description": "Output only. The full resource name of the step entry. Each step entry has a unique entry ID, which is a monotonically increasing counter. Step entry names have the format: `projects/{project}/locations/{location}/workflows/{workflow}/executions/{execution}/stepEntries/{step_entry}`.",
"readOnly": true,
"type": "string"
},
"navigationInfo": {
"$ref": "NavigationInfo",
"description": "Output only. The NavigationInfo associated to this step.",
"readOnly": true
},
"routine": {
"description": "Output only. The name of the routine this step entry belongs to. A routine name is the subworkflow name defined in the YAML source code. The top level routine name is `main`.",
"readOnly": true,
"type": "string"
},
"state": {
"description": "Output only. The state of the step entry.",
"enum": [
"STATE_UNSPECIFIED",
"STATE_IN_PROGRESS",
"STATE_SUCCEEDED",
"STATE_FAILED"
],
"enumDescriptions": [
"Invalid state.",
"The step entry is in progress.",
"The step entry finished successfully.",
"The step entry failed with an error."
],
"readOnly": true,
"type": "string"
},
"step": {
"description": "Output only. The name of the step this step entry belongs to.",
"readOnly": true,
"type": "string"
},
"stepEntryMetadata": {
"$ref": "StepEntryMetadata",
"description": "Output only. The StepEntryMetadata associated to this step.",
"readOnly": true
},
"stepType": {
"description": "Output only. The type of the step this step entry belongs to.",
"enum": [
"STEP_TYPE_UNSPECIFIED",
"STEP_ASSIGN",
"STEP_STD_LIB_CALL",
"STEP_CONNECTOR_CALL",
"STEP_SUBWORKFLOW_CALL",
"STEP_CALL",
"STEP_SWITCH",
"STEP_CONDITION",
"STEP_FOR",
"STEP_FOR_ITERATION",
"STEP_PARALLEL_FOR",
"STEP_PARALLEL_BRANCH",
"STEP_PARALLEL_BRANCH_ENTRY",
"STEP_TRY_RETRY_EXCEPT",
"STEP_TRY",
"STEP_RETRY",
"STEP_EXCEPT",
"STEP_RETURN",
"STEP_RAISE",
"STEP_GOTO"
],
"enumDescriptions": [
"Invalid step type.",
"The step entry assigns new variable(s).",
"The step entry calls a standard library routine.",
"The step entry calls a connector.",
"The step entry calls a subworklfow.",
"The step entry calls a subworkflow/stdlib.",
"The step entry executes a switch-case block.",
"The step entry executes a condition inside a switch.",
"The step entry executes a for loop.",
"The step entry executes a iteration of a for loop.",
"The step entry executes a parallel for loop.",
"The step entry executes a series of parallel branch(es).",
"The step entry executes a branch of a parallel branch.",
"The step entry executes a try/retry/except block.",
"The step entry executes the try part of a try/retry/except block.",
"The step entry executes the retry part of a try/retry/except block.",
"The step entry executes the except part of a try/retry/except block.",
"The step entry returns.",
"The step entry raises an error.",
"The step entry jumps to another step."
],
"readOnly": true,
"type": "string"
},
"updateTime": {
"description": "Output only. The most recently updated time of the step entry.",
"format": "google-datetime",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"StepEntryMetadata": {
"description": "StepEntryMetadata contains metadata information about this step.",
"id": "StepEntryMetadata",
"properties": {
"progressNumber": {
"description": "Progress number represents the current state of the current progress. eg: A step entry represents the 4th iteration in a progress of PROGRESS_TYPE_FOR.",
"format": "int64",
"type": "string"
},
"progressType": {
"description": "Progress type of this step entry.",
"enum": [
"PROGRESS_TYPE_UNSPECIFIED",
"PROGRESS_TYPE_FOR",
"PROGRESS_TYPE_SWITCH",
"PROGRESS_TYPE_RETRY",
"PROGRESS_TYPE_PARALLEL_FOR",
"PROGRESS_TYPE_PARALLEL_BRANCH"
],
"enumDescriptions": [
"Current step entry does not have any progress data.",
"Current step entry is in progress of a FOR step.",
"Current step entry is in progress of a SWITCH step.",
"Current step entry is in progress of a RETRY step.",
"Current step entry is in progress of a PARALLEL FOR step.",
"Current step entry is in progress of a PARALLEL BRANCH step."
],
"type": "string"
},
"threadId": {
"description": "Child thread id that this step entry belongs to.",
"type": "string"
}
},
"type": "object"
},
"TriggerPubsubExecutionRequest": {
"description": "Request for the TriggerPubsubExecution method.",
"id": "TriggerPubsubExecutionRequest",
@@ -556,6 +1046,11 @@
"description": "Required. LINT: LEGACY_NAMES The query parameter value for __GCP_CloudEventsMode, set by the Eventarc service when configuring triggers.",
"type": "string"
},
"deliveryAttempt": {
"description": "The number of attempts that have been made to deliver this message. This is set by Pub/Sub for subscriptions that have the \"dead letter\" feature enabled, and hence provided here for compatibility, but is ignored by Workflows.",
"format": "int32",
"type": "integer"
},
"message": {
"$ref": "PubsubMessage",
"description": "Required. The message of the Pub/Sub push notification."