Avvia l'annullamento asincrono in un'operazione a lunga esecuzione. Il server fa del possibile per annullare l'operazione, ma il successo non è garantito. Se il server non supporta questo metodo, restituisce google.rpc.Code.UNIMPLEMENTED. I client possono utilizzare Operations.GetOperation o altri metodi per verificare se l'annullamento è riuscito o se l'operazione è stata completata nonostante l'annullamento. Se l'annullamento viene eseguito correttamente, l'operazione non viene eliminata, ma diventa un'operazione con un valore Operation.error con google.rpc.Status.code pari a 1, corrispondente a Code.CANCELLED.
Richiesta HTTP
POST https://clouddeploy.googleapis.com/v1/{name=projects/*/locations/*/operations/*}:cancel
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-06-27 UTC."],[[["\u003cp\u003eThis webpage details the process for initiating the asynchronous cancellation of a long-running operation, acknowledging that success is not guaranteed.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request to cancel an operation is a \u003ccode\u003ePOST\u003c/code\u003e request to a specific URL structure using gRPC Transcoding, with the operation's name included as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eCanceling the operation requires an empty request body, meaning no data needs to be sent in the request.\u003c/p\u003e\n"],["\u003cp\u003eA successful cancellation will be confirmed with an empty JSON object in the response body, while the operation's status will contain a \u003ccode\u003eCode.CANCELLED\u003c/code\u003e error.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for canceling an operation requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.operations.cancel\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nStarts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use [Operations.GetOperation](/deploy/docs/api/reference/rest/v1/projects.locations.operations/get#google.longrunning.Operations.GetOperation) or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an [Operation.error](/deploy/docs/api/reference/rest/v1/projects.locations.operations#Operation.FIELDS.error) value with a [google.rpc.Status.code](/deploy/docs/api/reference/rest/v1/projects.locations.operations#Status.FIELDS.code) of `1`, corresponding to `Code.CANCELLED`.\n\n### HTTP request\n\n`POST https://clouddeploy.googleapis.com/v1/{name=projects/*/locations/*/operations/*}:cancel`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
