Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
Inicia la cancelación asíncrona en una operación de larga duración. El servidor hace todo lo que puede para cancelar la operación, pero no se puede garantizar nada. Si el servidor no admite este método, devuelve google.rpc.Code.UNIMPLEMENTED. Los clientes pueden usar Operations.GetOperation u otros métodos para comprobar si la cancelación se ha realizado correctamente o si la operación se ha completado a pesar de la cancelación. Si la cancelación se realiza correctamente, la operación no se elimina, sino que se convierte en una operación con un valor Operation.error y un valor google.rpc.Status.code de 1, que corresponde a Code.CANCELLED.
Solicitud HTTP
POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{name}:cancel
Parámetros de ruta
Parámetros
name
string
El nombre del recurso de operación que se va a cancelar.
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si la solicitud se hace correctamente, el cuerpo de la respuesta estará vacío.
Permisos de autorización
Debes disponer de uno de los siguientes permisos de OAuth:
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (UTC)."],[[["\u003cp\u003eThis API call initiates the cancellation of a long-running operation, with no guarantee of success.\u003c/p\u003e\n"],["\u003cp\u003eClients can verify the cancellation's outcome or operation completion status through \u003ccode\u003eOperations.GetOperation\u003c/code\u003e or alternative methods.\u003c/p\u003e\n"],["\u003cp\u003eA successful cancellation results in the operation receiving an error status indicating \u003ccode\u003eCode.CANCELLED\u003c/code\u003e, rather than deletion.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request for cancellation is a POST request to a specific endpoint, requiring the operation's name in the path and an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-translation\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.operations.cancel\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` 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](/distributed-cloud/hosted/docs/latest/gdch/apis/vertex-ai/translation/rest/v3/projects.operations#Operation.FIELDS.error) value with a [google.rpc.Status.code](/distributed-cloud/hosted/docs/latest/gdch/apis/vertex-ai/translation/rest/v3/projects.operations#Status.FIELDS.code) of 1, corresponding to `Code.CANCELLED`.\n\n### HTTP request\n\n`POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{name}:cancel`\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 empty.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-translation`\n- `https://www.googleapis.com/auth/cloud-platform`"]]
