View a markdown version of this page

제안 세트 작업 - AWS Marketplace

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

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

제안 세트 작업

AWS Marketplace 제안 세트를 사용하면 판매자가 여러 비공개 제안을 구매자를 위한 통합 다중 제품 거래 가능 패키지로 패키징할 수 있습니다. 이 기능은 복잡한 엔터프라이즈 환경에서 포괄적인 end-to-end 솔루션에 대한 증가하는 고객 수요를 해결합니다.

일반적으로 구매자는 여러 판매자로부터 개별 제품을 검색하고 조달해야 했기 때문에 경험 조각화, 통합 문제 및 조달 주기가 길어졌습니다. 제안 세트는 AWS Marketplace 파트너가 여러 제안을 결합하여 고객이 일회성 승인으로 모든 구성 요소를 검토하고 수락할 수 있는 조정된 비공개 제안을 통해 트랜잭션 프로세스를 간소화함으로써 이를 간소화합니다.

제안 세트는 솔루션과 함께 작동하여 포괄적인 다중 제품을 제공합니다. 솔루션은 자세한 설명, 아키텍처 다이어그램 및 사용 사례 설명서를 비롯한 풍부한 마케팅 콘텐츠를 제공하는 반면, 제안 세트는 통합 조달을 위한 거래 가능한 패키징 및 상용 용어를 처리합니다.

제안 세트 엔터티

제안 세트는 2~7개의 비공개 제안을 단일 거래 가능 패키지로 그룹화하는 컨테이너입니다. 제안 세트 내의 각 제안은 고유한 요금, 결제 조건, 기간 및 최종 사용자 라이선스 계약(EULA)을 유지하는 반면, 제안 세트는 구매자에게 통합된 검색 및 수락 경험을 제공합니다.

주요 특성:

  • 여러 비공개 제안을 그룹화합니다(최소 2개, 최대 7개).

  • 단일 작업으로 모든 제안을 통합 구매자 수락 가능

  • 각 제안에 대해 고유한 용어로 유연성을 유지합니다.

  • 각 제품에 대해 별도의 계약을 생성하여 구매 후 독립 관리를 허용합니다.

  • 향상된 마케팅 콘텐츠를 위해 솔루션과 선택적으로 연결할 수 있습니다.

제안 세트 엔터티 유형은 입니다OfferSet@1.0.

개체 식별자

제안 세트는 offerset-* 식별자 형식(예: offerset-abc123def456)을 사용합니다.

개체 ARN 형식

제안 세트는 표준 AWS ARN 형식을 따릅니다.

arn:aws:aws-marketplace:{region}:{account-id}:AWSMarketplace/OfferSet/{offerset-id}

예제:

arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-abc123def456

제안 세트 시작하기

이 섹션에서는 AWS Marketplace 카탈로그 API 변경 유형을 사용하여 제안 세트를 생성하고 관리하는 방법에 대한 자세한 정보를 제공합니다.

시작하기 전에, 다음 사항을 확인해야 합니다.

제안 세트 나열

계정의 모든 제안 세트를 나열하려면가 로 EntityType 설정된 ListEntities API 작업을 호출합니다OfferSet.

요청

POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet" }

응답

{ "EntitySummaryList": [ { "EntityType": "OfferSet", "EntityId": "offerset-xyz123", "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123", "LastModifiedDate": "2025-06-25T23:46:25Z", "OfferSetSummary": { "Name": "Enterprise Security Solution Offer Set", "State": "Released", "ReleaseDate": "2025-06-25T23:46:20Z", "SolutionId": "soln-abc987", "AssociatedOfferIds": [ "offer-abc123", "offer-def456", "offer-ghi789" ] } } ], "NextToken": null }

상태별로 제안 세트 필터링

EntityTypeFilters 파라미터를 사용하여 상태별로 제안 세트를 필터링할 수 있습니다.

요청

POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "State": { "ValueList": [ "Released" ] } } } }

솔루션 ID를 기준으로 제안 세트 필터링

EntityTypeFilters 파라미터를 사용하여 솔루션 ID별로 제안 세트를 필터링할 수 있습니다.

요청

POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "SolutionId": { "ValueList": [ "soln-abc987" ] } } } }

릴리스 날짜별로 제안 세트 필터링

릴리스 날짜별로 제안 세트를 필터링하고 EntityTypeFiltersEntityTypeSort 파라미터를 사용하여 결과를 정렬할 수 있습니다.

요청

POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "ReleaseDate": { "AfterValue": "2025-11-01" } } }, "EntityTypeSort": { "OfferSetSort": { "SortBy": "ReleaseDate", "SortOrder": "DESCENDING" } } }

제안 세트 설명

특정 제안 세트에 대한 자세한 정보를 가져오려면 DescribeEntity API 작업을 호출합니다.

요청

GET /DescribeEntity?catalog=AWSMarketplace&entityId=offerset-xyz123 HTTP/1.1

응답

{ "EntityType": "OfferSet@1.0", "EntityId": "offerset-xyz123", "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123", "LastModifiedDate": "2025-06-25T23:46:25Z", "DetailsDocument": { "Id": "offerset-xyz123", "Name": "Enterprise Security Solution Offer Set", "BuyerNotes": "Complete security solution including endpoint protection and network monitoring", "State": "Released", "SolutionId": "soln-abc987", "ReleaseDate": "2025-06-25T23:46:20Z", "AssociatedOffers": [ { "OfferId": "offer-abc123" }, { "OfferId": "offer-def456" }, { "OfferId": "offer-ghi789" } ] } }

제안 세트 생성

CreateOfferSet 변경 유형을 사용하여 초안 상태에서 새 제안 세트 개체를 생성합니다. 이 단계는 제안 세트 수명 주기의 첫 번째 단계로, 구매자에게 릴리스하기 전에 나중에 제안 연결 및 메타데이터로 구성될 기본 엔터티를 설정합니다.

요청 구문

POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "CreateOfferSet", "Entity": { "Type": "OfferSet@1.0" }, "ChangeName": "CreateOfferSetChange", "DetailsDocument": { "Name": "Enterprise Security Solution Offer Set" } } ] }

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

  • Entity (객체)(필수) - 생성 중인 엔터티 유형입니다.

    • Type (문자열)(필수) - 여야 합니다OfferSet@1.0.

  • DetailsDocument (객체)(필수) - 요청의 세부 정보입니다.

    • Name (문자열)(필수) - 사용자와 고객의 가독성을 높이기 위해 제안 세트와 연결된 이름입니다. 최소 길이: 1자. 최대 길이: 150자.

응답 구문

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

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

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

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

처리가 성공하면는 접두사가 인 고유 식별자가 있는 초안 상태의 제안 세트를 AWS Marketplace 생성합니다offerset-.

제안 세트 정보 업데이트

UpdateInformation 변경 유형을 사용하여 이름 및 구매자 메모를 포함하여 기존 제안 세트의 세부 정보를 수정합니다.

요청 구문

POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "UpdateInformation", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Name": "Updated Enterprise Security Offer Set", "BuyerNotes": "Complete security solution including endpoint protection, network monitoring, and professional services implementation" } } ] }

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

  • Entity (객체)(필수) - 업데이트 중인 엔터티입니다.

    • Identifier (문자열)(필수) - 제안 세트 ID입니다. 자세한 내용은 식별자 단원을 참조하십시오.

    • Type (문자열)(필수) - 여야 합니다OfferSet@1.0.

  • DetailsDocument (객체)(필수) - 하나 이상의 필드를 제공해야 합니다.

    • Name (문자열)(선택 사항) - 구매자가 볼 수 있는 표시 이름입니다. 최소 길이: 1자. 최대 길이: 150자.

    • BuyerNotes (문자열)(선택 사항) - 구매자가 용도와 내용을 이해하는 데 도움이 되는 제안 세트에 대한 세부 정보입니다. 최소 길이: 1자. 최대 길이: 1,000자.

응답 구문

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

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

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

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

제안을 제안 세트와 연결

AssociateOffers 변경 유형을 사용하여 여러 AWS Marketplace 제안을 제안 세트와 연결합니다. 이렇게 하면 제안과 제안 세트 간의 관계가 생성되어 제안 세트의 거래 가능한 구성의 일부가 됩니다.

작업은 멱등성이며 현재 상태에 관계없이 제안을 연결할 수 있으므로 개별 제안이 릴리스되기 전에 완전한 구성을 사용할 수 있습니다. 각 제안은 하나의 제안 세트에만 속할 수 있습니다.

중요

개별 제안OfferSetId의는 변경할 수 없으며 제안 생성 중에만 설정할 수 있습니다. 를 사용하여 제안을 제안 세트와 연결AssociateOffers하기 전에 먼저 개별 제안을 생성하고 제안 생성 OfferSetId 중에를 지정해야 합니다. 올바른가 없는 기존 제안을 포함해야 하는 경우 올바른가 OfferSetId 지정된 새 제안을 생성OfferSetId해야 합니다.

필수 IAM 권한에 대한 자세한 내용은 섹션을 참조하세요제안 세트에 대한 IAM 권한.

요청 구문

POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "AssociateOffers", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Offers": [ { "OfferId": "offer-xyz789" }, { "OfferId": "offer-def456" }, { "OfferId": "offer-ghi123" } ] } } ] }

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

  • Entity (객체)(필수) - 업데이트 중인 엔터티입니다.

    • Identifier (문자열)(필수) - 제안 세트 ID입니다. 자세한 내용은 식별자 단원을 참조하십시오.

    • Type (문자열)(필수) - 여야 합니다OfferSet@1.0.

  • DetailsDocument (객체)(필수) - 요청의 세부 정보입니다.

    • Offers (배열)(필수) - 연결할 AWS Marketplace 제안 목록입니다. 최소: 항목 1개. 최대: 항목 7개.

      • OfferId (문자열)(필수) - AWS Marketplace 제안의 식별자입니다. 최소 길이: 1자. 최대 길이: 36자.

응답 구문

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

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

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

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

비동기 오류

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

오류 코드 오류 메시지

TOO_MANY_OFFERS

최대 7개의 제안을 제안 세트에 연결합니다.

INCOMPATIBLE_OFFER_SET_REFERENCE

모든 제안이이 제안 세트에 대해 특별히 생성되었는지 확인합니다.

INVALID_UPDATE_REQUEST

요청된 변경은 제안 세트가 릴리스된 후에는 수행할 수 없습니다.

제안 세트에서 제안 연결 해제

DisassociateOffers 변경 유형을 사용하여 AWS Marketplace 제안 세트에서 여러 제안을 제거합니다. 이 멱등성 작업은 제안의 OfferSetId 속성을 유지하면서 연결 관계를 제거합니다. 연결 해제된 제안은 동일한 제안 세트와 다시 연결될 때까지 구매자 검색에서 숨겨집니다. 다른 제안 세트와 연결할 수 없습니다.

요청 구문

POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "DisassociateOffers", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Offers": [ { "OfferId": "offer-xyz789" } ] } } ] }

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

  • Entity (객체)(필수) - 업데이트 중인 엔터티입니다.

    • Identifier (문자열)(필수) - 제안 세트 ID입니다. 자세한 내용은 식별자 단원을 참조하십시오.

    • Type (문자열)(필수) - 여야 합니다OfferSet@1.0.

  • DetailsDocument (객체)(필수) - 요청의 세부 정보입니다.

    • Offers (배열)(필수) - 연결 해제할 제안 목록입니다. 최소: 항목 1개. 최대: 항목 7개.

      • OfferId (문자열)(필수) - AWS Marketplace 제안의 식별자입니다. 최소 길이: 1자. 최대 길이: 36자.

응답 구문

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

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

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

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

비동기 오류

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

오류 코드 오류 메시지

INVALID_UPDATE_REQUEST

요청된 변경은 제안 세트가 릴리스된 후에는 수행할 수 없습니다.

솔루션을 제안 세트와 연결

AssociateSolution 변경 유형을 사용하여 단일 AWS Marketplace 솔루션을 제안 세트와 연결합니다. 이렇게 하면 구매자가 제안 세트의 솔루션 연결을 검색하고 자세한 설명, 아키텍처 다이어그램 및 사용 사례 설명서와 같은 솔루션의 풍부한 마케팅 콘텐츠에 액세스할 수 있는 관계가 생성됩니다.

참고

이는 느슨하게 결합된 연결입니다. AWS Marketplace는 솔루션과 제안 세트 간에 일관성을 적용하지 않습니다. 솔루션에는 AWS Marketplace 제품, 제안 세트의 제품과 다른 제품 또는 겹치는 제품이 포함될 수 없습니다. 마케팅 및 검색 목적으로 소유한 솔루션을 연결할 수 있는 완전한 유연성이 있습니다.

필요한 IAM 권한에 대한 자세한 내용은 섹션을 참조하세요제안 세트에 대한 IAM 권한.

요청 구문

POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "AssociateSolution", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "SolutionId": "soln-xyz789" } } ] }

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

  • Entity (객체)(필수) - 업데이트 중인 엔터티입니다.

    • Identifier (문자열)(필수) - 제안 세트 ID입니다. 자세한 내용은 식별자 단원을 참조하십시오.

    • Type (문자열)(필수) - 여야 합니다OfferSet@1.0.

  • DetailsDocument (객체)(필수) - 요청의 세부 정보입니다.

    • SolutionId (문자열)(필수) - 연결할 AWS Marketplace 솔루션의 식별자입니다. 최소 길이: 1자. 최대 길이: 50자. 패턴과 일치해야 합니다^soln-[A-Za-z0-9]+$.

응답 구문

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

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

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

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

비동기 오류

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

오류 코드 오류 메시지

INCOMPATIBLE_SOLUTION_ASSOCIATION

새 솔루션을 연결하기 전에 기존 솔루션의 연결을 해제합니다.

INVALID_UPDATE_REQUEST

요청된 변경은 제안 세트가 릴리스된 후에는 수행할 수 없습니다.

제안 세트에서 솔루션 연결 해제

DisassociateSolution 변경 유형을 사용하여 솔루션과 제안 세트 간의 연결을 제거합니다. 이렇게 하면 제안 세트의 거래 가능한 기능을 유지하면서 제안 세트에서 솔루션의 마케팅 콘텐츠가 제거됩니다.

요청 구문

POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "DisassociateSolution", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "SolutionId": "soln-xyz789" } } ] }

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

  • Entity (객체)(필수) - 업데이트 중인 엔터티입니다.

    • Identifier (문자열)(필수) - 제안 세트 ID입니다. 자세한 내용은 식별자 단원을 참조하십시오.

    • Type (문자열)(필수) - 여야 합니다OfferSet@1.0.

  • DetailsDocument (객체)(필수) - 요청의 세부 정보입니다.

    • SolutionId (문자열)(필수) - 연결을 해제할 솔루션의 식별자입니다. 최소 길이: 1자. 최대 길이: 50자.

응답 구문

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

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

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

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

비동기 오류

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

오류 코드 오류 메시지

INVALID_UPDATE_REQUEST

요청된 변경은 제안 세트가 릴리스된 후에는 수행할 수 없습니다.

제안 세트 릴리스

ReleaseOfferSet 변경 유형을 사용하여 구매자가 제안 세트를 사용할 수 있도록 합니다. 릴리스되면 제안 세트가 초안에서 릴리스됨 상태로 전환되고,를 통해 검색할 수 있게 되며 AWS Marketplace, 관련 제안은 통합 패키지의 일부로만 찾을 수 있습니다.

릴리스된 제안 세트는 개별 제안과 제안 세트 자체의 두 가지 수준에서 알림을 생성합니다. 모든 개별 제안 알림에는 기존 알림 채널(이메일 알림Amazon EventBridge 이벤트)의 OfferSetId가 포함됩니다. 제안 세트가 릴리스될 때와 같은 주요 이벤트에 대해 제안 세트 수준 알림이 전송됩니다.

요청 구문

POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "ReleaseOfferSet", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": {} } ] }

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

  • Entity (객체)(필수) - 업데이트 중인 엔터티입니다.

    • Identifier (문자열)(필수) - 제안 세트 ID입니다. 자세한 내용은 식별자 단원을 참조하십시오.

    • Type (문자열)(필수) - 여야 합니다OfferSet@1.0.

  • DetailsDocument (객체)(필수) -이 작업의 객체가 비어 있습니다.

응답 구문

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

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

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

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

비동기 오류

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

오류 코드 오류 메시지

누락_구매자_노트

제안 세트를 릴리스하기 전에 BuyerNotes를 제공합니다.

누락_꺼짐

제안을 릴리스하기 전에 제안 세트에 두 개 이상의 제안을 연결합니다.

TOO_MANY_OFFERS_PER_PRODUCT

제품당 하나의 제안만 제안 세트에 연결합니다.

일관되지 않은_오퍼_통화_코드

연결된 모든 제안에 일치하는 CurrencyCode가 있는지 확인합니다.

INCONSISTENT_OFFER_AVAILABILITY_END_DATE

연결된 모든 제안에 일치하는 AvailabilityEndDate가 있는지 확인합니다.

일관되지 않은_제안_대상_규칙

연결된 모든 제안에 일치하는 TargetingRule이 있는지 확인합니다.

INCOMPATIBLE_OFFER_TARGETING_RULE

구매자 대상 제안만 제안 세트에 연결할 수 있습니다.

EXPIRED_OFFERS

제안 세트에서 만료된 제안을 연결 해제하거나 AvailabilityEndDates를 확장합니다.

DRAFT_OFFERS

제안 세트를 릴리스하기 전에 모든 관련 제안을 릴리스합니다.

INCOMPATIBLE_SOLUTION_STATE

제한적 또는 퍼블릭 상태의 솔루션을 제공합니다.

INVALID_UPDATE_REQUEST

요청된 변경은 제안 세트가 릴리스된 후에는 수행할 수 없습니다.

제안 세트 수명 주기

제안 세트 수명 주기는 다음 단계로 구성됩니다.

생성 단계

CreateOfferSet 변경 유형을 사용하여 제안 세트 개체를 초안 상태로 생성합니다. 제안 세트는 고유 식별자를 수신하고 초안 상태로 시작됩니다.

구성 단계

구성 중에 다음을 수행합니다.

  • UpdateInformation (이름, 구매자 메모)를 사용하여 메타데이터 추가 또는 업데이트

  • 개별 비공개 제안 생성, 제안 생성 OfferSetId 중 지정

  • 를 사용하여 제안을 제안 세트와 연결 AssociateOffers

  • 선택적으로 향상된 마케팅 콘텐츠를 AssociateSolution 위해를 사용하여 솔루션 연결

중요

개별 제안OfferSetId의는 변경할 수 없으며 제안 생성 중에만 설정할 수 있습니다. 를 사용하여 제안을 제안 세트와 연결AssociateOffers하기 전에 먼저 개별 제안을 생성하고 제안 생성 OfferSetId 중에를 지정해야 합니다. 올바른가 없는 기존 제안을 포함해야 하는 경우 올바른가 OfferSetId 지정된 새 제안을 생성OfferSetId해야 합니다.

검증 단계

제안 세트를 릴리스하기 전에 다음을 확인하세요.

  • 제안 세트에는 2~7개의 제안이 포함됩니다.

  • 모든 관련 제안은 다음과 같아야 합니다.

    • 릴리스됨 상태

    • 활성

    • 동일한 통화 사용

    • 동일한 구매자 AWS 계정 ID(들)를 대상으로 지정

    • 만료 날짜가 동일함

릴리스 단계

준비가 되면 ReleaseOfferSet 변경 유형을 사용하여 제안 세트를 초안에서 릴리스됨 상태로 전환합니다. 이렇게 하면 구매자가 제안 세트를 검색할 수 있습니다 AWS Marketplace.

릴리스 후 관리

만료 관리:

  • 제안 세트의 유효 만료는 모든 관련 제안 중 가장 빠른 만료 날짜로 계산됩니다.

  • 기존 제안 관리 기능(UpdateAvailability 변경 유형)을 사용하여 개별 제안 만료 날짜를 수정할 수 있습니다.

제안 세트 수정 사항:

구매자가 릴리스된 제안 세트에 대한 변경을 요청하면 재생성 워크플로를 사용합니다.

  1. 새 제안 세트 엔터티 생성

  2. 변경이 필요하지 않은 제안의 경우 AWS Marketplace Management Portal을 통해 기존 제안을 복제합니다.

  3. 수정이 필요한 제안의 경우 요청된 변경 사항이 포함된 새 제안을 생성하고 새를 지정합니다. OfferSetId

  4. 를 사용하여 모든 제안(복제 및 신규)을 새 제안 세트와 연결 AssociateOffers

  5. 를 사용하여 새 제안 세트 릴리스 ReleaseOfferSet

  6. 관련 제안의 가용성 종료일을 설정하여 원래 제안 세트 만료

제안 세트에 대한 IAM 권한

AWS Marketplace 카탈로그 API를 사용하여 제안 세트를 사용하려면 특정 IAM 권한이 필요합니다. 이 섹션에서는 제안 세트 작업 및 교차 엔터티 권한 부여 요구 사항에 필요한 권한을 설명합니다.

필수 IAM 작업

제안 세트 작업에 필요한 IAM 작업은 다음과 같습니다.

  • aws-marketplace:StartChangeSet - 생성, 업데이트, 연결 및 릴리스 작업을 포함한 모든 제안 세트 변경 유형에 필요합니다.

  • aws-marketplace:DescribeChangeSet - 변경 세트 실행의 상태 및 결과를 확인하는 데 필요합니다.

  • aws-marketplace:ListEntities - 계정의 제안 세트를 나열하는 데 필요합니다.

  • aws-marketplace:DescribeEntity - 제안 세트에 대한 세부 정보를 검색하는 데 필요합니다.

리소스 권한

다음 ARN 패턴을 사용하여 특정 리소스에 대한 권한을 부여합니다.

  • 제안 세트 - arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*

  • 개별 제안 - arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*

  • 솔루션 - arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*

보다 제한적인 권한을 얻으려면 와일드카드(*)를 특정 엔터티 식별자로 바꿉니다.

교차 엔터티 권한 부여

일부 제안 세트 작업에는 제안 세트와 연결 중인 엔터티 모두에 대한 권한이 필요합니다.

AssociateOffers

  • aws-marketplace:StartChangeSet 제안 세트 엔터티에 대한 권한

  • aws-marketplace:StartChangeSet 연결된 각 개별 제안 엔터티에 대한 AssociateWithOfferSet 변경 유형이 있는 권한

AssociateSolution

  • aws-marketplace:StartChangeSet 제안 세트 엔터티에 대한 권한

  • aws-marketplace:StartChangeSet 연결 중인 솔루션 엔터티에 대한 AssociateWithOfferSet 변경 유형이 있는 권한

참고

제안 또는 솔루션에 대한 DescribeEntity (읽기 전용) 권한만 있으면 연결 작업에 충분하지 않습니다. 제안 세트와 연결된 엔터티에 대한 AssociateWithOfferSet 변경 유형에 대한 StartChangeSet 권한이 있어야 합니다.

예제 IAM 정책

기본 제안 세트 관리

이 정책은 교차 엔터티 연결 없이 기본 제안 세트 작업에 대한 권한을 제공합니다.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:StartChangeSet", "aws-marketplace:DescribeChangeSet", "aws-marketplace:ListEntities", "aws-marketplace:DescribeEntity" ], "Resource": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*" ] } ] }

AssociateOffers에 대한 교차 엔터티 권한

이 정책은 AssociateOffers에 필요한 특정 권한 및 조건을 보여줍니다.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateOffers"] } } }, { "Effect": "Allow", "Action": "aws-marketplace:DescribeEntity", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*" }, { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateWithOfferSet"] } } } ] }

보다 제한적인 권한을 얻으려면 와일드카드(*)를 특정 엔터티 식별자로 바꿉니다.

AssociateSolution에 대한 교차 엔터티 권한

이 정책은 AssociateSolution에 필요한 특정 권한 및 조건을 보여줍니다.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateSolution"] } } }, { "Effect": "Allow", "Action": "aws-marketplace:DescribeEntity", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*" }, { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateWithOfferSet"] } } } ] }

보다 제한적인 권한을 얻으려면 와일드카드(*)를 특정 엔터티 식별자로 바꿉니다.