Carregar uma lista de dispositivos para criar um lote para o cliente especificadoUpload a list of devices to create a new batch for the specified customer

Aplica-se a:Applies to:

  • Partner CenterPartner Center
  • Partner Center do Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany

Como carregar uma lista de informações sobre dispositivos para criar um novo lote para o cliente especificado.How to upload a list of information about devices to create a new batch for the specified customer. Isso cria um lote de dispositivo para o registro em implantação sem toque e associa os dispositivos e o lote do dispositivo ao cliente especificado.This creates a device batch for enrollment in zero-touch deployment, and associates the devices and the device batch with the specified customer.

Pré-requisitosPrerequisites

  • Credenciais, conforme descrito em Autenticação do Partner Center.Credentials as described in Partner Center authentication. Este cenário dá suporte à autenticação com credenciais de aplicativo + usuário.This scenario supports authentication with App+User credentials. Siga o modelo de aplicativo seguro ao usar o aplicativo + autenticação de usuário com as APIs do Partner Center.Follow the secure app model when using App+User authentication with Partner Center APIs.

  • Uma ID do cliente (customer-tenant-id).A customer ID (customer-tenant-id). Se você não souber a ID do cliente, poderá procurar no painel do Partner Center.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecione CSP no menu do Partner Center e, em seguida, Clientes.Select CSP from the Partner Center menu, followed by Customers. Selecione o cliente na lista de clientes e selecione Conta.Select the customer from the customer list, then select Account. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • A lista de recursos do dispositivo que fornecem as informações sobre os dispositivos individuais.The list of device resources that provide the information about the individual devices.

C#C#

Para carregar uma lista de dispositivos para criar um novo lote de dispositivo:To upload a list of devices to create a new device batch:

  1. Crie uma nova instância de [lista/dotnet/API/System. Collections. Generic. list-1) do tipo dispositivo e preencha a lista com os dispositivos.Instantiate a new [List/dotnet/api/system.collections.generic.list-1) of type Device and populate the list with the devices. As seguintes combinações de propriedades populadas são necessárias no mínimo para identificar cada dispositivo:The following combinations of populated properties are required at a minimum for identifying each device:

  2. Crie uma instância de um objeto DeviceBatchCreationRequest e defina a propriedade BatchId como um nome exclusivo de sua escolha e a propriedade Devices para a lista de dispositivos a serem carregados.Instantiate a DeviceBatchCreationRequest object and set the BatchId property to a unique name of your choosing, and the Devices property to the list of devices to upload.

  3. Processe a solicitação de criação de lote do dispositivo chamando o método IAggregatePartner. Customers. ById com o identificador de cliente para recuperar uma interface para operações no cliente especificado.Process the device batch creation request by calling the IAggregatePartner.Customers.ById method with the customer identifier to retrieve an interface to operations on the specified customer.

  4. Chame o método DeviceBatches. Create ou createasync com a solicitação de criação de lote do dispositivo para criar o lote.Call the DeviceBatches.Create or CreateAsync method with the device batch creation request to create the batch.

IAggregatePartner partnerOperations;
string selectedCustomerId;

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

DeviceBatchCreationRequest
    newDeviceBatch = new DeviceBatchCreationRequest
{
    BatchId = "SDKTestDeviceBatch",
    Devices = devicesToBeUploaded
};

var trackingLocation =
    partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.Create(newDeviceBatch);

Exemplo: aplicativo de teste do console.Sample: Console test app. Projeto: classede exemplos do SDK do Partner Center: CreateDeviceBatch.csProject: Partner Center SDK Samples Class: CreateDeviceBatch.cs

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
POSTPOST {baseURL}/v1/Customers/{Customer-ID}/deviceBatches http/1.1{baseURL}/v1/customers/{customer-id}/deviceBatches HTTP/1.1

Parâmetro do URIURI parameter

Use os seguintes parâmetros de caminho ao criar a solicitação.Use the following path parameters when creating the request.

NomeName TipoType ObrigatórioRequired DescriçãoDescription
id do clientecustomer-id stringstring SimYes Uma cadeia com formato de GUID que identifica o cliente.A GUID-formatted string that identifies the customer.

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

O corpo da solicitação deve conter um recurso DeviceBatchCreationRequest .The request body must contain a DeviceBatchCreationRequest resource.

Exemplo de solicitaçãoRequest example

POST https://api.partnercenter.microsoft.com/v1/customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/deviceBatches HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: e3f26e6a-044f-4371-ad52-0d91ce4200be
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
    "BatchId": "SDKTestDeviceBatch",
    "Devices": [{
            "Id": null,
            "SerialNumber": "1R9-ZNP67",
            "ProductKey": "00329-00000-0003-AA606",
            "HardwareHash": "DummyHash123",
            "Policies": null,
            "CreatedBy": null,
            "UploadedDate": "0001-01-01T00:00:00",
            "AllowedOperations": null,
            "Attributes": {
                "ObjectType": "Device"
            }
        }
    ],
    "Attributes": {
        "ObjectType": "DeviceBatchCreationRequest"
    }
}

Resposta RESTREST response

Se for bem-sucedida, a resposta conterá um cabeçalho de local que tem um URI que pode ser usado para recuperar o status de carregamento do dispositivo.If successful, the response contains a Location header that has a URI that can be used to retrieve device upload status. Salve esse URI para uso com outras APIs REST relacionadas.Save this URI for use with other related REST APIs.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, confira Códigos de erro REST do Partner Center.For the full list, see Partner Center REST error codes.

Exemplo de respostaResponse example

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/batchJobStatus/beba2053-5401-46ff-9223-7e841ed78fbf
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2017 20:35:35 GMT