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](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).

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
<a name="ml-restrict-version"></a>

 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
<a name="ml-restrict-version-request-syntax"></a>

```
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
<a name="ml-restrict-version-required-fields"></a>

**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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
  +  `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
<a name="ml-restrict-version-response-syntax"></a>

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.
   +  Tiempo de procesamiento: de unos minutos a varias horas 
   +  Para ver los errores de validación, consulte [Cambiar el estado y los errores del conjunto](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors). 

1.  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`

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

## Errores
<a name="ml-restrict-version-errors"></a>

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