- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Lists instance partition long-running operations in the given instance. An instance partition operation has a name of the form projects/<project>/instances/<instance>/instancePartitions/<instancePartition>/operations/<operation>
. The long-running operation metadata field type metadata.type_url
describes the type of the metadata. Operations returned include those that have completed/failed/canceled within the last 7 days, and pending operations. Operations returned are ordered by operation.metadata.value.start_time
in descending order starting from the most recently started operation.
Authorization requires spanner.instancePartitionOperations.list
permission on the resource parent
.
HTTP request
GET https://spanner.googleapis.com/v1/{parent=projects/*/instances/*}/instancePartitionOperations
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
parent |
Required. The parent instance of the instance partition operations. Values are of the form Authorization requires the following IAM permission on the specified resource
|
Query parameters
Parameters | |
---|---|
filter |
Optional. An expression that filters the list of returned operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: The following fields in the Operation are eligible for filtering:
You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic. However, you can specify AND, OR, and NOT logic explicitly. Here are a few examples:
|
page |
Optional. Number of operations to be returned in the response. If 0 or less, defaults to the server's maximum allowed page size. |
page |
Optional. If non-empty, |
instance |
Optional. Deadline used while retrieving metadata for instance partition operations. Instance partitions whose operation metadata cannot be retrieved within this deadline will be added to [unreachable][ListInstancePartitionOperationsResponse.unreachable] in A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
Request body
The request body must be empty.
Response body
The response for instancePartitionOperations.list
.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"operations": [
{
object ( |
Fields | |
---|---|
operations[] |
The list of matching instance partition long-running operations. Each operation's name will be prefixed by the instance partition's name. The operation's metadata field type |
next |
|
unreachable |
The list of unreachable instance partitions. It includes the names of instance partitions whose operation metadata could not be retrieved within |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/spanner.admin
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.