Deployments - Get Deployment Devices

Obtient une liste d’appareils dans un déploiement avec leur état. Utile pour obtenir une liste des périphériques défaillants.

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}/devicestates
GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}/devicestates?$filter={$filter}

Paramètres URI

Name In Required Type Description
accountEndpoint
path True
  • string

Point de terminaison du compte.

deploymentId
path True
  • string

Identificateur du déploiement.

instanceId
path True
  • string

Identificateur de l’instance de compte.

$filter
query
  • string

Restreint l’ensemble des États de l’appareil de déploiement renvoyés. Vous pouvez filtrer sur deviceId et/ou deviceState.

Réponses

Name Type Description
200 OK

Les appareils dans le déploiement avec leurs États.

404 Not Found

Introuvable.

Sécurité

azure_auth

Azure Active Directory le Flow OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Deployments_GetDeploymentDevices

Sample Request

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/management/deployments/deploymentId/devicestates

Sample Response

{
  "value": [
    {
      "deviceId": "deviceId1",
      "retryCount": 1,
      "movedOnToNewDeployment": false,
      "deviceState": "Succeeded"
    },
    {
      "deviceId": "deviceId2",
      "retryCount": 1,
      "movedOnToNewDeployment": false,
      "deviceState": "Succeeded"
    }
  ]
}

Définitions

DeploymentDeviceState

État du périphérique de déploiement.

DeviceDeploymentState

État du déploiement.

PageableListOfDeploymentDeviceStates

Liste des États de l’appareil de déploiement.

DeploymentDeviceState

État du périphérique de déploiement.

Name Type Description
deviceId
  • string

Identité de l’appareil.

deviceState

État du périphérique de déploiement.

movedOnToNewDeployment
  • boolean

Indicateur booléen indiquant si ce périphérique est dans un déploiement plus récent et ne peut plus réessayer ce déploiement.

retryCount
  • integer

Nombre de nouvelles tentatives de ce déploiement sur cet appareil.

DeviceDeploymentState

État du déploiement.

Name Type Description
Canceled
  • string

Le déploiement a été annulé.

Failed
  • string

Le déploiement s’est terminé avec un échec.

InProgress
  • string

Le déploiement est en cours.

Incompatible
  • string

Le déploiement n’est pas compatible avec l’appareil.

Succeeded
  • string

Le déploiement s’est terminé avec succès.

PageableListOfDeploymentDeviceStates

Liste des États de l’appareil de déploiement.

Name Type Description
nextLink
  • string

Lien vers la page suivante d’éléments.

value

Collection d’éléments paginables.