Abrufen eines Versandetiketts
Verwenden Sie diese Methode, um Daten für ein bestimmtes Versandetikett einer bestimmten Übermittlung eines Produkts abzurufen.
Voraussetzungen
Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft-Hardware-APIs erfüllen, bevor Sie versuchen, eine dieser Methoden zu verwenden. Bevor Sie diese Methoden verwenden können, müssen das Produkt und die Übermittlung bereits in Ihrem Dev Center-Konto vorhanden sein. Informationen zum Erstellen oder Verwalten von Übermittlungen für Produkte finden Sie unter Verwalten von Produktübermittlungen.
Anforderung
Diese Methode hat die folgende Syntax. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Header und Anforderungstexts.
| Methode | Anforderungs-URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/{shippingLabelId} |
Anforderungsheader
| Header | type | BESCHREIBUNG |
|---|---|---|
| authorization | Zeichenfolge | Erforderlich. Die Microsoft Entra ID-Zugriffstoken im Format Bearer *<token>*. |
| accept (Akzeptieren) | Zeichenfolge | Optional. Gibt den Typ des Inhalts an. Zulässiger Wert ist "application/json" |
Anforderungsparameter
Anforderungsparameter sind für diese Methode optional.
| Name | Typ | BESCHREIBUNG |
|---|---|---|
| includeTargetingInfo | boolean | Optional. Wenn dieser Parameter auf true festgelegt ist, gibt das Versandetikett die Zieldetails des Versandetiketts zurück, z. B. Hardware-IDs und CHIDs. Weitere Informationen finden Sie unter Targeting-Objekt. |
Anforderungstext
Stellen Sie keinen Anforderungstext für diese Methode bereit.
Anforderungsbeispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie Informationen zu einem bestimmten Produkt abrufen, das in Ihrem Konto registriert ist.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964156/submissions/1152921504621467600/shippingLabels/1152921504606980300 HTTP/1.1
Authorization: Bearer <your access token>
Antwort
Im folgenden Beispiel wird der JSON-Antworttext veranschaulicht, der von einer erfolgreichen Anforderung für eine bestimmte Versandbezeichnung zurückgegeben wird. Details zu den Werten im Antworttext werden in der Tabelle nach dem Beispiel angezeigt.
{
"id": 1152921504606978300,
"productId": 14461751976964156,
"submissionId": 1152921504621467600,
"publishingSpecifications": {
"goLiveDate": "2018-04-12T05:28:32.721Z",
"visibleToAccounts": [
27691110,
27691111
],
"isAutoInstallDuringOSUpgrade": true,
"isAutoInstallOnApplicableSystems": true,
"isDisclosureRestricted": false,
"publishToWindows10s": false,
"additionalInfoForMsApproval": {
"microsoftContact": "abc@mcirosoft.com",
"validationsPerformed": "Validation 1",
"affectedOems": [
"OEM1",
"OEM2"
],
"isRebootRequired": false,
"isCoEngineered": true,
"isForUnreleasedHardware": true,
"hasUiSoftware": false,
"businessJustification": "This is a business justification"
}
},
"targeting": {
"hardwareIds": [
{
"bundleId": "amd64",
"infId": "foo.inf",
"operatingSystemCode": "WINDOWS_v100_SERVER_X64_RS5_FULL",
"pnpString": "hid\\vid_dummy256f&pid_dummyc62f",
"distributionState": "pendingAdd"
},
{
"bundleId": "amd64",
"infId": "foo.inf",
"operatingSystemCode": "WINDOWS_v100_RS2_FULL",
"pnpString": "hid\\vid_dummy256f&pid_dummyc62f",
"distributionState": "pendingAdd"
}
],
"chids": [
{
"chid": "346511cf-ccee-5c6d-8ee9-3c70fc7aae83",
"distributionState": "pendingAdd"
}
],
"restrictedToAudiences": [
"00000000-0000-0000-0000-000000000000",
"00000000-0000-0000-0000-000000000001"
],
"inServicePublishInfo": {
"flooring": "RS1",
"ceiling": "RS3"
},
"coEngDriverPublishInfo": {
"flooringBuildNumber": 17135,
"ceilingBuildNumber": 17139
}
},
"workflowStatus": {
"currentStep": "microsoftApproval",
"state": "started",
"messages": []
},
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978459",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978459",
"rel": "update_shippinglabel",
"method": "PATCH"
}
],
"name": "VR_RS4Build_DualPublishCheck",
"destination": "windowsUpdate"
}
Antworttext
Ausführliche Informationen zum Antworttext finden Sie unter ShippingLabel-Ressource.
Fehlercodes
Informationen zu Fehlercodes finden Sie unter Fehlercodes.