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

Artigo
03/04/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 dispositivo para registro na implantação sem toque e associa os dispositivos e o lote de dispositivos ao cliente especificado.

Pré-requisitos

Credenciais, conforme descrito em Autenticação do Partner Center. Este cenário dá suporte à autenticação com credenciais de aplicativo + usuário. Siga o modelo de aplicativo seguro ao usar a autenticação App+User com APIs do Partner Center.
Uma ID do cliente (customer-tenant-id). Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando o espaço de trabalho Clientes, 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 é igual à 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:
- Chave do Produto HardwareHash + .
- HardwareHash + SerialNumber.
- HardwareHash + ProductKey + SerialNumber.
- Somente HardwareHash .
- Somente ProductKey .
- SerialNumber + OemManufacturerName + ModelName.
Instancie um objeto DeviceBatchCreationRequest e defina a propriedade BatchId como um nome exclusivo de sua escolha e a propriedade Devices como a lista de dispositivos a serem carregados.
Processe a solicitação de criação em lote de dispositivo chamando o método IAggregatePartner.Customers.ById com o identificador de 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: Exemplos de SDK do Partner Center Classe: CreateDeviceBatch.cs

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
POST	{baseURL}/v1/customers/{customer-id}/deviceBatches HTTP/1.1

Parâmetro do URI

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

Nome	Digitar	Obrigatória	Descrição
id do cliente	string	Sim	Uma cadeia com formato de GUID que identifica o cliente.

Cabeçalhos da solicitação

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

Corpo da solicitação

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: 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"
    }
}

Importante

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

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

Resposta REST

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

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira 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: 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

Share via