A referência da API do AWS Marketplace foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a [Referência de API do AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Atualizar as informações da versão
<a name="ml-update-version"></a>

 Você pode usar a API do Catalog para atualizar os detalhes de uma versão existente do seu produto de aprendizado de máquina no AWS Marketplace. 

**Importante**  
 Você não pode atualizar o ARN de uma versão. Se precisar modificar o ARN, você deverá criar uma nova versão. 

**Usando `StartChangeSet`para adicionar uma versão:**
+  Para atualizar as informações da versão, chame a `StartChangeSet` operação com o tipo de `UpdateDeliveryOptions` alteração. 

## Sintaxe da solicitação
<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}}"
                  }
            }
          }
        ]
      }
    }
  ]
}
```

## Campos obrigatórios
<a name="ml-update-version-required-fields"></a>
+  `Entity`(objeto) — obrigatório 

  Contém informações sobre seu produto de ML.
  +  `Identifier`(string) — obrigatório 

    O ID do seu produto. Para obter mais informações, consulte [Identificador](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
  +  `Type`(string) — obrigatório 

    Especifica o método de entrega (tipo de produto). Deve ser `MachineLearningProduct@1.0`.
+  `DetailsDocument`(objeto) — obrigatório 

   Contém as informações da versão atualizada. 
  + `Version`(objeto) — obrigatório

    Define as informações específicas da versão.
    + `VersionTitle`(string) — obrigatório

      O identificador da versão exibido aos compradores, como “Versão 1.1" ou “1.1". Os compradores usam esse título para selecionar versões para implantação.
    + `ReleaseNotes`(string) — obrigatório 

      Notas detalhadas sobre esta versão, limitadas a 30.000 caracteres.
  + `DeliveryOptions`(matriz) — obrigatório 

    Especifica os métodos de entrega para a versão do seu produto. Limitado a uma opção de entrega por versão.
    + `Id`(string) — obrigatório 

      Identificador exclusivo para DeliveryOption o. Recupere isso usando a DescribeEntity ação em seu produto.
    + `Details`(objeto) — obrigatório 

      Contém as especificações da opção de entrega.
      + `SageMakerModelPackageSubscriptionDetails`ou `SageMakerAlgorithmSubscriptionDetails` (objeto) — obrigatório 

        Detalhes da opção de entrega.
        + `SampleNotebookUrl`(string) — obrigatório 

          Exemplo de link do notebook Jupyter fornecendo código para uso do comprador.
        + `RepositoryUrl`(string) — obrigatório 

          URL do repositório Git para clonagem de cadernos e dados de amostra.
        + `UsageInstructions`(string) — obrigatório 

          Para algoritmos: informações de treinamento. Para modelos: informações adicionais de uso.
        + `InputProperties`(objeto) — obrigatório 

          Detalhes dos requisitos model/algorithm de entrada do.
          + `Description`(string) — obrigatório 

            Descrição das entradas necessárias.
          + `Limitations` (string) 

            Qualquer limitação de entrada.
          + `SampleInput`(objeto) — obrigatório 

            Dados de entrada de amostra para diferentes operações.
            + `RealtimeInferenceUrl` (string) 

              Exemplo de URL de entrada para inferência em tempo real.
            + `RealtimeInferenceText` (string) 

              Exemplo de texto de entrada para inferência em tempo real.
            + `BatchTransformUrl` (string) 

              Exemplo de URL de entrada para trabalhos de transformação em lote.
            + `BatchTransformText` (string) 

              Exemplo de texto de entrada para trabalhos de transformação em lote.
          + `Parameters`(Matriz<Object>) 

            Detalhes de cada parâmetro de entrada.
            + `Name`(string) — obrigatório 

              Nome do parâmetro de entrada.
            + `Description`(string) — obrigatório 

              Descrição do parâmetro de entrada.
            + `Constraints` (string) 

              Restrições de parâmetros (MinValue, MaxValue,, AllowedValues, MinLength, Padrão MaxLength, etc.).
            + `Required` (booliano) 

              Indica se o parâmetro é obrigatório. O padrão é falso.
          + `SageMakerCustomAttributes`(Matriz<Object>) 

            Detalhes do suporte CustomAttributes.
            + `Name`(string) — obrigatório 

              Nome do atributo personalizado.
            + `Description`(string) — obrigatório 

              Descrição do atributo personalizado.
            + `Constraints` (string) 

              Restrições de atributos (MinValue, MaxValue, AllowedValues, MinLength, Padrão MaxLength, etc.).
            + `Required` (booliano) 

              Indica se o atributo é obrigatório. O padrão é falso.
        + `OutputProperties`(objeto) — obrigatório 

          Detalhes da saída model/algorithm do.
          + `Description`(string) — obrigatório 

            Descrição das model/algorithm saídas.
          + `SampleOutput`(Array<Object>) — obrigatório 

            Dados de saída de amostra para diferentes operações.
            + `RealtimeInferenceUrl` (string) 

              Exemplo de URL de saída para inferência em tempo real.
            + `RealtimeInferenceText` (string) 

              Exemplo de texto de saída para inferência em tempo real.
            + `BatchTransformUrl` (string) 

              Exemplo de URL de saída para trabalhos de transformação em lote.
            + `BatchTransformText` (string) 

              Exemplo de texto de saída para trabalhos de transformação em lote.
          + `Parameters`(Matriz) 

            Detalhes de cada parâmetro de saída.
            + `Name`(string) — obrigatório 

              Nome do parâmetro de saída.
            + `Description`(string) — obrigatório 

              Descrição do parâmetro de saída.
            + `AlwaysReturned` (booliano) 

              Indica se o parâmetro é sempre retornado. O padrão é falso.
        + `RecommendedInstanceTypes`(objeto) — obrigatório 

          Tipos de instância recomendados para um desempenho ideal.
          + `BatchTransform`(string) — obrigatório 

            Tipo de instância recomendado para operações de transformação em lote.
          + `RealtimeInference`(string) — obrigatório 

            Tipo de instância recomendado para operações de inferência em tempo real.
          + `Training`(string) — obrigatório 

            Tipo de instância recomendado para operações de treinamento de algoritmos. Exigido somente para SageMaker algoritmos.

## Sintaxe da resposta
<a name="ml-update-version-response-syntax"></a>

Uma solicitação bem-sucedida retorna:

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

**Processamento do conjunto de alterações**  
A solicitação de alteração entra em uma fila de processamento, na qual passa por várias etapas:

1. Validação: o sistema verifica se todas as informações atendem às AWS Marketplace diretrizes.
   +  Tempo de processamento: alguns minutos a várias horas 
   +  Para erros de validação, consulte [Status e erros do conjunto de alterações](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors). 

1.  Monitoramento de status: você pode verificar o status da solicitação de duas maneiras. 
   + Por meio do Portal AWS Marketplace de Gerenciamento
   + Como usar a operação `DescribeChangeSet`

1.  Conclusão: quando aprovada, a nova versão é atualizada. 

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

**Erros assíncronos**  
Erros específicos de `UpdateDeliveryOptions` ações podem ser recuperados usando a `DescribeChangeSet` operação após o início do processamento do conjunto de alterações. Para obter detalhes e solução de problemas, consulte [Status e erros do conjunto de alterações](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). 


| Código de erro | Mensagem de erro | 
| --- | --- | 
| STATUS DE PRODUTO\_INCOMPATÍVEL | Use um produto público ou limitado existente. | 
| ID\_OPTION\_DO\_DELIVERY INVÁLIDA | Forneça IDs de opção de entrega que possam ser encontrados no produto. IDs não encontrados: [x] | 
| STATUS DA OPÇÃO\_DE\_ENTREGA INCOMPATÍVEL | A opção de entrega não pode ser atualizada porque está em status restrito. Em vez disso, tente adicionar uma nova versão. | 
| OPÇÕES\_DE ENTREGA INCOMPATÍVEIS | Produto usado anteriormente [X] como opção de entrega, portanto, todas as opções de entrega futura devem ser do tipo [X] | 
| TIPO\_DE\_INSTÂNCIA\_RECOMENDADA\_INVÁLIDA\_RECOMENDADA | Forneça um tipo de instância existente e disponível para [X] (X pode ser Batch Transform, Realtime Inference ou Algorithm Training) | 
| TÍTULO DA VERSÃO\_DUPLICADO | O título da versão deve ser diferente de qualquer outro título de versão deste produto. | 
| CAMPO NÃO AUTORIZADO A SER ALTERADO | O campo X não pode ser alterado. |