取得出貨標籤
使用這個方法來擷取特定產品提交之特定出貨標籤的資料。
必要條件
如果您尚未這麼做，請先完成 Microsoft 硬體 API 的所有 必要條件 ，再嘗試使用這些方法。 您必須先在開發人員中心帳戶中存在產品與提交，才能使用這些方法。 若要建立或管理產品的提交，請參閱 管理產品提交中的方法。
要求
這個方法的語法如下。 請參閱下列各小節了解標頭和要求主體的使用範例和描述。
| 方法 | 要求 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/{shippingLabelId} |
要求標頭
| 標頭 | 類型 | Description |
|---|---|---|
| 授權 | 字串 | 必要。 Microsoft Entra識別碼存取權杖格式為Bearer * < token > *。 |
| accept | 字串 | 選擇性。 指定內容類型。 允許的值為 「application/json」 |
要求參數
這個方法的要求參數是選擇性的。
| 名稱 | 類型 | Description |
|---|---|---|
| includeTargetingInfo | boolean | 選擇性。 如果此參數設定為 true，則出貨標籤會傳回出貨標籤的目標詳細資料，例如硬體識別碼和 CHID。 如需詳細資訊，請參閱 目標物件。 |
要求本文
不提供此方法的要求主體。
要求範例
下列範例示範如何擷取註冊至您帳戶的特定產品相關資訊。
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964156/submissions/1152921504621467600/shippingLabels/1152921504606980300 HTTP/1.1
Authorization: Bearer <your access token>
回應
下列範例示範特定出貨標籤成功要求所傳回的 JSON 回應本文。 回應本文中值的詳細資料會出現在下列範例的表格中。
{
"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"
}
回應本文
如需回應本文的詳細資訊，請參閱 ShippingLabel 資源。
錯誤碼
如需錯誤碼的相關資訊，請參閱 錯誤碼。