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