AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Marketplace API 참조](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 버전 제한
카탈로그 API를 사용하여 기계 학습 제품의 버전을 제한할 수 있습니다 AWS Marketplace. 제한되면 새 구매자는 해당 버전에 액세스할 수 없습니다. 기존 구독자는 제한된 버전에 액세스할 수 있습니다. AWS Marketplace 지침에 따라 제한 후 90일 동안 기존 구매자에 대한 지속적인 지원이 필요합니다.
**중요**
하나 이상의 무제한 버전을 사용할 수 있어야 합니다. 제품의 마지막 공개 버전을 제한할 수 없습니다.
**버전을 제한하려면:**
+ 버전을 제한하려면 `RestrictDeliveryOptions` 변경 유형으로 `StartChangeSet` 작업을 호출합니다.
## 요청 구문
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "RestrictDeliveryOptions",
"Entity":
{
"Identifier": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
"Type": "MachineLearningProduct@1.0"
},
"DetailsDocument":
{
"DeliveryOptionIds":
[
"{{example1-2222-cccc-2222-cccccccccccc}}"
]
}
}
]
}
```
## 필수 필드
**필수 필드**
+ `Entity` (객체) - 필수
ML 제품에 대한 정보를 포함합니다.
+ `Identifier` (문자열) - 필수
제품 ID입니다. 자세한 내용은 [식별자](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)를 참조하세요.
+ `Type` (문자열) - 필수
전송 방법(제품 유형)을 지정합니다. 반드시 `MachineLearningProduct@1.0`이어야 합니다.
+ `DetailsDocument` (객체) - 필수
업데이트된 버전 정보를 포함합니다.
+ `DeliveryOptionIds` (객체 배열) - 필수
제한하려는 버전의 DeliveryOption IDs. 제한하려는 버전에서 DescribeEntity 작업을 호출하여 각 DeliveryOption의 고유 식별자를 검색합니다.
## 응답 구문
요청이 성공하면 다음을 반환합니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
1. 검증: 시스템에서 모든 정보가 AWS Marketplace 지침을 충족하는지 확인합니다.
+ 처리 시간: 몇 분에서 몇 시간
+ 검증 오류는 [변경 세트 상태 및 오류를](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors) 참조하세요.
1. 상태 모니터링: 요청의 상태를 두 가지 방법으로 확인할 수 있습니다.
+ AWS Marketplace 관리 포털을 통해
+ `DescribeChangeSet` 작업 사용
1. 완료: 승인되면 새 버전이 제한됩니다.
## 오류
**비동기 오류**
변경 세트 처리 중에 다음 오류가 발생할 수 있으며 `DescribeChangeSet` 작업을 사용하여 검색할 수 있습니다.
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_PRODUCT\_STATUS | 기존 퍼블릭 또는 제한된 제품 사용 |
| MISSING\_DELIVERY\_OPTION\_IDS | 기존 IDs 목록에서 전송 옵션을 제공합니다. |
| INVALID\_DELIVERY\_OPTION\_IDS | 제품에서 찾을 수 있는 전송 옵션 IDs를 제공합니다. IDs 찾을 수 없음: [x] |
| INVALID\_DELIVERY\_OPTION\_STATUS | [invalid\_ids] 전송 옵션 IDs가 잘못되었습니다. 퍼블릭 상태에서 전송 옵션을 제공합니다. |
| ALL\_DELIVERY\_OPTIONS\_RESTRICTED | 하나 이상의가 퍼블릭 상태로 유지되어야 하므로 제한할 전송 옵션을 더 적게 제공합니다. |