View a markdown version of this page

요금 조건 업데이트 - AWS Marketplace
요청 구문필수 필드응답 구문세트 처리 변경오류

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

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

요금 조건 업데이트

카탈로그 API를 사용하여에서 기계 학습 제품의 요금을 업데이트할 수 있습니다 AWS Marketplace.

참고

기계 학습 제품의 지원되는 모든 인스턴스 유형의 가격을 책정해야 합니다. 첫 번째 버전을 생성할 때 UpdatePricingTerms 및는 제품을 게시하기 위해 지원되는 모든 인스턴스 유형에 대한 요금으로 유형을 AddDeliveryOptions 변경합니다. 이전에 지원되지 않은 새 인스턴스 유형이 있는 기존 제품에 새 버전을 추가할 때는 UpdatePricingTerms 및 AddDeliveryOptions 변경 유형에 해당 인스턴스 유형을 포함해야 합니다.

요금 조건을 업데이트하려면 UpdatePricingTerms 변경 유형으로 StartChangeSet 작업을 호출합니다.

요청 구문

POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
    "Catalog": "AWSMarketplace",
    "ChangeSet": [
        {
            "ChangeType": "UpdatePricingTerms",
            "Entity": {
                "Type": "Offer@1.0",
                "Identifier": "$CreateOfferChange.Entity.Identifier"
            },
            "DetailsDocument": {
                "PricingModel": "Usage",
                "Terms": [
                    {
                        "Type": "UsageBasedPricingTerm",
                        "CurrencyCode": "USD",
                        "RateCards": [
                            {
                                "RateCard": [
                                    {
                                      "DimensionKey": "ml.m4.4xlarge.m.i.b",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m5.4xlarge.m.i.b",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m4.16xlarge.m.i.b",
                                      "Price": 0.1
                                    },    
                                    {
                                      "DimensionKey": "m.i.c",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m4.4xlarge.a.t",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m5.4xlarge.a.t",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m4.16xlarge.a.t",
                                      "Price": 0.1
                                    }
                                ]
                            }   
                        ]
                    },
                    {
                        "Type": "FreeTrialPricingTerm",
                        "Duration": "P30D",
                        "Grants": [
                            {
                                "DimensionKey": "ml.m4.4xlarge.m.i.b"
                            },
                              {
                                "DimensionKey": "ml.m5.4xlarge.m.i.b"
                              },
                              {
                                "DimensionKey": "ml.m4.16xlarge.m.i.b"
                              },
                              {
                                "DimensionKey": "m.i.c"
                              },
                              {
                                "DimensionKey": "ml.m4.4xlarge.a.t"
                              },
                              {
                                "DimensionKey": "ml.m5.4xlarge.a.t"
                              },
                              {
                                "DimensionKey": "ml.m4.16xlarge.a.t"
                              }
                        ]
                    }
                ]
            }
        },
    ]
}

필수 필드

  • Entity (객체) (필수) - ML 제품의 제안에 대한 정보를 포함합니다.

    • Identifier (문자열)(필수) - 요금 조건을 업데이트하려는 제안 ID입니다. 자세한 내용은 식별자를 참조하세요.

    • Type (문자열)(필수) - 요금을 업데이트Offer@1.0하려면가 여야 Type 합니다.

  • DetailsDocument (객체)(필수) - 기계 학습 제품의 요금 조건에 대한 세부 정보입니다.

    • PricingModel (문자열)(필수) - 제품의 요금 모델 - 사용량, 무료 및 계약(프라이빗 제안의 경우) 중에서 선택할 수 있습니다. 자세한 내용은 Machine Learning 제품 요금을 참조하세요.

    • Terms (객체 배열) - 제품의 전체 요금을 집합적으로 정의하는 요금 조건 배열입니다.

      • Type (문자열)(필수) - 요금 조건의 유형입니다. 유효한 옵션은 UsageBasedPricingTerm 또는 FreeTrialPricingTerm 또는 입니다FixedUpfrontPricingTerm(프라이빗 제안의 경우).

      • CurrencyCode (문자열) ( UsageBasedPricingTerm 또는 FixedUpfrontPricingTerm - 요금 기간의 통화에 필요합니다. 유효한 값은 USD입니다.

      • RateCards (객체 배열)(의 경우 필수UsageBasedPricingTerm) - 기계 학습 제품의 요금을 정의하는 비율 카드입니다. 이 배열에는 하나RateCard만 포함해야 합니다.

        • RateCard (객체 배열) - 기계 학습 제품의 차원 및 비율 배열입니다. 제품을 게시하려면 지원되는 모든 인스턴스 유형의 가격이 책정되어야 합니다.

          • DimensionKey - 요금을 책정하는 차원입니다. 유효한 차원 키는 다음과 같습니다.

            • 인스턴스 유형 다음에 시간당 요금에 대한 작업이 옵니다.

              • 인스턴스 유형은 로 시작하고 그 ml 뒤에 인스턴스 이름과 크기가 옵니다. exampole의 경우 ml.m4.xlarge

              • 작업은 m.i.b 배치 변환, m.i.r 시간당 실시간 추론 및 알고리즘 훈련a.t에 사용됩니다.

              • 예: ml.m4.4xlarge.m.i.b 배치 변환, ml.m4.xlarge.m.i.r 실시간 추론 또는 ml.m4.16xlarge.a.t 알고리즘 훈련

            • m.i.c 추론당 실시간 요금.

          • Price - 차원 속도입니다. 요금은 dimensionKey에 따라 시간당 또는 추론당입니다.

      • Duration (문자열) ( FreeTrialPricingTerm 또는 FixedUpfrontPricingTerm - 무료 평가판 또는 계약 기간. 무료 평가판의 경우 유효한 값은 X에서 Y 사이입니다. 계약의 경우 유효한 값은 X에서 Y 사이입니다.

      • 권한 부여(객체 배열) - 무료 평가판을 사용할 수 있는 dimensionKeys에 대한 세부 정보입니다. 지원되는 모든 dimensionKeys 제공해야 합니다.

        • DimensionKey - 무료 평가판 제안의 일부로 포함할 차원입니다.

          • 인스턴스 유형 다음에 시간당 요금에 대한 작업이 옵니다.

            • 인스턴스 유형은 로 시작하고 그 ml 뒤에 인스턴스 이름과 크기가 옵니다. 예: ml.m4.xlarge

            • 작업은 m.i.b 배치 변환, m.i.r 시간당 실시간 추론 또는 알고리즘 훈련을 a.t 위한 것입니다.

            • 예: ml.m4.4xlarge.m.i.b 배치 변환, ml.m4.xlarge.m.i.r 실시간 추론 또는 ml.m4.16xlarge.a.t 알고리즘 훈련

          • m.i.c 추론당 실시간 요금.

응답 구문

요청이 성공하면 다음을 반환합니다.

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

세트 처리 변경

변경 요청은 여러 단계를 거치는 처리 대기열로 들어갑니다.

  1. 검증: 시스템은 모든 정보가 AWS Marketplace 지침을 충족하는지 확인합니다.

  2. 상태 모니터링: 요청의 상태를 두 가지 방법으로 확인할 수 있습니다.

    • AWS Marketplace 관리 포털을 통해

    • DescribeChangeSet 작업 사용

  3. 완료: 승인되면 요금 조건이 업데이트됩니다.

오류

비동기 오류

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

오류 코드 오류 메시지
INCOMPATIBLE_PRODUCT_STATUS 기존의 제한 또는 공개 제품을 사용합니다.