Aktualisieren eines Versandetiketts
Verwenden Sie diese Methode in der Microsoft-Hardware-API , um ein Versandetikett zu aktualisieren. Bevor Sie diese Methode verwenden, stellen Sie sicher, dass Sie bereits ein Versandetikett erstellt haben. Weitere Informationen zum Erstellen eines Versandetiketts finden Sie unter Erstellen eines neuen Versandetiketts.
Voraussetzungen
Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft-Hardware-APIs erfüllen, bevor Sie eine dieser Methoden verwenden.
Anforderung
Diese Methode hat die folgende Syntax. Die anderen Abschnitte in diesem Thema enthalten Verwendungsbeispiele und Beschreibungen des Headers und des Anforderungstexts.
| Methode | Anforderungs-URI |
|---|---|
| PATCH | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId} |
Die productID, submissionID und shippingLabelID in der Methode stellen das Produkt, die Übermittlung und das Versandetikett dar, das aktualisiert werden soll.
Anforderungsheader
| Header | type | BESCHREIBUNG |
|---|---|---|
| Authorization | String | Erforderlich. Der Microsoft Entra ID-Zugriffstoken im Format Bearertoken<>. |
| Akzeptieren | String | Optional. Gibt den Typ des Inhalts an. Zulässiger Wert ist "application/json" |
Anforderungsparameter
Geben Sie keine Anforderungsparameter für diese Methode an.
Anforderungstext
Im folgenden Beispiel wird der JSON-Anforderungstext für ein Versandetikett veranschaulicht. An einem Versandetikett können nur die folgenden Arten von Änderungen vorgenommen werden:
- Hinzufügen von Hardware-IDs
- Entfernen/Ablaufen von Hardware-IDs
- Hinzufügen von CHIDs
- Entfernen von CHIDs
- Hinzufügen einer Zielgruppe
- Aktualisieren/Entfernen der Zielgruppe
- Geben Sie die geschäftliche Begründung für die Änderungen an.
{
"targeting": {
"chids": [
{
"action": "add",
"chid": "812fac65-9c26-473c-b3a9-1eb3803ac22c"
},
{
"action": "remove",
"chid": "aed6336d-0958-444c-89b6-bf471191d6f0"
}
],
"hardwareIds": [
{
"action": "remove",
"bundleId": "a2dfbcd8-1d4a-4885-90a3-2ac8360542da",
"infId": "foo.inf",
"operatingSystemCode": "WINDOWS_v100_X64_RS3_FULL",
"pnpString": "pci\\ven_8086&dev_5a85"
},
{
"action": "add",
"bundleId": "48140805-45a3-4a76-8818-e75c117adba9",
"infId": "foo.inf",
"operatingSystemCode": "WINDOWS_v100_X64_RS3_FULL",
"pnpString": "pci\\ven_8086&dev_5a85"
}
],
"restrictedToAudiences": [
"00000000-0000-0000-0000-000000000000",
"00000000-0000-0000-0000-000000000001"
],
"inServicePublishInfo": {
"flooring": "RS1",
"ceiling": "RS3"
},
"businessJustification": "Business justification for updating shipping label"
}
}
Ausführliche Informationen zu den Feldern in der Anforderung finden Sie unter ShippingLabel-Ressource.
Beachten Sie Folgendes:
Sie müssen einen Wert für die Aktion angeben, wenn Sie CHIDs oder Hardware-IDs aktualisieren.
Die Zielgruppe ist ein Feld, das nur aktualisiert wird. Die Angabe eines Werts in diesem Feld überschreibt jeden vorherigen Wert. Wenn der Wert leer bleibt, wird der vorherige Wert entfernt.
Informationen zum Abrufen einer Liste von Zielgruppen für Ihre organization finden Sie unter Zielgruppe abrufen.
Das Hardware-ID-Objekt sollte beim Aktualisieren eines Versandetiketts eine gültige Kombination aus Bundle-ID, PNP-ID, Betriebssystemcode und INF-Namen enthalten. Um die gültigen, zulässigen Kombinationen dieser Attribute für Ihre Übermittlung (Paket) abzurufen, laden Sie die Treibermetadatendatei (als Link bereitgestellt) herunter, wenn Sie die Details einer Übermittlung erhalten. Weitere Informationen finden Sie unter Treiberpaketmetadaten.
Anforderungsbeispiele
Im folgenden Beispiel wird veranschaulicht, wie ein Versandetikett aktualisiert wird.
PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964156/submissions/1152921504621467600/shippingLabels/1152921504606980300 HTTP/1.1
Authorization: Bearer <your access token>
Antwort
Die Antwort ist mit dem HTTP-status 204 leer.
Verwenden Sie nach diesem Schritt die -Methode unter Abrufen eines Versandetiketts , um die aktualisierten Details des Versandetiketts abzurufen.
Fehlercodes
Weitere Informationen zu Fehlercodes finden Sie unter Fehlercodes.