配送先住所ラベルの取得
このメソッドを使用すると、製品の特定の申請の特定の配送先住所ラベルに関するデータを取得できます。
前提条件
Microsoft ハードウェア API に関するすべての前提条件がまだ満たされていない場合は、ここに記載されているメソッドを使用する前に前提条件を整えてください。 これらのメソッドを使用するには、自分のデベロッパー センター アカウントに、製品および申請が既に存在している必要があります。 製品申請を作成または管理するには、製品申請の管理をご覧ください。
要求
このメソッドの構文は次のとおりです。 ヘッダーと要求本文の使用例と説明については、次のセクションをご覧ください。
認証方法 | 要求 URI |
---|---|
GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/{shippingLabelId} |
要求ヘッダー
Header | 型 | 説明 |
---|---|---|
承認 | string | 必須。 Bearer *<token>* 形式の Microsoft Entra ID アクセス トークン。 |
accept | string | 省略可能。 コンテンツの種類を指定します。 使用できる値は "application/json" です |
要求パラメーター
このメソッドでは、要求パラメーターはオプションです。
名前 | 種類 | 説明 |
---|---|---|
includeTargetingInfo | boolean | 省略可能。 このパラメーターが true に設定されている場合は、配送先住所ラベルで、配送先住所ラベルのターゲットの詳細が返されます (ハードウェア ID や 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 リソース」をご覧ください。
エラー コード
エラー コードについて詳しくは、「Error codes (エラー コード)」をご覧ください。