View a markdown version of this page

Actualizar la información de la 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.

Actualizar la información de la versión

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

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

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

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

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

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.

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

Errores

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.

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.