Cette page a été traduite par l'API Cloud Translation.

REST Resource: customer.devices.chromeos.commands

Ressource: DirectoryChromeosdevicesCommand

Informations concernant une commande envoyée à un appareil.

Représentation JSON

Représentation JSON
{ "commandId": string, "type": enum (`CommandType`), "issueTime": string, "state": enum (`State`), "commandExpireTime": string, "commandResult": { object (`DirectoryChromeosdevicesCommandResult`) }, "payload": string }

{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}

Champs
`commandId`	`string (int64 format)` ID unique d'une commande d'appareil.
`type`	`enum (CommandType)` Type de la commande.
`issueTime`	`string (Timestamp format)` Code temporel de l'émission de la commande par l'administrateur. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : `"2014-10-02T15:01:23Z"` et `"2014-10-02T15:01:23.045123456Z"`.
`state`	`enum (State)` Indique l'état de la commande.
`commandExpireTime`	`string (Timestamp format)` Heure d'expiration de la commande. Si l'appareil n'exécute pas la commande dans ce délai, la commande expire. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : `"2014-10-02T15:01:23Z"` et `"2014-10-02T15:01:23.045123456Z"`.
`commandResult`	`object (DirectoryChromeosdevicesCommandResult)` Résultat de l'exécution de la commande.
`payload`	`string` Charge utile spécifiée par la commande, le cas échéant.

CommandType

Détermine le type de commande que l'appareil doit exécuter.

Enums
`COMMAND_TYPE_UNSPECIFIED`	Le type de commande n'a pas été spécifié.
`REBOOT`	Redémarrez l'appareil. Peut être émis pour les appareils en mode kiosque et de session Invité gérée, ainsi que pour les appareils standards exécutant ChromeOS 113 ou une version ultérieure.
`TAKE_A_SCREENSHOT`	Prenez une capture d'écran de l'appareil. Disponible uniquement si l'appareil est en mode Kiosque.
`SET_VOLUME`	Réglez le volume de l'appareil. ne peuvent être émises que pour les appareils en mode Kiosque et les sessions Invité gérées ;
`WIPE_USERS`	Effacez tous les utilisateurs de l'appareil. Si vous exécutez cette commande sur l'appareil, toutes les données de profil utilisateur seront supprimées, mais les règles relatives à l'appareil et l'enregistrement seront conservés.
`REMOTE_POWERWASH`	Efface les données de l'appareil en effectuant un nettoyage intensif. Si vous exécutez cette commande sur l'appareil, toutes les données seront supprimées, y compris les règles relatives aux utilisateurs et aux appareils, ainsi que les règles d'enregistrement. Avertissement: Cette opération rétablira la configuration d'usine de l'appareil sans aucun enregistrement, sauf s'il fait l'objet d'un enregistrement forcé ou automatique. À utiliser avec précaution, car il s'agit d'une action irréversible.
`DEVICE_START_CRD_SESSION`	Démarre une session de bureau à distance Chrome.
`CAPTURE_LOGS`	Enregistrez les journaux système d'un appareil en mode kiosque. Les journaux peuvent être téléchargés à partir du lien downloadUrl présent dans le champ `deviceFiles` des chromeosdevices
`FETCH_SUPPORT_PACKET`	Récupérer à distance les paquets d'assistance d'un appareil Le dossier d'assistance est une archive ZIP contenant divers journaux système et données de débogage d'un appareil ChromeOS. Vous pouvez télécharger la formule d'assistance en cliquant sur le lien downloadURL présent dans le champ `deviceFiles` de `chromeosdevices`

État

Représente l'état de la commande émise.

Enums
`STATE_UNSPECIFIED`	L'état de la commande n'a pas été spécifié.
`PENDING`	Une commande non expirée n'a pas encore été envoyée au client.
`EXPIRED`	La commande n'a pas été exécutée par le client dans le délai prévu.
`CANCELLED`	La commande est annulée par l'administrateur lorsque l'état "PENDING" (en attente) est activé.
`SENT_TO_CLIENT`	La commande a été envoyée au client.
`ACKED_BY_CLIENT`	Le client a répondu qu'il avait reçu la commande.
`EXECUTED_BY_CLIENT`	Le client a exécuté la commande (non) avec succès.

DirectoryChromeosdevicesCommandResult

Résultat de l'exécution d'une commande.

Représentation JSON
{ "result": enum (`CommandResultType`), "executeTime": string, "errorMessage": string, "commandResultPayload": string }

Champs
`result`	`enum (CommandResultType)` Résultat de la commande.
`executeTime`	`string (Timestamp format)` Heure à laquelle la commande a été exécutée ou a échoué. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : `"2014-10-02T15:01:23Z"` et `"2014-10-02T15:01:23.045123456Z"`.
`errorMessage`	`string` Message d'erreur avec une brève explication de la raison de l'échec de la commande. Présent uniquement si la commande a échoué.
`commandResultPayload`	`string` Charge utile du résultat de la commande. Les commandes suivantes répondent avec une charge utile: `DEVICE_START_CRD_SESSION`: la charge utile est un objet JSON concaténé au format: { "url": url }. L'URL fournit un lien vers la session du Bureau à distance Chrome.

CommandResultType

Type de résultat de la commande.

Enums
`COMMAND_RESULT_TYPE_UNSPECIFIED`	Le résultat de la commande n'était pas spécifié.
`IGNORED`	La commande a été ignorée, car elle est obsolète.
`FAILURE`	Impossible d'exécuter la commande.
`SUCCESS`	La commande a bien été exécutée.

Méthodes
`get`	Récupère les données de commande d'une commande spécifique envoyée à l'appareil.