Operations

Attention:Il s'agit d'une version obsolète de l'API Deployment Manager. Veuillez utiliser la dernière version de l'API à la place.

Une opération suit l'état de toutes les requêtes qui modifient des données. Une opération est renvoyée pour chaque requête qui modifie des ressources.

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

Ressource "Operation", utilisée pour gérer les requêtes d'API asynchrones.

{
  "kind": "deploymentmanager#operation",
  "id": unsigned long,
  "creationTimestamp": string,
  "name": string,
  "zone": string,
  "clientOperationId": string,
  "operationType": string,
  "targetLink": string,
  "targetId": unsigned long,
  "status": string,
  "statusMessage": string,
  "user": string,
  "progress": integer,
  "insertTime": string,
  "startTime": string,
  "endTime": string,
  "error": {
    "errors": [
      {
        "code": string,
        "location": string,
        "message": string
      }
    ]
  },
  "warnings": [
    {
      "code": string,
      "message": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ]
    }
  ],
  "httpErrorStatusCode": integer,
  "httpErrorMessage": string,
  "selfLink": string,
  "region": string,
  "description": string
}
Nom de propriété Valeur Description Remarques
clientOperationId string [Sortie uniquement] Réservé pour une utilisation ultérieure.
creationTimestamp string [Uniquement en sortie] Horodatage de la création au format texte RFC 3339.
description string [Uniquement en sortie] Description textuelle de l'opération, qui est définie lors de sa création.
endTime string [Uniquement en sortie] Heure à laquelle cette opération a été terminée. Cette valeur est au format texte RFC3339.
error object [Sortie uniquement] Si des erreurs sont générées lors du traitement de l'opération, ce champ est renseigné.
error.errors[] list [Uniquement en sortie] Tableau des erreurs rencontrées lors du traitement de cette opération.
error.errors[].code string [Uniquement en sortie] Identifiant du type d'erreur rencontré.
error.errors[].location string [Uniquement en sortie] Indique le champ de la requête à l'origine de l'erreur. Cette propriété est facultative.
error.errors[].message string [Uniquement en sortie] Message d'erreur facultatif qui s'affiche dans un format lisible.
httpErrorMessage string [Sortie uniquement] Si l'opération échoue, ce champ contient le message d'erreur HTTP renvoyé, par exemple NOT FOUND.
httpErrorStatusCode integer [Sortie uniquement] Si l'opération échoue, ce champ contient le code d'état d'erreur HTTP renvoyé. Par exemple, un 404 signifie que la ressource n'a pas été trouvée.
id unsigned long [Sortie uniquement] Identifiant unique de la ressource. Cet identifiant est défini par le serveur.
insertTime string [Uniquement en sortie] Heure à laquelle cette opération a été demandée. Cette valeur est au format texte RFC3339.
kind string [Uniquement en sortie] Type de la ressource. Toujours compute#operation pour les ressources d'opération.
name string [Uniquement en sortie] Nom de la ressource.
operationType string [Uniquement en sortie] Type d'opération, tel que insert, update ou delete, etc.
progress integer [Uniquement en sortie] Indicateur de progression facultatif compris entre 0 et 100. Il ne doit pas nécessairement être linéaire ou permettre un suivi précis des opérations. Cette valeur ne doit pas être utilisée pour deviner quand l'opération sera terminée. Ce nombre doit augmenter de manière monotone au fur et à mesure de l'opération.
region string [Uniquement en sortie] URL de la région où se trouve l'opération. Disponible uniquement lorsque vous effectuez des opérations régionales.
startTime string [Uniquement en sortie] Heure à laquelle cette opération a été démarrée par le serveur. Cette valeur est au format texte RFC3339.
status string [Sortie uniquement] État de l'opération, qui peut être l'un des suivants: PENDING, RUNNING ou DONE.
statusMessage string [Uniquement en sortie] Description textuelle facultative de l'état actuel de l'opération.
targetId unsigned long [Sortie uniquement] ID cible unique, qui identifie une incarnation spécifique de la ressource cible.
user string [Uniquement en sortie] Utilisateur à l'origine de l'opération, par exemple: user@example.com.
warnings[] list [Uniquement en sortie] Si des messages d'avertissement sont générés lors du traitement de l'opération, ce champ est renseigné.
warnings[].code string [Uniquement en sortie] Code d'avertissement, le cas échéant. Par exemple, Compute Engine renvoie NO_RESULTS_ON_PAGE si la réponse ne contient aucun résultat.
warnings[].data[] list [Sortie uniquement] Métadonnées sur cet avertissement au format key: value. Exemple :
"data": [ { "key": "scope", "value": "zones/us-east1-d" }
warnings[].data[].key string [Sortie uniquement] Clé fournissant plus d'informations sur l'avertissement renvoyé. Par exemple, pour les avertissements où aucune zone n'est renvoyée dans une requête de liste, cette clé peut être scope et la valeur de la clé peut être le nom de la zone. Il peut s'agir, par exemple, d'une clé indiquant une ressource obsolète et d'une suggestion de remplacement, ou d'un avertissement concernant des paramètres réseau non valides (par exemple, si une instance tente d'effectuer un transfert d'adresses IP, mais que cette fonctionnalité n'est pas activée).
warnings[].data[].value string [Sortie uniquement] Valeur de données d'avertissement correspondant à la clé.
warnings[].message string [Sortie uniquement] Description lisible du code d'avertissement.
zone string [Uniquement en sortie] URL de la zone où se trouve l'opération. Disponible uniquement lors de l'exécution d'opérations par zone.

Méthodes

get
Obtient des informations sur une opération spécifique.
liste
Répertorie toutes les opérations d'un projet.