장기 실행 작업 폴링

이 페이지에서는 비동기 메서드의 완료 상태를 확인하는 방법을 설명합니다. 이러한 메서드는 작업의 진행 상황과 최종 상태에 관한 정보를 제공하는 장기 실행 작업을 반환합니다.

다음 메서드는 장기 실행 작업을 반환합니다.

  • CreateKey
  • UpdateKey
  • DeleteKey
  • UndeleteKey

이러한 메서드 중 하나에 요청을 하면 성공 시 메서드는 서버에서 진행 중인 작업을 나타내는 작업 식별자를 name 필드에 반환합니다. 예를 들면 다음과 같습니다.

{
  "name": "operations/akmf.6573437d-47c1-42c4-b817-0562f514f6ff"
}

작업 상태를 확인하려면 name 필드의 값을 사용하여 operations.get 메서드를 사용합니다.

  gcurl https://apikeys.googleapis.com/v2/operations/akmf.6573437d-47c1-42c4-b817-0562f514f6ff

작업을 폴링하려면 응답에 "done": true이 포함될 때까지 10초 백오프로 operations.get 메서드를 반복해서 호출하는 것이 좋습니다.

{
  "name": "operations/akmf.6573437d-47c1-42c4-b817-0562f514f6ff",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.apikeys.v2.Key",
    "name": "projects/103621867718/locations/global/keys/b7ff1f9f-8275-410a-94dd-3855ee9b5dd2",
    "keyString": "----REDACTED----",
    "createTime": "2019-02-04T23:56:28.531Z",
    "uid": "b7ff1f9f-8275-410a-94dd-3855ee9b5dd2",
    "updateTime": "2019-02-04T23:56:28.531Z",
    "restrictions": {
      "browserKeyRestrictions": {
      }
    },
    "etag": "k0bsYGkIvSxDVwNxyw49NQ=="
  }
}