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.
# Añadir conjuntos de datos a AWS Data Exchange
**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 añadir conjuntos de datos a su AWS Data Exchange producto, 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
En este tutorial, se explican los pasos detallados para añadir nuevos conjuntos de AWS Data Exchange datos a un producto publicado. El tutorial contiene los siguientes pasos generales.
**Topics**
+ [Configurar permisos de IAM](#data-set-catalog-iam-permissions)
+ [Acceda a la API del AWS Marketplace catálogo](#data-set-access-catalog-api)
+ [Obtenga el ID de su producto desde la AWS Data Exchange consola](#get-data-set-exchange-product-id)
+ [Iniciar una solicitud de cambio](#start-data-set-change-request)
+ [Verificar el estado del conjunto de cambios](#check-data-set-change-status)
### Configurar permisos de IAM
Antes de empezar, necesita permisos AWS Identity and Access Management (de IAM) para usar la API del AWS Marketplace catálogo. Estos permisos se suman a los permisos que necesita para AWS Data Exchange utilizarlos.
1. Navegue con su navegador hasta la consola de IAM e inicie sesión con una Cuenta de AWS que pueda gestionar los permisos de IAM.
1. En el panel de navegación izquierdo, elija **Políticas**.
1. Elija **Crear política**.
1. Elija la pestaña **JSON** y proporcione los permisos siguientes. Esto proporciona acceso completo a la API del AWS Marketplace catálogo. Puede restringir el acceso según sea apropiado para su caso de uso.
------
#### [ JSON ]
****
```
{
"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": "*"
}
]
}
```
------
1. Elija **Siguiente: revisar**.
1. Escriba un nombre para la política (por ejemplo, **CatalogAPIFullAccess**) y elija **Crear política**.
1. Con la consola de IAM, elija los usuarios, grupos o roles a los que desea asignar la política.
### Acceda a la API del AWS Marketplace catálogo
Para acceder a la API del AWS Marketplace catálogo, utilice el siguiente punto final del cliente HTTP.
```
catalog.marketplace.us-east-1.amazonaws.com
```
### Obtenga el ID de su producto desde la AWS Data Exchange consola
Antes de poder utilizar la API del AWS Marketplace catálogo para publicar nuevos conjuntos de datos, obtén el identificador de producto en la AWS Data Exchange consola. 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](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html) 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 [Obtenga el ID de su producto desde la AWS Data Exchange consola](#get-data-set-exchange-product-id).
1. Realice una solicitud `StartChangeSet` con un tipo de cambio `AddDataSets`.
**nota**
Para obtener información sobre cómo trabajar con conjuntos de cambios en la API de AWS Marketplace catálogo, consulte [Trabajar con conjuntos de cambios](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets). Para obtener más información acerca de cómo trabajar con el identificador de las entidades, consulte [Identificador](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#identifier).
**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": []
}
]
}
```
## AddDataSets excepciones
Se pueden producir las siguientes excepciones cuando se utiliza la API de AWS Marketplace catálogo con AWS Data Exchange:
**DATA\$1SET\$1NOT\$1FOUND**
Esto ocurre cuando no se encuentra el conjunto de datos solicitado. Para resolver este problema, asegúrese de que no haya ningún error tipográfico en el ARN del conjunto de datos y de que Cuenta de AWS es suyo el conjunto de datos e inténtelo de nuevo.
**INVALID\$1INPUT**
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\$1SET\$1ALREADY\$1PUBLISHED**
Esto ocurre cuando el conjunto de datos ya se ha agregado previamente al producto.
**DATA\$1SET\$1DUPLICATE\$1PROVIDED**
Esto ocurre cuando se proporciona el mismo conjunto de datos más de una vez en la solicitud.