AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 AWS Marketplace API 참조를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS MarketplaceAPIs를 사용하여 재판매 권한 부여 작업

를 사용하여 재판매 권한 부여 작업을 자동화AWS Marketplace Catalog API할 수 있습니다.

제품은에서 판매 중인 제품을 설명하지만 AWS Marketplace 재판매 권한 부여(기회라고도 함)는이 제품을 재판매할 수 있는 권한 부여 방법과 관련된 용어와 규칙을 설명합니다AWS Marketplace. CPPO는 재판매 권한 부여의 대상입니다.

재판매 승인에는 제조업체와 채널 파트너 간의 리셀러 계약에 대해 수락할 약관 및 규칙 모음이 있습니다. 재판매 승인 약관을 수락하면 리셀러는 약관에 명시된 조건에 따라 제품에 대한 제안을 생성할 수 있습니다.

재판매 권한 부여에는 두 가지 유형의 규칙이 있습니다.

다음 리소스를 참조하세요.

다음 주제에서는 카탈로그 API를 사용하여 재판매 권한 부여를 생성하고 업데이트하는 방법을 설명합니다.

재판매 권한 부여 사전 조건

재판매 승인을 사용하려면 독립 소프트웨어 공급업체(ISVs)와AWS Marketplace 채널 파트너 모두 리소스 공유 권한을 제공하는 서비스 연결 역할을 생성해야 합니다AWS. 두 그룹 모두이 사전 조건을 수행하지 않는 경우 AWS는 ISV의 권한 부여 리소스를 AWS Marketplace채널 파트너와 공유할 수 없습니다. 자세한 내용은 AWS Marketplace 판매자 안내서의에 대한 재판매 권한 부여를 위한 역할 사용을AWS Marketplace 참조하세요.

새 재판매 권한 부여 생성

카탈로그 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 변경 유형을 추가합니다.

응답 구문

요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 ChangeSetArn 대한 ChangeSetId 및를 제공하며 다음과 같습니다.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

변경 요청이 대기열에 추가되고 처리됩니다.

를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 DescribeChangeSet API를 통해 직접 요청 상태를 확인할 수 있습니다.

요청이 완료되면(가 Status인 경우SUCCEEDED) 새 ResaleAuthorization가 생성됩니다. SUCCEEDED 상태는 CreateResaleAuthorization 변경 유형 호출이 완료되었음을 나타내지만 ResaleAuthorization 상태는 여전히 Draft 상태입니다.

다음은 DescribeChangeSet 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 응답으로 실패합니다.

비동기 오류

다음 오류는의 CreateResaleAuthorization 작업에만 해당됩니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

구매자 대상 업데이트

카탈로그 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 변경 유형을 추가합니다.

응답 구문

요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 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 API를 통해 직접 요청 상태를 확인할 수 있습니다.

동기 검증

스키마 검증은의 UpdateBuyerTargetingTerms 작업에 따라 다릅니다AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행됩니다StartChangeSet. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.

비동기 오류

다음 오류는의 UpdateBuyerTargetingTerms 작업에만 해당됩니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

가용성 업데이트

카탈로그 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 변경 유형을 추가합니다.

응답 구문

요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 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 API를 통해 직접 요청 상태를 확인할 수 있습니다.

동기 검증

스키마 검증은의 UpdateAvailability 작업에 따라 다릅니다AWS Marketplace Catalog API. 검증은를 호출할 때 수행됩니다StartChangeSet. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.

비동기 오류

다음 오류는 AWS Marketplace Catalog API의 UpdateAvailability 작업에만 해당됩니다. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

미래 날짜의 계약의 유효성 업데이트

카탈로그 API를 사용하여 미래 날짜의 서비스 시작 날짜를 수정하고 제어할 수 있습니다AWS Marketplace.

이 변경 세트는 재판매 권한 부여를 해제하는 데 필수는 아닙니다.

재판매 권한 부여의 제품 계약 기간을 수정하고 제어하려면 다음 예제와 같이 UpdateBuyerValidityTerms 변경 유형을 사용하여 StartChangeSet API 작업을 호출합니다.

요청 구문

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 변경 유형을 추가합니다.

응답 구문

요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 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 API를 통해 직접 요청 상태를 확인할 수 있습니다.

동기 검증

스키마 검증은의 UpdateBuyerValidityTerms 작업에 따라 다릅니다AWS Marketplace Catalog API. 검증은를 호출할 때 수행됩니다StartChangeSet. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.

비동기 오류

다음 오류는의 UpdateBuyerValidityTerms 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

법률 리소스 업데이트

카탈로그 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 변경 유형을 추가합니다.

응답 구문

요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 ChangeSetArn 대한 ChangeSetId 및를 제공하며 다음과 같습니다.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간 정도 걸릴 수 있습니다.

를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 DescribeChangeSet API를 통해 직접 요청 상태를 확인할 수 있습니다.

동기 검증

스키마 검증은의 UpdateLegalTerms 작업에 따라 다릅니다AWS Marketplace Catalog API. 검증은를 호출할 때 수행됩니다StartChangeSet. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.

비동기 오류

다음 오류는의 UpdateLegalTerms 작업에만 해당됩니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

요금 업데이트

카탈로그 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 변경 유형을 추가합니다.

응답 구문

요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 ChangeSetArn 대한 ChangeSetId 및를 제공하며 다음과 같습니다.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간 정도 걸릴 수 있습니다.

를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 DescribeChangeSet API를 통해 직접 요청 상태를 확인할 수 있습니다.

동기 검증

다음 스키마 검증은 AWS Marketplace 카탈로그 API의 UpdatePricingTerms 작업에 따라 다릅니다. 검증은를 호출할 때 수행됩니다StartChangeSet. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.

비동기 오류

다음 오류는의 UpdatePricingTerms 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

결제 일정 업데이트

카탈로그 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 변경 유형을 추가합니다.

응답 구문

요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 ChangeSetArn 대한 ChangeSetId 및를 제공하며 다음과 같습니다.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간 정도 걸릴 수 있습니다.

를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 DescribeChangeSet API를 통해 직접 요청 상태를 확인할 수 있습니다.

동기 검증

스키마 검증은의 UpdatePaymentScheduleTerms 작업에 따라 다릅니다AWS Marketplace Catalog API. 검증은를 호출할 때 수행됩니다StartChangeSet. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.

비동기 오류

다음 오류는의 UpdatePaymentScheduleTerms 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 또는를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

재판매 권한 부여 세부 정보 업데이트

카탈로그 API를 사용하여에서 재판매 권한 부여 세부 정보를 업데이트할 수 있습니다AWS Marketplace.

재판매 권한 부여 세부 정보를 업데이트하려면 다음 예제와 같이 UpdateInformation 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

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 변경 유형을 추가할 필드에 대한 정보를 제공합니다.

응답 구문

요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 ChangeSetArn 대한 ChangeSetId 및를 제공하며 다음과 같습니다.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간이 걸릴 수 있습니다.

를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 DescribeChangeSet API를 통해 직접 요청 상태를 확인할 수 있습니다.

동기 검증

다음 스키마 검증은의 UpdateInformation 작업에 따라 다릅니다AWS Marketplace Catalog API. 이러한 검증은를 호출할 때 수행StartChangeSet되며 입력이 다음 요구 사항을 충족하지 않으면 HTTP 오류와 함께 요청이 실패합니다.

비동기 오류

다음 오류는의 UpdateInformation 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 또는를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

재판매 권한 부여 제한

카탈로그 API를 사용하여에서 제한 규칙을 재판매 권한 부여로 설정할 수 있습니다AWS Marketplace.

채널 파트너는 더 이상 제한된 재판매 권한 부여를 사용하여 비공개 제안을 생성할 수 없습니다. 기존 비공개 제안은 영향을 받지 않습니다.

재판매 승인을 제한하려면 다음 예제와 같이 RestrictResaleAuthorization 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "RestrictResaleAuthorization",
      "Entity": {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "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 API를 통해 직접 요청 상태를 확인할 수 있습니다.

동기 검증

스키마 검증은 AWS Marketplace Catalog API의 RestrictResaleAuthorization 작업에 따라 다릅니다. 이러한 검증은를 호출할 때 수행됩니다StartChangeSet. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.

비동기 오류

다음 오류는의 RestrictResaleAuthorization 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 또는를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

재판매 권한 부여를 해제하고 채널 파트너에게 표시

카탈로그 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 변경 유형을 추가합니다.

응답 구문

요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 ChangeSetArn 대한 ChangeSetId 및를 제공하며 다음과 같습니다.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

변경 요청이 대기열에 추가되고 처리됩니다. 여기에는 AWS Marketplace지침을 충족하는지 확인하기 위한 정보 검증이 포함됩니다. 검증 프로세스는 몇 분에서 몇 시간이 걸릴 수 있습니다.

를 통해 AWS Marketplace Management Portal또는 API 작업을 사용하여 카탈로그 DescribeChangeSet API를 통해 직접 요청 상태를 확인할 수 있습니다.

동기 검증

스키마 검증은의 ReleaseResaleAuthorization 작업에 따라 다릅니다AWS Marketplace Catalog API. 검증은를 호출할 때 수행됩니다StartChangeSet. 요청이 다음 요구 사항을 충족하지 않으면 HTTP 응답으로 실패합니다.

비동기 오류

다음 오류는의 ReleaseResaleAuthorization 작업과 관련이 있습니다AWS Marketplace Catalog API. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 섹션을 참조하세요변경 세트 작업.

기존 재판매 권한 부여 설명

재판매 권한 부여 세부 정보를 설명하려면 다음 예제와 같이 ResaleAuthorization@1.0엔터티 유형으로 DescribeEntity API 작업을 호출합니다.

요청 구문

GET /DescribeEntity?catalog=<Catalog>&entityId=<EntityId> HTTP/1.1

필드에 대한 정보를 제공하여 DescribeEntity 변경 유형을 추가합니다.

응답 구문

이 요청에 대한 응답은 제안 세부 정보를 제공하며 다음과 같습니다.

{
  "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 응답에 표시되는 필드에 대한 정보입니다.