View a markdown version of this page

Restringir una versión - AWS Marketplace
Sintaxis de la solicitudCampos obligatoriosSintaxis de la respuestaErrores

Se reestructuró la referencia de API de AWS Marketplace. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia de API de AWS Marketplace.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Restringir una versión

Puedes usar la API de catálogo para restringir una versión de tu producto de aprendizaje automático AWS Marketplace. Cuando está restringida, los nuevos compradores no pueden acceder a esa versión. Los suscriptores actuales conservan el acceso a las versiones restringidas. AWS Marketplace las directrices exigen un apoyo continuo a los compradores actuales durante 90 días a partir de la fecha de restricción.

importante

Debe permanecer disponible al menos una versión sin restricciones. No puedes restringir la última versión disponible públicamente de un producto.

Para restringir una versión:

  • Para restringir una versión, llame a la StartChangeSet operación con el tipo de RestrictDeliveryOptions cambio.

Sintaxis de la solicitud

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 obligatorios

Campos obligatorios

  • Entity(objeto): obligatorio

    Contiene información sobre su producto de aprendizaje automático.

    • Identifier(cadena): obligatorio

      Tu identificador de producto. Para obtener más información, consulta Identificador.

    • Type(cadena): obligatorio

      Especifica el método de entrega (tipo de producto). Debe ser MachineLearningProduct@1.0.

  • DetailsDocument(objeto): obligatorio

    Contiene la información de la versión actualizada.

    • DeliveryOptionIds(conjunto de objetos): obligatorio

      Lista de DeliveryOption identificadores de las versiones que desea restringir. Recupera el identificador único de cada una de ellas DeliveryOption mediante una llamada a la DescribeEntity acción en la versión que estás restringiendo.

Sintaxis de la respuesta

Una solicitud correcta devuelve:

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

  1. Validación: el sistema comprueba si toda la información cumple con AWS Marketplace las directrices.

  2. Supervisión del estado: puede comprobar el estado de la solicitud de dos maneras.

    • A través AWS Marketplace del portal de administración

    • Usar la operación DescribeChangeSet

  3. Finalización: una vez aprobada, la nueva versión está restringida.

Errores

Errores asíncronos

Los siguientes errores pueden producirse durante el procesamiento del conjunto de cambios y se pueden recuperar mediante la operación: DescribeChangeSet

Código de error Mensaje de error
ESTADO DEL PRODUCTO INCOMPATIBLE Usa un producto público o limitado existente
MISSING_DELIVERY_OPTION_IDS Proporcione la opción de entrega de la lista de identificadores existente.
ID_DELIVERY_OPTION_IDS NO VÁLIDOS Proporciona los identificadores de las opciones de envío que se encuentran en el producto. No se encontraron los ID: [x]
ESTADO DE OPCIÓN DE ENTREGA NO VÁLIDO Los identificadores de las opciones de envío [invalid_ids] no son válidos. Proporcione las opciones de entrega en estado público.
ALL_DELIVERY_OPTIONS_RESTRICTED Proporcione menos opciones de entrega para restringirlas, ya que al menos una debe permanecer en estado público.