View a markdown version of this page

Atualizar as informações da versão - AWS Marketplace
Sintaxe da solicitaçãoCampos obrigatóriosSintaxe da respostaErros

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.

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

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 StartChangeSetpara 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

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

  • 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.

    • 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.

        • SageMakerModelPackageSubscriptionDetailsou 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

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.

  2. 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

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

Erros

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.

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.