Method: projects.locations.operations.cancel

Démarre l'annulation asynchrone sur une opération de longue durée. Le serveur fait de son mieux pour annuler l'opération, mais la réussite de l'annulation n'est pas garantie. Si le serveur n'accepte pas cette méthode, il renvoie google.rpc.Code.UNIMPLEMENTED. Les clients peuvent utiliser Operations.GetOperation ou d'autres méthodes pour vérifier si l'annulation a réussi, ou si l'opération a abouti malgré la tentative d'annulation. En cas d'annulation réussie, l'opération n'est pas supprimée, mais elle devient une opération dotée d'une valeur Operation.error avec un code d'état google.rpc.Status.code de 1, correspondant au code Code.CANCELLED.

Requête HTTP

POST https://{endpoint}/v1/{name=projects/*/locations/*/operations/*}:cancel

Où {endpoint} est l'un des points de terminaison de service compatibles.

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin

Paramètres
name

string

Le nom de la ressource de l'opération à annuler.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse est vide.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • gkemulticloud.operations.cancel

Pour en savoir plus, consultez la documentation IAM.