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

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

AMI 기반 제품 작업

를 사용하여 Amazon Machine Image(AMI) 기반 제품 작업을 위한 작업을 자동화AWS Marketplace Catalog API할 수 있습니다.

카탈로그 API를 사용하여 AMI 기반 제품을 생성하는 방법에 대한 자세한 내용은 섹션을 참조하세요제품 생성.

다음 주제에서는 카탈로그 API를 사용하여 AMI 기반 제품에 대한 작업을 수행하는 방법을 설명합니다.

새 버전 추가

카탈로그 API를 사용하여 기존 AMI 기반 제품에 새 버전을 추가할 수 있습니다AWS Marketplace. 를 사용하여 제품에 새 AMI 버전을 추가하는 방법에 대한 자세한 내용은 AWS Marketplace판매자 안내서의 새 버전 추가를 AWS Marketplace Management Portal참조하세요.

AWS Marketplace에 새 AMI를 추가하는 요청이 포함된 요청을 생성할 때는 AMI를 AWS Marketplace 시스템에 복사한 다음 보안 문제를 스캔해야 합니다. AMI에서 작업을 수행할 권한이 있는 AWS Identity and Access Management(IAM) 역할을 생성하여 AWS Marketplace에 AMI에 대한 액세스 권한을 부여해야 합니다. 필요한 권한에 대한 자세한 내용은 AWS Marketplace판매자 안내서의 AWS Marktplace에 AMI에 대한 액세스 권한 부여를 참조하세요.

새 버전을 추가하려면 다음 예제와 같이 AMI 기반 제품의 AddDeliveryOptions 변경 유형으로 StartChangeSet API 작업을 호출합니다. 실제로 새 버전을 생성하지 않고 API 호출을 테스트하려면 Intent 파라미터를 로 설정합니다VALIDATE. 자세한 내용은 의도를 참조하세요.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "AddDeliveryOptions",
      "Entity":
      {
        "Type": "AmiProduct@1.0",
        "Identifier": "prod-example12345"
      },
      "DetailsDocument":
      {
        "Version":
        {
          "VersionTitle": "My new title",
          "ReleaseNotes": "My new Release notes"
        },
        "DeliveryOptions":
        [
          {
            "Details":
            {
              "AmiDeliveryOptionDetails":
              {
                "AmiSource":
                {
                  "AmiId": "ami-1234567890abcdef",
                  "AccessRoleArn": "arn:aws:iam::12345678901:role/AwsMarketplaceAmiIngestion",
                  "UserName": "ec2-user",
                  "OperatingSystemName": "AMAZONLINUX",
                  "OperatingSystemVersion": "Amazon Linux 2 AMI 2.0.20210126.0 x86_64 HVM gp2",
                  "AfiIds": ["afi-1234567890abcdefg", "afi-abcdefg1234567890"] //Optional (Required only for FPGA products)
                },
                "UsageInstructions": "Easy to use AMI",
                "RecommendedInstanceType": "m4.xlarge",
                "SecurityGroups":
                [
                  {
                    "IpProtocol": "tcp",
                    "FromPort": 443,
                    "ToPort": 443,
                    "IpRanges":
                    [
                      "0.0.0.0/0"
                    ]
                  }
                ]
              }
            }
          },
          {
            "DeliveryOptionTitle": "My new AMI with CFTdelivery option",
            "Details":
            {
              "DeploymentTemplateDeliveryOptionDetails":
              {
                "ShortDescription": "My new short description",
                "LongDescription": "My new long description",
                "UsageInstructions": "My new usage instructions",
                "RecommendedInstanceType": "m4.xlarge",
                "ArchitectureDiagram": "https://my-bucket.s3.amazonaws.com/my-folder/diagram.png",
                "Template": "https://my-bucket.s3.amazonaws.com/my-folder/cft.template",
                "TemplateSources":
                [
                  {
                    "ParameterName": "MyAmiParam",
                    "AmiSource":
                    {
                      "AmiId": "ami-1234567890abcdef",
                      "AccessRoleArn": "arn:aws:iam::12345678901:role/AwsMarketplaceAmiIngestion",
                      "UserName": "ec2-user",
                      "OperatingSystemName": "AMAZONLINUX",
                      "OperatingSystemVersion": "Amazon Linux 2 AMI 2.0.20210126.0 x86_64 HVM gp2"
                    }
                  }
                ]
              }
            }
          }
        ]
      }
    }
  ],
  "Intent": "APPLY"
}

다음 목록은 AddDeliveryOptions 변경 유형과 함께 사용하는 입력 필드에 대한 정보를 제공합니다. 달리 명시되지 않는 한 모든 필드는 필수입니다. 이러한 필드에 대한 자세한 내용은 AWS Marketplace판매자 안내서의 새 버전 추가를 참조하세요.

응답 구문

요청에 대한 변경 세트가 생성됩니다. 이 요청에 대한 응답은 변경 세트에 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판매자 안내서의 새 버전 추가를 참조하세요.

비동기 오류

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

를 사용하여 AMI 기반 제품을 생성할 수도 있습니다AWS Marketplace Management Portal. 자세한 내용은 AWS Marketplace판매자 안내서의 AMI 제품을 참조하세요.

AMI 기반 제품 업데이트를 자동화하는 방법을 보여주는 연습은 카탈로그 API(5:08)AWS Marketplace를 사용하여의 제품 목록에 대한 업데이트 자동화 동영상을 참조할 수도 있습니다.

버전 정보 업데이트

카탈로그 API를 사용하여 AMI 기반 제품의 기존 버전에 대한 세부 정보를 업데이트할 수 있습니다AWS Marketplace.

버전의 AMI는 업데이트할 수 없습니다. AMI를 업데이트해야 하는 경우 대신 새 버전을 생성합니다.

새 버전을 추가하려면 다음 예제와 같이 UpdateDeliveryOptions 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateDeliveryOptions",
      "Entity":
      {
        "Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
        "Type": "AmiProduct@1.0"
      },
      "DetailsDocument":
      {
        "Version":
        {
          "ReleaseNotes": "*My new Release notes*"
        },
        "DeliveryOptions":
        [
          {
            "Id": "example1-2222-cccc-2222-cccccccccccc",
            "Details":
            {
              "AmiDeliveryOptionDetails":
              {
                "UsageInstructions": "Easy to use AMI"
              }
            }
          },
          {
            "Id": "example1-2222-dddd-2222-dddddddddddd",
            "Details":
            {
              "DeploymentTemplateDeliveryOptionDetails":
              {work with ami
                "DeliveryOptionTitle": "My updated delivery option title",
                "UsageInstructions": "Updated usage instructions here."
              }
            }
          }
        ]
      }
    }
  ]
}

다음은 UpdateDeliveryOptions 변경 유형을 추가하기 위해 제공하는 입력 필드에 대한 정보입니다. 이러한 필드에 대한 자세한 내용은 AWS Marketplace판매자 안내서의 버전 정보 업데이트를 참조하세요.

응답 구문

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

변경 세트에 대한 자세한 내용은 변경 세트 작업의 내용을 참조하세요. 판매자 제품 변경 세트의 오류에 대한 자세한 내용은 섹션을 참조하세요설정 상태 및 오류 변경.

비동기 오류

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

변경 세트가 처리를 시작한 후 DescribeChangeSet 작업을 사용하여 UpdatePricingTerms 작업을 검색할 수 있습니다. 오류 세부 정보 및 문제 해결에 대한 자세한 내용은이 가이드 설정 상태 및 오류 변경앞부분의 섹션을 참조하세요.

버전 제한

카탈로그 API를 사용하여 AMI 기반 제품의 버전을 제한할 수 있습니다. 이렇게 하면 신규 구매자가 해당 버전을 사용하지 못하지만 기존 구매자가 계속 사용할 수 있습니다. 버전에서 모든 전송 옵션을 제한하면 버전이 제한됩니다. 버전에서 전부는 아니지만 하나 이상의 전송 옵션을 제한하면 해당 버전의 전송 옵션만 제한됩니다. 항상 사용 가능한 제품의 무제한 버전이 하나 이상 있어야 합니다. 따라서 제품의 마지막 공개적으로 사용 가능한 버전을 제한할 수 없습니다.

버전을 제한하려면 다음 예제와 같이 RestrictDeliveryOptions 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictDeliveryOptions",
      "Entity":
      {
        "Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
        "Type": "AmiProduct@1.0"
      },
      "DetailsDocument":
      {
        "DeliveryOptionIds":
        [
          "example1-2222-cccc-2222-cccccccccccc"
        ]
      }
    }
  ]
}

다음은 RestrictDeliveryOptions 변경 유형을 추가하기 위해 제공하는 입력 필드에 대한 정보입니다.

응답 구문

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

비동기 오류

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

향후 AWS 리전지원 업데이트

카탈로그 API를 사용하여에서 AMI 기반 제품에 대한 향후 AWS 리전지원 기본 설정을 변경할 수 있습니다AWS Marketplace.

향후 AWS 리전지원 기본 설정을 변경하려면 다음 예제와 같이 UpdateFutureRegionSupport 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateFutureRegionSupport",
      "Entity":
      {
        "Identifier": "prod-example12345",
        "Type": "AmiProduct@1.0"
      },
      "DetailsDocument":
      {
        "FutureRegionSupport":
        {
          "SupportedRegions":
          [
            "All"
          ]
        }
      }
    }
  ]
}

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

응답 구문

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

비동기 오류

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

지원되는 추가AWS 리전

카탈로그 API를 사용하여 AMI 기반 제품에 AWS 리전지원되는 새를 추가할 수 있습니다AWS Marketplace.

지원되는 새 리전을 추가하려면 다음 예제와 같이 AddRegions 변경 유형을 사용하여 StartChangeSet API 작업을 호출합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "AddRegions",
      "DetailsDocument": {
        "Regions": [
          "us-east-1",
          "ap-northeast-2"
        ]
      },
      "Entity": {
        "Identifier": "prod-123456@1",
        "Type": "AmiProduct@1.0"
      }
    }
  ]
}

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

응답 구문

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

비동기 오류

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

제한AWS 리전

카탈로그 API를 사용하여 AMI 기반 제품에 AWS 리전대해 이전에 지원되는를 제한할 수 있습니다AWS Marketplace.

이전에 지원되는 리전을 제한하려면 다음 예제와 같이 RestrictRegions 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "RestrictRegions",
      "DetailsDocument": {
        "Regions": [
          "us-east-1",
          "ap-northeast-2"
        ]
      },
      "Entity": {
        "Identifier": "prod-123456@1",
        "Type": "AmiProduct@1.0"
      }
    }
  ]
}

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

응답 구문

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

비동기 오류

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

새 인스턴스 유형 추가

카탈로그 API를 사용하여 AMI 기반 제품의 새 인스턴스 유형을 추가할 수 있습니다AWS Marketplace.

AddInstanceTypes는 제품을 생성할 때 기존 제품과 새로 생성된 제품에 새 인스턴스 유형을 추가합니다. 변경 유형은 제품 문서의 모든 버전을 새 인스턴스 유형으로 업데이트합니다.

제한된 인스턴스 유형을 추가할 때 인스턴스 유형을 제한 목록에서 제거하고 사용 가능한 인스턴스 유형 목록에 추가할 수 있습니다. 이를 통해 판매자는 제품 제한을 변경할 수 있습니다. 인스턴스 유형 목록은 교체 가능하며 제품의 영구 제한 상태가 아닙니다.

내부적으로 측정된 제품의 경우 판매자는 별도의 변경 유형을 호출AddDimensions하고 인스턴스 유형에 대한 요금을 UpdatePricingTerms 업데이트해야 합니다.

새 인스턴스 유형을 추가하려면 다음 예제와 같이 RestrictRegions 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

AddInstanceTypes 변경 유형만 아래에 나와 있습니다. 내부적으로 측정된 AMI 판매자는 AMI에 대한 유형을 호출AddInstanceTypes하고 UpdatePricingTerms 변경해야 합니다.

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "AddInstanceTypes",
      "Entity":
      {
        "Identifier": "prod-example12345",
        "Type": "AmiProduct@1.0"
      },
      "DetailsDocument":
      {
        "InstanceTypes":
        [
          "m1.medium"
        ]
      }
    }
  ]
}

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

응답 구문

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

동기 검증

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

비동기 오류

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

인스턴스 유형 제한

카탈로그 API를 사용하여 AMI 기반 제품에 사용할 수 있는 인스턴스 유형을 제한할 수 있습니다AWS Marketplace.

기존 구독자는이 변경의 영향을 받지 않으며 제한된 인스턴스 유형을 사용할 수 있습니다. 그러나 새로운 구매자는 제한된 인스턴스 유형을 사용할 수 없습니다. 현재 인스턴스 유형 구독을 중지하려면(인스턴스 유형이 제한되면) AWS Marketplace판매자 운영 팀에 문의해야 합니다.

RestrictInstanctTypes는 인스턴스 유형을 제품 문서의 모든 버전으로 제한합니다. AddInstanceTypes 변경 유형에서 제품의 모든 버전을 업데이트합니다. 권장 인스턴스 유형을 제한할 수 없습니다. 권장 인스턴스 유형은 버전 수준이므로 판매자가 여러 인스턴스 유형을 제한하지 못할 수 있습니다.

내부적으로 측정된 제품의 경우를 호출할 때 별도의 변경 유형을 호출해야 합니다RestrictDimensions. 이렇게 하면 제한된 인스턴스 유형에 대한 새 제안이 생성되지 않습니다.

AMI 기반 제품에 사용할 수 있는 인스턴스 유형을 제한하려면 다음 예제와 같이 RestrictInstanceTypes 변경 유형으로 StartChangeSet API 작업을 호출합니다.

요청 구문

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictInstanceTypes",
      "Entity":
      {
        "Identifier": "prod-example12345",
        "Type": "AmiProduct@1.0"
      },
      "DetailsDocument":
      {
        "InstanceTypes":
        [
          "m1.medium"
        ]
      }
    }
  ]
}

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

응답 구문

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

동기 검증

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

비동기 오류

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