De status ophalen van het uploaden van een apparaat-batch
Van toepassing op: Partnercentrum
De status van een batchupload van een apparaat voor een opgegeven klant ophalen.
Juiste rollen: globale beheerder | Beheerderagent | Verkoopagent
Vereisten
Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een klant-id (
customer-tenant-id
). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id
).De batchtracerings-id die wordt geretourneerd in de locatieheader toen de apparaatbatch werd verzonden. Zie Een lijst met apparaten uploaden voor de opgegeven klant voor meer informatie.
C#
Als u de status van een batchupload van een apparaat wilt ophalen, roept u eerst de methode IAggregatePartner.Customers.ById aan met de klant-id om een interface op te halen voor bewerkingen op de opgegeven klant. Roep vervolgens de methode BatchUploadStatus.ById aan met de batchtracerings-id om een interface op te halen voor batchuploadstatusbewerkingen. Roep tot slot de methode Get of GetAsync aan om de status op te halen.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedTrackingId;
var status =
partnerOperations.Customers.ById(selectedCustomerId).BatchUploadStatus.ById(selectedTrackingId).Get();
Voorbeeld: consoletest-app. Project: Voorbeeldklasse Partner Center SDK: GetBatchUploadStatus.cs
REST-aanvraag
Aanvraagsyntaxis
Methode | Aanvraag-URI |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/batchJobStatus/{batchtracking-id} HTTP/1.1 |
URI-parameter
Gebruik de volgende padparameters bij het maken van de aanvraag.
Naam | Type | Vereist | Beschrijving |
---|---|---|---|
klant-id | string | Ja | Een tekenreeks met GUID-indeling die de klant identificeert. |
batchtracking-id | string | Ja | Een id met GUID-indeling die wordt gebruikt om de uploadstatus van een apparaatbatch op te halen. Deze id wordt geretourneerd in de locatieheader wanneer de apparaatbatch is verzonden. |
Aanvraagheaders
Zie Rest-headers in Partnercentrum voor meer informatie.
Aanvraagtekst
None
Aanvraagvoorbeeld
GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/batchjobstatus/0127ed8e-ff72-4983-a3d8-e8d8bd378932 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
REST-antwoord
Als dit lukt, bevat het antwoord een BatchUploadDetails-resource .
Geslaagde antwoorden en foutcodes
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.
Responsvoorbeeld
HTTP/1.1 200 OK
Content-Length: 400
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
{
"batchTrackingId": "0127ed8e-ff72-4983-a3d8-e8d8bd378932",
"status": "finished",
"startedTime": "2017-07-25T10:00:00",
"completedTime": "2017-07-25T10:10:00",
"devicesStatus": [{
"serialNumber": "1234567890",
"productKey": "12345-67890-09876-54321-13579",
"status": "finished_with_errors",
"errorCode": "808",
"errorDescription": "ZtdDeviceAssignedToOtherTenant",
"attributes": {
"objectType": "DeviceUploadDetails"
}
}
],
"attributes": {
"objectType": "BatchUploadDetails"
}
}