AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Marketplace API 참조](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS MarketplaceAPIs를 사용하여 재판매 권한 부여 작업
를 사용하여 재판매 권한 부여 작업을 자동화AWS Marketplace Catalog API할 수 있습니다.
*제품은*에서 판매 중인 제품을 설명하지만 AWS Marketplace *재판매 권한* 부여(기회라고도 함)는이 제품을 재판매할 수 있는 권한 부여 방법과 관련된 용어와 규칙을 설명합니다AWS Marketplace. *CPPO*는 재판매 권한 부여의 대상입니다.
재판매 승인에는 제조업체와 채널 파트너 간의 리셀러 계약에 대해 수락할 약관 및 규칙 모음이 있습니다. 재판매 승인 약관을 수락하면 리셀러는 약관에 명시된 조건에 따라 제품에 대한 제안을 생성할 수 있습니다.
재판매 권한 부여에는 두 가지 유형의 규칙이 있습니다.
+ **AvailabilityRule** -에서 재판매 권한 부여의 수명 주기를 제어합니다AWS Marketplace.
+ **PartnerTargetingRule ** - 특정 채널 파트너 집합이 재판매 권한 부여에 액세스할 수 있어야 하는지 여부를 지정합니다.
다음 리소스를 참조하세요.
+ 작업 코드 예제가 포함된 end-to-end 랩은 *AWS Marketplace 판매자 워크숍*의 [랩: 리셀러 권한 부여](https://catalog.workshops.aws/mpseller/en-US/manage-offers-with-api/authorize-a-reseller)를 참조하세요.
+ API 요청의 코드 예제는 GitHub의 *AWS샘플*에서 [Python](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/python/src/catalog_api/resale_authorization) 및 [Java](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java/resources/changeSets/channel_partner_offers) 예제를 참조하세요.
+ 재판매 권한 부여 생성에 대한 동영상은 YouTube의 [AWS Marketplace카탈로그 API를 사용하여 재판매 권한 부여 생성을 참조하세요](https://www.youtube.com/watch?v=vLIbvFYI974).
다음 주제에서는 카탈로그 API를 사용하여 재판매 권한 부여를 생성하고 업데이트하는 방법을 설명합니다.
**Topics**
+ [재판매 권한 부여 사전 조건](#prerequisites)
+ [새 재판매 권한 부여 생성](#create-resale-authorization)
+ [구매자 대상 업데이트](#update-buyer-targeting)
+ [가용성 업데이트](#update-availability-resale-auth)
+ [미래 날짜의 계약의 유효성 업데이트](#update-validity-fda)
+ [법률 리소스 업데이트](#update-existing-legal-terms)
+ [요금 업데이트](#update-existing-pricing-terms)
+ [결제 일정 업데이트](#update-payment-schedule-details)
+ [재판매 권한 부여 세부 정보 업데이트](#update-resale-auth-information)
+ [재판매 권한 부여 제한](#restricte-resale-auth)
+ [재판매 권한 부여를 해제하고 채널 파트너에게 표시](#release-resale-auth)
+ [기존 재판매 권한 부여 설명](#describe-entity-resale-auth)
## 재판매 권한 부여 사전 조건
재판매 승인을 사용하려면 독립 소프트웨어 공급업체(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) 참조하세요.
## 새 재판매 권한 부여 생성
카탈로그 API를 사용하여에서 새 재판매 권한 부여를 생성할 수 있습니다AWS Marketplace.
요청이 성공적으로 처리되면가 `Draft` 상태의 재판매 승인을 AWS Marketplace Catalog API생성합니다. 불완전한 재판매 권한 부여이며 채널 파트너에게 표시되지 않습니다AWS Marketplace.
`Update` 변경 유형을 사용하여 재판매 승인을 완료합니다. 재판매 권한 부여가 완료되면 `ReleaseResaleAuthorization` 변경 유형을 사용하여 재판매 권한 부여 생성 프로세스를 완료하고 재판매 권한 부여를 릴리스합니다. 그러면 전체 재판매 권한 부여를 검증하고 채널 파트너가 이를 볼 수 있습니다AWS Marketplace.
`Draft` 상태에서 재판매 권한 부여를 생성하려면 다음 예제와 같이 `CreateResaleAuthorization` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "xyz",
"Entity":
{
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument":
{
"ProductId": "prod-ad8EXAMPLE51",
"Name": "Test ResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "777788889999"
}
}
]
}
```
입력 필드에 대한 정보를 제공하여 `CreateResaleAuthorization` 변경 유형을 추가합니다.
+ **엔**터티(객체)(필수) - 재판매 승인.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`ResaleAuthorization@1.0`.
+ **DetailsDocument**(객체)(필수) - 요청의 세부 정보입니다.
+ **ProductId**(문자열)(필수) - 재판매 권한 부여를 생성할 제품 ID입니다.
+ **이름**(문자열)(필수) - 사용자와 채널 파트너의 가독성을 높이기 위해 ResaleAuthorization과 연결된 이름입니다.
+ **설명**(문자열)(선택 사항) - ResaleAuthorization에 대한 세부 정보를 추가할 수 있는 자유 형식 텍스트 필드입니다.
+ **ResellerAccountId**(문자열)(필수) - 이를 설명하고 사용하여 비공개 제안을 `ResaleAuthorization` 생성할 수 AWS 계정있는 대상 채널 파트너의를 추가합니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `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를 통해 직접 요청 상태를 확인할 수 있습니다.
요청이 완료되면(가 `Status`인 경우`SUCCEEDED`) 새 `ResaleAuthorization`가 생성됩니다. `SUCCEEDED` 상태는 `CreateResaleAuthorization` 변경 유형 호출이 완료되었음을 나타내지만 `ResaleAuthorization` 상태는 여전히 `Draft` 상태입니다.
다음은 [DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html) API 작업의 응답을 보여줍니다.
```
{
"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": "CreateResaleAuthorization",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"ProductId": "prod-ad8EXAMPLE51",
"Name": "Test ResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "777788889999",
"BulkRequestId": "84977023-5093-4a66-8b24-ef2c5a2f8b1f"
},
"ErrorDetailList":
[]
}
]
}
```
**동기 검증**
스키마 검증은의 `CreateResaleAuthorization` 작업에 따라 다릅니다AWS Marketplace Catalog API. 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP 코드 |
| --- | --- | --- |
| ProductId | 필수
null이거나 비어 있으면 안 됩니다.
길이는 1\~50자여야 합니다. | 422 |
| ProductId | 사용자는 지정된 제품에 대한 ResaleAuthorization 생성할 권한이 있어야 합니다. | 403 |
| ProductId | 카탈로그의 기존 제품이어야 하며 Draft 상태가 아니어야 합니다.제품을 재판매할 수 있도록 지원해야 합니다. | 404 |
| 이름 | 필수
null이거나 비어 있으면 안 됩니다.
길이는 1\~100자여야 합니다.
특수 문자는 허용되지 않음 | 422 |
| 설명 | 선택 사항
길이는 1\~255자여야 합니다.
특수 문자는 허용되지 않음 | 422 |
| ResellerAccountId | 필수
비어 있으면 안 됩니다.
AWS 계정IDs 유효한 형식(12자리 숫자)이어야 합니다. | 422 |
| BulkRequestId | 선택 사항
길이는 1\~50자여야 합니다.
UUID 형식이어야 합니다. | 422 |
| 알 수 없는 속성 | 추가 속성은 허용되지 않습니다. | 422 |
**비동기 오류**
다음 오류는의 `CreateResaleAuthorization ` 작업에만 해당됩니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INVALID\_RESELLER\_ACCOUNT | 유효한 리셀러 계정을 제공합니다. |
## 구매자 대상 업데이트
카탈로그 API를 사용하여 재판매 승인을 대상으로 하는 구매자를 업데이트할 수 있습니다AWS Marketplace.
최신 요청에 포함되지 않은 기존 대상 지정 옵션은 재판매 권한 부여에서 제거됩니다. 이 변경 유형은 재판매 권한 부여 릴리스의 경우 선택 사항입니다.
재판매 권한 부여를 대상으로 하는 구매자를 업데이트하려면 다음 예제와 같이 `UpdateBuyerTargetingTerms` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType":"UpdateBuyerTargetingTerms",
"Entity":{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"Terms":
[
{
"Type": "BuyerTargetingTerm",
"PositiveTargeting":
{
"BuyerAccounts":
[
"123456789012"
]
}
}
]
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdateBuyerTargetingTerms` 변경 유형을 추가합니다.
+ **엔**터티(객체)(필수) - 재판매 승인.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`ResaleAuthorization@1.0`.
+ **식별자**(문자열)(필수) - 재판매 권한 부여 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청의 세부 정보입니다.
+ **용어**(구조 배열)(선택 사항) - 업데이트하려는 용어를 대상으로 하는 구매자 목록입니다. `ResaleAuthorization` 특정 구매자를 대상으로 하지 않으려는 경우 용어 필드를 건너뛸 수 있습니다. 기본적으로 `ResaleAuthorization`는 모든 구매자를 대상으로 합니다. 지원되는 용어는 다음과 같습니다.
+ **BuyerTargetingTerms**(객체)(선택 사항) - ResaleAuthorization에 대한 구매자별 대상 지정을 정의합니다.
+ **유형**(문자열)(필수) - 업데이트 중인 용어의 범주입니다.
+ **PositiveTargeting**(객체)(필수) - 구매자의 프로필이에 대한 액세스를 허용하기 위해 충족해야 하는 기준을 정의합니다`ResaleAuthorization`.
+ **BuyerAccounts**(문자열 배열)(선택 사항) - 선택 사항으로 나열합니다. 대상 구매자의를 추가할 수 있습니다AWS 계정. 특정 구매자를 대상으로 `ResaleAuthorization` 하지 않으려는 경우이 필드를 생략해야 합니다. 기본적으로 모든 구매자를 대상으로 합니다. 지정된 경우 대상 채널 파트너는 비공개 제안을 생성하고 구매자 하위 집합을 대상으로 지정할 수 있습니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `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를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
스키마 검증은의 `UpdateBuyerTargetingTerms` 작업에 따라 다릅니다AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 |
| --- | --- |
| 용어 | 선택 사항
null이거나 비어 있으면 안 됩니다.
목록에는 "BuyerTargetingTerm"만 허용됩니다.
목록 크기는 1이어야 합니다(현재 여러 구매자 조건이 필요한 사용 사례는 없음). |
| BuyerTargetingTerm.PositiveTargeting | 필수
비어 있으면 안 됩니다. |
| BuyerTargetingTerm.PositiveTargeting.BuyerAccounts | 선택 사항
AWS 계정IDs 유효한 형식(12자리 숫자)이어야 합니다.
25개 이상의 계정을 포함할 수 없습니다. |
| 알 수 없는 속성 | 추가 속성은 허용되지 않습니다. |
**비동기 오류**
다음 오류는의 `UpdateBuyerTargetingTerms` 작업에만 해당됩니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_BUYER\_TARGETING | PreExistingBuyerAgreement를 사용한 ResaleAuthorization에는 하나 이상의 구매자 계정이 있어야 합니다. |
## 가용성 업데이트
카탈로그 API를 사용하여 생성된 비공개 제안 수 또는 비공개 제안을 생성할 수 있는 특정 시점까지의 가용성을 제한할 수 있습니다.
규칙 목록에서 가용성을 확인할 수 있지만 기본적으로이 값은이 재판매 권한 부여의 무제한 사용입니다.
재판매 권한 부여의 가용성과 사용성을 제어하려면 다음 예제와 같이 `UpdateAvailability` 변경 유형을 사용하여 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateAvailability",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"AvailabilityEndDate": "2022-05-31",
"OffersMaxQuantity": 1
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdateAvailability` 변경 유형을 추가합니다.
+ **엔**터티(객체)(필수) - 재판매 승인.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`ResaleAuthorization@1.0`.
+ **식별자**(문자열)(필수) - 재판매 권한 부여 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청의 세부 정보입니다.
+ **AvailabilityEndDate**(문자열)(선택 사항) - 채널 파트너가를 활용하여 제안을 `ResaleAuthorization` 생성할 수 있을 때까지 종료 날짜를 정의합니다. 채널 파트너는 지정된 종료 날짜까지 이를 `ResaleAuthorization` 여러 번 사용할 수 있습니다. 날짜는 ISO\_8601 형식으로 표시됩니다.
+ **OffersMaxQuantity**(정수)(선택 사항) - ResaleAuthorization을 사용하여 생성할 수 있는 최대 비공개 제안 수를 정의합니다. 구독 수는 정의되지 않습니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `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를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
스키마 검증은의 `UpdateAvailability` 작업에 따라 다릅니다AWS Marketplace Catalog API. 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 |
| --- | --- |
| OffersMaxQuantity | 선택 사항
음수가 아닌 정수여야 합니다.
허용된 값만 "1"(현재 여러 수량을 지원하는 사용 사례 없음) |
| AvailabilityEndDate | 선택 사항
ISO\_8601 형식이어야 합니다.
미래 날짜여야 합니다. |
| 가용성 | OffersMaxQuantity 또는 AvailabilityEndDate를 제공합니다. |
| 알 수 없는 속성 | 추가 속성은 허용되지 않습니다. |
**비동기 오류**
다음 오류는 AWS Marketplace Catalog API의 `UpdateAvailability` 작업에만 해당됩니다. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INVALID\_AVAILABILITY\_END\_DATE | ResalePaymentScheduleTerms의 모든 ChargeDate 앞에 있는 AvailabilityEndDate를 제공합니다. ChargeDate |
| INVALID\_AVAILABILITY\_END\_DATE | 향후 AvailabilityEndDate를 제공합니다. |
## 미래 날짜의 계약의 유효성 업데이트
카탈로그 API를 사용하여 미래 날짜의 서비스 시작 날짜를 수정하고 제어할 수 있습니다AWS Marketplace.
이 변경 세트는 재판매 권한 부여를 해제하는 데 필수는 아닙니다.
재판매 권한 부여의 제품 계약 기간을 수정하고 제어하려면 다음 예제와 같이 `UpdateBuyerValidityTerms` 변경 유형을 사용하여 `StartChangeSet` API 작업을 호출합니다.
**참고**
장래 날짜의 계약은 SaaS 제품 유형에 대해서만 지원됩니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateBuyerValidityTerms",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"Terms":
[
{
"Type": "BuyerValidityTerm",
"MaximumAgreementStartDate": "2024-05-31"
}
]
}
}
]
}
```
입력 필드에 대한 정보를 제공하여 `UpdateBuyerValidityTerms` 변경 유형을 추가합니다.
+ **엔**터티(객체)(필수) - 재판매 권한 부여.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`ResaleAuthorization@1.0`.
+ **식별자**(문자열)(필수) - 재판매 권한 부여 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청의 세부 정보입니다.
+ **용어**(구조 배열) - 업데이트하려는 계약 유효 기간 목록입니다. 지원되는 용어는 다음과 같습니다.
+ **BuyerValidityTerm**(객체) - ResaleAuthorization에서 제품에 대한 서비스의 가용성을 정의합니다.
+ **유형**(문자열) - 업데이트 중인 용어의 범주입니다.
+ **MaximumAgreementStartDate**(문자열)(필수) - 제공된 제품의 계약 시작 날짜를 정의합니다. 미래 날짜의 제안은이 서비스 시작 날짜를 초과할 수 없습니다. 날짜는 ISO\_8601 형식으로 표시됩니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `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를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
스키마 검증은의 `UpdateBuyerValidityTerms` 작업에 따라 다릅니다AWS Marketplace Catalog API. 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 |
| --- | --- |
| 용어 | 필수
null이거나 비어 있으면 안 됩니다.
목록에는 "BuyerValidityTerm"만 허용됩니다.
목록 크기는 1이어야 합니다(현재 여러 서비스 가용성 조건이 필요한 사용 사례는 없음). |
| MaximumAgreementStartDate | 필수
null이거나 비어 있으면 안 됩니다.
미래 날짜여야 하며 지금부터 3년을 초과해서는 안 됩니다.
ISO\_8601 형식이어야 합니다. |
| 알 수 없는 속성 | 추가 속성은 허용되지 않습니다. |
**비동기 오류**
다음 오류는의 `UpdateBuyerValidityTerms ` 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_PRODUCT | 제품에는 BuyerValidityTerm이 지원되지 않습니다. |
| INVALID\_MAXIMUM\_AGREEMENT\_START\_DATE | 허용된 한도에 향후 MaximumAgreementStartDate를 입력합니다. |
## 법률 리소스 업데이트
카탈로그 API를 사용하여에서 기존 법률 용어를 완전히 바꿀 수 있습니다AWS Marketplace.
최신 요청에 포함되지 않은 법적 약관은 재판매 권한 부여에서 제거됩니다. `BuyerLegalTerm`에는 최종 구매자 계약에 포함될 EULA와 채널 파트너와 ISV 간의 리셀러 계약에 포함될 리셀러 계약이 `LegalTerm` 포함되어 있습니다.
의 법적 조건을 업데이트하려면 다음 예제와 같이 `UpdateLegalTerms` 변경 유형으로 `StartChangeSet` API 작업을 `ResaleAuthorization`호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateLegalTerms",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"Terms":
[
{
"Type": "BuyerLegalTerm",
"Documents":
[
{
"Type": "CustomEula",
"Url": "https://my-public-bucket.s3.amazonaws.com/eula-example12345.txt"
}
]
},
{
"Type": "ResaleLegalTerm",
"Documents":
[
{
"Type": "CustomResellerContract",
"Url": "https://my-public-bucket.s3.amazonaws.com/reseller-example12345.txt"
}
]
}
]
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdateLegalTerms` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - 재판매 승인.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`ResaleAuthorization@1.0`.
+ **식별자**(문자열)(필수) - 재판매 권한 부여 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청의 세부 정보입니다.
+ **용어**(구조 배열)(필수) - 법적 용어 목록입니다. 지원되는 법률 용어는 다음과 같습니다.
+ **BuyerLegalTerm**(객체)(필수) - 수락자에게 제안할 텍스트 계약 목록을 정의합니다. 최종 사용자 라이선스 계약(EULA)을 예로 들 수 있습니다.
+ **유형**(문자열)(필수) - 업데이트 중인 용어의 범주입니다.
+ **문서**(구조 배열)(필수) - 구매자에게 제안할 법적 리소스에 대한 참조 목록입니다. EULA를 예로 들 수 있습니다. 각 참조는 `Type` 및 로 구성됩니다`URL`.
+ **유형**(문자열)(필수) - 문서 유형입니다. 사용 가능한 문서 유형은 다음과 같습니다.
+ **StandardEula** - 표준 계약AWS Marketplace. 자세한 내용은 *AWS Marketplace 판매자 안내서*의 [SCMP](https://docs.aws.amazon.com/marketplace/latest/userguide/standardized-license-terms.html#standard-contracts)를 참조하세요. 이 유형은에서 관리하므로 URL을 제공할 필요가 없습니다AWS Marketplace.
+ **EnterpriseEula** -에 대한 엔터프라이즈 계약입니다AWS Marketplace. 자세한 내용은 AWS Marketplace판매자 안내서의 DSA를 참조하세요. 이 유형은에서 관리하므로 URL을 제공할 필요가 없습니다AWS Marketplace.
+ **CustomEula** - 제조업체가 제공하는 사용자 지정 EULA입니다. 이 문서 유형에는 액세스 가능한 S3 버킷에 저장된 EULA의 URL이 필요합니다.
+ **URL**(문자열)(조건부 필수) - 구매자가 읽을 수 있는 법률 문서의 URL입니다. 이는 범주 유형이 인 경우에 필요합니다`CustomEula`.
+ **ResaleLegalTerm**(객체)(선택 사항) - 채널 파트너에게만 제안할 텍스트 계약 목록을 정의합니다. 이 기간은 구매자가 사용할 수 없습니다.
+ **유형**(문자열)(필수) - 업데이트 중인 용어의 범주입니다.
+ **문서**(구조 배열)(필수) - 채널 파트너에게 제안할 리셀러 법률 리소스에 대한 참조 목록입니다.
+ **유형**(문자열)(필수) - 문서의 범주입니다. 사용 가능한 문서 유형은 다음과 같습니다.
+ **StandardResellerContract** - 표준 리셀러 계약AWS Marketplace.
+ **CustomResellerContract** - 제조업체가 체결한 사용자 지정 리셀러 계약입니다. 리셀러 계약의 URL은 액세스 가능한 S3 버킷에 저장되며이 문서 유형에 필요합니다.
+ **URL**(문자열)(조건부 필수) - 채널 파트너가 읽을 수 있는 리셀러 계약 문서의 URL입니다. 유형이 CustomResellerContract인 경우 필요합니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `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를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
스키마 검증은의 `UpdateLegalTerms` 작업에 따라 다릅니다AWS Marketplace Catalog API. 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP 코드 |
| --- | --- | --- |
| 용어 | 필수
null이거나 비어 있으면 안 됩니다. | 422 |
| 용어[].BuyerLegalTerm | 필수
null이거나 비어 있으면 안 됩니다. | 422 |
| 용어[].ResaleLegalTerm | 선택 사항
있는 경우 null이거나 비어 있으면 안 됩니다. | 422 |
| 용어[].BuyerLegalTerm.Documents | 필수
null이거나 비어 있으면 안 됩니다. | 422 |
| 용어[].BuyerLegalTerm.Documents[].유형 | 필수
null이거나 비어 있으면 안 됩니다.
허용된 값:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/marketplace/latest/developerguide/work-with-resale-authorizations.html) | 422 |
| 용어[].BuyerLegalTerm.Documents[].URL | 필수이며 "Type"이 "CustomEula"인 경우 유효한 URL이어야 합니다."Type"이 ["StandardEula", "EnterpriseEula"] 중 하나인 경우 제공해서는 안 됩니다. | 422 |
| 용어[].ResaleLegalTerm.Documents | 필수
null이거나 비어 있으면 안 됩니다. | 422 |
| 용어[].ResaleLegalTerm.Documents[].유형 | 필수
null이거나 빈 값이어서는 안 됩니다. 허용된 값:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/marketplace/latest/developerguide/work-with-resale-authorizations.html) | 422 |
| 용어[].ResaleLegalTerm.Documents[].URL | 필수이며 "Type"이 "CustomResellerContract"인 경우 유효한 URL이어야 합니다.
"Type"이 ["StandardContract"] 중 하나인 경우 제공해서는 안 됩니다. | 422 |
| 알 수 없는 속성 | 추가 속성은 허용되지 않습니다. | 422 |
**비동기 오류**
다음 오류는의 `UpdateLegalTerms` 작업에만 해당됩니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet`후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INVALID\_BUYER\_LEGAL\_DOCUMENTS | 액세스 가능한 S3 버킷에 저장된 구매자 법률 문서의 URLs을 제공합니다. |
| 유효하지 않은\_재판매\_법적\_문서 | 액세스 가능한 S3 버킷에 저장된 재판매 법률 문서의 URLs을 제공합니다. |
| MISSING\_MANDATORY\_TERMS | BuyerLegalTerm을 제공합니다. |
## 요금 업데이트
카탈로그 API를 사용하여에서 기존 요금 조건을 완전히 바꿀 수 있습니다AWS Marketplace.
최신 요청에 포함되지 않은 요금 조건은 재판매 권한 부여에서 제거됩니다. 이 API를 통해 제품의 할인 요금을 업데이트할 수 있습니다.
재판매 권한 부여에 대한 요금 세부 정보를 업데이트하려면 다음 예제와 같이 `UpdatePricingTerms` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdatePricingTerms",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"PricingModel": "Contract",
"Terms":
[
{
"Type": "ResaleUsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards":
[
{
"RateCard":
[
{
"DimensionKey": "m3.large",
"Price": "0.10"
},
{
"DimensionKey": "m4.xlarge",
"Price": "0.20"
}
]
}
]
},
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards":
[
{
"Selector":
{
"Type": "Duration",
"Value": "P12M"
},
"RateCard":
[
{
"DimensionKey": "m3.large",
"Price": "300"
},
{
"DimensionKey": "m4.xlarge",
"Price": "400"
}
],
"Constraints":
{
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "ResaleFixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Duration": "P2M",
"Price": "200.0",
"Grants":
[
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
}
]
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdatePricingTerms` 변경 유형을 추가합니다.
+ **엔**터티(객체)(필수) - 재판매 권한 부여.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`ResaleAuthorization@1.0`.
+ **식별자**(문자열)(필수) - 재판매 권한 부여 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청의 세부 정보입니다.
+ **PricingModel**(문자열)(필수) - 제안에 대한 요금 모델입니다. 요금 모델의 가능한 값은 다음과 같습니다.
+ **사용량** - 구매자에게 제품 사용량에 대한 요금이 청구되는 사용량 기반 요금 모델입니다.
+ **계약** - 계약 기반 요금 모델에서 구매자에게는 제품 사용에 대한 요금이 미리 청구되거나 유연한 결제 일정이 제공됩니다. 구매자는 계약 이상의 추가 사용량에 대해서도 비용을 지불할 수 있습니다. 채널 파트너는 각 차원의이 결제 일정 및 요금에 마크업을 추가할 수 있습니다.
+ **용어**(구조 배열)(필수) - 업데이트하려는 요금 조건 목록입니다. 지원되는 요금 조건은 다음과 같습니다.
+ **ResaleUsageBasedPricingTerm**(객체) - 제품 사용량에 따라 고객에게 요금이 부과되는 종pay-as-you-go(PAYG) 요금 모델을 정의합니다.
+ **유형**(문자열)(필수) - 용어의 범주입니다.
+ **CurrencyCode**(문자열) -이 용어에 언급된 가격의 통화를 정의합니다. 현재는 USD만 지원됩니다.
+ **RateCards**(구조 배열) - 요율 카드 목록입니다.
+ **RateCard**(구조 배열) - Rate Card는 제품 차원의 단위당 요금을 정의합니다.
+ **DimensionKey**(문자열) - 지정된 권한이 적용되는 차원입니다. 차원은 제품의 용량 범주를 나타내며 제품이에 나열될 때 지정됩니다AWS Marketplace.
+ **가격**(문자열) - 청구할 금액을 계산하는 데 사용되는 제품 차원의 단위 가격입니다.
+ **제약 조건**(객체)(선택 사항) - 수락자가 용어를 구성하는 방법에 대한 제한을 정의합니다.
+ **MultipleDimensionSelection**(문자열)(선택 사항) - 구매자가 요금 카드에서 여러 차원을 선택할 수 있는지 여부를 결정합니다. 가능한 값은 `Allowed` 및 `Disallowed`입니다. 기본값은 `Allowed`입니다.
+ **QuantityConfiguration**(문자열)(선택 사항) - 수락자가 요금 카드의 각 차원에 대한 수량을 구성할 수 있는지 여부를 결정합니다. 가능한 값은 `Allowed` 및 `Disallowed`입니다. 기본값은 `Allowed`입니다.
+ **ResaleFixedUpfrontPricingTerm**(객체) - 고객에게 고정 선결제 금액이 청구되는 선결제 요금 모델을 정의합니다.
+ **유형**(문자열)(필수) - 업데이트 중인 용어의 범주입니다.
+ **CurrencyCode**(문자열) -이 기간에 언급된 가격의 통화를 정의합니다. 이 용어에 언급된 가격의 통화를 정의합니다. USD, AUD, EUR, GBP 및 JPY가 지원됩니다.
+ **가격**(문자열)(필수) -이 기간이 수락될 때 고객에게 청구되는 고정 금액입니다.
+ **기간**(문자열)(필수) - ResaleAuthorization 부여의 계약 기간입니다. 이 필드는 ISO 8601 형식을 지원합니다.
+ **권한 부여**(구조 배열)(필수) - 계약 실행의 일부로 고정 선결제 요금을 수락자에게 부여할 권한입니다.
+ **DimensionKey**(문자열)(필수) - 제품 문서에 정의된 고유한 차원 키입니다. 차원은 제품의 용량 범주를 나타내며 제품이에 나열될 때 지정됩니다AWS Marketplace.
+ **MaxQuantity**(정수)(필수) - 구매자에게 제품의 지정된 차원에 대한 권한을 부여할 수 있는 최대 용량입니다. MaxQuantity가 제공되지 않은 경우 구매자는 지정된 차원을 무제한으로 사용할 수 있습니다.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `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를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은 AWS Marketplace 카탈로그 API의 `UpdatePricingTerms` 작업에 따라 다릅니다. 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 |
| --- | --- |
| 용어 | 필수
null이거나 비어 있으면 안 됩니다.
각 용어는 일회성 허용 용어만 표시해야 합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/marketplace/latest/developerguide/work-with-resale-authorizations.html) |
| 용어[].ResaleUsageBasedPricingTerm.CurrencyCode | 필수
허용되는 값: USD |
| 용어[].ResaleUsageBasedPricingTerm.Validity | 필수
null이거나 비어 있으면 안 됩니다.
예상 형식: ISO 8601 기간 |
| 용어[].ResaleUsageBasedPricingTerm.RateCards | 필수
null이거나 비어 있으면 안 됩니다. |
| 용어[].ResaleUsageBasedPricingTerm.RateCards[].DimensionKey | 필수
null이거나 비어 있으면 안 됩니다.
길이는 1\~60이어야 합니다. |
| 용어[].ResaleUsageBasedPricingTerm.RateCards[].가격 | 필수
null이거나 비어 있으면 안 됩니다.
데이터 형식은 "문자열"입니다.
음수가 아니어야 합니다.
최대 8십진수 지원
특수 문자가 지원되지 않음 |
| 용어[].ResaleConfigurableUpfrontPricingTerm.CurrencyCode | 필수
허용되는 값: ["USD", "AUD", "EUR", "GBP", "JPN"] |
| 용어[].ResaleConfigurableUpfrontPricingTerm.RateCards[].Selector.Type | 필수
null이거나 비어 있으면 안 됩니다.
허용된 값: 기간 |
| 용어[].ResaleConfigurableUpfrontPricingTerm.RateCards[].Selector.Value | 필수
null이거나 비어 있으면 안 됩니다.
예상 형식: ISO 8601 기간 |
| 용어[].ResaleConfigurableUpfrontPricingTerm.RateCards[].RateCard.DimensionKey | 필수
null이거나 비어 있으면 안 됩니다.
길이는 1\~60이어야 합니다. |
| 용어[].ResaleConfigurableUpfrontPricingTerm.RateCards[].RateCard.Price | 필수
null이거나 비어 있으면 안 됩니다.
데이터 형식은 "문자열"입니다.
음수가 아니어야 합니다.
최대 6십진수 지원
특수 문자가 지원되지 않음 |
| 용어[].ResaleConfigurableUpfrontPricingTerm.RateCards[].제약 조건 | 선택 사항 |
| 용어[].ResaleFixedUpfrontPricingTerm.CurrencyCode | 필수 허용되는 값: ["USD", "AUD", "EUR", "GBP", "JPN"] |
| 용어[].ResaleFixedUpfrontPricingTerm.Price | 필수
null이거나 비어 있으면 안 됩니다.
데이터 형식은 "문자열"입니다.
음수가 아니어야 합니다.
최대 6십진수 지원
특수 문자가 지원되지 않음
허용되는 값: 0.0 |
| 용어[].ResaleFixedUpfrontPricingTerm.Duration | 필수
null이거나 비어 있으면 안 됩니다.
예상 형식: ISO 8601 기간 |
| 용어[].ResaleFixedUpfrontPricingTerm.Grants[].DimensionKey | 필수
null이거나 비어 있으면 안 됩니다.
길이는 1\~60이어야 합니다. |
| 용어[].ResaleFixedUpfrontPricingTerm.Grants[].MaxQuantty | 필수
null이거나 비어 있으면 안 됩니다. |
| 알 수 없는 속성 | 추가 속성은 허용되지 않습니다. |
**비동기 오류**
다음 오류는의 `UpdatePricingTerms` 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INVALID\_CURRENCY\_CODE | 모든 요금 및 결제 조건에 동일한 CurrencyCode를 제공합니다. |
| INCOMPATIBLE\_PRODUCT | [x]의 제품에서 사용 가능한 기존 차원을 사용합니다. |
| DUPLICATE\_DIMENSION\_KEYS | [x]에서 차원 키의 고유한 목록을 비율 카드에 제공 |
| INVALID\_RATE\_CARD | [x]에서 단위가 동일한 차원 제공 |
| INVALID\_RATE\_CARD | ResaleUsageBasedPricingTerm에서 측정된 차원에 대해서만 요금 카드를 제공합니다. |
| INVALID\_RATE\_CARD | ResaleUsageBasedPricingTerm에서 사용 가능한 모든 측정 차원에 대한 사용량 기반 요금을 제공합니다. |
| TOO\_MANY\_RATES | ResaleUsageBasedPricingTerm의 허용된 한도 내에서 RateCards를 제공합니다. ResaleUsageBasedPricingTerm |
| DUPLICATE\_SELECTORS | ResaleConfigurableUpfrontPricingTerm에 고유한 선택기 목록을 제공합니다. |
| INVALID\_RATE\_CARD | ConfigurableUpfrontPricingTerm에 기간 [x] 동안 하나 이상의 차원 키가 누락되었습니다. 모든 기간 동안 동일한 차원 키 세트에 대한 가격을 제공합니다. |
| INVALID\_RATE\_CARD | 모든 측정된 차원 또는 권한이 있는 모든 차원을 [x]로 입력합니다. |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | PricingModel 대한 ResaleConfigurableUpfrontPricingTerm에서 MultipleDimensionSelection 및 QuantityConfiguration을 허용되지 않음으로 설정합니다. QuantityConfiguration ResaleConfigurableUpfrontPricingTerm |
| TOO\_MANY\_RATE\_CARDS | ConfigurableUpfrontPricingTerm의 요금 카드 하나만 제품에 허용됩니다. |
| INCOMPATIBLE\_TERMS | 다음 조건은 PricingModel [x,y,z]과 호환되지 않습니다. |
| TOO\_MANY\_RATES | 허용되는 한도 내에서 RateCards를 [x term]으로 제공합니다. |
| TOO\_MANY\_GRANTS | [x term]에 최대 [N]개의 권한 부여를 제공합니다. |
| INVALID\_SELECTOR\_DURATION\_VALUE | ResaleConfigurableUpfront에서 [x]\~[y]개월의 기간 제공 |
| TOO\_MANY\_GRANTS | [x]\~[y]개월의 기간을 입력합니다. |
| INVALID\_SELECTOR\_DURATION\_VALUE | ResaleConfigurableUpfront에서 측정된 차원의 지속 시간 세부 수준이 일 수준인지 확인 |
| INVALID\_DURATION | FixedUpfront에서 측정된 차원의 지속 시간 세부 수준이 일 수준인지 확인합니다. |
| INVALID\_RATE\_CARD | [x]에 권한이 있는 차원만 제공합니다. |
| 누락\_지속 시간 | [x]로 기간을 입력합니다. |
| DUPLICATE\_DIMENSION\_KEYS | Grants에 [x]의 고유한 차원 키 목록을 제공합니다. |
| 호환되지 않는\_결제\_설정 | CurrencyCode와 호환되도록 결제 설정을 업데이트합니다. |
| INCOMPATIBLE\_SELLER\_VERIFICATION | 필요한 모든 판매자 확인 프로세스를 완료합니다. |
| INVALID\_CURRENCY\_CODE | 지원되는 CurrencyCode를 제공합니다. |
| INVALID\_CURRENCY\_CODE | 모든 요금 및 결제 조건에 동일한 CurrencyCode를 제공합니다. |
| 호환되지 않는\_통화\_코드 | 제안이 릴리스된 후에는 CurrencyCode를 변경할 수 없습니다. |
## 결제 일정 업데이트
카탈로그 API를 사용하여 유연한 결제 일정과 같은 결제 관련 세부 정보를 변경할 수 있습니다AWS Marketplace.
재판매 권한 부여에 대한 결제 관련 세부 정보를 업데이트하려면 다음 예제와 같이 `UpdatePaymentScheduleTerms` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"Terms":
[
{
"Type": "ResalePaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule":
[
{
"ChargeDate": "2021-12-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2022-03-01",
"ChargeAmount": "250.00"
}
]
}
]
}
}
]
}
```
필드에 대한 정보를 제공하여 `UpdatePaymentScheduleTerms` 변경 유형을 추가합니다.
+ **엔**터티(객체)(필수) - 재판매 승인.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`ResaleAuthorization@1.0`.
+ **식별자**(문자열)(필수) - 재판매 권한 부여 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청의 세부 정보입니다.
+ **용어**(구조 배열) - 업데이트하려는 결제 조건 목록입니다. 지원되는 결제 조건은 다음과 같습니다.
+ **ResalePaymentScheduleTerm**(객체) - 계약 유효 기간 동안 고객에게 다른 날짜에 고정 요금이 청구되는 할부 기반 요금 모델을 정의합니다.
+ **유형**(문자열) - 업데이트 중인 용어의 범주입니다.
+ **CurrencyCode**(문자열)(필수) - 일정에 언급된 결제에 대한 통화를 정의합니다. USD, AUD, EUR, GBP 및 JPY가 지원됩니다.
+ **일정**(구조 배열) - 각 요소가 하나의 결제 분할을 정의하는 결제 일정 목록입니다. 여기에는 지불할 가격과 고객에게 요금이 청구되는 날짜를 계산하는 데 필요한 정보가 포함되어 있습니다.
+ **ChargeDate**(문자열)(필수) - 고객이이 결제 일정 기간에 정의된 요금을 지불하는 날짜입니다. 이 필드는 ISO 8601 형식을 지원합니다.
+ **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 |
| --- | --- | --- |
| Terms.Type | 필수
[x] 제품에는 지원되지 않음
허용된 조건: ResalePaymentScheduleTerm | 422 |
| 용어[].CurrencyCode | 필수
허용되는 값: USD | 422 |
| 용어[].ResalePaymentScheduleTerm.Schedule | 필수
길이는 1\~60이어야 합니다. | 422 |
| 용어[].ResalePaymentScheduleTerm.Shedule.ChargeDate | 필수
ISO 8601 형식이어야 합니다.
날짜는 미래여야 합니다. | 422 |
| 용어[].ResalePaymentScheduleTerm.Shedule.ChargeAmount | 필수
음수가 아니어야 합니다. | 422 |
| 알 수 없는 속성 | 추가 속성은 허용되지 않습니다. | 422 |
**비동기 오류**
다음 오류는의 `UpdatePaymentScheduleTerms` 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 또는를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_TERMS | OffersMaxQuantity 및 AvailabilityEndDate는 ResalePaymentScheduleTerm에 있어야 합니다. |
| TOO\_MANY\_SCHEDULED\_결제 | ResalePaymentScheduleTerm에서 최대 60개의 예약된 결제를 제공합니다. |
| DUPLICATE\_™\_DATES | ResalePaymentScheduleTerm에 고유한 청구 날짜를 입력합니다. |
| INVALID\_™\_DATES | 향후 ChargeDate를 제공합니다. |
| INVALID\_™\_DATES | [x] 이전의 마지막 청구 날짜를 입력합니다. |
| MISSING\_MANDATORY\_TERMS | ResaleFixedUpfrontPricingTerm과 ResalePaymentScheduleTerm을 함께 제공합니다. |
| INVALID\_CURRENCY\_CODE | 모든 요금 및 결제 조건에 동일한 CurrencyCode를 제공합니다. |
| 호환되지 않는\_결제\_설정 | CurrencyCode와 호환되도록 결제 설정을 업데이트합니다. |
| INCOMPATIBLE\_SELLER\_VERIFICATION | 필요한 모든 판매자 확인 프로세스를 완료합니다. |
| INVALID\_CURRENCY\_CODE | 지원되는 CurrencyCode를 제공합니다. |
| INVALID\_CURRENCY\_CODE | 모든 요금 및 결제 조건에 동일한 CurrencyCode를 제공합니다. |
| 호환되지 않는\_통화\_코드 | 제안이 릴리스된 후에는 CurrencyCode를 변경할 수 없습니다. |
## 재판매 권한 부여 세부 정보 업데이트
카탈로그 API를 사용하여에서 재판매 권한 부여 세부 정보를 업데이트할 수 있습니다AWS Marketplace.
재판매 권한 부여 세부 정보를 업데이트하려면 다음 예제와 같이 `UpdateInformation` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**참고**
`UpdateInformation` 변경 유형은 요청에 제공된 섹션만 업데이트하며 다른 모든 정보는 변경되지 않습니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateInformation",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument":
{
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"PreExistingBuyerAgreement":
{
"AcquisitionChannel": "AwsMarketplace",
"PricingModel": "Contract"
}
}
}
]
}
```
`UpdateInformation` 변경 유형을 추가할 필드에 대한 정보를 제공합니다.
+ **엔**터티(객체)(필수) - 재판매 권한 부여.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`ResaleAuthorization@1.0`.
+ **식별자**(문자열)(필수) - 재판매 권한 부여 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 재판매 권한 부여에 대한 정보를 업데이트하려는 정보를 포함하여 요청의 세부 정보입니다.
+ **이름**(문자열)(선택 사항) - 사용자와 채널 파트너의 가독성을 높이기 위해 ResaleAuthorization과 연결된 이름입니다.
+ **설명**(문자열)(선택 사항) - 설명은 ResaleAuthorization에 대한 세부 정보를 추가할 수 있는 자유 형식 텍스트입니다.
+ **PreExistingBuyerAgreement**(객체)(선택 사항) -이 제안이 동일한 기본 제품에 대해 기존 고객과 체결한 기존 계약의 갱신인지 여부를 결정합니다. 기존 계약은 내부 또는 외부에 있을 수 AWS있습니다AWS Marketplace.는 제안을 감사하고 갱신되었는지 확인할 수 있습니다. 가 제안을 확인할 수 없는 경우AWS AWS는 고객의 제안 및 권한을 취소할 수 있습니다.
+ **AcquisitionChannel**(문자열)(필수) - 기존 구매자 계약이 외부에서 서명되었는지 AWS Marketplace아니면 로그인되었는지 나타냅니다AWS Marketplace.
가능한 값: `External`, `AwsMarketplace`
+ **PricingModel**(문자열)(필수) **-** 기존 계약에서 사용하는 요금 모델을 나타냅니다.
가능한 값: `Contract`, `Usage`, `BYOL`, `Free`
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `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를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
다음 스키마 검증은의 `UpdateInformation` 작업에 따라 다릅니다AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행`StartChangeSet`되며 입력이 다음 요구 사항을 충족하지 않으면 HTTP 오류와 함께 요청이 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP 코드 |
| --- | --- | --- |
| 이름 | 선택 사항
null이거나 비어 있으면 안 됩니다.
길이는 1\~100자여야 합니다.
패턴 ^[A-Za-z0-9]\*$
특수 문자 또는 공백은 허용되지 않음 | 422 |
| 설명 | 선택 사항
길이는 1\~255자여야 합니다.
패턴 ^[A-Za-z0-9\\\\s]\*$
특수 문자는 허용되지 않음 | 422 |
| 알 수 없는 속성 | 추가 속성은 허용되지 않습니다. | 422 |
**비동기 오류**
다음 오류는의 `UpdateInformation` 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 또는를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_BUYER\_TARGETING | PreExistingBuyerAgreement를 사용한 ResaleAuthorization에는 하나 이상의 구매자 계정이 있어야 합니다. |
## 재판매 권한 부여 제한
카탈로그 API를 사용하여에서 제한 규칙을 재판매 권한 부여로 설정할 수 있습니다AWS Marketplace.
채널 파트너는 더 이상 제한된 재판매 권한 부여를 사용하여 비공개 제안을 생성할 수 없습니다. 기존 비공개 제안은 영향을 받지 않습니다.
재판매 승인을 제한하려면 다음 예제와 같이 `RestrictResaleAuthorization` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**중요**
이는 되돌릴 수 없는 작업입니다. 재판매 승인이 로 표시된 후에는 다시 `Active` 상태가 될 `Restricted`수 없습니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument": {}
}
]
}
```
필드에 대한 정보를 제공하여 `RestrictResaleAuthorization` 변경 유형을 추가합니다.
+ **개체**(객체)(필수) - 재판매 승인.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`ResaleAuthorization@1.0`.
+ **식별자**(문자열)(필수) - 재판매 권한 부여 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청의 세부 정보입니다. 의 빈 객체여야 합니다`RestrictResaleAuthorization`.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `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를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
스키마 검증은 AWS Marketplace Catalog API의 `RestrictResaleAuthorization` 작업에 따라 다릅니다. 이러한 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP 코드 |
| --- | --- | --- |
| DetailsDocument | 비어 있어야 합니다. | 422 |
| RestrictResaleAuthorization | 만료된 ResaleAuthorization는 로 표시할 수 없습니다. `Restricted` | 422 |
| 알 수 없는 속성 | 추가 속성은 허용되지 않습니다. | 422 |
**비동기 오류**
다음 오류는의 `RestrictResaleAuthorization` 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 또는를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| INCOMPATIBLE\_STATUS | 만료된 ResaleAuthorization는 제한으로 표시할 수 없습니다. |
## 재판매 권한 부여를 해제하고 채널 파트너에게 표시
카탈로그 API를 사용하여 `Active` 상태로 `ResaleAuthorization`를 시작할 수 있습니다.
`ReleaseResaleAuthorization`는 채널 파트너가 재판매 승인을 사용하여 비공개 제안을 생성할 수 있도록 재판매 승인을 활성화합니다.
재판매 권한 부여를 해제하려면 다음 예제와 같이 `ReleaseResaleAuthorization` 변경 유형으로 `StartChangeSet` API 작업을 호출합니다.
**요청 구문**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity":
{
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-123456789"
},
"DetailsDocument": {}
}
]
}
```
필드에 대한 정보를 제공하여 `ReleaseResaleAuthorization` 변경 유형을 추가합니다.
+ **엔**터티(객체)(필수) - 재판매 권한 부여.
+ **유형**(문자열)(필수) -는 항상 `Type`입니다`ResaleAuthorization@1.0`.
+ **식별자**(문자열)(필수) - 재판매 권한 부여 ID입니다. 자세한 내용은 [식별자](catalog-apis.md#identifier) 단원을 참조하십시오.
+ **DetailsDocument**(객체)(필수) - 요청의 세부 정보입니다. 의 경우 비어 있어야 합니다`ReleaseResaleAuthorization`.
**응답 구문**
요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 `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를 통해 직접 요청 상태를 확인할 수 있습니다.
**동기 검증**
스키마 검증은의 `ReleaseResaleAuthorization` 작업에 따라 다릅니다AWS Marketplace Catalog API. 검증은를 호출할 때 수행됩니다`StartChangeSet`. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.
| 입력 필드 | 검증 규칙 | HTTP 코드 |
| --- | --- | --- |
| 알 수 없는 속성 | 추가 속성은 허용되지 않습니다. | 422 |
**비동기 오류**
다음 오류는의 `ReleaseResaleAuthorization` 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 `DescribeChangeSet` 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 `DescribeChangeSet` 방법에 대한 자세한 내용은 섹션을 참조하세요[변경 세트 작업](catalog-apis.md#working-with-change-sets).
| 오류 코드 | 오류 메시지 |
| --- | --- |
| MISSING\_MANDATORY\_TERMS | BuyerLegalTerm을 제공합니다. |
| MISSING\_MANDATORY\_TERMS | PricingTerm 제공합니다. |
| INCOMPATIBLE\_PRODUCT | 제한적 또는 공개 상태의 활성 제품을 사용합니다. |
| INCOMPATIBLE\_PRICING\_TERM | PaymentScheduleTerm과 FixedUpfrontPricingTerm이 함께 있어야 합니다. |
| INCOMPATIBLE\_BUYER\_TARGETING | PreExistingBuyerAgreement를 사용한 ResaleAuthorization에는 하나 이상의 구매자 계정이 있어야 합니다. |
| MISSING\_MANDATORY\_TERMS | [x,y,z] 중 하나 이상을 제공합니다. |
| INCOMPATIBLE\_STATUS | [x] 재판매 권한이 릴리스된 후에는 요청을 수행할 수 없습니다. |
## 기존 재판매 권한 부여 설명
재판매 권한 부여 세부 정보를 설명하려면 다음 예제와 같이 `ResaleAuthorization@1.0`엔터티 유형으로 `DescribeEntity` API 작업을 호출합니다.
**요청 구문**
```
GET /DescribeEntity?catalog=&entityId= HTTP/1.1
```
필드에 대한 정보를 제공하여 `DescribeEntity` 변경 유형을 추가합니다.
+ **카탈로그**(문자열) - 요청과 관련된 카탈로그입니다. 고정 값: `AWSMarketplace`.
+ **entityId**(문자열) - 설명할의 고유 ID`ResaleAuthorization`입니다.
**응답 구문**
이 요청에 대한 응답은 제안 세부 정보를 제공하며 다음과 같습니다.
```
{
"EntityType": "ResaleAuthorization@1.0",
"EntityIdentifier": "resaleauthz-123456789",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/ResaleAuthorization/resaleauthz-123456789",
"LastModifiedDate": "2021-03-10T21:57:16Z",
"DetailsDocument": {
"Name": "TestResaleAuthorization",
"Description": "ResaleAuthorization for Test Product",
"ProductId": "prod-ad8EXAMPLE51",
"ProductName": "TestProduct",
"Status": "Active", /*Draft, Active, Restricted*/
"PreExistingBuyerAgreement": {
"AcquisitionChannel": "Unknown",
"PricingModel": "Unknown"
},
"CreatedDate": "2023-07-18T16:39:31.335Z",
"ManufacturerLegalName": "ChannelCAPI.Inc",
"ManufacturerAccountId": "123456789012",
"Dimensions": [
{
"Name": "Protected Resources",
"Description": "Additional 100 protected resources",
"Key": "hundredresources",
"Unit": "Units",
"Types": [
"Entitled"
]
}
],
"OfferDetails": {
"OfferExtendedStatus": "Not Started", /* Not Started, Completed-Used, Completed-Usable*/
"OfferCreatedCount": 0
},
"Terms": [
{
"Type": "ResaleUsageBasedPricingTerm",
"Id": "term_id_placeholder",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "resource_number",
"Price": "0.05"
},
{
"DimensionKey": "scanned_data",
"Price": "0.05"
}
]
}
]
},
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"Id": "term_id_placeholder",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P24M"
},
"RateCard": [
{
"DimensionKey": "hundredresources",
"Price": "0.04"
},
{
"DimensionKey": "tenTBData",
"Price": "0.03"
},
{
"DimensionKey": "channel_custom",
"Price": "0.02"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "ResaleFixedUpfrontPricingTerm",
"Id": "term-sdh27fb2",
"CurrencyCode": "USD",
"Duration": "P180D",
"Price": "0.0",
"Grants": [
{
"DimensionKey": "sdf73rbns93nl120d10xm1",
"MaxQuantity": 1
}
]
},
{
"Type": "ResalePaymentScheduleTerm",
"Id": "term-sdh27fb2",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2018-07-01T00:00:00.000Z",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2019-05-01T00:00:00.000Z",
"ChargeAmount": "200.00"
}
]
},
{
"Type": "BuyerLegalTerm",
"Id": "term_id_placeholder",
"Documents": [
{
"Type": "StandardEula",
"Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/a85cace8-6d9d-40ca-a053-78fc265479bf?isSigned=yes"
}
]
},
{
"Type": "ResaleLegalTerm",
"Id": "term_id_placeholder",
"Documents": [
{
"Type": "StandardResellerContract",
"Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/bed55b56-7ab4-4c4c-b633-3bf4f6efcb98?isSigned=yes"
}
]
},
{
"Type": "BuyerValidityTerm",
"Id": "term_id_placeholder",
"MaximumAgreementStartDate": "2023-09-25T23:59:59.000Z"
},
{
"Type": "BuyerTargetingTerm",
"Id": "term_id_placeholder",
"PositiveTargeting": {
"BuyerAccounts": [
{
"AwsAccountId": "444455556666"
}
]
}
}
],
"Rules": [
{
"Type": "AvailabilityRule",
"Id": "availability_rule_id_placeholder",
/* If the AvailabilityEndDate and OffersMaxQuantity not present Usage will be Unlimited*/
"Usage": "Limited",
"AvailabilityEndDate": "2022-05-31T23:59:59Z",
"OffersMaxQuantity": 1
},
{
"Type": "PartnerTargetingRule",
"Id": "partner_targeting_rule_id_placeholder",
"ResellerAccountId": "777777777777",
"ResellerLegalName": "ChannelCAPICP.Inc"
}
]
}
}
```
다음은 `DescribeEntity` 응답에 표시되는 필드에 대한 정보입니다.
+ **EntityType**(문자열) - 엔터티의 명명된 유형으로, ResaleAuthorization@1.0입니다.
+ **EntityIdentifier**(문자열) - EntityId@RevisionId 형식의 개체 식별자입니다.
+ **EntityArn**(문자열) -이 요청에서 참조되는 변경 세트의 고유 식별자와 연결된 ARN입니다.
+ **LastModifiedDate**(문자열) - 개체의 마지막 수정 날짜로, ISO 8601 형식(2018-02-27T13:45:22Z)입니다.
+ **DetailsDocument**(객체)(필수) -이 JSON 문자열에는 개체의 세부 정보가 포함됩니다.
+ **이름**(문자열) - 사용자와 채널 파트너의 가독성을 높이기 위해 ResaleAuthorization과 연결된 이름입니다. 계약 정보의 일부로 표시됩니다.
+ **설명**(문자열) - 설명은 본인만 사용할 수 있으며 구매자에게 절대 노출되지 않는 자유 형식 텍스트입니다.
+ **ProductId**(문자열) - 설명은 본인만 사용할 수 있으며 구매자에게 절대 노출되지 않는 자유 형식 텍스트입니다.
+ **AgreementToken**(문자열) - ResaleAuthorization의 콘텐츠에서 생성됩니다. 여기에는 계약을 생성하는 동안 용어, 규칙 및 제안자에 대한 정보가 포함되어 있습니다. 조달 중 권한 부여 확인 및 검증에 사용됩니다.
+ **용어**(구조 배열) - 수락을 위해 제시된 용어 목록입니다.
+ **규칙**(구조 배열) - 규칙 또는 지침 세트의 목록입니다.