This page describes how to programmatically poll the long-running operation
resources returned by methods in
Service Infrastructure APIs that take a substantial amount of time to complete, such
as service.rollouts.create
.
After an operation is done, the done
field will be set to true.
To poll an operation, repeatedly invoke the operations.get
method with a recommended 10 seconds backoff until the operation is done:
# This is an example of getting a pending `Operation` resource.
gcurl
https
://
servicemanagement
.
googleapis
.
com
/
v1
/
operations
/
rollouts
.
endpointsapis
.
appspot
.
com
:
2016
-
07
-
16r2
{
"name"
:
"operations/rollouts.endpointsapis.appspot.com:2016-07-16r2"
,
"metadata"
:
{
"@type"
:
"type.googleapis.com/google.api.servicemanagement.v1.OperationMetadata"
,
"resourceNames"
:
[
"services/endpointsapis.appspot.com/rollouts/2016-07-16r2"
]
,
"steps"
:
[
{
"description"
:
"update Service Controller"
,
"status"
:
"In_PROGRESS"
}
]
,
"progressPercentage"
:
0
,
"startTime"
:
"2016-07-16T00:56:55.737Z"
,
}
"response"
:
{
"@type"
:
"type.googleapis.com/google.api.servicemanagement.v1.Rollout"
,
"rolloutId"
:
"2016-07-16r2"
,
"createTime"
:
"2016-07-16T00:56:55.724Z"
,
"serviceSelectionStrategy"
:
{
"serviceConfigIds"
:
[
"2016-07-16r1"
]
}
,
"serviceName"
:
"endpointsapis.appspot.com"
}
# This is an example of getting a done `Operation` resource.
gcurl
https
://
servicemanagement
.
googleapis
.
com
/
v1
/
operations
/
rollouts
.
endpointsapis
.
appspot
.
com
:
2016
-
07
-
16r2
{
"name"
:
"operations/rollouts.endpointsapis.appspot.com:2016-07-16r2"
,
"metadata"
:
{
"@type"
:
"type.googleapis.com/google.api.servicemanagement.v1.OperationMetadata"
,
"resourceNames"
:
[
"services/endpointsapis.appspot.com/rollouts/2016-07-16r2"
]
,
"steps"
:
[
{
"description"
:
"update Service Controller"
,
"status"
:
"Done"
}
]
,
"progressPercentage"
:
100
,
"startTime"
:
"2016-07-16T00:56:55.737Z"
,
}
"done"
:
true
,
"response"
:
{
"@type"
:
"type.googleapis.com/google.api.servicemanagement.v1.Rollout"
,
"rolloutId"
:
"2016-07-16r2"
,
"createTime"
:
"2016-07-16T00:56:55.724Z"
,
"serviceSelectionStrategy"
:
{
"serviceConfigIds"
:
[
"2016-07-16r1"
]
}
,
"serviceName"
:
"endpointsapis.appspot.com"
}
