De status van een apparatenbatch-upload ophalen

Artikel
03/07/2025

Van toepassing op: Partnercentrum

De status van een batchupload van een apparaat voor een opgegeven klant verkrijgen.

Juiste rollen: Beheerdersagent | Verkoopagent

Vereisten

Referenties zoals beschreven in authenticatie van het 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 Location-header wanneer de apparaatbatch werd ingediend. 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: Partnercentrum SDK Voorbeelden Klasse: GetBatchUploadStatus.cs

REST-aanvraag

Aanvraagsyntaxis

Wijze	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.

Name	Type	Vereist	Beschrijving
klant-id	tekenreeks	Ja	Een tekenreeks met GUID-formaat die de klant identificeert.
batchtracking-id	tekenreeks	Ja	Een id met GUID-indeling die wordt gebruikt om de uploadstatus van een apparaatbatch op te halen. Deze ID wordt geretourneerd in de Location-header wanneer de apparaatbatch succesvol is ingediend.

Aanvraagheaders

Meer informatie vindt u in de Partner Center REST headers.

Aanvraagtekst

Geen

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-antwoord

Als dit lukt, bevat het antwoord een BatchUploadDetails-resource .

Geslaagde antwoorden en foutcodes

Elke respons komt met een HTTP-statuscode die aangeeft of de operatie is geslaagd of mislukt, en aanvullende informatie voor foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partnercentrum REST-foutcodes voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Content-Length: 400
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
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"
    }
}

Delen via