Carregar uma lista de dispositivos para criar um novo lote para o cliente especificado

Artigo
09/11/2024

Aplica-se a: Partner Center

Como carregar uma lista de informações sobre dispositivos para criar um novo lote para o cliente especificado. Isso cria um lote de dispositivos para registro na implantação zero-touch e associa os dispositivos e o lote de dispositivos ao cliente especificado.

Pré-requisitos

Credenciais conforme descrito na autenticação do Partner Center. Este cenário oferece suporte à autenticação com credenciais App+User. Siga o modelo de aplicativo seguro ao usar a autenticação App+User com APIs do Partner Center.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Partner Center selecionando a área de trabalho Clientes e, em seguida, o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é a mesma que a ID do cliente (customer-tenant-id).
A lista de recursos de dispositivo que fornecem as informações sobre os dispositivos individuais.

C#

Para carregar uma lista de dispositivos para criar um novo lote de dispositivos:

Instancie um novo [List/dotnet/api/system.collections.generic.list-1] do tipo Device e preencha a lista com os dispositivos. As seguintes combinações de propriedades preenchidas são necessárias, no mínimo, para identificar cada dispositivo:
- HardwareHash + ProductKey.
- HardwareHash + SerialNumber.
- HardwareHash + ProductKey + SerialNumber.
- Apenas HardwareHash .
- Apenas ProductKey .
- SerialNumber + OemManufacturerName + ModelName.
Instancie 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.
Processe a solicitação de criação de lote de dispositivo chamando o método IAggregatePartner.Customers.ById com o identificador do cliente para recuperar uma interface para operações no cliente especificado.
Chame o método DeviceBatches.Create ou CreateAsync com a solicitação de criação de lote de dispositivo para criar o lote.

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 de console. Projeto: Exemplo de SDK do Partner Center Classe: CreateDeviceBatch.cs

Pedido REST

Sintaxe da solicitação

Método	URI do pedido
POST	{baseURL}/v1/customers/{customer-id}/deviceBatches HTTP/1.1

Parâmetro URI

Use os seguintes parâmetros de caminho ao criar a solicitação.

Nome	Type	Obrigatório	Description
ID do cliente	string	Sim	Uma cadeia de caracteres formatada em GUID que identifica o cliente.

Cabeçalhos do pedido

Para obter mais informações, consulte Cabeçalhos REST do Partner Center.

Corpo do pedido

O corpo da solicitação deve conter um recurso DeviceBatchCreationRequest .

Exemplo de solicitação

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: aaaa0000-bb11-2222-33cc-444444dddddd
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"
    }
}

Importante

A partir de junho de 2023, a versão 3.4.0 mais recente do SDK do .NET do Partner Center foi arquivada. Você pode baixar a versão do SDK do GitHub, juntamente com um arquivo readme que contém informações úteis.

Os parceiros são incentivados a continuar a usar as APIs REST do Partner Center.

Resposta do REST

Se bem-sucedida, a resposta contém um cabeçalho Location que tem um URI que pode ser usado para recuperar o status de carregamento do dispositivo. Salve este URI para uso com outras APIs REST relacionadas.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.

Exemplo de resposta

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/batchJobStatus/beba2053-5401-46ff-9223-7e841ed78fbf
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2017 20:35:35 GMT

Partilhar via