Modifie l'état d'un lot d'appareils ChromeOS. Pour plus d'informations sur la modification de l'état d'un appareil ChromeOS, consultez Faire réparer des appareils ChromeOS, modifier leur affectation ou les supprimer.
Requête HTTP
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
customerId |
Obligatoire. ID permanent du compte Google Workspace. |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "deviceIds": [ string ], "changeChromeOsDeviceStatusAction": enum ( |
Champs | |
---|---|
deviceIds[] |
Obligatoire. Liste des ID des appareils ChromeOS à modifier. 50 maximum. |
changeChromeOsDeviceStatusAction |
Obligatoire. Action à effectuer sur l'appareil ChromeOS pour modifier son état. |
deprovisionReason |
Facultatif. Motif du déprovisionnement d'un appareil. Doit être fourni si "changeChromeOsDeviceStatusAction" est défini sur "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION". Sinon, omettez ce champ. |
Corps de la réponse
Réponse de modification de l'état d'un lot d'appareils ChromeOS.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"changeChromeOsDeviceStatusResults": [
{
object ( |
Champs | |
---|---|
changeChromeOsDeviceStatusResults[] |
Résultats pour chacun des appareils ChromeOS fournis dans la requête. |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/admin.directory.device.chromeos
Pour en savoir plus, consultez le guide relatif aux autorisations.
ChangeChromeOsDeviceStatusAction
Action à effectuer pour modifier l'état d'un appareil ChromeOS.
Enums | |
---|---|
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED |
Valeur par défaut. La valeur n'est pas utilisée. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION |
Déprovisionne un appareil ChromeOS. Si des appareils ChromeOS ne sont plus utilisés dans votre organisation, vous devez les déprovisionner pour ne plus avoir à les gérer. Si vous annulez la gestion de l'appareil, toutes les règles qui s'y trouvaient, ainsi que les imprimantes au niveau de celui-ci seront supprimées. De plus, l'appareil ne pourra plus être utilisé en tant que kiosque. En fonction de la licence associée à l'appareil, cette action peut libérer la licence dans le groupe de licences, ce qui vous permet de l'utiliser sur un autre appareil. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE |
Désactive un appareil ChromeOS. Utilisez cette action en cas de perte ou de vol de l'appareil d'un utilisateur. L'appareil est alors toujours géré. Il continue ainsi de recevoir des règles, mais personne ne peut l'utiliser. En fonction de la licence associée à l'appareil, cette action peut libérer la licence dans le groupe de licences, ce qui vous permet de l'utiliser sur un autre appareil. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE |
Réactive un appareil ChromeOS qui peut être utilisé après sa désactivation. Réactive l'appareil une fois qu'il n'est plus perdu ou récupéré. Cela permet de réutiliser l'appareil. En fonction de la licence associée à l'appareil, celle-ci peut consommer une licence du pool de licences. Si le nombre de licences disponibles est insuffisant, l'opération échouera. |
ChangeChromeOsDeviceStatusResult
Résultat d'une opération de changement d'état sur un seul appareil ChromeOS.
Représentation JSON |
---|
{ "deviceId": string, // Union field |
Champs | |
---|---|
deviceId |
ID unique de l'appareil ChromeOS. |
Champ d'union
|
|
error |
Résultat d'erreur de l'opération en cas d'échec. |
response |
L'état de l'appareil a bien été modifié. |
État
Le type Status
définit un modèle d'erreur logique adapté aux différents environnements de programmation, y compris les API REST et RPC. Il est utilisé par le protocole gRPC. Chaque message Status
contient trois éléments de données : un code d'erreur, un message d'erreur et les détails de l'erreur.
Pour en savoir plus sur ce modèle d'erreur et sur son utilisation, consultez le Guide de conception d'API.
Représentation JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Champs | |
---|---|
code |
Code d'état, qui doit être une valeur d'énumération de |
message |
Message d'erreur destiné au développeur, qui doit être en anglais. Tout message d'erreur destiné aux utilisateurs doit être localisé et envoyé dans le champ |
details[] |
Liste de messages comportant les détails de l'erreur. Il existe un ensemble commun de types de message utilisable par les API. Objet contenant des champs d'un type arbitraire. Un champ supplémentaire |
ChangeChromeOsDeviceStatusSucceeded
Ce type ne comporte aucun champ.
Réponse en cas de modification de l'état d'un appareil ChromeOS.