本頁面說明如何透過程式輪詢長時間執行的作業資源,這類資源是由 Service Infrastructure API 中耗時較久才能完成的方法 (例如 service.rollouts.create
) 傳回。作業完成後,系統會將 done
欄位設為 true。
如要輪詢作業,建議您以每 10 秒輪詢一次的頻率重複叫用 operations.get
方法,直到作業完成為止:
# 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"
}