Package google.longrunning

Index

• Operations (interface)
• CancelOperationRequest (message)
• GetOperationRequest (message)
• ListOperationsRequest (message)
• ListOperationsResponse (message)
• Operation (message)

Opérations

Gère les opérations de longue durée effectuées avec un service API.

Lorsqu'une méthode API prend normalement beaucoup de temps pour aboutir, elle peut être conçue pour renvoyer l'interface Operation au client. Le client peut se servir de cette interface pour recevoir la réponse réelle de manière asynchrone en interrogeant la ressource de l'opération, ou en transmettant la ressource de l'opération à une autre API (telle que l'API Pub/Sub). Tout service d'API qui renvoie des opérations de longue durée doit implémenter l'interface Operations afin que les développeurs puissent bénéficier d'une expérience client cohérente.

CancelOperation

rpc CancelOperation(CancelOperationRequest) returns (Empty) 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 portant une valeur Operation.error avec un google.rpc.Status.code de 1, ce qui correspond à Code.CANCELLED. Niveaux d'accès des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/discoveryengine.readwrite Pour plus d'informations, consultez la Authentication Overview.

GetOperation

rpc GetOperation(GetOperationRequest) returns (Operation) Récupère le dernier état d'une opération de longue durée. Cette méthode permet aux clients d'interroger le résultat de l'opération à des intervalles recommandés par le service d'API. Niveaux d'accès des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/discoveryengine.readwrite Pour plus d'informations, consultez la Authentication Overview. Autorisations IAM Nécessite l'autorisation IAM suivante sur la ressource name : discoveryengine.operations.get Pour en savoir plus, consultez la documentation IAM.

ListOperations

rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse) Répertorie les opérations qui correspondent au filtre spécifié dans la requête. Si le serveur n'accepte pas cette méthode, il renvoie UNIMPLEMENTED. Niveaux d'accès des autorisations Nécessite l'un des champs d'application OAuth suivants : https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/discoveryengine.readwrite Pour plus d'informations, consultez la Authentication Overview. Autorisations IAM Nécessite l'autorisation IAM suivante sur la ressource name : discoveryengine.operations.list Pour en savoir plus, consultez la documentation IAM.

CancelOperationRequest

Message de requête pour Operations.CancelOperation.

Champs
name	string Nom de la ressource de l'opération à annuler.

GetOperationRequest

Message de requête pour Operations.GetOperation.

Champs
name	string Nom de ressource de l'opération.

ListOperationsRequest

Message de requête pour Operations.ListOperations.

Champs
name	string Le nom de la ressource parente de l'opération.
filter	string Le filtre de la liste standard.
page_size	int32 La taille de page de la liste standard.
page_token	string Jeton de la page de la liste standard.
return_partial_success	bool Lorsque la valeur est définie sur true, les opérations accessibles sont renvoyées normalement, et celles qui ne le sont pas sont renvoyées dans le champ [ListOperationsResponse.unreachable]. Cette valeur ne peut être définie sur true que lors de la lecture de plusieurs collections, par exemple lorsque parent est défini sur "projects/example/locations/-". Par défaut, ce champ n'est pas pris en charge et générera une erreur UNIMPLEMENTED s'il est défini, sauf indication contraire explicite dans la documentation spécifique au service ou au produit.

ListOperationsResponse

Le message de réponse pour Operations.ListOperations.

Champs
operations[]	Operation La liste des opérations qui correspondent au filtre spécifié dans la requête.
next_page_token	string Le jeton de page suivante de la liste standard.
unreachable[]	string Liste non triée. Ressources inaccessibles. Ce champ est renseigné lorsque la requête définit ListOperationsRequest.return_partial_success et lit les collections (par exemple, lorsqu'elle tente de lister toutes les ressources dans tous les lieux acceptés).

Opération

Cette ressource représente une opération de longue durée résultant d'un appel d'API réseau.

Champs
name	string Nom attribué par le serveur. Unique au sein du service qui le renvoie initialement. Si vous utilisez le mappage HTTP par défaut, le champ name doit être un nom de ressource se terminant par operations/{unique_id}.
metadata	Any Métadonnées spécifiques au service associées à l'opération. Ce champ contient généralement des informations de progression et des métadonnées courantes telles que la date de création. Certains services peuvent ne pas fournir ce genre de métadonnées. Toute méthode renvoyant une opération de longue durée doit indiquer le type de métadonnées, le cas échéant.
done	bool Si la valeur est false, cela signifie que l'opération est toujours en cours. Si elle est définie sur true, l'opération est terminée, et un message error ou response est disponible.
Champ d'union result. Résultat de l'opération, qui peut être une erreur (message error) ou une réponse valide (message response). Si done == false, ni error, ni response ne sont définis. Si done == true, une seule des options error ou response peut être définie. Certains services peuvent ne pas fournir le résultat. result ne peut être qu'un des éléments suivants :
error	Status Résultat d'erreur de l'opération en cas d'échec ou d'annulation.
response	Any Réponse normale indiquant la réussite de l'opération. Si la méthode d'origine ne renvoie aucune donnée en cas de réussite (telle que Delete), la réponse est google.protobuf.Empty. Si la méthode d'origine est une méthode Get/Create/Update standard, la réponse doit correspondre à la ressource. Pour les autres méthodes, la réponse doit avoir le type XxxResponse, où Xxx est le nom de la méthode d'origine. Par exemple, si le nom de la méthode d'origine est TakeSnapshot(), le type de réponse déduit est TakeSnapshotResponse.