AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Marketplace API 참조](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 요금 조건 업데이트
카탈로그 API를 사용하여에서 기계 학습 제품의 요금을 업데이트할 수 있습니다 AWS Marketplace.
**참고**
기계 학습 제품의 지원되는 모든 인스턴스 유형의 가격을 책정해야 합니다. 첫 번째 버전을 생성할 때 `UpdatePricingTerms` 및는 제품을 게시하기 위해 지원되는 모든 인스턴스 유형에 대한 요금으로 유형을 `AddDeliveryOptions` 변경합니다. 이전에 지원되지 않은 새 인스턴스 유형이 있는 기존 제품에 새 버전을 추가할 때는 `UpdatePricingTerms` 및 `AddDeliveryOptions` 변경 유형에 해당 인스턴스 유형을 포함해야 합니다.
요금 조건을 업데이트하려면 `UpdatePricingTerms` 변경 유형으로 `StartChangeSet` 작업을 호출합니다.
## 요청 구문
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "ml.m4.4xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "ml.m5.4xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.16xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "m.i.c",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.4xlarge.a.t",
"Price": 0.1
},
{
"DimensionKey": "ml.m5.4xlarge.a.t",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.16xlarge.a.t",
"Price": 0.1
}
]
}
]
},
{
"Type": "FreeTrialPricingTerm",
"Duration": "P30D",
"Grants": [
{
"DimensionKey": "ml.m4.4xlarge.m.i.b"
},
{
"DimensionKey": "ml.m5.4xlarge.m.i.b"
},
{
"DimensionKey": "ml.m4.16xlarge.m.i.b"
},
{
"DimensionKey": "m.i.c"
},
{
"DimensionKey": "ml.m4.4xlarge.a.t"
},
{
"DimensionKey": "ml.m5.4xlarge.a.t"
},
{
"DimensionKey": "ml.m4.16xlarge.a.t"
}
]
}
]
}
},
]
}
```
## 필수 필드
+ `Entity` (객체) (필수) - ML 제품의 제안에 대한 정보를 포함합니다.
+ `Identifier` (문자열)(필수) - 요금 조건을 업데이트하려는 제안 ID입니다. 자세한 내용은 [식별자](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)를 참조하세요.
+ `Type` (문자열)(필수) - 요금을 업데이트`Offer@1.0`하려면가 여야 `Type` 합니다.
+ `DetailsDocument` (객체)(필수) - 기계 학습 제품의 요금 조건에 대한 세부 정보입니다.
+ `PricingModel` (문자열)(필수) - 제품의 요금 모델 - 사용량, 무료 및 계약(프라이빗 제안의 경우) 중에서 선택할 수 있습니다. 자세한 내용은 [Machine Learning 제품 요금을](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-pricing.html) 참조하세요.
+ `Terms` (객체 배열) - 제품의 전체 요금을 집합적으로 정의하는 요금 조건 배열입니다.
+ `Type` (문자열)(필수) - 요금 조건의 유형입니다. 유효한 옵션은 `UsageBasedPricingTerm` 또는 `FreeTrialPricingTerm` 또는 입니다`FixedUpfrontPricingTerm`(프라이빗 제안의 경우).
+ `CurrencyCode` (문자열) ( `UsageBasedPricingTerm` 또는 `FixedUpfrontPricingTerm` - 요금 기간의 통화에 필요합니다. 유효한 값은 `USD`입니다.
+ `RateCards` (객체 배열)(의 경우 필수`UsageBasedPricingTerm`) - 기계 학습 제품의 요금을 정의하는 비율 카드입니다. 이 배열에는 하나`RateCard`만 포함해야 합니다.
+ `RateCard` (객체 배열) - 기계 학습 제품의 차원 및 비율 배열입니다. 제품을 게시하려면 지원되는 모든 인스턴스 유형의 가격이 책정되어야 합니다.
+ `DimensionKey` - 요금을 책정하는 차원입니다. 유효한 차원 키는 다음과 같습니다.
+ 인스턴스 유형 다음에 시간당 요금에 대한 작업이 옵니다.
+ 인스턴스 유형은 로 시작하고 그 `ml` 뒤에 인스턴스 이름과 크기가 옵니다. exampole의 경우 `ml.m4.xlarge`
+ 작업은 `m.i.b` 배치 변환, `m.i.r` 시간당 실시간 추론 및 알고리즘 훈련`a.t`에 사용됩니다.
+ 예: `ml.m4.4xlarge.m.i.b` 배치 변환, `ml.m4.xlarge.m.i.r` 실시간 추론 또는 `ml.m4.16xlarge.a.t` 알고리즘 훈련
+ `m.i.c` 추론당 실시간 요금.
+ `Price` - 차원 속도입니다. 요금은 dimensionKey에 따라 시간당 또는 추론당입니다.
+ `Duration` (문자열) ( `FreeTrialPricingTerm` 또는 `FixedUpfrontPricingTerm` - 무료 평가판 또는 계약 기간. 무료 평가판의 경우 유효한 값은 X에서 Y 사이입니다. 계약의 경우 유효한 값은 X에서 Y 사이입니다.
+ 권한 부여(객체 배열) - 무료 평가판을 사용할 수 있는 dimensionKeys에 대한 세부 정보입니다. 지원되는 모든 dimensionKeys 제공해야 합니다.
+ DimensionKey - 무료 평가판 제안의 일부로 포함할 차원입니다.
+ 인스턴스 유형 다음에 시간당 요금에 대한 작업이 옵니다.
+ 인스턴스 유형은 로 시작하고 그 `ml` 뒤에 인스턴스 이름과 크기가 옵니다. 예: `ml.m4.xlarge`
+ 작업은 `m.i.b` 배치 변환, `m.i.r` 시간당 실시간 추론 또는 알고리즘 훈련을 `a.t` 위한 것입니다.
+ 예: `ml.m4.4xlarge.m.i.b` 배치 변환, `ml.m4.xlarge.m.i.r` 실시간 추론 또는 `ml.m4.16xlarge.a.t` 알고리즘 훈련
+ `m.i.c` 추론당 실시간 요금.
## 응답 구문
요청이 성공하면 다음을 반환합니다.
```
{
"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` 작업을 사용하여 `UpdatePricingTerms` 작업에 대한 특정 오류를 검색할 수 있습니다. 오류 세부 정보 및 문제 해결은 [ 변경 세트 상태 및 오류를](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets) 참조하세요.
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_PRODUCT\_STATUS | 기존의 제한 또는 공개 제품을 사용합니다. |