버전 정보 업데이트

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

중요

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

`StartChangeSet`를 사용하여 버전 추가:

버전 정보를 업데이트하려면 UpdateDeliveryOptions 변경 유형으로 StartChangeSet 작업을 호출합니다.

요청 구문


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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateDeliveryOptions",
      "Entity":
      {
        "Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
        "Type": "MachineLearningProduct@1.0"
      },
      "DetailsDocument":
      {
        "Version":
        {
          "ReleaseNotes": "Adding support for new parameters"
        },
        "DeliveryOptions":
        [
          {
            "Id": "example1-2222-cccc-2222-cccccccccccc",
            "Details":
            {
              "SagemakerModelPackageDeliveryOptionDetails":
              {
                "SampleNotebookUrl": "https://www.amazon.com",
                "RepositoryUrl":"https://www,amazon.com",
                "InputProperties": 
                { 
                    "SampleInput": {
                        "RealtimeInferenceUrl": "https://www.sampleData.com",
                        "BatchTranformUrl": "https://www.sampleData.com",
                     },
                 },
                 "RecommendedInstanceTypes": {
                        "BatchTransform": "ml.m4.large",
                        "RealtimeInference": "ml.m4.large"
                  }
            }
          }
        ]
      }
    }
  ]
}

필수 필드

Entity (객체) - 필수

ML 제품에 대한 정보를 포함합니다.
- Identifier (문자열) - 필수
  
  제품 ID입니다. 자세한 내용은 식별자를 참조하세요.
- Type (문자열) - 필수
  
  전송 방법(제품 유형)을 지정합니다. 반드시 MachineLearningProduct@1.0이어야 합니다.
DetailsDocument (객체) - 필수

업데이트된 버전 정보를 포함합니다.
- Version (객체) - 필수
  
  버전별 정보를 정의합니다.
  - VersionTitle (문자열) - 필수
    
    "버전 1.1" 또는 "1.1"과 같이 구매자에게 표시되는 버전 식별자입니다. 구매자는이 제목을 사용하여 배포할 버전을 선택합니다.
  - ReleaseNotes (문자열) - 필수
    
    이 버전에 대한 자세한 참고 사항은 30,000자로 제한됩니다.
- DeliveryOptions (배열) - 필수
  
  제품 버전의 전송 방법을 지정합니다. 버전당 하나의 전송 옵션으로 제한됩니다.
  - Id (문자열) - 필수
    
    DeliveryOption의 고유 식별자입니다. 제품에서 DescribeEntity 작업을 사용하여 이를 검색합니다.
  - Details (객체) - 필수
    
    전송 옵션 사양을 포함합니다.
    
    SageMakerModelPackageSubscriptionDetails 또는 SageMakerAlgorithmSubscriptionDetails (객체) - 필수
    
    전송 옵션의 세부 정보입니다.
    
    SampleNotebookUrl (문자열) - 필수
    
    구매자 사용에 대한 코드를 제공하는 샘플 Jupyter 노트북 링크입니다.
    
    RepositoryUrl (문자열) - 필수
    
    노트북 및 샘플 데이터를 복제하기 위한 Git 리포지토리 URL입니다.
    
    UsageInstructions (문자열) - 필수
    
    알고리즘의 경우: 훈련 정보. 모델의 경우: 추가 사용 정보.
    
    InputProperties (객체) - 필수
    
    모델/알고리즘의 입력 요구 사항에 대한 세부 정보입니다.
    
    Description (문자열) - 필수
    
    필수 입력에 대한 설명입니다.
    
    Limitations(문자열)
    
    모든 입력 제한.
    
    SampleInput (객체) - 필수
    
    다양한 작업에 대한 샘플 입력 데이터입니다.
    
    RealtimeInferenceUrl(문자열)
    
    실시간 추론을 위한 샘플 입력 URL입니다.
    
    RealtimeInferenceText(문자열)
    
    실시간 추론을 위한 샘플 입력 텍스트입니다.
    
    BatchTransformUrl(문자열)
    
    배치 변환 작업에 대한 샘플 입력 URL입니다.
    
    BatchTransformText(문자열)
    
    배치 변환 작업에 대한 샘플 입력 텍스트입니다.
    
    Parameters (배열<객체>)
    
    각 입력 파라미터에 대한 세부 정보입니다.
    
    Name (문자열) - 필수
    
    입력 파라미터의 이름입니다.
    
    Description (문자열) - 필수
    
    입력 파라미터에 대한 설명입니다.
    
    Constraints(문자열)
    
    파라미터 제약 조건(MinValue, MaxValue, AllowedValues, MinLength, MaxLength, Pattern 등).
    
    Required(부울)
    
    파라미터가 필요한지 여부를 나타냅니다. 기본값은 false입니다.
    
    SageMakerCustomAttributes (배열<객체>)
    
    지원되는 CustomAttributes에 대한 세부 정보입니다.
    
    Name (문자열) - 필수
    
    사용자 지정 속성의 이름입니다.
    
    Description (문자열) - 필수
    
    사용자 지정 속성에 대한 설명입니다.
    
    Constraints(문자열)
    
    속성 제약 조건(MinValue, MaxValue, AllowedValues, MinLength, MaxLength, Pattern 등).
    
    Required(부울)
    
    속성이 필요한지 여부를 나타냅니다. 기본값은 false입니다.
    
    OutputProperties (객체) - 필수
    
    모델/알고리즘 출력의 세부 정보입니다.
    
    Description (문자열) - 필수
    
    모델/알고리즘 출력에 대한 설명입니다.
    
    SampleOutput (Array<Object>) - 필수
    
    다양한 작업에 대한 샘플 출력 데이터입니다.
    
    RealtimeInferenceUrl(문자열)
    
    실시간 추론을 위한 샘플 출력 URL입니다.
    
    RealtimeInferenceText(문자열)
    
    실시간 추론을 위한 샘플 출력 텍스트입니다.
    
    BatchTransformUrl(문자열)
    
    배치 변환 작업에 대한 샘플 출력 URL입니다.
    
    BatchTransformText(문자열)
    
    배치 변환 작업에 대한 샘플 출력 텍스트입니다.
    
    Parameters (배열)
    
    각 출력 파라미터에 대한 세부 정보입니다.
    
    Name (문자열) - 필수
    
    출력 파라미터의 이름입니다.
    
    Description (문자열) - 필수
    
    출력 파라미터에 대한 설명입니다.
    
    AlwaysReturned(부울)
    
    파라미터가 항상 반환되는지 여부를 나타냅니다. 기본값은 false입니다.
    
    RecommendedInstanceTypes (객체) - 필수
    
    최적의 성능을 위해 권장되는 인스턴스 유형입니다.
    
    BatchTransform (문자열) - 필수
    
    배치 변환 작업에 권장되는 인스턴스 유형입니다.
    
    RealtimeInference (문자열) - 필수
    
    실시간 추론 작업에 권장되는 인스턴스 유형입니다.
    
    Training (문자열) - 필수
    
    알고리즘 훈련 작업에 권장되는 인스턴스 유형입니다. SageMaker 알고리즘에만 필요합니다.

응답 구문

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


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

세트 처리 변경

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

검증: 시스템에서 모든 정보가 AWS Marketplace 지침을 충족하는지 확인합니다.
- 처리 시간: 몇 분에서 몇 시간
- 검증 오류는 변경 세트 상태 및 오류를 참조하세요.
상태 모니터링: 요청의 상태를 두 가지 방법으로 확인할 수 있습니다.
- AWS Marketplace 관리 포털을 통해
- DescribeChangeSet 작업 사용
완료: 승인되면 새 버전이 업데이트됩니다.

오류

비동기 오류

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

오류 코드	오류 메시지
INCOMPATIBLE_PRODUCT_STATUS	기존의 제한 또는 공개 제품을 사용합니다.
INVALID_DELIVERY_OPTION_ID	제품에서 찾을 수 있는 전송 옵션 IDs를 제공합니다. IDs 찾을 수 없음: [x]
INCOMPATIBLE_DELIVERY_OPTION_STATUS	전송 옵션은 제한된 상태이므로 업데이트할 수 없습니다. 대신 새 버전을 추가해 보세요.
INCOMPATIBLE_DELIVERY_OPTIONS	이전에 [X]를 전송 옵션으로 사용한 제품이므로 예정된 모든 전송 옵션은 [X] 유형이어야 합니다.
INVALID_RECOMMENDED_INSTANCE_TYPE	[X]에 사용할 수 있는 기존 인스턴스 유형을 제공합니다(X는 배치 변환, 실시간 추론 또는 ALgorithm 훈련일 수 있음).
DUPLICATE_VERSION_TITLE	버전 제목은이 제품의 다른 버전 제목과 달라야 합니다.
FIELD_NOT_ALLOWED_TO_CHANGE	필드 X는 변경할 수 없습니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

새 버전 추가

요금 조건 업데이트