Obter uma lista de lotes de dispositivo para o cliente especificado
Aplica-se a: Partner Center
Como recuperar uma coleção de lotes de dispositivos para o cliente especificado.
Cada lote de dispositivos contém informações de resumo status sobre dispositivos que foram registrados na implantação sem toque.
Pré-requisitos
Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Uma ID do cliente (
customer-tenant-id
). Se você não souber a ID do cliente, poderá pesquisá-la no Partner Center selecionando o workspace 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
).
C#
Para obter a coleção de lotes de dispositivo para o cliente especificado, primeiro chame o método IAggregatePartner.Customers.ById com a ID do cliente para recuperar uma interface para operações no cliente especificado. Em seguida, recupere o valor da propriedade DeviceBatches para obter uma interface para operações de coleta em lote do dispositivo. Por fim, chame o método Get ou GetAsync para recuperar a coleção.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
var devicesBatches =
partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.Get();
Exemplo: aplicativo de teste do console. Project: Classe de exemplos do SDK do Partner Center: GetDevicesBatches.cs
Solicitação REST
Sintaxe da solicitação
Método | URI da solicitação |
---|---|
GET | {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 | Type | Obrigatório | Descrição |
---|---|---|---|
id do cliente | string | Sim | Uma cadeia com formato de GUID que identifica o cliente. |
Cabeçalhos de solicitação
Para obter mais informações, confira Cabeçalhos REST do Partner Center.
Corpo da solicitação
Nenhum
Exemplo de solicitação
GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Resposta REST
Se tiver êxito, o corpo da resposta conterá a coleção de recursos DeviceBatch .
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 200 OK
Content-Length: 339
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 4a5002a2-0c1b-4e57-b491-dbcf19c0e7b8
MS-RequestId: 7b3e2e00-b330-4480-9d84-59ace713427f
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 17:52:41 GMT
{
"totalCount": 1,
"items": [{
"id": "Test batch",
"status": "finished",
"creationDate": "2017-07-25T01:51:00",
"devicesCount": 5,
"devicesLink": {
"uri": "/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches/Test batch/devices",
"method": "GET",
"headers": []
},
"attributes": {
"objectType": "DeviceBatch"
}
}
],
"attributes": {
"objectType": "Collection"
}
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de