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.

# Actualizar la información de la versión
<a name="ml-update-version"></a>

 Puedes usar la API de catálogo para actualizar los detalles de una versión existente de tu producto de aprendizaje automático en AWS Marketplace. 

**importante**  
 No puede actualizar el ARN de una versión. Si necesita modificar el ARN, debe crear una nueva versión en su lugar. 

**Uso `StartChangeSet`para añadir una versión:**
+  Para actualizar la información de la versión, llame a la `StartChangeSet` operación con el tipo de `UpdateDeliveryOptions` cambio. 

## Sintaxis de la solicitud
<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 obligatorios
<a name="ml-update-version-required-fields"></a>
+  `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. 
  + `Version`(objeto): obligatorio

    Define la información específica de la versión.
    + `VersionTitle`(cadena): obligatorio

      El identificador de versión que se muestra a los compradores, como «versión 1.1» o «1.1». Los compradores utilizan este título para seleccionar las versiones que se van a implementar.
    + `ReleaseNotes`(cadena): obligatorio 

      Notas detalladas sobre esta versión, limitadas a 30 000 caracteres.
  + `DeliveryOptions`(matriz): obligatorio 

    Especifica los métodos de entrega para la versión del producto. Limitado a una opción de entrega por versión.
    + `Id`(cadena): obligatorio 

      Identificador único para. DeliveryOption Recupera esto mediante la DescribeEntity acción de tu producto.
    + `Details`(objeto): obligatorio 

      Contiene las especificaciones de la opción de entrega.
      + `SageMakerModelPackageSubscriptionDetails`o `SageMakerAlgorithmSubscriptionDetails` (objeto): obligatorio 

        Detalles de la opción de entrega.
        + `SampleNotebookUrl`(cadena): obligatorio 

          Ejemplo de enlace a un cuaderno de Jupyter con un código para que lo utilice el comprador.
        + `RepositoryUrl`(cadena): obligatorio 

          URL del repositorio de Git para clonar datos de cuadernos y muestras.
        + `UsageInstructions`(cadena): obligatorio 

          Para algoritmos: información de entrenamiento. Para los modelos: información de uso adicional.
        + `InputProperties`(objeto): obligatorio 

          Detalles de los requisitos model/algorithm de entrada.
          + `Description`(cadena): obligatorio 

            Descripción de las entradas requeridas.
          + `Limitations` (cadena) 

            Cualquier limitación de entrada.
          + `SampleInput`(objeto): obligatorio 

            Ejemplos de datos de entrada para diferentes operaciones.
            + `RealtimeInferenceUrl` (cadena) 

              Ejemplo de URL de entrada para inferencias en tiempo real.
            + `RealtimeInferenceText` (cadena) 

              Ejemplo de texto de entrada para inferencias en tiempo real.
            + `BatchTransformUrl` (cadena) 

              Ejemplo de URL de entrada para trabajos de transformación por lotes.
            + `BatchTransformText` (cadena) 

              Ejemplo de texto de entrada para trabajos de transformación por lotes.
          + `Parameters`(Matriz<Object>) 

            Detalles de cada parámetro de entrada.
            + `Name`(cadena): obligatorio 

              Nombre del parámetro de entrada.
            + `Description`(cadena): obligatorio 

              Descripción del parámetro de entrada.
            + `Constraints` (cadena) 

              Restricciones de parámetros (MinValue MaxValue AllowedValues, MinLength, MaxLength,, Patrón, etc.).
            + `Required` (booleano) 

              Indica si el parámetro es obligatorio. La opción predeterminada es falso.
          + `SageMakerCustomAttributes`(Matriz<Object>) 

            Detalles de soporte CustomAttributes.
            + `Name`(cadena): obligatorio 

              Nombre del atributo personalizado.
            + `Description`(cadena): obligatorio 

              Descripción del atributo personalizado.
            + `Constraints` (cadena) 

              Restricciones de atributos (MinValue MaxValue AllowedValues, MinLength, MaxLength,, Patrón, etc.).
            + `Required` (booleano) 

              Indica si el atributo es obligatorio. La opción predeterminada es falso.
        + `OutputProperties`(objeto): obligatorio 

          Detalles de model/algorithm la salida.
          + `Description`(cadena): obligatorio 

            Descripción de los model/algorithm resultados.
          + `SampleOutput`(Matriz<Object>): obligatorio 

            Datos de salida de muestra para diferentes operaciones.
            + `RealtimeInferenceUrl` (cadena) 

              Ejemplo de URL de salida para inferencias en tiempo real.
            + `RealtimeInferenceText` (cadena) 

              Ejemplo de texto de salida para inferencias en tiempo real.
            + `BatchTransformUrl` (cadena) 

              Ejemplo de URL de salida para trabajos de transformación por lotes.
            + `BatchTransformText` (cadena) 

              Ejemplo de texto de salida para trabajos de transformación por lotes.
          + `Parameters`(Matriz) 

            Detalles de cada parámetro de salida.
            + `Name`(cadena): obligatorio 

              Nombre del parámetro de salida.
            + `Description`(cadena): obligatorio 

              Descripción del parámetro de salida.
            + `AlwaysReturned` (booleano) 

              Indica si el parámetro se devuelve siempre. La opción predeterminada es falso.
        + `RecommendedInstanceTypes`(objeto): obligatorio 

          Tipos de instancias recomendados para un rendimiento óptimo.
          + `BatchTransform`(cadena): obligatorio 

            Tipo de instancia recomendado para operaciones de transformación por lotes.
          + `RealtimeInference`(cadena): obligatorio 

            Tipo de instancia recomendado para operaciones de inferencia en tiempo real.
          + `Training`(cadena): obligatorio 

            Tipo de instancia recomendado para las operaciones de entrenamiento de algoritmos. Necesario solo para SageMaker algoritmos.

## Sintaxis de la respuesta
<a name="ml-update-version-response-syntax"></a>

Una solicitud correcta devuelve:

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

**Procesamiento del conjunto de cambios**  
La solicitud de cambio entra en una cola de procesamiento, donde se somete a varios pasos:

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: cuando se aprueba, la nueva versión se actualiza. 

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

**Errores asíncronos**  
Los errores específicos de las `UpdateDeliveryOptions` acciones se pueden recuperar mediante la `DescribeChangeSet` operación una vez que el conjunto de cambios comience a procesarse. Para obtener información sobre los errores y solucionar problemas, consulte [Cambiar el estado y los errores del conjunto](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). 


| Código de error | Mensaje de error | 
| --- | --- | 
| INCOMPATIBLE\_PRODUCT\_STATUS | Usa un producto público o limitado existente. | 
| ID\_OPCIÓN\_DE\_ENTREGA NO VÁLIDO | Proporciona los identificadores de las opciones de envío que se encuentran en el producto. No se encontraron los identificadores: [x] | 
| INCOMPATIBLE\_DELIVERY\_OPTION\_STATUS | La opción de envío no se puede actualizar porque está restringida. Intenta añadir una nueva versión en su lugar. | 
| OPCIONES\_DE\_ENTREGA INCOMPATIBLES | El producto utilizaba anteriormente [X] como opción de entrega, por lo que todas las próximas opciones de entrega deberían ser del tipo [X] | 
| TIPO\_INSTANCIA\_RECOMENDADA NO VÁLIDA | Proporcione un tipo de instancia existente y disponible para [X] (X puede ser Batch Transform, Realtime Inference o Algorithm Training) | 
| TITULO\_DE\_VERSIÓN\_DUPLICADO | El título de la versión debe ser diferente al de cualquier otro título de versión de este producto. | 
| EL CAMPO NO ESTÁ PERMITIDO CAMBIAR | No se permite cambiar el campo X. |