배송 레이블 가져오기
이 메서드를 사용하여 특정 제품 제출의 특정 배송 레이블에 대한 데이터를 검색합니다.
사전 요구 사항
아직 수행하지 않은 경우 이러한 메서드를 사용하기 전에 Microsoft 하드웨어 API에 대한 모든 필수 구성 요소를 완료합니다. 이러한 방법을 사용하려면 먼저 제품 및 제출이 개발자 센터 계정에 이미 있어야 합니다. 제품에 대한 제출을 만들거나 관리하려면 제품 제출 관리의 방법을 참조 하세요.
요청
이 메서드에는 다음 구문이 있습니다. 헤더 및 요청 본문의 사용 예제와 설명은 다음 섹션을 참조하세요.
| 방법 | 요청 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/{shippingLabelId} |
요청 헤더
| 헤더 | 형식 | 설명 |
|---|---|---|
| 권한 부여 | string | 필수 사항입니다. 전달자 *<토큰*형식의 Microsoft Entra ID 액세스 토큰>입니다. |
| accept | 문자열 | (선택 사항) 콘텐츠 형식을 지정합니다. 허용되는 값은 "application/json"입니다. |
요청 매개 변수
요청 매개 변수는 이 메서드에 대한 선택 사항입니다.
| Name | 형식 | Description |
|---|---|---|
| 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 리소스를 참조하세요.
오류 코드
오류 코드에 대한 자세한 내용은 오류 코드를 참조하세요.