Charger la liste des appareils dans un lot existant pour le client spécifiéUpload a list of devices to an existing batch for the specified customer

S’applique àApplies To

  • Espace partenairesPartner Center
  • Espace partenaires de Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany

Télécharger une liste d’informations sur les appareils dans un lot existant pour le client spécifié.How to upload a list of information about devices to an existing batch for the specified customer. Cela associe les appareils à un lot d’appareils déjà créé.This associates the devices with a device batch already created.

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application autonome et de l’application + utilisateur.This scenario supports authentication with both standalone App and App+User credentials.

  • ID du client (customer-tenant-id).A customer ID (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans le tableau de bord de l’Espace partenaires.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Sélectionnez CSP dans le menu Espace partenaires, puis Clients.Select CSP from the Partner Center menu, followed by Customers. Sélectionnez le client dans la liste des clients, puis Compte.Select the customer from the customer list, then select Account. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Identificateur du lot de l’appareil.The device batch identifier.

  • Liste des ressources d’appareil qui fournissent des informations sur les appareils individuels.The list of device resources that provide the information about the individual devices.

C#C#

Pour télécharger une liste d’appareils sur un lot d’appareils existant, commencez par instancier un nouveau [list/dotnet/API/System. Collections. Generic. List-1) de type Device et remplissez la liste avec les périphériques.To upload a list of devices to an existing device batch, first, instantiate a new [List/dotnet/api/system.collections.generic.list-1) of type Device and populate the list with the devices. Les combinaisons suivantes de propriétés remplies sont requises au minimum pour identifier chaque appareil :The following combinations of populated properties are required at a minimum for identifying each device:

Ensuite, appelez la méthode collection iaggregatepartner. Customers. méthode BYID avec l’identificateur du client pour récupérer une interface pour les opérations sur le client spécifié.Then, call the IAggregatePartner.Customers.ById method with the customer identifier to retrieve an interface to operations on the specified customer. Ensuite, appelez la méthode DeviceBatches. méthode BYID avec l’identificateur de lot de l’appareil pour obtenir une interface pour les opérations du lot spécifié.Next, call the DeviceBatches.ById method with the device batch identifier to get an interface to operations for the specified batch. Enfin, appelez la méthode Devices. Create ou CreateAsync avec la liste des appareils pour ajouter les périphériques au lot de l’appareil.Finally, call the Devices.Create or CreateAsync method with the list of devices to add the devices to the device batch.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedDeviceBatchId;

List<Device> devicesToBeUploaded = new List<Device>
{
    new Device
    {
        HardwareHash = "DummyHash1234",
        ProductKey = "00329-00000-0003-AA606",
        SerialNumber = "2R9-ZNP67"
    },

    new Device
    {
        HardwareHash = "DummyHash12345",
        ProductKey = "00329-00000-0003-AA606",
        SerialNumber = "2R9-ZNP67"
    }
};

var trackingLocation =
    partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.ById(selectedDeviceBatchId).Devices.Create(devicesToBeUploaded);

Exemple: application de test console.Sample: Console test app. Projet: classed’exemples du kit de développement logiciel (SDK) Partner Center : CreateDevices.csProject: Partner Center SDK Samples Class: CreateDevices.cs

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
POSTPOST {baseURL}/v1/Customers/{Customer-ID}/deviceBatches/{devicebatch-ID}/Devices http/1.1{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices HTTP/1.1

Paramètre d’URIURI parameter

Utilisez le chemin d’accès et les paramètres de requête suivants lors de la création de la demande.Use the following path and query parameters when creating the request.

NomName TypeType ObligatoireRequired DescriptionDescription
customer-idcustomer-id stringstring OuiYes Chaîne au format GUID qui identifie le client.A GUID-formatted string that identifies the customer.
ID d’devicebatchdevicebatch-id stringstring OuiYes Identificateur de chaîne qui identifie le lot de l’appareil.A string identifier that identifies the device batch.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Le corps de la demande doit contenir un tableau d’objets d' appareil .The request body must contain an array of Device objects. Les combinaisons de champs suivantes permettant d’identifier un appareil sont acceptées :The following combinations of fields for identifying a device are accepted:

  • hardwareHash + productKey.hardwareHash + productKey.
  • hardwareHash + serialNumber.hardwareHash + serialNumber.
  • hardwareHash + productKey + serialNumber.hardwareHash + productKey + serialNumber.
  • hardwareHash uniquement.hardwareHash only.
  • productKey uniquement.productKey only.
  • serialNumber + oemManufacturerName + modelName.serialNumber + oemManufacturerName + modelName.

Exemple de requêteRequest example

POST https://api.partnercenter.microsoft.com/v1/customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/deviceBatches/Test/devices HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e286d69b-7f5f-4098-8999-21d3b54e4e47
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 482
Expect: 100-continue

[{
        "Id": null,
        "SerialNumber": "2R9-ZNP67",
        "ProductKey": "00329-00000-0003-AA606",
        "HardwareHash": "DummyHash1234",
        "Policies": null,
        "CreatedBy": null,
        "UploadedDate": "0001-01-01T00:00:00",
        "AllowedOperations": null,
        "Attributes": {
            "ObjectType": "Device"
        }
    }, {
        "Id": null,
        "SerialNumber": "2R9-ZNP67",
        "ProductKey": "00329-00000-0003-AA606",
        "HardwareHash": "DummyHash12345",
        "Policies": null,
        "CreatedBy": null,
        "UploadedDate": "0001-01-01T00:00:00",
        "AllowedOperations": null,
        "Attributes": {
            "ObjectType": "Device"
        }
    }
]

Réponse RESTREST response

En cas de réussite, la réponse contient un en-tête d' emplacement qui a un URI qui peut être utilisé pour récupérer l’état du chargement de l’appareil.If successful, the response contains a Location header that has a URI that can be used to retrieve device upload status. Enregistrez cet URI pour une utilisation avec d’autres API REST associées.Save this URI for use with other related REST APIs.

Codes d’erreur et de réussite de la réponseResponse success and error codes

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.For the full list, see Partner Center REST error codes.

Exemple de réponseResponse example

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/batchJobStatus/16c00110-e79a-433d-aa28-f69dd60df671
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: e286d69b-7f5f-4098-8999-21d3b54e4e47
MS-CV: OBkGN9pSN0a5xvua.0
MS-ServerId: 101112012
Date: Thu, 28 Sep 2017 20:08:46 GMT