Microsoft Hardware API에서 이 메서드를 사용하여 배송 레이블을 업데이트합니다. 이 메서드를 사용하기 전에 배송 레이블을 이미 만들었는지 확인합니다. 배송 레이블을 만드는 방법에 대한 자세한 내용은 새 배송 레이블 만들기를 참조하세요.
사전 요구 사항
아직 수행하지 않은 경우 이러한 메서드를 사용하기 전에 Microsoft 하드웨어 API에 대한 모든 필수 조건을 완료합니다.
요청
이 메서드에는 다음 구문이 있습니다. 이 항목의 다른 섹션에서는 헤더 및 요청 본문에 대한 사용 예제와 설명을 제공합니다.
| 메서드 | 요청 URI |
|---|---|
| 패치 | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/shippingLabels/{shippingLabelId} |
메서드의 productID, submissionID 및 shippingLabelID 는 업데이트할 제품, 제출 및 배송 레이블을 나타냅니다.
요청 헤더
| 헤더 | 형식 | Description |
|---|---|---|
| 권한 부여 | 문자열 | 필수 사항입니다. 전달자토큰 형식의 Microsoft Entra ID 액세스 토큰>입니다<. |
| 동의함 | String | 선택 사항입니다. 콘텐츠 형식을 지정합니다. 허용되는 값은 "application/json"입니다. |
요청 매개 변수
이 메서드에 대한 요청 매개 변수를 제공하지 마세요.
요청 본문
다음 예제에서는 배송 레이블에 대한 JSON 요청 본문을 보여 줍니다. 배송 레이블에 대해 다음과 같은 유형의 변경만 수행할 수 있습니다.
- 하드웨어 ID 추가
- 하드웨어 ID 제거/만료
- CHID 추가
- CHID 제거
- 대상 그룹 추가
- 대상 그룹 업데이트/제거
- 변경 내용에 대한 비즈니스 근거 제공
{
"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"
}
}
요청의 필드에 대한 자세한 내용은 ShippingLabel 리소스를 참조하세요.
주의할 사항:
CHID 또는 HardwareID를 업데이트할 때 작업에 대한 값을 제공해야 합니다.
대상 그룹은 업데이트 전용 필드입니다. 이 필드에 값을 제공하면 이전 값이 덮어씁니다. 값을 비워 두면 이전 값이 제거됩니다.
organization 대상 그룹 목록을 가져오는 방법을 알아보려면 대상 그룹 가져오기를 참조하세요.
하드웨어 ID 개체는 배송 레이블을 업데이트할 때 번들 ID, PNP ID, OS 코드 및 INF 이름의 유효한 조합을 포함해야 합니다. 제출(패키지)에 대해 이러한 특성의 유효하고 허용된 조합을 얻으려면 제출 세부 정보를 가져올 때 드라이버 메타데이터 파일(링크로 제공)을 다운로드합니다. 자세한 내용은 드라이버 패키지 메타데이터를 참조하세요.
요청 예제
다음 예제에서는 배송 레이블을 업데이트하는 방법을 보여 줍니다.
PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964156/submissions/1152921504621467600/shippingLabels/1152921504606980300 HTTP/1.1
Authorization: Bearer <your access token>
응답
응답은 HTTP 상태 204로 비어 있습니다.
이 단계가 끝나면 배송 레이블 가져오기의 메서드를 사용하여 배송 레이블 의 업데이트된 세부 정보를 가져옵니다.
오류 코드
오류 코드에 대한 자세한 내용은 오류 코드를 참조하세요.