

AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Marketplace API 참조](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)를 참조하세요.

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

# 버전 정보 업데이트
<a name="ml-update-version"></a>

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

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

**`StartChangeSet`를 사용하여 버전 추가:**
+  버전 정보를 업데이트하려면 `UpdateDeliveryOptions` 변경 유형으로 `StartChangeSet` 작업을 호출합니다.

## 요청 구문
<a name="ml-update-version-request-syntax"></a>

```
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}}"
                  }
            }
          }
        ]
      }
    }
  ]
}
```

## 필수 필드
<a name="ml-update-version-required-fields"></a>
+  `Entity` (객체) - 필수 

  ML 제품에 대한 정보를 포함합니다.
  +  `Identifier` (문자열) - 필수 

    제품 ID입니다. 자세한 내용은 [식별자](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)를 참조하세요.
  +  `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 알고리즘에만 필요합니다.

## 응답 구문
<a name="ml-update-version-response-syntax"></a>

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

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

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

1. 검증: 시스템에서 모든 정보가 AWS Marketplace 지침을 충족하는지 확인합니다.
   +  처리 시간: 몇 분에서 몇 시간 
   +  검증 오류는 [변경 세트 상태 및 오류를](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors) 참조하세요.

1.  상태 모니터링: 요청의 상태를 두 가지 방법으로 확인할 수 있습니다.
   +  AWS Marketplace 관리 포털을 통해
   + `DescribeChangeSet` 작업 사용

1.  완료: 승인되면 새 버전이 업데이트됩니다.

## 오류
<a name="ml-update-version-errors"></a>

**비동기 오류**  
변경 세트가 처리를 시작한 후 `DescribeChangeSet` 작업을 사용하여 `UpdateDeliveryOptions` 작업에 대한 특정 오류를 검색할 수 있습니다. 오류 세부 정보 및 문제 해결은 [ 변경 세트 상태 및 오류를](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets) 참조하세요.


| 오류 코드 | 오류 메시지 | 
| --- | --- | 
| 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는 변경할 수 없습니다. | 