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

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

솔루션 작업

솔루션은 특정 고객 문제를 해결하기 위해 함께 작동하는 제품 및 서비스 모음입니다. 솔루션에는 AWS Marketplace 제품 및 AWS Marketplace가 아닌 제품이 포함될 수 있습니다. 솔루션은 여러 제품이 통합되어 산업별 사용 사례를 해결하는 방법을 보여주는 데 도움이 됩니다. 이 솔루션은 고객 문제, 사용 사례, 통합 세부 정보 및 관련 제품을 설명합니다.

AWS Marketplace 및 AWS Partner Central의 솔루션

Partner Central 2.0에서 Partner Central 3.0으로 마이그레이션하면 AWS 계정을 생성하고 AWS Marketplace 판매자로 등록하라는 메시지가 표시됩니다. 자세한 내용은 판매자 프로필 등록 및 생성을 참조하세요. 이 등록은 다음을 위해 필요합니다.

프로필 연결 및 마이그레이션 이해

Partner Central 계정과 AWS Marketplace 계정을 연결하는 두 가지 고유한 시나리오가 있습니다.

프로필 연결 전용 - Partner Central 3.0으로 마이그레이션하지 않고 AWS Partner Central 및 AWS 계정을 연결하는 경우 AWS Marketplace 솔루션과 Partner Central 솔루션은 별도로 유지됩니다. 각 플랫폼을 독립적으로 관리합니다.

프로필 마이그레이션 - 연결된 AWS Marketplace 판매자 프로필을 사용하여 Partner Central 3.0으로 마이그레이션하는 경우:

Partner Central APIs에서 기존 AWS Marketplace 솔루션 사용 가능

Partner Central 3.0 프로파일 마이그레이션 전에 생성한 AWS Marketplace 솔루션은 Partner Central APIs에서 자동으로 인식되지 않습니다. 이는 마이그레이션을 완료하고 AWS 계정을 Partner Central 계정과 연결한 후에도 적용됩니다.

기존 사전 마이그레이션 솔루션을 Partner Central APIs에 표시하려면 솔루션의 필드를 업데이트합니다. 현재 있는 것과 동일한 정보를 입력할 수 있습니다. Partner Central 3.0 프로파일 마이그레이션 전에 생성한 각 솔루션에 대해이 프로세스를 반복합니다.

예를 들어 UpdateInformation 변경 유형을 사용하여 솔루션의 이름을 현재 값으로 업데이트합니다. 솔루션을 한 번 업데이트하면 Partner Central APIs는 해당 솔루션에 대한 향후 업데이트를 자동으로 인식합니다.

솔루션 개체

솔루션은 구매자가 상품을 검색하고 이해하는 데 도움이 되는 마케팅 문서입니다. 솔루션에는 제목, 설명, 사용 사례, AWS Marketplace 제품 및 AWS Marketplace가 아닌 제품이 포함되어 있습니다. 솔루션은 제품, 제안 및 제안 세트와는 별도의 엔터티 유형입니다. 각 솔루션에는 구매자가 개별 제품과 별도로 찾아볼 수 있는 자체 검색 및 나열 경험이 있습니다.

주요 특징

솔루션 개체 유형은 입니다Solution@1.0.

개체 식별자

솔루션은 soln-* 식별자 형식(예: soln-abc123def456)을 사용합니다.

개체 ARN 형식

솔루션은 표준 AWS ARN 형식을 따릅니다.

arn:{aws-partition}:aws-marketplace:{region}:{account-id}:{aws-marketplace-catalog}/Solution/{solution-id}

예제:

arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123def456

솔루션 시작하기

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

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

솔루션 나열

계정의 모든 솔루션을 나열하려면 ListEntities API 작업을 호출하고를 솔루션EntityType으로 설정합니다.

요청

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

{
  "Catalog": "AWSMarketplace",
  "EntityType": "Solution"
}

응답

{
  "EntitySummaryList": [
    {
      "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
      "EntityId": "soln-abc123456",
      "EntityType": "Solution",
      "LastModifiedDate": "2024-10-10T19:50:43Z",
      "Name": "Test Solution 1",
      "Visibility": "Limited"
    }
  ],
  "NextToken": null
}

가시성을 기준으로 솔루션 필터링

FilterList 파라미터를 사용하여 가시성을 기준으로 솔루션을 필터링할 수 있습니다.

요청

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

{
  "Catalog": "AWSMarketplace",
  "EntityType": "Solution",
  "FilterList": [
    {
      "Name": "Visibility",
      "ValueList": [
        "Public"
      ]
    }
  ]
}

솔루션 세부 정보 가져오기

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

요청

GET /DescribeEntity?catalog=AWSMarketplace&entityId=soln-abc123456 HTTP/1.1

응답

{
  "Details": "{...}",
  "DetailsDocument": {
    "Lifecycle": {
      "Visibility": "Limited"
    },
    "Identifiers": {
      "Id": "soln-abc123456"
    },
    "Presentation": {
      "Title": "My Solution",
      "Name": "solution_for_customer_X",
      "ShortDescription": "Solution value proposition",
      "LongDescription": "Detailed solution description",
      "LogoUrl": "https://s3.amazonaws.com/logo.jpg",
      "UseCases": [
        {
          "Group": "advertising_and_marketing",
          "SubGroup": "ad_intelligence_and_measurement",
          "Item": "amazon_ads_insights",
          "Description": "Use case description"
        }
      ]
    },
    "RelatedProducts": {
      "AwsMarketplaceProducts": [
        {
          "ProductId": "prod-123"
        }
      ],
      "IntegrationDescription": "How products work together",
      "NonAwsMarketplaceProducts": [
        {
          "Type": "Hardware",
          "Title": "A hardware product",
          "Url": "https://example.com",
          "Description": "My hardware product description"
        }
      ]
    },
    "BuyerEngagement": [
      {
        "EngagementOption": "RequestPrivateOffer"
      }
    ]
  },
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
  "EntityIdentifier": "soln-abc123456@12",
  "EntityType": "Solution@1.0",
  "LastModifiedDate": "2025-04-22T01:02:48Z"
}

솔루션의 변경 기록 나열

특정 솔루션의 변경 기록을 보려면 개체 필터를 사용하여 ListChangeSets API 작업을 호출합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "FilterList": [
    {
      "Name": "EntityId",
      "ValueList": [
        "soln-abc123456"
      ]
    }
  ]
}

솔루션 및 변경 세트에 태그 지정

솔루션을 생성하는 동안 솔루션에 태그를 추가하고 세트를 변경하거나 나중에 업데이트할 수 있습니다.

생성 중 태그

다른 솔루션 CreateSolution 변경 유형이 아닌 변경 유형에EntityTags만를 추가할 수 있습니다. 모든 StartChangeSet페이로드ChangeSetTags에를 추가할 수 있습니다.

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "DetailsDocument": {
        "Name": "Test solution resource name"
      },
      "EntityTags": [
        {
          "Key": "Team",
          "Value": "Solutions"
        }
      ]
    }
  ],
  "ChangeSetTags": [
    {
      "Key": "Environment",
      "Value": "Production"
    }
  ]
}

기존 리소스의 태그 관리

TagResource 및 UntagResource API 작업을 사용하여 기존 솔루션의 태그를 관리하고 세트를 변경합니다. ListTagsForResource를 사용하여 현재 태그를 봅니다.

자세한 내용은 리소스에 대한 태그 관리 및 개체에 태그 추가 및 생성 중 세트 변경을 참조하세요.

솔루션을 생성

CreateSolution 변경 유형을 사용하여 솔루션 ID와 이름만 있는 새 솔루션 문서를 생성할 수 있습니다. 다른 값은 아직 채워지지 않았습니다.

요청이 성공적으로 처리되면 AWS Marketplace에서 자동으로 Draft 상태의 솔루션을 생성합니다. 이 불완전한 솔루션은 AWS Marketplace의 구매자에게 표시되지 않습니다.

그런 다음 UpdateInformation, UpdateRelatedProducts, UpdateBuyerEngagementOptions (솔루션 생성에 선택 사항) 및와 같은 다른 변경 유형을 사용하여 Limited 솔루션을 완료합니다ReleaseSolution. ReleaseSolution 변경 유형은 Limited 솔루션에 필요한 모든 필수 필드가 솔루션에 있는지 확인한 다음 Limited 가시성으로 이동합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "ChangeName": "CreateSolutionChange",
      "DetailsDocument": {
        "Name": "solution_for_customerX_en",
        "Title": "New Partner Solution"
      }
    }
  ]
}

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

응답 구문

요청에 대한 변경 세트가 생성됩니다. 응답은 ChangeSetId 및를 제공합니다ChangeSetArn.

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

변경 요청이 대기열에 추가되고 처리됩니다. AWS Marketplace Management Portal 또는 DescribeChangeSet API 작업을 사용하여 상태를 확인할 수 있습니다.

요청이 성공적으로 완료되면(가 Status인 경우SUCCEEDED) 새 솔루션 ID가 생성됩니다.

비동기 오류

CreateSolution 작업은 일반적인 비동기 오류 외에도 특정 오류를 반환합니다. 변경 세트 처리가 완료된 DescribeChangeSet 후에서 이러한 오류가 발생합니다. 변경 요청 상태를 가져오는 방법을 알아보려면 변경 세트 작업을 참조하세요.

솔루션 정보 업데이트

AWS Marketplace에 이미 솔루션이 있는 경우 카탈로그 API를 사용하여 솔루션 정보를 업데이트할 수 있습니다.

솔루션 정보를 업데이트하려면 UpdateInformation 변경 유형과 업데이트된 세부 정보를 사용하여 StartChangeSet API 작업을 호출합니다. 다음 예제를 참조하세요.

AWS Marketplace는 로고 및 프로모션 미디어 자산을 확인하고 AWS Marketplace 소유 위치로 수집합니다. DescribeEntity는 StartChangeSet의 원래 입력이 아닌 수집된 파일에 대해 액세스 가능한 URL을 반환합니다. 제출된 원래 URLs 보려면 DescribeChangeSet API를 사용합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Identifier": "soln-1234abcd",
        "Type": "Solution@1.0"
      },
      "DetailsDocument": {
        "Name": "project_cold_harbor",
        "Title": "My Awesome Solution",
        "ShortDescription": "Solution value proposition",
        "LongDescription": "Detailed solution description explaining how this addresses customer needs",
        "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/logo.jpg",
        "PromotionalMedia": [
          {
            "Type": "Image",
            "Url": "https://s3.amazonaws.com/awsmp-media/image.jpg",
            "Title": "Sample image",
            "Description": "Sample image description"
          },
          {
            "Type": "Video",
            "Url": "https://s3.amazonaws.com/awsmp-media/video.mp4",
            "Title": "Sample video",
            "PreviewUrl": "https://s3.amazonaws.com/awsmp-media/preview.png",
            "Description": "Sample video description"
          }
        ],
        "AdditionalResources": [
          {
            "Text": "Troubleshooting guide",
            "Url": "https://example.com/troubleshooting"
          }
        ],
        "UseCases": [
          {
            "Group": "advertising_and_marketing",
            "SubGroup": "ad_intelligence_and_measurement",
            "Item": "amazon_ads_insights",
            "Description": "Highlight description of this use case"
          }
        ]
      }
    }
  ]
}

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

미리 서명된 URL 정보는 미리 서명된 URLs.

응답 구문

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

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

변경 요청이 대기열에 추가되고 처리됩니다. 요청 상태를 확인하려면 AWS Marketplace 관리 포털을 사용하거나 DescribeChangeSet API를 호출합니다.

Public 솔루션에 대해 수정된 PromotionalMedia 자산으로이 변경 유형을 트리거한 후 완료하는 데 최대 37일이 걸릴 수 있습니다. 여기에는 AWS Marketplace 판매자 운영 팀이 검토, 감사 및 승인해야 하는 시간이 포함됩니다.

비동기 오류

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

관련 제품 업데이트

카탈로그 API를 사용하여 AWS Marketplace 제품 및 비 AWS Marketplace 제품을 포함하여 솔루션에 포함된 제품 및 서비스를 업데이트할 수 있습니다.

관련 제품을 업데이트하려면 다음 예제와 같이 UpdateRelatedProducts 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateRelatedProducts",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-123456"
      },
      "DetailsDocument": {
        "IntegrationDescription": "How to use the products in this solution (usage guide)",
        "AwsMarketplaceProducts": [
          {
            "ProductId": "prod-123"
          },
          {
            "ProductId": "prod-456"
          }
        ],
        "NonAwsMarketplaceProducts": [
          {
            "Type": "Hardware",
            "Title": "Diamond engine",
            "Description": "Hardware details",
            "Url": "https://example.com/hardware-product-specs.html"
          }
        ]
      }
    }
  ]
}

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

응답 구문

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

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

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

요청 상태를 확인하려면 AWS Marketplace 관리 포털을 사용하거나 DescribeChangeSet API를 호출합니다.

비동기 오류

일반적인 비동기 오류 외에도 다음 오류는 AWS Marketplace Catalog API의 UpdateRelatedProducts 작업에 고유합니다. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 변경 세트 작업을 참조하세요.

솔루션 릴리스

카탈로그 API를 사용하여 AWS Marketplace의 Limited 가시성에 Draft 대한 솔루션을 게시할 수 있습니다.

ReleaseSolution 변경 유형은 Limited 솔루션의 모든 필수 필드가 있는지 확인합니다. 그런 다음 솔루션을에서 Limited 가시성Draft으로 이동합니다. 솔루션이 Limited 가시성 상태가 되면 Draft 가시성으로 되돌릴 수 없습니다.

솔루션을 릴리스하려면 다음 예제와 같이 ReleaseSolution 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "ReleaseSolution",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {}
    }
  ]
}

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

응답 구문

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

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

변경 요청이 대기열에 추가되고 처리됩니다. AWS Marketplace 관리 포털을 통해 또는 API 작업을 사용하여 카탈로그 DescribeChangeSet API를 통해 직접 요청 상태를 확인할 수 있습니다.

비동기 오류

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

구매자 참여 옵션 업데이트

카탈로그 API를 사용하여 구매자의 솔루션 참여 방식을 구성할 수 있습니다.

구매자 참여 옵션을 업데이트하려면 다음 예제와 같이 UpdateBuyerEngagementOptions 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateBuyerEngagementOptions",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": [
        {
          "EngagementOption": "RequestProductDemo"
        },
        {
          "EngagementOption": "RequestPrivateOffer"
        }
      ]
    }
  ]
}

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

응답 구문

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

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

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

요청 상태를 확인하려면 AWS Marketplace 관리 포털을 사용하거나 DescribeChangeSet API를 호출합니다.

비동기 오류

일반적인 비동기 오류 외에도 다음 오류는 AWS Marketplace Catalog API의 UpdateBuyerEngagementOptions 작업에 고유합니다. 이러한 오류는 변경 세트가 처리된 DescribeChangeSet 후를 호출할 때 반환됩니다. 를 사용하여 변경 요청의 상태를 가져오는 DescribeChangeSet 방법에 대한 자세한 내용은 변경 세트 작업을 참조하세요.

솔루션 가시성 업데이트

카탈로그 API를 사용하여 AWS Marketplace에서 솔루션의 가시성을 업데이트할 수 있습니다.

대상 가시성을 Limited, Public또는 로 설정할 수 있습니다Restricted.

를 TargetVisibility로 설정하면 Public UpdateVisibility 변경 유형을 AWS Marketplace 판매자 운영 팀의 수동 검토가 필요합니다. 이렇게 하면 실행 시간이 늘어납니다. 자체 변경 세트에서 UpdateVisibility 별도로 사용합니다.

솔루션의 가시성을 업데이트하려면 다음 예제와 같이 UpdateVisibility 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

TargetVisibility가 Public 또는 인 경우 Limited.

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateVisibility",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {
        "TargetVisibility": "Public"
      }
    }
  ]
}

TargetVisibility가 인 경우 입니다Restricted.

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateVisibility",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {
        "TargetVisibility": "Restricted"
      }
    }
  ]
}

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

응답 구문

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

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

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

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

를 TargetVisibility로 사용하여이 변경 유형을 트리거Public한 후 완료하는 데 최대 37일이 걸릴 수 있습니다. 여기에는 AWS Marketplace 판매자 운영 팀이 검토, 감사 및 승인해야 하는 시간이 포함됩니다.

비동기 오류

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

일반적인 비동기 오류 코드

URL 유효성 및 지원되지 않는 문자 확인과 같이 모든 솔루션 변경 유형에 적용되는 일부 비동기 검증이 있으며, 오류 코드와 오류 메시지가 여기에 나열되어 있습니다.

제공된 각 URL 필드는 HTTPS 프로토콜을 사용해야 하며 RFC2396 또는 RFC 2732 표준을 준수해야 합니다.

솔루션 수명 주기

솔루션은 다음 가시성 값을 통해 진행됩니다.

전체 솔루션의 최소 요구 사항

전체 솔루션을 생성하고 초안 상태 이후에 게시하려면 다음과 같은 변경 유형 및 속성이 필요합니다.

다음 예제에서는 단일 변경 세트에서 Limited 가시성이 있는 완전한 솔루션을 생성하는 방법을 보여줍니다.

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "ChangeName": "CreateSolutionChange",
      "DetailsDocument": {
        "Name": "complete_solution_example",
        "Title": "Complete Solution Example"
      }
    },
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateInformationChange",
      "DetailsDocument": {
        "ShortDescription": "A comprehensive solution for customer needs",
        "LongDescription": "This solution combines multiple products to address specific customer requirements in the advertising and marketing space.",
        "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/solution-logo.jpg",
        "UseCases": [
          {
            "Group": "advertising_and_marketing",
            "SubGroup": "ad_intelligence_and_measurement",
            "Item": "amazon_ads_insights",
            "Description": "Provides comprehensive advertising insights and measurement capabilities"
          }
        ]
      }
    },
    {
      "ChangeType": "UpdateRelatedProducts",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateRelatedProductsChange",
      "DetailsDocument": {
        "AwsMarketplaceProducts": [
          {
            "ProductId": "prod-123"
          }
        ],
        "IntegrationDescription": "These products work together to provide end-to-end advertising analytics and optimization capabilities."
      }
    },
    {
      "ChangeType": "UpdateBuyerEngagementOptions",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateBuyerEngagementChange",
      "DetailsDocument": [
        {
          "EngagementOption": "RequestPrivateOffer"
        }
      ]
    },
    {
      "ChangeType": "ReleaseSolution",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "ReleaseSolutionChange",
      "DetailsDocument": {}
    }
  ]
}

솔루션에 대한 IAM 권한

AWS Marketplace Catalog API는 표준 IAM 권한을 사용합니다. 자세한 내용은 AWS Marketplace Catalog API에 대한 액세스 제어를 참조하세요.

AWSMarketplaceSellerProductFullAccess를 사용하여 AWS Management Console에서 Catalog API 및 Partner Central 3.0을 통해 솔루션에 액세스하는 데 필요한 모든 작업을 수행할 수 있습니다.

솔루션에 대한 샘플 IAM 정책

다음 샘플 IAM 정책은 Solution@1.0엔터티에 대한 특정 작업(DescribeEntity, ListEntities및 StartChangeSet)을 허용합니다. 보안 주체의 액세스를 특정 엔터티 IDs의 특정 변경 유형에 제한하도록 추가로 범위를 좁히거나, 보안 주체가 Catalog API에서 지원하는 다른 엔터티 유형에서도 작동할 수 있도록 범위를 넓힐 수 있습니다.

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ],
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": [
            "CreateSolution",
            "UpdateInformation",
            "UpdateRelatedProducts",
            "ReleaseSolution",
            "UpdateBuyerEngagementOptions",
            "UpdateVisibility"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ListEntities",
        "aws-marketplace:DescribeEntity"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:DescribeChangeSet",
        "aws-marketplace:ListChangeSets",
        "aws-marketplace:CancelChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:TagResource",
        "aws-marketplace:UntagResource",
        "aws-marketplace:ListTagsForResource"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ]
    }
  ]
}

특정 솔루션에 대한 액세스 제한

리소스 ARN의 솔루션 ID를 사용하여 특정 솔루션에 대한 액세스를 제한할 수 있습니다.

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:DescribeEntity",
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-specific123"
      ]
    }
  ]
}

특정 변경 유형에 대한 액세스 제한

조건 키를 사용하여 특정 변경 유형에 대한 액세스를 제한할 수 있습니다.

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
      ],
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": [
            "UpdateInformation",
            "UpdateRelatedProducts"
          ]
        }
      }
    }
  ]
}