View a markdown version of this page

Restringir uma 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á.

Restringir uma versão

Você pode usar a API de catálogo para restringir uma versão do seu produto de aprendizado de máquina em AWS Marketplace. Quando restrito, novos compradores não podem acessar essa versão. Os assinantes existentes mantêm o acesso às versões restritas. AWS Marketplace as diretrizes exigem suporte contínuo para compradores existentes por 90 dias após a restrição.

Importante

Pelo menos uma versão irrestrita deve permanecer disponível. Você não pode restringir a última versão disponível publicamente de um produto.

Para restringir uma versão:

  • Para restringir uma versão, chame a StartChangeSet operação com o tipo de RestrictDeliveryOptions alteração.

Sintaxe da solicitação

POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictDeliveryOptions",
      "Entity":
      {
        "Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
        "Type": "MachineLearningProduct@1.0"
      },
      "DetailsDocument":
      {
        "DeliveryOptionIds":
        [
          "example1-2222-cccc-2222-cccccccccccc"
        ]
      }
    }
  ]
}

Campos obrigatórios

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.

    • DeliveryOptionIds(matriz de objetos) — obrigatório

      Lista de DeliveryOption IDs para as versões que você deseja restringir. Recupere o identificador exclusivo de cada um DeliveryOption chamando a DescribeEntity ação na versão que você está restringindo.

Sintaxe da resposta

Uma solicitação bem-sucedida retorna:

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

  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 é restrita.

Erros

Erros assíncronos

Os seguintes erros podem ocorrer durante o processamento do conjunto de alterações e podem ser recuperados usando a DescribeChangeSet operação:

Código de erro Mensagem de erro
STATUS DE PRODUTO_INCOMPATÍVEL Use um produto público ou limitado existente
IDS_OPTION_DE_DELIVERY AUSENTES Forneça a opção de entrega a partir da lista existente de IDs.
IDS_OPTION_DE_DELIVERY INVÁLIDOS 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 INVÁLIDA Os IDs da opção de entrega [invalid_ids] são inválidos. Forneça opções de entrega no estado público.
TODAS AS OPÇÕES_DE ENTREGA RESTRITAS Forneça menos opções de entrega para restringir, pois pelo menos uma deve permanecer em estado público.