AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Marketplace API 참조](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Marketplace APIs를 사용하여 채널 파트너 비공개 제안 작업
를 사용하여 채널 파트너 비공개 제안(CPPO) 작업을 자동화 AWS Marketplace Catalog API 할 수 있습니다.CPPOs
CPPO를 생성하거나 업데이트할 때 제안 초안에는 재판매 승인의 약관과 규칙이 포함되며 구매자가 볼 수 없습니다. 조직의 여러 페르소나를 참여시켜 비공개 제안을 생성할 수 있지만 필수는 아닙니다.
예를 들어 한 페르소나는 가격 업데이트를 담당하고 다른 페르소나는 결제 일정 업데이트를 담당할 수 있습니다. 그러면 세 번째 페르소나는 법률 용어를 업데이트할 책임이 있습니다. 페르소나에게 제안의 특정 부분을 업데이트할 수 있는 권한을 부여할 수 있습니다. 그러나 재판매 권한 부여에는 읽기 권한만 부여할 수 있습니다.
변경 유형을 호출하기 위한 사전 조건으로 하나 이상의 재판매 승인을 받고 작업을 숙지해야 합니다 AWS Marketplace Catalog API.
자세한 내용은 *AWS Marketplace 판매자 안내서*의 [ 채널 파트너 비공개 제안을](https://docs.aws.amazon.com/marketplace/latest/userguide/channel-partner-offers.html) 참조하세요.
다음 주제에서는 카탈로그 API를 사용하여 CPPOs를 생성하고 업데이트하는 방법을 설명합니다.
**Topics**
+ [CPPO 사전 조건](#cppo-prerequisites)
+ [CPPO 생성](#create-offer-using-resale-auth)
+ [채널 파트너 비공개 대체 제안 생성](#create-replacement-offer-using-resale-auth)
+ [마크업 업데이트](#update-markup)
+ [대상 지정 구성 업데이트](#update-targeting-cppo)
+ [법률 리소스 업데이트](#update-legal-terms-cppo)
+ [CPPO의 검색 가능성 업데이트](#update-availability-cppo)
+ [계약의 만료 날짜 정의](#update-validity-terms-cppo)
+ [요금 업데이트](#update-pricing-terms-cppo)
+ [결제 일정 세부 정보 업데이트](#update-payment-schedule-terms-cppo)
+ [CPPO 게시](#release-offer-cppo)
+ [기존 CPPO 정의](#describe-entity-cppo)
## CPPO 사전 조건
ResaleAuthorization(SLR) 설정을 위한 서비스 연결 역할은 재판매 권한 부여를 사용하여 CPPO를 생성하기 위한 필수 사전 조건입니다. 재판매 승인을 사용하려면 독립 소프트웨어 공급업체(ISVs)와 AWS Marketplace 채널 파트너 모두에 리소스 공유 권한을 제공하는 서비스 연결 역할을 생성해야 합니다 AWS. 두 그룹 모두이 사전 조건을 수행하지 않는 경우 AWS 는 ISV의 권한 부여 리소스를 AWS Marketplace 채널 파트너와 공유할 수 없습니다. 자세한 내용은 *AWS Marketplace 판매자 안내서*의에 [대한 재판매 권한 부여를 위한 역할 사용을 AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/userguide/using-roles-for-resale-authorization.html) 참조하세요.
## CPPO 생성
사용자를 대상으로 하는 재판매 권한 부여를 사용하여의 `Draft` 상태에서 채널 파트너 비공개 제안(CPPO)을 생성합니다 AWS Marketplace.
요청이 성공적으로 처리되면는 재판매 승인 조건을 사용하여 `Draft` 상태의 제안을 AWS Marketplace Catalog API 생성합니다. `DescribeEntity`를 사용하여 재판매 권한 부여의 초안 제안에 적용된 조건을 볼 수 있습니다. 이는 불완전한 제안이며에서 구매자에게 표시되지 않습니다 AWS Marketplace. 그런 다음 CPPO와 연결된 변경 유형을 사용하여 제안을 완료합니다.
제안이 완료되면 `ReleaseOffer` 변경 유형을 사용하여 제안 생성 프로세스를 완료하고 제안을 릴리스합니다. 이렇게 하면 전체 제안이 검증되고 구매자가 제안을 볼 수 있습니다 AWS Marketplace.
채널 파트너 비공개 제안을 생성하려면 다음 예제와 같이 `CreateOfferUsingResaleAuthorization` 변경 유형을 사용하여 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ResaleAuthorizationId": "resaleauthz-123456789",
"Name": "Test Offer",
"OfferSetId": "offerset-b3f9EXAMPLE27"
}
}
]
}
```
필드에 대한 정보를 제공하여 `CreateOfferUsingResaleAuthorization` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - CPPO.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`Offer@1.0`.
+ **DetailsDocument**(객체)(필수) - 요청 세부 정보의 JSON 값입니다.
+ **ResaleAuthorizationId**(문자열)(필수) - 제공되는 제품, 조건 및 규칙을 포함하는 고유 식별자입니다. 채널 파트너는 업데이트 변경 유형을 사용하여 추가 용어 및 규칙을 추가할 수 있습니다. ResaleAuthorization을 사용할 수 있어야 하며 파트너로 지정해야 합니다.
+ **이름**(문자열)(선택 사항) - 가독성을 높이기 위해 제안과 연결된 이름입니다. 계약 정보의 일부로 표시됩니다.
+ **OfferSetId**(문자열)(선택 사항) -이 제안을 연결할 제안 세트의 ID입니다. 제안 세트의 일부가 될 제안을 생성할 때만이 필드를 지정합니다. OfferSetId를 제공하지 않으면 독립 실행형으로 구매할 수 있는 개별 제안이 생성됩니다. 제안 생성 중에 OfferSetId를 지정하는 것은 제안을 해당 제안 세트와 연결하려는 의도만 나타냅니다. 연결을 완료하려면 제안이 생성된 후 [ AssociateOffers 변경 유형을 사용해야](work-with-offer-sets.md#associate-offers) 합니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `ChangeSetArn` 대한 `ChangeSetId` 및를 제공하며 다음과 같습니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
변경 요청이 대기열에 추가되고 처리됩니다.
를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API를 통해 직접 요청 상태를 확인할 수 있습니다.
이 요청에 대한 응답은 요청 상태를 제공합니다. 상태가 이면 `SUCCEEDED`새 `OfferId`이 생성됩니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef",
"ChangeSetName": "Submitted by 123456789012",
"StartTime": "2021-05-27T22:21:26Z",
"EndTime": "2021-05-27T22:32:19Z",
"Status": "SUCCEEDED",
"ChangeSet": [
{
"ChangeType": "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"ResaleAuthorizationId": "resaleauthz-123456789",
"Name": "Test Offer"
},
"ErrorDetailList": []
}
]
}
```
`GET` `DescribeEntity` 요청을 사용하여 AWS Marketplace Catalog API 참조의 `ResaleAuthorization`에서 생성된 제안 규칙 및 조건 초안을 설명할 수 있습니다. 자세한 내용은 [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html) 단원을 참조하십시오.
**ResaleAuthorization의 용어 및 규칙**
+ **LegalTerms** - ResaleAuthorization의 EULA와 같은 법적 조건을 설명하는 조항이 초안 제안에 추가됩니다. `UpdateLegalTerms` 변경 유형을 사용하여 법률 용어를 추가할 수 있습니다. 자세한 내용은 [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-legal-terms-cppo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-legal-terms-cppo) 단원을 참조하십시오.
+ **PricingTerms** - ResaleAuthorization에서 제조업체가 설명하는 모든 요금 조건(`ConfigurableUpfrontPricingTerm`, `FixedUpfrontPricingTerm`, `UsageBasedPricingTerm`, `PaymentScheduleTerms`)이 초안 제안에 추가됩니다. `UpdateMarkup` 변경 유형을 사용하여 대상 구매자의 요금(각 차원에 대해)을 늘리도록 선택할 수 있습니다. 자세한 내용은 이 안내서의 [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-markup](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-markup) 섹션을 참조하세요.
+ **PaymentTerms** - 제조업체가 ResaleAuthorization에서 향후 결제 일정을 정의한 경우 초안 제안에서 결제 조건을 볼 수 있습니다. `UpdateMarkup` 변경 유형을 사용하여 대상 구매자의 결제 일정 금액을 늘리도록 선택할 수 있습니다. 구매자의 결제 일정을 설정하려면를 사용할 수 있습니다`UpdatePaymentScheduleTerms`. 자세한 내용은 [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-payment-schedule-terms-cppo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-payment-schedule-terms-cppo) 단원을 참조하십시오.
+ **TargetingRule** - ResaleAuthorization이 특정 구매자를 대상으로 하는 경우 채널 파트너는 PositiveTargeting을 사용하여 일부 구매자에게 비공개 제안을 제공할 수 있습니다. 기본적으로이 규칙은 ResaleAuthorization의 모든 구매자를 포함합니다. `UpdateTargeting` 변경 유형을 사용하여 특정 구매자를 선택하고 초안 제안을 업데이트할 수 있습니다. 자세한 내용은 [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-targeting-cppo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/cppos.html#update-targeting-cppo) 단원을 참조하십시오.
```
{
"EntityType": "Offer@1.0",
"EntityIdentifier": "offer-a5EXAMPLEwzpu@1",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:444555666777:AWSMarketplace/Offer/offer-a5oEXAMPLEzpu",
"LastModifiedDate": "2021-03-10T21:57:16Z",
"DetailsDocument": {
"Id": "offer-3rb23tu92rn",
"Name": "Test Offer",
"Description": "Worldwide private offer for Test Product",
"ProductId": "prod-0bc848d78b51",
"ResaleAuthorizationId": "resaleauthz-123456789",
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "300.00"
},
{
"DimensionKey": "m4.xlarge",
"Price": "400.00"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "0.10"
},
{
"DimensionKey": "m4.xlarge",
"Price": "0.20"
}
]
}
]
},
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2020-12-01T00:00:00.000Z",
"ChargeAmount": "1000.00"
},
{
"ChargeDate": "2021-06-15T00:00:00.000Z",
"ChargeAmount": "1250.00"
}
]
}
],
"Rules": [
{
"Type": "TargetingRule",
"PositiveTargeting": {
"BuyerAccounts": [
"111222333444"
]
}
}
]
}
}
```
**동기 검증**
다음 스키마 검증은의 `CreateOfferUsingResaleAuthorization` 작업에 따라 다릅니다 AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP 코드 |
| --- | --- | --- |
| 이름 | 필수
길이는 1\~150자여야 합니다. | 422 |
| 설명 | 필수
길이는 1\~255자여야 합니다. | 422 |
| ResaleAuthorizationId | 필수
길이는 1\~50자여야 합니다. | 422 |
| ResaleAuthorizationId | ResaleAuthorization은 채널 파트너를 대상으로 해야 합니다. | 422 |
| ResaleAuthorizationId | ResaleAuthorization이 활성화되어 있어야 합니다. | 422 |
| 채널 파트너 | 채널 파트너는에서 유료 판매자여야 합니다. AWS Marketplace | 422 |
**비동기 오류**
다음 오류는의 `CreateOfferUsingResaleAuthorization` 작업에만 해당됩니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | 활성 상태에서 ResaleAuthorization을 사용합니다. |
| INCOMPATIBLE\_PRODUCT | 제품 제안에서는 OfferSetId가 지원되지 않습니다. |
## 채널 파트너 비공개 대체 제안 생성
카탈로그 API를 사용하여에서 채널 파트너 비공개 대체 제안을 생성할 수 있습니다 AWS Marketplace.
다음 예제와 같이 사용자 `ResaleAuthorization` 대상과 제안자인 계약을 사용하여 `CreateReplacementOfferUsingResaleAuthorization` 변경 유형`StartChangeSet`으로를 호출하여 카탈로그 API에서 채널 파트너 비공개 대체 제안을 `Draft` 상태의 상태로 생성합니다. 대체 제안은 종료되기 전에 이전 제안의 계약을 대체하는 데 사용할 수 있습니다.
`CreateReplacementOfferUsingResaleAuthorization`는 대상 지정 시 계약 수락자와 함께 초안 제안을 생성합니다. 이 대상 지정은 나중에 변경할 수 없습니다. 초안 제안에는 계약의 소스 제안 ID도 포함됩니다.
채널 파트너 비공개 대체 제안을 생성하려면 다음 예제와 같이 `CreateReplacementOfferUsingResaleAuthorization` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateReplacementOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ResaleAuthorizationId": "2bd2c761-3b7f-3771-a9a7-e8ad36517698",
"Name": "CAPI-saas-abo-contract-fps",
"AgreementId": "agmt-f2ooEXAMLEamtm7mjj0j59gu"
}
}
]
}
```
필드에 대한 정보를 제공하여 `CreateReplacementOfferUsingResaleAuthorization` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - CPPO.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`Offer@1.0`.
+ **DetailsDocument**(객체)(필수) - 요청 세부 정보의 JSON 값입니다.
+ **ResaleAuthorizationId**(문자열)(필수) - 제공되는 제품, 약관 및 규칙을 포함하는 `ResaleAuthorizationId` 고유 식별자입니다. 채널 파트너는 변경 유형 업데이트를 사용하여 추가 용어 및 규칙을 추가할 수 있습니다.
`ResaleAuthorization`를 사용할 수 있고 파트너로 지정해야 합니다.
+ **이름**(문자열)(선택 사항) - 사용자와 고객의 가독성을 높이기 위해 제안과 `Name` 연결됩니다. 계약 정보의 일부로도 표시됩니다.
+ **AgreementId**(문자열)(필수) - 대상 구매자가 대체하려는 이전 제안을 수락할 때 생성된 계약의 고유 식별자`AgreementId`입니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `ChangeSetArn` 대한 `ChangeSetId` 및를 제공하며 다음과 같습니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
변경 요청이 대기열에 추가되고 처리됩니다.
를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은의 `CreateReplacementOfferUsingResaleAuthorization` 작업에 따라 다릅니다 AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 |
| --- | --- |
| 이름 | 길이는 1\~150자여야 합니다. |
| AgreementId | 제공된 계약이 활성 상태여야 합니다. 제공된 계약이 있어야 합니다.
제공된 계약은 채널 파트너가 소유해야 합니다. |
| ResaleAuthorizationId | 필수
길이는 1\~50자여야 합니다. |
| ResaleAuthorizationId | ResaleAuthorization은 채널 파트너를 대상으로 해야 합니다. |
| ResaleAuthorizationId | ResaleAuthorization이 활성화되어 있어야 합니다. |
| 채널 파트너 | 채널 파트너는에서 유료 판매자여야 합니다. AWS Marketplace |
**비동기 오류**
다음 오류는의 `CreateReplacementOfferUsingResaleAuthorization` 작업과 관련이 있습니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | 활성 상태에서 ResaleAuthorization을 사용합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | ResaleAuthorization은 계약과 연결된 동일한 제품에 대한 것이어야 합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | 계약 수락자를 대상으로 하는 ResaleAuthorization을 사용합니다. |
## 마크업 업데이트
카탈로그 API를 사용하여에서 제안의 백분율 값별로 요금 조건을 업데이트할 수 있습니다 AWS Marketplace.
이렇게 하면 제조업체가 ResaleAuthorization 부여에 정의한 모든 요금 조건 및 결제 조건(향후 결제 일정의 경우)에 지정된 백분율 마크업이 적용됩니다. 기존 마크업은 덮어씁니다. 를 사용하여 업데이트된 요금 및 결제 조건을 볼 수 있습니다`DescribeEntity`.
마크업을 업데이트하려면 다음 예제와 같이 `UpdateMarkup` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateMarkup",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Percentage": "5.0"
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdateMarkup` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - CPPO.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`Offer@1.0`.
+ **식별자**(문자열)(필수) - 제안 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청 세부 정보의 JSON 값입니다.
+ **백분율**(문자열)(필수) - 백분율 값이 제조업체 요금 또는 결제 조건에 추가됩니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `ChangeSetArn` 대한 `ChangeSetId` 및를 제공하며 다음과 같습니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace 판매자 운영 팀과 정보를 검증하여 지침을 충족하는 AWS Marketplace 지 확인하는 것이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간이 걸릴 수 있습니다.
를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은의 `UpdateMarkup` 작업에 따라 다릅니다 AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 |
| --- | --- |
| 백분율 | 필수
데이터 형식은 "문자열"입니다.
음수가 아니어야 합니다.
최대 9개의 소수점 허용 |
**비동기 오류**
다음 오류는의 `UpdateMarkup` 작업과 관련이 있습니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_MARKUP | 제안이 릴리스된 후에는 요청된 변경을 수행할 수 없습니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | MarkupPercentage PaymentScheduleTerm 또는 FixedUpfrontPricingTerm가 제안에 있고에 없는 경우를 업데이트할 수 없습니다ResaleAuthorization. |
| INCOMPATIBLE\_TERMS | 특정 결제 금액으로 UpdatePaymentScheduleTerms를 사용하거나 예약된 날짜에 대해 단일 마크업 백분율로 UpdateMarkup을 사용합니다. |
| INVALID\_MARKUP\_PERCENTAGE | UpdateMarkup은 ResaleAuthorization을 사용하여 생성된 제안에 대해서만 호출할 수 있습니다. |
## 대상 지정 구성 업데이트
카탈로그 API를 사용하여 기존 대상 지정 구성을 완전히 바꿀 수 있습니다 AWS Marketplace.
최신 요청에 포함되지 않은 기존 대상 지정 옵션은 제안에서 제거됩니다. 제조업체는에서 특정 대상 구매자를 언급할 수 있습니다`ResaleAuthorization`. 채널 파트너는 `UpdateTargeting` 변경 유형`PositiveTargeting`에서를 사용하여 일부 구매자에게 비공개 제안을 제공할 수 있습니다.
제안의 대상 지정 구성을 업데이트하려면 다음 예제와 같이 `UpdateTargeting` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"PositiveTargeting": {
"CountryCodes": [
"US",
"CA"
],
"BuyerAccounts": [
"111222333444"
]
},
"NegativeTargeting": {
"CountryCodes": [
"XX"
]
}
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdateTargeting` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - CPPO.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`Offer@1.0`.
+ **식별자**(문자열)(필수) - 제안 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청 세부 정보의 JSON 값입니다.
+ **PositiveTargeting**(객체)(선택 사항) - 긍정적인 타겟팅은 구매자의 프로필이 제안에 액세스할 수 있도록 허용하기 위해 충족해야 하는 기준을 정의합니다. 이 필드는 선택 사항이지만이 필드가 있는 경우 하나 이상의 대상 지정 옵션을 제공해야 합니다.
+ **CountryCodes**(문자열 배열)(선택 사항) - 국가에 따라 대상 지정을 허용하는 옵션으로 나열합니다. 국가에 대한 제안을 대상으로 지정하지 않으려는 경우이 필드를 생략해야 합니다. 있는 경우 목록에 하나 이상의 국가 코드가 포함되어야 합니다. 이 목록의 각 요소는 ISO 3166-1 alpha-2 형식을 사용하는 유효한 2자 국가 코드여야 합니다.
+ **BuyerAccounts**(문자열 배열)(선택 사항) -를 기반으로 대상 지정을 허용하는 옵션으로 나열합니다 AWS 계정 (프라이빗 제안이라고도 함). 에 대한 제안을 대상으로 지정하지 않으려는 경우 AWS 계정이 필드를 생략해야 합니다.
+ **NegativeTargeting**(객체)(선택 사항) - 부정 타겟팅은 제안에 액세스하기 위해 고객의 프로필이 충족해야 하는 기준을 정의합니다. 이 필드는 선택 사항이지만이 필드가 있는 경우 하나 이상의 대상 지정 옵션을 제공해야 합니다.
+ **CountryCodes**(문자열 배열)(필수) - 국가에 따라 대상 지정을 허용하는 옵션으로 나열합니다. 특정 국가에 대한 제안을 대상으로 하지 않으려는 경우이 필드를 생략해야 합니다. 있는 경우 목록에 하나 이상의 국가 코드가 포함되어야 합니다. 이 목록의 각 요소는 ISO 3166-1 alpha-2 형식을 사용하는 유효한 2자 국가 코드여야 합니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `ChangeSetArn` 대한 `ChangeSetId` 및를 제공하며 다음과 같습니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace 지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간 정도 걸릴 수 있습니다.
를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은의 `UpdateTargeting` 작업에 따라 다릅니다 AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP 코드 |
| --- | --- | --- |
| 세부 정보 | 필수 | 422 |
| PositiveTargeting | 선택 사항 | 422 |
| NegativeTargeting | 선택 사항 | 422 |
| PositiveTargeting.CountryCodes | 선택 사항
국가 코드는 유효해야 합니다(ISO 3166-1 alpha-2). | 422 |
| PositiveTargeting.BuyerAccounts | 선택 사항
AWS 계정 IDs 유효한 형식(12자리 숫자)이어야 합니다.
25개 이상의 계정을 포함할 수 없습니다. | 422 |
| NegativeTargeting.CountryCodes | 선택 사항
국가 코드는 유효해야 합니다(ISO 3166-1 alpha-2). | 422 |
| NegativeTargeting.BuyerAccounts | 제공해서는 안 됩니다( BuyerAccounts의 부정 타겟팅은 지원되지 않음). | 422 |
**비동기 오류**
다음 오류는의 `UpdateTargeting` 작업과 관련이 있습니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INVALID\_BUYER\_ACCOUNTS | 유효한 구매자 계정을 제공합니다. 잘못된 계정: [x]. |
| INVALID\_COUNTRY\_CODES | 지원되는 국가 코드를 제공합니다. |
| INVALID\_TARGETING | 동일한 속성에서 음수 또는 양수 타겟팅을 사용합니다. |
| INCOMPATIBLE\_PRODUCT | 제품에 대해서는 국가 기반 대상 지정이 지원되지 않습니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | ResaleAuthorization 부여와 호환되는 BuyerAccounts를 제공합니다. |
| INCOMPATIBLE\_TARGETING | 제안이 릴리스된 후에는 요청된 변경을 수행할 수 없습니다. |
| INCOMPATIBLE\_TARGETING | 제안이 만료된 후에는 요청된 변경을 수행할 수 없습니다. |
| INCOMPATIBLE\_TARGETING | 대체 제안에서는 대상 지정을 업데이트할 수 없습니다. 구매자가 제공된 AgreementId와 연결되지 않은 경우 구매자와 연결된 AgreementId를 제공하여 새 비공개 제안을 생성합니다. |
| TOO\_MANY\_BUYER\_ACCOUNTS | 허용된 한도 내에서 BuyerAccounts를 제공합니다. |
## 법률 리소스 업데이트
카탈로그 API를 사용하여 재판매 권한 부여 법적 조건을 병합하고 기존 법적 조건을 완전히 바꿀 수 있습니다 AWS Marketplace.
이 변경 사항은 기존 계약에 영향을 주지 않습니다. 최신 요청에 포함되지 않은 법적 약관은 제안에서 제거됩니다. 를 호출하여 병합된 법률 용어를 볼 수 있습니다`DescribeEntity`.
제안의 법적 조건을 업데이트하려면 다음 예제와 같이 `UpdateLegalTerms` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
}
]
}
]
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdateLegalTerms` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - CPPO.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`Offer@1.0`.
+ **식별자**(문자열)(필수) - 제안 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청 세부 정보의 JSON 값입니다.
+ **용어**(구조 배열)(필수) - 업데이트하려는 법적 용어 목록입니다. 지원되는 법률 용어는 다음과 같습니다.
+ **LegalTerm**(객체)(필수) - 수락자에게 제안할 텍스트 계약 목록을 정의합니다. 이러한 계약의 한 예는 최종 사용자 라이선스 계약(EULA)입니다.
+ **유형**(문자열)(필수) - 업데이트 중인 용어의 범주입니다.
+ **문서**(구조 배열)(필수) - 구매자에게 제안할 법적 리소스에 대한 참조 목록입니다. 이러한 리소스의 한 가지 예는 최종 사용자 라이선스 계약(EULA)입니다. 각 참조는 유형과 URL로 구성됩니다.
+ **유형**(문자열)(필수) - 문서 유형입니다. 사용 가능한 문서 유형은 다음과 같습니다.
+ **CustomEula** - 판매자가 제공하는 사용자 지정 EULA입니다. 이 문서 유형에는 액세스 가능한 S3 버킷에 저장된 EULA의 URL이 필요합니다.
+ **StandardEula** – 표준 계약 AWS Marketplace (SCMP). SCMP에 대한 자세한 내용은 AWS Marketplace 판매자 안내서를 참조하세요. 이 유형은에서 관리하므로 URL을 제공하지 않습니다 AWS Marketplace.
+ **URL**(문자열)(조건부 필수) - 구매자가 읽을 수 있는 법률 문서의 URL입니다. `Type`가 다음 [] 중 하나인 경우 필요합니다`CustomEula`.
+ **버전**(문자열)(조건부 필수) -에서 제공하는 표준 계약의 버전입니다 AWS Marketplace. 이는가 `Type`인 경우에 필요합니다`StandardEula`. 사용 가능한 버전은 다음과 같습니다.
+ **2022-07-14** -에 대한 표준 계약 버전 AWS Marketplace 은 다음 Amazon S3 버킷에서 사용할 수 있습니다. [https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf](https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf)
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트의 ID를 제공합니다.
**응답 구문**
```
{
"ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-
1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace 판매자 운영 팀과 정보를 검증하여 지침을 충족하는 AWS Marketplace 지 확인하는 작업이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간 정도 걸릴 수 있습니다. 를 통해 AWS Marketplace Management Portal또는 `DescribeChangeSet` 작업을 사용하여 카탈로그 API에서 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은의 `UpdateLegalTerms` 작업에 따라 다릅니다 AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP 코드 |
| --- | --- | --- |
| 용어 | 필수
목록에는 LegalTerm만 허용됩니다.
목록 크기는 1이어야 합니다. | 422 |
| 용어[].LegalTerm.Documents | 필수 | 422 |
| 용어[].LegalTerm.Documents[].유형 | 필수
허용된 값:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/marketplace/latest/developerguide/work-with-cppos.html) | 422 |
| 용어[].LegalTerm.Documents[].URL | 필수이며 "Type"이 다음 중 하나인 경우 유효한 URL이어야 합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/marketplace/latest/developerguide/work-with-cppos.html) | 422 |
**비동기 오류**
다음 오류는의 `UpdateLegalTerms` 작업과 관련이 있습니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_TERMS | 제안이 릴리스된 후에는 요청된 변경을 수행할 수 없습니다. |
| INCOMPATIBLE\_TERMS | 제안이 만료된 후에는 요청된 변경을 수행할 수 없습니다. |
| INVALID\_LEGAL\_DOCUMENTS | 액세스 가능한 S3 버킷에 저장된 법적 문서의 URLs을 제공합니다. |
| INVALID\_LEGAL\_DOCUMENTS | 새 제안에는 최신 버전의 StandardEula만 지원됩니다. |
| INVALID\_LEGAL\_DOCUMENTS | 지원되는 파일 형식으로 법률 문서를 제공합니다. |
| INVALID\_LEGAL\_DOCUMENTS | 지원되는 문서 유형을 사용하여 법률 문서를 제공합니다. |
| LIMIT\_EXCEEDED\_LEGAL\_DOCUMENT\_SIZE | 허용되는 크기 제한 내에서 법률 문서를 제공합니다. |
## CPPO의 검색 가능성 업데이트
카탈로그 API를 사용하여에서 제안의 검색 가능성을 관리할 수 있습니다 AWS Marketplace. 이 변경 유형은 기존 계약에 영향을 주지 않습니다.
향후 특정 날짜를 설정하여 제안의 검색 가능성을 제한하거나 과거에 제안을 만료하도록 선택할 수 있습니다.
제안의 검색 가능성을 관리하려면 다음 예제와 같이 `UpdateAvailability` 변경 유형을 사용하여 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"AvailabilityEndDate": "2024-05-31"
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdateAvailability` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - CPPO.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`Offer@1.0`.
+ **식별자**(문자열)(필수) - 제안 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청 세부 정보의 JSON 값입니다.
+ **AvailabilityEndDate**(문자열) - 제안을 검색하고 구매할 수 있는 날짜입니다 AWS Marketplace. 향후 특정 날짜를 설정하여 가용성을 제한하거나 과거에 제안을 만료하도록 선택할 수 있습니다. 날짜는 `YYYY-MM-DD` 형식으로 표시됩니다. 제안은 제공된 날짜의 23:59:59.999 UTC에 만료됩니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `ChangeSetArn` 대한 `ChangeSetId` 및를 제공하며 다음과 같습니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace 지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간 정도 걸릴 수 있습니다.
를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은의 `UpdateAvailability` 작업에 따라 다릅니다 AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP 코드 |
| --- | --- | --- |
| AvailabilityEndDate | 필수
형식: "YYYY-MM-DD" | 422 |
**비동기 오류**
다음 오류는의 `UpdateAvailability` 작업과 관련이 있습니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INVALID\_AVAILABILITY\_END\_DATE | AvailabilityEndDate는 공개 제안에서 지원되지 않습니다. |
| INVALID\_AVAILABILITY\_END\_DATE | 향후 AvailabilityEndDate를 제공합니다. |
| INVALID\_AVAILABILITY\_END\_DATE | AgreementEndDate 이전의 AvailabilityEndDate를 제공합니다. AgreementEndDate |
| MISSING\_AVAILABILITY\_END\_DATE | 계약 종료 날짜 이전의 AvailabilityEndDate를 제공합니다. |
## 계약의 만료 날짜 정의
카탈로그 API를 사용하여이 제안을 사용하여 생성된 계약의 만료 날짜를 정의할 수 있습니다 AWS Marketplace.
이 변경 사항은 기존 계약에 영향을 주지 않습니다. 제조업체는 재판매 승인에서 최대 계약 시작일을 언급할 수 있습니다. 그러나 채널 파트너는 해당 날짜 이후의 계약 시작 날짜를 제공할 수 없습니다.
계약의 만료 날짜를 정의하려면 다음 예제와 같이 `UpdateValidityTerms` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P12M",
"AgreementStartDate": "2021-08-01",
"AgreementEndDate": "2022-08-01"
}
]
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdateValidityTerms` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - CPPO.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`Offer@1.0`.
+ **식별자**(문자열)(필수) - 제안 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청 세부 정보의 JSON 값입니다.
+ **용어**(구조 배열) **-** 업데이트하려는 유효 용어 목록입니다. 지원되는 유효 기간은 다음과 같습니다.
+ **ValidityTerm**(객체) **-**이 제안에서 생성된 계약을 유효하게 유지할 조건을 정의합니다.
+ **유형**(문자열) **-** 업데이트 중인 용어의 범주입니다.
+ **AgreementDuration**(문자열) **-** 계약이 활성 상태로 유지되는 기간을 정의합니다. `AgreementStartDate`이 제공되지 않은 경우 계약 기간은 계약 서명 시간을 기준으로 합니다. 기간은 ISO\_8601 형식으로 표시됩니다.
+ **AgreementStartDate**(문자열) **-** 계약이 시작되는 날짜를 정의합니다. `AgreementStartDate`는 YYYY-MM-DD 형식으로 표시됩니다. 계약은 제공된 날짜의 00:00:00.000 UTC에 시작됩니다. `AgreementStartDate`이 제공되지 않은 경우 계약 시작 날짜는 계약 서명 시간을 기준으로 결정됩니다.
+ **AgreementEndDate**(문자열) **-** 계약이 종료되는 날짜를 정의합니다. `AgreementEndDate`는 YYYY-MM-DD 형식으로 표시됩니다. 계약은 제공된 날짜의 23:59:59.999 UTC에 종료됩니다. `AgreementEndDate`이 제공되지 않은 경우 계약 종료일은 개별 조건의 유효성에 따라 결정됩니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `ChangeSetArn` 대한 `ChangeSetId` 및를 제공하며 다음과 같습니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace 지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간 정도 걸릴 수 있습니다.
를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은의 `UpdateValidityTerms` 작업에 따라 다릅니다 AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP 코드 |
| --- | --- | --- |
| 용어 | 필수
목록에는 "ValidityTerm"만 허용됩니다.
비어 있거나 용어를 하나만 포함해야 합니다. | 422 |
| 용어[].ValidityTerm | 지원되는 사용 사례:
1. AgreementDuration만 있는 ValidityTerm
2. AgreementStartDate만 포함된 ValidityTerm
3. AgreementEndDate만 있는 ValidityTerm
4. AgreementStartDate 및 AgreementEndDate가 모두 포함된 ValidityTerm | 422 |
| 용어[].ValidityTerm.AgreementDuration | 선택 사항
ISO\_8601 형식으로 표시됩니다. | 422 |
| 용어[].ValidityTerm.AgreementStartDate | 선택 사항
형식: "YYYY-MM-DD" | 422 |
| 용어[].ValidityTerm.AgreementEndDate | 선택 사항
형식: "YYYY-MM-DD" | 422 |
**비동기 오류**
다음 오류는의 `UpdateValidityTerms` 작업과 관련이 있습니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_AGREEMENT | 대체할 현재 계약이 미래 날짜가 아닌 경우 AgreementStartDate는 미래 날짜가 될 수 없습니다. |
| INCOMPATIBLE\_AGREEMENT\_END\_DATE | 제안이 릴리스된 후에는 AgreementEndDate를 업데이트할 수 없습니다. |
| INCOMPATIBLE\_AGREEMENT\_START\_DATE | 제안이 릴리스된 후에는 AgreementStartDate를 업데이트할 수 없습니다. |
| INCOMPATIBLE\_PRODUCT | 향후 AgreementStartDate는 지원되지 않습니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | AgreementStartDate와 AgreementEndDate 사이의 기간이 ResaleAuthorization 부여와 호환되는지 확인합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | AgreementStartDate가 ResaleAuthorization 부여와 호환되는지 확인합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | AgreementEndDate가 ResaleAuthorization 부여와 호환되는지 확인합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | AgreementStartDate와 AgreementEndDate 사이의 기간이 ResaleAuthorization와 호환되는지 확인합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | AgreementDuration이 ResaleAuthorization에 지정된 기간과 일치하는지 확인합니다. |
| INCOMPATIBLE\_TERMS | 공개 제안에는 ValidityTerm이 지원되지 않습니다. |
| INCOMPATIBLE\_TERMS | 제안이 만료된 후에는 요청된 변경을 수행할 수 없습니다. |
| INVALID\_AGREEMENT\_DURATION | [x]일 이상의 AgreementDuration을 제공합니다. |
| INVALID\_AGREEMENT\_END\_DATE | 향후 AgreementEndDate를 제공합니다. |
| INVALID\_AGREEMENT\_END\_DATE | [x] 이후이거나 같은 AgreementEndDate를 제공합니다. |
| INVALID\_AGREEMENT\_START\_DATE | AvailabilityEndDate 이후인 AgreementStartDate를 제공합니다. AvailabilityEndDate |
| INVALID\_AGREEMENT\_START\_DATE | AgreementStartDate 이전의 AgreementEndDate를 제공합니다. |
| INVALID\_AGREEMENT\_START\_DATE | 오늘부터 [x]년 이내에 있는 AgreementStartDate를 제공합니다. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | AgreementDuration과 AgreementEndDate가 모두 포함된 ValidityTerm은 지원되지 않습니다. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | AgreementStartDate와 AgreementDuration이 모두 포함된 ValidityTerm은 제품에 대한 제안에서 지원되지 않습니다. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | AgreementStartDate가 포함된 ValidityTerm은 제품에 대한 제안에서 지원되지 않습니다. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | AgreementStartDate만 있는 ValidityTerm은 지원되지 않습니다. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | AgreementEndDate는 향후 AgreementStartDate와 함께 사용하거나 대체 제안에 사용하지 않는 한 지원되지 않습니다. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | 차이가 [x]년 이하인 경우 AgreementStartDate 및 AgreementEndDate를 제공합니다. |
| MISSING\_AGREEMENT\_START\_DATE | ConfigurableUpfrontPricingTerm과 함께 사용할 때 AgreementStartDate가 ValidityTerm에 있는지 확인합니다. ValidityTerm |
## 요금 업데이트
카탈로그 API를 사용하여 기존 요금 조건을 완전히 바꿀 수 있습니다.
최신 요청에 포함되지 않은 요금 조건은 제안에서 제거됩니다. 채널 파트너는이 변경 유형을 전달에만 사용할 수 있습니다`FixedUpFrontPricingTerm`.
제안의 요금 조건을 업데이트하려면 다음 예제와 같이 `UpdatePricingTerms` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"Details": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "200.00",
"Duration": "P465D",
"Grants": [
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
}
]
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdatePricingTerms` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - CPPO.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`Offer@1.0`.
+ **식별자**(문자열)(필수) - 제안 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **세부 정보**(문자열)(필수) - 요청의 세부 정보입니다. 이 필드는 JSON 문자열 필드입니다. 문자열에 있을 수 없는 이스케이프 문자(예: 따옴표)를 포함하여 한 줄 문자열 필드에 대해 올바른 형식을 지정해야 합니다.
+ **PricingModel**(문자열)(필수) - 제안에 대한 요금 모델입니다. 요금 모델의 가능한 값은 다음과 같습니다.
+ **계약** - 구매자에게 제품 사용에 대한 요금이 미리 청구되거나 유연한 결제 일정을 제공하는 계약 기반 요금 모델입니다. 구매자는 계약 이상의 추가 사용량에 대해서도 비용을 지불할 수 있습니다.
+ **용어**(구조 배열)(필수) - 업데이트하려는 요금 조건 목록입니다. 지원되는 요금 조건은 다음과 같습니다.
+ **FixedUpfrontPricingTerm**(객체) - 고객에게 고정 선결제 금액이 청구되는 선결제 요금 모델을 정의합니다.
+ **유형**(문자열)(필수) - 업데이트 중인 용어의 유형입니다.
+ **CurrencyCode**(문자열)(필수) -이 기간에 언급된 가격의 통화를 정의합니다. 공개 제안의 경우 USD만 지원됩니다. 비공개 제안의 경우 USD, AUD, EUR, GBP 및 JPY가 지원됩니다.
+ **가격**(문자열)(필수) -이 기간이 수락되면 고객에게 청구되는 고정 금액입니다.
+ **권한 부여**(구조 배열)(필수) - 계약 실행의 일부로 고정 선결제 수락자에게 부여되는 권한입니다.
+ **DimensionKey**(문자열)(필수) - 제품 문서에 정의된 고유한 차원 키입니다. 차원은 제품의 용량 범주를 나타내며 제품이에 나열될 때 지정됩니다 AWS Marketplace.
+ **MaxQuantity**(정수)(선택 사항) - 구매자에게 제품의 지정된 차원에 대한 권한을 부여할 수 있는 최대 용량입니다. `MaxQuantity`이 제공되지 않은 경우 구매자는 지정된 차원을 무제한으로 사용할 수 있습니다.
+ **기간**(문자열)(선택 사항) - 용어가 활성 상태로 유지되는 기간을 정의합니다. 이 필드는 ISO 8601 형식을 지원합니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `ChangeSetArn` 대한 `ChangeSetId` 및를 제공하며 다음과 같습니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace 지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간 정도 걸릴 수 있습니다.
를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은의 `UpdatePricingTerms` 작업에 따라 다릅니다 AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 |
| --- | --- |
| PricingModel | 필수
허용된 요금 모델:
계약 |
| 용어 | 필수
허용되는 조건:
FixedUpfrontPricingTerm |
| 용어[].FixedUpfrontPricingTerm.CurrencyCode | 필수
허용되는 값: ["USD", "AUD", "EUR", "GBP", "JPN"]
허용된 요금 모델:
계약 |
| 용어[].FixedUpfrontPricingTerm.Price | 필수
데이터 형식은 "문자열"입니다. 음수가 아니어야 합니다.
최대 6십진수 지원
특수 문자가 지원되지 않음 |
| 용어[].FixedUpfrontPricingTerm.Duration | 필수
예상 형식: ISO 8601 기간 |
| 용어[].FixedUpfrontPricingTerm.Grants[].DimensionKey | 필수
길이는 1\~60이어야 합니다. |
| 용어[].FixedUpfrontPricingTerm.Grants[].MaxQuantity | 필수 |
**비동기 오류**
다음 오류는의 `UpdatePricingTerms` 작업에만 해당됩니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| DUPLICATE\_DIMENSION\_KEYS | Grants에 [x]의 고유한 차원 키 목록을 제공합니다. |
| DUPLICATE\_DIMENSION\_KEYS | RateCard에 [x]의 고유한 차원 키 목록을 제공합니다. |
| DUPLICATE\_SELECTORS | ConfigurableUpfrontPricingTerm에 고유한 선택기 목록을 제공합니다. |
| DUPLICATE\_TERM\_TYPES | 용어 유형의 고유한 목록을 제공합니다. |
| INCOMPATIBLE\_AGREEMENT | 대체 제안에서 [x, y, z]라는 용어는 제거할 수 없습니다. |
| INCOMPATIBLE\_AGREEMENT | 대체 제안에 [x, y, z]라는 용어를 추가할 수 없습니다. |
| 호환되지 않는\_통화\_코드 | 제안이 릴리스된 후에는 CurrencyCode를 변경할 수 없습니다. |
| 호환되지 않는\_결제\_설정 | CurrencyCode와 호환되도록 결제 설정을 업데이트합니다. |
| INCOMPATIBLE\_PRODUCT | 제품에는 사용 요금 모델이 지원되지 않습니다. |
| INCOMPATIBLE\_PRODUCT | 제품에 대해서는 계약 요금 모델이 지원되지 않습니다. |
| INCOMPATIBLE\_PRODUCT | 제품에 대해서는 바이올 요금 모델이 지원되지 않습니다. |
| INCOMPATIBLE\_PRODUCT | 제품에는 무료 요금 모델이 지원되지 않습니다. |
| INCOMPATIBLE\_PRODUCT | [x]는 제품에 대한 제안에서 지원되지 않습니다. |
| INCOMPATIBLE\_PRODUCT | 제공된 결제 및 요금 조건은 호환되지 않습니다. |
| INCOMPATIBLE\_PRODUCT | [x]의 제품에서 사용 가능한 기존 차원을 사용합니다. |
| INCOMPATIBLE\_PRODUCT | 제안의 유일한 요금 기간인 FreeTrialPricingTerm은 제품에 대해 지원되지 않습니다. |
| INCOMPATIBLE\_PRODUCT | 제품에는 [x,y,z]라는 용어가 지원되지 않습니다. |
| INCOMPATIBLE\_PRODUCT | 대체 제안은 계약 요금 모델에 대해서만 지원됩니다. |
| INCOMPATIBLE\_PRODUCT | 제품 차원과 호환되는 요금 조건(들)을 제공합니다. 호환되지 않는 요금 조건: [x,y,z]. |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | 사용량 요금 모델에 대해 ConfigurableUpfrontPricingTerm에서 MultipleDimensionSelection 및 QuantityConfiguration을 허용으로 설정합니다. QuantityConfiguration ConfigurableUpfrontPricingTerm |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | 사용량 요금 모델의 경우 ConfigurableUpfrontPricingTerm에서 MultipleDimensionSelection 및 QuantityConfiguration을 허용되지 않음으로 설정합니다. QuantityConfiguration ConfigurableUpfrontPricingTerm |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | 제안이 릴리스된 후에는 ConfigurableUpfrontPricingTerm QuantityConfiguration을 변경할 수 없습니다. |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | 제안이 릴리스된 후에는 ConfigurableUpfrontPricingTerm의 MultipleDimensionSelection을 변경할 수 없습니다. |
| INCOMPATIBLE\_RATES | 무료 요금 모델을 사용할 때 모든 요금 금액과 가격을 0(0)으로 설정합니다. |
| INCOMPATIBLE\_RATES | 제품에 대한 무료 평가판 제안의 경우 UsageBasedPricingTerm에는 영(0) 가격만 허용됩니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | ResaleAuthorization에 지정된 것과 동일한 CurrencyCode를 제공합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | FixedUpfrontPricingTerm의 기간이 ResaleAuthorization에 지정된 기간과 일치하는지 확인합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | ResaleAuthorization과 호환되는 용어(들)를 제공합니다. 호환되지 않는 용어: [x, y, z]. |
| INCOMPATIBLE\_SELECTOR\_DURATION | 제안이 발표된 후에는 ConfigurableUpfrontPricingTerm의 요율 카드에서 기간을 제거할 수 없습니다. |
| INCOMPATIBLE\_SELLER\_VERIFICATION | 필요한 모든 판매자 확인 프로세스를 완료합니다. |
| INCOMPATIBLE\_TERMS | [x]는 [y,z]라는 용어와 함께 지원되지 않습니다. |
| INCOMPATIBLE\_TERMS | 제안이 릴리스된 후에는 [x,y,z]라는 용어를 추가할 수 없습니다. |
| INCOMPATIBLE\_TERMS | 제안이 릴리스된 후에는 다음 조건을 제거할 수 없습니다. [x,y,z]. |
| INCOMPATIBLE\_TERMS | [x]는 비공개 제안에는 지원되지 않습니다. |
| INCOMPATIBLE\_TERMS | 무제한 사용을 허용하는 FreeTrialPricingTerm에서는 다음 용어가 지원되지 않습니다. [x,y,z]. |
| INCOMPATIBLE\_TERMS | 제품의 FreeTrialPricingTerm에서는 [x,y,z]라는 용어가 지원되지 않습니다. |
| INCOMPATIBLE\_TERMS | 제안에 PaymentScheduleTerm이 포함된 경우 FixedUpfrontPricingTerm에 대해 영(0) 가격을 제공합니다. |
| INCOMPATIBLE\_TERMS | 다음 조건은 PricingModel [x,y,z]과 호환되지 않습니다. |
| INCOMPATIBLE\_TERMS | FixedUpfrontPricingTerm은 MarkupPercentage가 0(0)보다 큰 경우 지원되지 않습니다. |
| INCOMPATIBLE\_TERMS | 제안이 릴리스된 후에는 요청된 변경을 수행할 수 없습니다. |
| INCOMPATIBLE\_TERMS | 제안이 만료된 후에는 요청된 변경을 수행할 수 없습니다. |
| INVALID\_AGREEMENT\_DURATION | [x]\~[y]개월의 기간을 입력합니다. |
| INVALID\_AGREEMENT\_DURATION | 측정 차원에 대한 기간 세부 수준이 일 수준인지 확인합니다. |
| INVALID\_CURRENCY\_CODE | 지원되는 CurrencyCode를 제공합니다. |
| INVALID\_CURRENCY\_CODE | 모든 요금 및 결제 조건에 동일한 CurrencyCode를 제공합니다. |
| INVALID\_DURATION | FreeTrialPricingTerm의 기간이 허용된 범위 내에 있는지 확인합니다. |
| INVALID\_DURATION | AgreementStartDate AgreementEndDate 사이의 기간과 일치하는 FixedUpfrontPricingTerm의 기간을 제공합니다. |
| INVALID\_DURATION | [x]\~[y]개월의 기간을 입력합니다. |
| INVALID\_DURATION | 측정 차원에 대한 지속 시간 세부 수준이 일 수준인지 확인합니다. |
| INVALID\_GRANTS | FreeTrialPricingTerm의 모든 권한 부여에 대해 동일한 MaxQuantity를 제공합니다. |
| INVALID\_GRANTS | FreeTrialPricingTerm에서 사용 가능한 모든 측정 차원에 대한 권한 부여를 제공합니다. |
| INVALID\_PRICE\_CHANGE | [x]는 지난 120일 동안 가격 인상을 요청했기 때문에 [y]까지 업데이트할 수 없습니다. 이전 가격 인상 요청을 취소하거나 자세한 내용은 AWS Marketplace 관리형 카탈로그 운영 팀에 문의하세요. |
| INVALID\_PRICE\_CHANGE | [x]의 가격 인상 및 차원 추가는 동일한 요청에서 지원되지 않습니다. 먼저 차원을 추가합니다. |
| INVALID\_PRICE\_CHANGE | UsageBasedPricingTerm의 가격 상승 및 하락은 동일한 요청에서 지원되지 않습니다. 먼저 가격을 낮춥니다. |
| INVALID\_PRICE\_CHANGE | 동일한 요청에서는 RecurringPaymentTerm의 가격 인상과 UsageBasedPricingTerm의 가격 하락이 지원되지 않습니다. 먼저 가격을 낮춥니다. |
| INVALID\_PRICE\_CHANGE | 동일한 요청에서는 RecurringPaymentTerm의 가격 감소와 UsageBasedPricingTerm의 가격 증가가 지원되지 않습니다. 먼저 가격을 낮춥니다. |
| INVALID\_RATE\_CARD | ConfigurableUpfrontPricingTerm에 기간 [x] 동안 하나 이상의 차원 키가 누락되었습니다. 모든 기간 동안 동일한 차원 키 세트에 대한 가격을 제공합니다. |
| INVALID\_RATE\_CARD | UsageBasedPricingTerm에서 측정된 차원에 대해서만 요금 카드를 제공합니다. |
| INVALID\_RATE\_CARD | [x]에서는 속도를 제거할 수 없습니다. 기존 요금 카드의 모든 차원에 대한 가격을 제공합니다. |
| INVALID\_RATE\_CARD | [x]에서 단위가 동일한 차원을 제공합니다. |
| INVALID\_RATE\_CARD | 모든 측정된 차원 또는 권한이 있는 모든 차원을 [x]로 입력합니다. |
| INVALID\_RATE\_CARD | [x]에 권한이 있는 차원만 제공합니다. |
| INVALID\_RATE\_CARD | UsageBasedPricingTerm 기반 요금을 제공합니다. |
| INVALID\_RATE\_CARD | 모든 무료 평가판 차원에 대한 사용량 기반 요금을 제공합니다. |
| INVALID\_RATE\_CARD | UsageBasedPricingTerm에서 최대 소수점 8자리까지 가격을 제공합니다. |
| INVALID\_SELECTOR\_DURATION\_VALUE | [x]\~[y]개월의 기간을 입력합니다. |
| INVALID\_SELECTOR\_DURATION\_VALUE | 측정 차원에 대한 지속 시간 세부 수준이 일 수준인지 확인합니다. |
| INVALID\_SELECTOR\_DURATION\_VALUE | ConfigurableUpfrontPricingTerm의 기간이 허용된 범위 내에 있는지 확인합니다. |
| INVALID\_SELECTOR\_DURATION\_VALUE | 지원되는 계약 기간을 하나 이상 제공합니다. |
| INVALID\_SELECTOR\_DURATION\_VALUE | 지원되는 계약 기간 또는 단일 사용자 지정 기간을 하나 이상 제공합니다. |
| INVALID\_SELECTOR\_DURATION\_VALUE | AgreementStartDate AgreementEndDate 간의 기간과 일치하는 ConfigurableUpfrontPricingTerm의 기간을 제공합니다. |
| 누락\_지속 시간 | FixedUpfrontPricingTerm에 기간을 입력합니다. |
| MISSING\_MANDATORY\_TERMS | FixedUpfrontPricingTerm은 ByolPricingTerm 또는 PaymentScheduleTerm과 페어링된 경우에만 지원됩니다. |
| MISSING\_MANDATORY\_TERMS | [x,y,z] 중 하나 이상을 제공합니다. |
| MISSING\_MANDATORY\_TERMS | Byol 요금 모델을 사용할 때 ByolPricingTerm을 제공합니다. |
| TOO\_MANY\_GRANTS | [y]에 최대 [x]개의 권한 부여를 제공합니다. |
| TOO\_MANY\_RATE\_CARDS | ConfigurableUpfrontPricingTerm의 요금 카드 하나만 제품에 허용됩니다. |
| TOO\_MANY\_RATE\_CARDS | 제품의 ConfigurableUpfrontPricingTerm에는 최대 [x]개의 요금 카드가 허용됩니다. |
| TOO\_MANY\_RATES | ConfigurableUpfrontPricingTerm의 허용된 한도 내에서 RateCards를 제공합니다. |
| TOO\_MANY\_RATES | UsageBasedPricingTerm의 허용된 한도 내에서 RateCards를 제공합니다. |
## 결제 일정 세부 정보 업데이트
카탈로그 API를 사용하여 유연한 결제 일정과 같은 결제 일정 세부 정보를 변경할 수 있습니다 AWS Marketplace.
제조업체가 재판매 승인에 결제 일정을 제공한 경우 채널 파트너는 다음 중 하나를 수행할 수 있습니다.
+ `UpdateMarkup` 변경 유형을 사용하여 모든 결제 일정에 균일한 백분율 마크업을 적용합니다.
+ `UpdatePaymentScheduleTerms` 변경 유형을 사용하여 사용자 지정 결제 금액을 재판매 승인에 제공된 값보다 크거나 같은 값으로 설정합니다. 결제 날짜는 변경할 수 없습니다. 두 옵션을 동시에 적용할 수는 없습니다. 마크업이 먼저 적용되고 결제 일정을 적용하기 위해 마크업을 변경해야 하는 경우 `UpdateMarkup` 변경 유형을 `0` 통해 마크업을 로 설정합니다. 결제 일정이 먼저 적용되는 경우 변경 사항을 되돌려 마크업을 적용할 수 없습니다.
제안에 대한 결제 관련 세부 정보를 업데이트하려면 다음 예제와 같이 `UpdatePaymentScheduleTerms` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"Schedule": [
{
"ChargeDate": "2021-12-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2022-03-01",
"ChargeAmount": "250.00"
}
]
}
]
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdatePaymentScheduleTerms` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - CPPO.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`Offer@1.0`.
+ **식별자**(문자열)(필수) - 제안 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청 세부 정보의 JSON 값입니다.
+ **용어**(구조 배열) - 업데이트하려는 결제 조건 목록입니다. 지원되는 결제 조건은 다음과 같습니다.
+ **PaymentScheduleTerm**(객체) - 계약 유효 기간 동안 고객에게 다른 날짜에 고정 요금이 청구되는 할부 기반 요금 모델을 정의합니다.
+ **유형**(문자열) - 업데이트 중인 용어의 유형입니다. 객체 값 입니다`"PaymentScheduleTerm"`.
+ **일정**(구조 배열) - 각 요소가 하나의 결제 분할을 정의하는 결제 일정 목록입니다. 여기에는 지불할 가격과 고객에게 요금이 청구되는 날짜를 계산하는 데 필요한 정보가 포함되어 있습니다.
+ **ChargeDate**(문자열) - 고객이이 결제 일정 기간에 정의된 요금을 지불하는 날짜입니다. `ChargeDate`는 YYYY-MM-DD 형식으로 표시됩니다. 인보이스는 제공된 날짜에 생성됩니다.
+ **ChargeAmount**(문자열) - 고객이 예약된 날짜()에 지불하는 가격입니다`ChargeDate`.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `ChangeSetArn` 대한 `ChangeSetId` 및를 제공하며 다음과 같습니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace 지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간 정도 걸릴 수 있습니다.
를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은의 `UpdatePaymentScheduleTerms` 작업에 따라 다릅니다 AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP |
| --- | --- | --- |
| 용어 | 필수
"PaymentScheduleTerm"만 허용됩니다.
목록 크기는 2보다 작아야 합니다. | 422 |
| 용어[].PaymentScheduleTerm.CurrencyCode | 필수
지원되는 통화: ["USD", "AUD", "EUR", "GBP", "JPN"] | 422 |
| 용어[].PaymentScheduleTerm.Schedule[] | 필수
목록 크기는 1\~60이어야 합니다. | 422 |
| 용어[].PaymentScheduleTerm.Schedule[].ChargeDate | 필수
형식: "YYYY-MM-DD" | 422 |
| 용어[].PaymentScheduleTerm.Schedule[].ChargeAmount | 필수데이터 형식은 "문자열"입니다.
최대 2개의 소수 자릿수가 지원되는 음수가 아닌 소수 자릿수
추가 속성은 허용되지 않습니다. | 422 |
**비동기 오류**
다음 오류는의 `UpdatePaymentScheduleTerms` 작업에만 해당됩니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| DUPLICATE\_™\_DATES | PaymentScheduleTerm에 고유한 청구 날짜를 입력합니다. |
| 호환되지 않는\_마크업\_백분율 | MarkupPercentage가 0(0)보다 큰 경우 PaymentScheduleTerm이 지원되지 않습니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | ResaleAuthorization과 호환되는 용어(들)를 제공합니다. 호환되지 않는 용어: [PaymentScheduleTerm]. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | PaymentScheduleTerm의 총 ChargeAmounts가 ResaleAuthorization과 호환되는지 확인합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | PaymentScheduleTerm의 청구 날짜가 ResaleAuthorization의 청구 날짜와 동일한지 확인합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | PaymentScheduleTerm의 청구 금액이 해당 날짜의 ResaleAuthorization의 청구 금액보다 크거나 같은지 확인합니다. |
| INCOMPATIBLE\_TERMS | 제안이 릴리스된 후에는 요청된 변경을 수행할 수 없습니다. |
| INCOMPATIBLE\_TERMS | 제안이 만료된 후에는 요청된 변경을 수행할 수 없습니다. |
| INCOMPATIBLE\_TERMS | 특정 결제 금액으로 UpdatePaymentScheduleTerms를 사용하거나 예약된 날짜에 대해 단일 마크업 백분율로 UpdateMarkup을 사용합니다. |
| INVALID\_™\_DATES | AgreementEndDate 이전의 청구 날짜를 입력합니다. |
| TOO\_MANY\_BACKDATED\_CHARGES | AvailabilityEndDate 전에 최대 1개의 예약된 결제를 제공합니다. |
| 오류 코드 | 오류 메시지 |
| --- | --- |
| DUPLICATE\_™\_DATES | PaymentScheduleTerm에 고유한 청구 날짜를 입력합니다. |
| 호환되지 않는\_통화\_코드 | 제안이 릴리스된 후에는 CurrencyCode를 변경할 수 없습니다. |
| 호환되지 않는\_마크업\_백분율 | MarkupPercentage가 0(0)보다 큰 경우 PaymentScheduleTerm이 지원되지 않습니다. |
| 호환되지 않는\_결제\_설정 | CurrencyCode와 호환되도록 결제 설정을 업데이트합니다. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | ResaleAuthorization과 호환되는 용어(들)를 제공합니다. 호환되지 않는 용어: [PaymentScheduleTerm]. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | PaymentScheduleTerm의 총 ChargeAmounts가 ResaleAuthorization과 호환되는지 확인합니다. |
| INCOMPATIBLE\_SELLER\_VERIFICATION | 필요한 모든 판매자 확인 프로세스를 완료합니다. |
| INCOMPATIBLE\_TERMS | 제안이 릴리스된 후에는 요청된 변경을 수행할 수 없습니다. |
| INCOMPATIBLE\_TERMS | 제안이 만료된 후에는 요청된 변경을 수행할 수 없습니다. |
| INVALID\_™\_DATES | AgreementEndDate 이전의 청구 날짜를 입력합니다. |
| INVALID\_CURRENCY\_CODE | 지원되는 CurrencyCode를 제공합니다. |
| INVALID\_CURRENCY\_CODE | 모든 요금 및 결제 조건에 동일한 CurrencyCode를 제공합니다. |
| TOO\_MANY\_BACKDATED\_CHARGES | AvailabilityEndDate 전에 최대 1개의 예약된 결제를 제공합니다. |
## CPPO 게시
카탈로그 API를 사용하여 모든 업데이트 변경 유형에서 수집된 정보를 병합한 다음 제안을 게시할 수 있습니다 AWS Marketplace.
제안`ReleaseOffer`은가 호출될 때까지 `Draft` 상태로 유지됩니다. 제안이 릴리스되면에서 검색할 수 있습니다 AWS Marketplace.
제안을 게시하려면 다음 예제와 같이 `ReleaseOffer` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {}
}
]
}
```
`ReleaseOffer` 변경 유형을 추가할 필드에 대한 정보를 제공합니다.
+ **개체**(객체)(필수) - CPPO.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`Offer@1.0`.
+ **식별자**(문자열)(필수) - 제안 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청 세부 정보의 JSON 값입니다. 의 경우 비어 있어야 합니다`ReleaseOffer`.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `ChangeSetArn` 대한 `ChangeSetId` 및를 제공하며 다음과 같습니다.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace 지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간 정도 걸릴 수 있습니다.
를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은의 `ReleaseOffer` 작업에 따라 다릅니다 AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 |
| --- | --- |
| 세부 정보 | 비어 있어야 합니다({}). |
**비동기 오류**
다음 오류는의 `ReleaseOffer` 작업과 관련이 있습니다 AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| 호환되지 않는\_결제\_설정 | CurrencyCode와 호환되도록 결제 설정을 업데이트합니다. |
| INCOMPATIBLE\_PRODUCT | 먼저 제품에 대한 공개 제안을 생성합니다. |
| INCOMPATIBLE\_SELLER\_VERIFICATION | 필요한 모든 판매자 확인 프로세스를 완료합니다. |
| INVALID\_UPDATE\_REQUEST | 제안이 릴리스된 후에는 요청된 변경을 수행할 수 없습니다. |
| MISSING\_AGREEMENT\_END\_DATE | 대체 제안에 대한 AgreementEndDate를 제공합니다. |
| MISSING\_AVAILABILITY\_END\_DATE | 비공개 제안에 대한 AvailabilityEndDate를 제공합니다. |
| MISSING\_MANDATORY\_TERMS | 제안에 PaymentScheduleTerm이 포함된 경우 FixedUpfrontPricingTerm을 제공합니다. PaymentScheduleTerm |
| 누락\_구매자\_계정 | ResaleAuthorization을 사용하여 생성된 제안에 대해 PositiveTargeting에 BuyersAccounts 제공합니다. |
| 누락\_구매자\_계정 | 제품에 대한 모든 제안은 비공개여야 합니다. BuyersAccounts에 PositiveTargeting을 제공합니다. |
| 누락\_설명 | 제안을 릴리스하기 전에 설명을 설정합니다. |
| MISSING\_MANDATORY\_TERMS | 제안에 [x]를 추가합니다. |
| MISSING\_MANDATORY\_TERMS | 제안에 PaymentScheduleTerm이 포함된 경우 FixedUpfrontPricingTerm을 제공합니다. PaymentScheduleTerm |
| 누락\_이름 | 제안을 릴리스하기 전에 이름을 설정합니다. |
| TOO\_MANY\_OFFERS | 제품당 하나의 공개 제안만 생성할 수 있습니다. |
| TOO\_MANY\_OFFERS | 제품당 하나의 공개 무료 평가판 제안만 생성할 수 있습니다. |
## 기존 CPPO 정의
카탈로그 API를 사용하여에서 CPPO 세부 정보를 정의할 수 있습니다 AWS Marketplace.
기존 CPPO를 정의하려면 다음 예제와 같이 `Offer@1.0`엔터티 유형으로 `DescribeEntity` API 작업을 호출합니다.
**요청 구문**
```
GET /DescribeEntity?catalog=&entityId= HTTP/1.1
```
필드에 대한 정보를 제공하여 `DescribeEntity` 변경 유형을 추가합니다.
+ **카탈로그**(문자열) - 요청과 관련된 카탈로그입니다. 고정 값: `AWSMarketplace`.
+ **entityId**(문자열) - 설명할 제안의 고유 ID입니다.
**응답 구문**
이 요청에 대한 응답은 제안 세부 정보를 제공하며 다음과 같습니다.
```
{
"EntityType": "Offer@1.0",
"EntityIdentifier": "offer-a5oEXAMPLEzpu@1",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:446235747164:AWSMarketplace/Offer/offer-a5oEXAMPLEzpu",
"LastModifiedDate": "2021-03-10T21:57:16Z",
"Details": {
"Id": "offer-3rEXAMPLErn",
"State": "Released",
"Name": "Test Offer",
"Description": "Worldwide private offer for Test Product",
"PreExistingAgreement": {
"AcquisitionChannel": "External",
"PricingModel": "Contract"
},
"ProductId": "prod-0bEXAMPLEb51",
"ResaleAuthorizationId": "resaleauthz-123456789",
"MarkupPercentage": "5.0",
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "300.00"
},
{
"DimensionKey": "m4.xlarge",
"Price": "400.00"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "0.10"
},
{
"DimensionKey": "m4.xlarge",
"Price": "0.20"
}
]
}
]
},
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2020-12-01T00:00:00Z",
"ChargeAmount": "1000.00"
},
{
"ChargeDate": "2021-06-15T00:00:00Z",
"ChargeAmount": "1250.00"
}
]
}
],
"Rules": [
{
"Type": "TargetingRule",
"PositiveTargeting": {
"CountryCodes": [
"US",
"CA"
],
"BuyerAccounts": [
"118033953248"
]
},
"NegativeTargeting": {
"CountryCodes": [
"XX"
]
}
},
{
"Type": "AvailabilityRule",
"AvailabilityEndDate": "2050-08-30T01:56:03Z"
}
]
}
}
```
`DescribeEntity` 응답의 입력 필드에 대한 정보를 제공합니다.
+ **EntityType**(문자열) - 엔터티의 명명된 유형으로, 입니다`Offer@1.0`.
+ **EntityIdentifier**(문자열) - 형식의 개체 식별자입니다`EntityId@RevisionId`.
+ **EntityArn**(문자열) -이 요청에서 참조되는 변경 세트의 고유 식별자와 연결된 ARN입니다.
+ **LastModifiedDate**(문자열) - 개체의 마지막 수정 날짜로, ISO 8601 형식()입니다`2018-02-27T13:45:22Z`.
+ **DetailsDocument**(객체) - JSON 객체에는 개체의 세부 정보가 포함됩니다.
+ **Id**(문자열) - AWS Marketplace 및의 제안 엔터티에 대한 고유 식별자는 제안 생성 중에 생성됩니다.
+ **상태**(문자열) - 제안의 상태입니다.
+ **이름**(문자열) - 사용자와 고객의 가독성을 높이기 위해 제안과 연결된 이름입니다. 계약 정보의 일부로도 표시됩니다.
+ **설명**(문자열) - 설명은 본인만 사용할 수 있으며 구매자에게 절대 노출되지 않는 자유 형식 텍스트입니다.
+ **PreExistingAgreement**(문자열) -이 제안이 동일한 기본 제품에 대한 기존 고객과의 기존 계약에 대한 갱신인지 여부를 결정합니다. 기존 계약은 내부 또는 외부에 있을 수 AWS 있습니다 AWS Marketplace.는 제안을 감사하고 갱신되었는지 확인할 수 있습니다. AWS 가 제안을 확인할 수 없는 경우 AWS 는 고객의 제안 및 권한을 취소할 수 있습니다.
+ **AcquisitionChannel**(문자열) - 기존 계약이 외부 AWS Marketplace 또는 내부에서 서명되었는지 여부를 나타냅니다 AWS Marketplace. 가능한 값: `External`, `AwsMarketplace`.
+ **PricingModel**(문자열) - 기존 계약에서 사용하는 요금 모델을 나타냅니다. 가능한 값: `Contract`, `Usage`, `Byol`, `Free`.
+ **ProductId**(문자열) - 설명은 본인만 사용할 수 있으며 구매자에게 절대 노출되지 않는 자유 형식 텍스트입니다.
+ **ResaleAuthorizationId**(문자열) - ResaleAuthorization은 비공개 제안을 생성하는 데 사용됩니다.
+ **MarkupPercentage**(문자열) - 채널 파트너가 `UpdateMarkup` 변경 유형에서 전달한 백분율 값입니다. 이 마크업은 이미 용어에 적용됩니다.
+ **용어**(구조 배열) - 용어 목록입니다.
+ **규칙**(구조 배열) - 규칙 목록입니다.