장기 실행 작업에 대한 비동기 취소를 시작합니다. 서버는 작업이 취소되도록 최선을 다하지만 성공한다고 보장되지 않습니다. 서버에서 이 메서드를 지원하지 않으면 google.rpc.Code.UNIMPLEMENTED
가 반환됩니다. 클라이언트는 Operations.GetOperation
또는 다른 메서드를 사용하여 취소가 성공했는지 또는 취소에도 불구하고 작업이 완료되었는지 여부를 확인할 수 있습니다. 취소가 성공하면 작업은 삭제되지 않고 대신 Operation.error
값을 갖는 작업이 되며 google.rpc.Status.code
가 1로 설정됩니다. 이 값은 Code.CANCELLED
에 해당합니다.
HTTP 요청
POST https://cloudaicompanion.googleapis.com/v1/{name=projects/*/locations/*/operations/*}:cancel
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
name |
취소할 작업 리소스의 이름입니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
성공한 경우 응답 본문은 비어 있습니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/cloud-platform
자세한 내용은 인증 개요를 참조하세요.
IAM 권한
name
리소스에 대해서는 다음 IAM 권한이 필요합니다.
cloudaicompanion.operations.cancel
자세한 내용은 IAM 문서를 참조하세요.