AddDataSets

nota

Los conjuntos de datos agregados mediante el conjunto de cambios de la API del catálogo de tipo AddDataSets tienen el método de publicación del producto como predeterminado.

Para agregar conjuntos de datos a su producto de AWS Data Exchange, inicie un conjunto de cambios de tipo AddDataSets. Para ello, puede utilizar la operación de la API de StartChangeSet y especificar el tipo de cambio, el identificador del producto, el tipo de producto y los detalles, incluido el Nombre de recurso de Amazon (ARN) del conjunto de datos.

Tutorial: Agregar conjuntos de datos nuevos a un producto de datos publicado

Este tutorial explica los pasos detallados para agregar conjuntos de datos de AWS Data Exchange nuevos a un producto publicado. El tutorial contiene los siguientes pasos generales.

Configurar permisos de IAM

Antes de empezar, necesita permisos de AWS Identity and Access Management (IAM) para usar la API del catálogo de AWS Marketplace. Estos permisos se suman a los permisos que necesita para utilizar AWS Data Exchange.

1. Acceda con el navegador a la consola de IAM e inicie sesión con una Cuenta de AWS que pueda gestionar los permisos de IAM.

2. En el panel de navegación izquierdo, elija Políticas.

3. Elija Crear política.

4. Elija la pestaña JSON y proporcione los permisos siguientes. Esto proporciona acceso completo a la API del catálogo de AWS Marketplace. Puede restringir el acceso según sea apropiado para su caso de uso.

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "aws-marketplace:CancelChangeSet",
           "aws-marketplace:ListChangeSets",
           "aws-marketplace:DescribeEntity",
           "aws-marketplace:StartChangeSet",
           "aws-marketplace:ListEntities",
           "aws-marketplace:DescribeChangeSet",
           "dataexchange:PublishDataSet"
         ],
         "Resource": "*"
       }
     ]
   }

5. Elija Siguiente: revisar.

6. Escriba un nombre para la política (por ejemplo, CatalogAPIFullAccess) y elija Crear política.

7. Con la consola de IAM, elija los usuarios, grupos o roles a los que desea asignar la política.

Acceder a la API del catálogo de AWS Marketplace

Para acceder a la API del catálogo de AWS Marketplace, utilice punto de conexión siguiente del cliente de HTTP.

catalog.marketplace.us-east-1.amazonaws.com

Obtener el ID de su producto desde la consola de AWS Data Exchange

Para poder utilizar la API del catálogo de AWS Marketplace para publicar nuevos conjuntos de datos, obtenga el ID de su producto en la consola de AWS Data Exchange. Vaya al Panel de control del producto y, a continuación, copie el ID del producto para el que desea publicar los conjuntos de datos. También puede utilizar la API del catálogo de AWS Marketplace para encontrar el ID del producto mediante la acción ListEntities con el tipo de entidad DataProduct@1.0.

Iniciar una solicitud de cambio

Para iniciar una solicitud de cambio para agregar un conjunto de datos a su producto de prueba

1. Copie el ID de entidad obtenido siguiendo las instrucciones de Obtener el ID de su producto desde la consola de AWS Data Exchange.

2. Realice una solicitud StartChangeSet con un tipo de cambio AddDataSets.

nota

Para obtener información sobre los conjuntos de cambios en la API del catálogo de AWS Marketplace, consulte Trabajar con conjuntos de cambios. Para obtener más información acerca de cómo trabajar con el identificador de las entidades, consulte Identificador.

Ejemplo de solicitud

https://catalog.marketplace.us-east-1.amazonaws.com/StartChangeSet

Ejemplo de cuerpo de solicitud

{
    "Catalog": "AWSMarketplace",
    "ChangeSetName": "Adding Data Set to my test Data Product",
    "ChangeSet": [
        {
            "ChangeType": "AddDataSets",
            "Entity": {
                "Identifier": "entity-id@1",
                "Type": "DataProduct@1.0"
            },
            "Details": "{ \"DataSets\": [ { \"Arn\": \"data-set-arn\" } ] }"
        }
    ]
}

Ejemplo de respuesta

{
  "ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh"
}

Verificar el estado del conjunto de cambios

Después de usar la operación StartChangeSet de la API para iniciar la solicitud de cambio, puede utilizar la operación DescribeChangeSet para comprobar su estado. Proporcione el ID del conjunto de cambios devuelto en la respuesta a StartChangeSet de la API.

Ejemplo de solicitud

https://catalog.marketplace.us-east-1.amazonaws.com/DescribeChangeSet?catalog=AWSMarketplace&changeSetId=cs-bnEXAMPLE4mkz9oh

Ejemplo de cuerpo de solicitud

{
"changeSetId":"cs-bnEXAMPLE4mkz9oh"
}

Ejemplo de respuesta

{
    "ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
    "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh",
    "ChangeSetName": "Adding Data Set to my test Data Product",
    "StartTime": "2018-09-20T19:45:03.115+0000",
    "EndTime": "2018-09-20T19:48:12.517+0000",
    "Status": "SUCCEEDED",
    "FailureDescription": null,
    "ChangeSet": [
        {
            "ChangeType": "AddDataSets",
            "Entity": {
                "Type": "DataProduct@1.0",
                "Identifier": "entity-id@1"
            },
            "ErrorList": []
        }
    ]
}

Excepciones de AddDatasets

Cuando se utiliza la API del catálogo de AWS Marketplace con AWS Data Exchange, pueden surgir las excepciones siguientes:

DATA_SET_NOT_FOUND

Esto ocurre cuando no se encuentra el conjunto de datos solicitado. Para solucionar este problema, asegúrese de que no haya ningún error tipográfico en el ARN del conjunto de datos y de que su Cuenta de AWS sea propietaria del conjunto de datos y vuelva a intentarlo.

INVALID_INPUT

No se ha podido procesar la solicitud porque la entrada no es válida. Para solucionar este problema, asegúrese de que no haya ningún error tipográfico en la solicitud y de que el producto no supere el número máximo de conjuntos de datos permitido.

DATA_SET_ALREADY_PUBLISHED

Esto ocurre cuando el conjunto de datos ya se ha agregado previamente al producto.

DATA_SET_DUPLICATE_PROVIDED

Esto ocurre cuando se proporciona el mismo conjunto de datos más de una vez en la solicitud.