Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Utilizzo AWS Data Exchange con l'API Marketplace AWS Catalog
Questo capitolo contiene informazioni supplementari sull'utilizzo AWS Data Exchange e sull'API Marketplace AWS Catalog. Il servizio Marketplace AWS Catalog API fornisce un'interfaccia API che consente ai fornitori di accedere in modo programmatico alle funzionalità di pubblicazione Marketplace AWS self-service.
L'API supporta un'ampia gamma di operazioni per la visualizzazione e la gestione dei prodotti. È possibile estendere la pipeline interna di sviluppo o implementazione Marketplace AWS tramite l'integrazione delle API per automatizzare il processo di aggiornamento del prodotto. Puoi anche creare la tua interfaccia utente interna in aggiunta all'API per gestire i tuoi prodotti su. Marketplace AWS
Puoi utilizzare l'API Marketplace AWS Catalog per aggiornare i tuoi AWS Data Exchange prodotti. Per visualizzare i tuoi prodotti, puoi utilizzare le operazioni `ListEntities` e l'`DescribeEntity`API. Per aggiornare il AWS Data Exchange prodotto, è necessario creare un nuovo set di modifiche, ovvero la risorsa dell'API Catalog che rappresenta un'operazione asincrona utilizzata per gestire i prodotti. Per ulteriori informazioni, consulta il [Marketplace AWS Catalog](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Operations_AWS_Marketplace_Catalog_Service.html) API Reference.
Tieni presente quanto segue quando lavori con l'API Catalog:
+ Ogni AWS Data Exchange prodotto è rappresentato nell'API del catalogo come [entità](https://docs.aws.amazon.com//marketplace-catalog/latest/api-reference/API_Entity.html).
+ AWS Data Exchange i prodotti hanno `DataProduct` come`EntityType`.
+ Ogni prodotto può avere un solo set di modifiche in esecuzione simultanea alla volta. Ciò significa che non è possibile creare un secondo set di modifiche fino al termine dell'esecuzione del primo.
**Topics**
+ [Aggiungi set di dati a AWS Data Exchange](add-data-sets.md)
# Aggiungi set di dati a AWS Data Exchange
**Nota**
I set di dati aggiunti tramite il set di modifiche dell'API Catalog sono di tipo `AddDataSets` predefinito per il metodo di pubblicazione del prodotto.
Per aggiungere set di dati al AWS Data Exchange prodotto, avvia un set di modifiche di tipo`AddDataSets`. A tale scopo, puoi utilizzare l'operazione `StartChangeSet` API e specificare il tipo di modifica, l'identificativo del prodotto, il tipo di prodotto e i dettagli, incluso il set di dati Amazon Resource Name (ARN).
## Tutorial: aggiunta di nuovi set di dati a un prodotto di dati pubblicato
Questo tutorial illustra i passaggi dettagliati per aggiungere nuovi set di AWS Data Exchange dati a un prodotto pubblicato. Il tutorial presenta i seguenti passaggi di alto livello.
**Topics**
+ [Impostare autorizzazioni IAM](#data-set-catalog-iam-permissions)
+ [Accedi all'API Marketplace AWS Catalog](#data-set-access-catalog-api)
+ [Ottieni l'ID del prodotto dalla console AWS Data Exchange](#get-data-set-exchange-product-id)
+ [Avvia una richiesta di modifica](#start-data-set-change-request)
+ [Controlla lo stato del set di modifiche](#check-data-set-change-status)
### Impostare autorizzazioni IAM
Prima di iniziare, sono necessarie le autorizzazioni AWS Identity and Access Management (IAM) per utilizzare l'API Marketplace AWS Catalog. Queste autorizzazioni si aggiungono alle autorizzazioni necessarie per l'utilizzo. AWS Data Exchange
1. Accedi con il browser alla console IAM e accedi utilizzando un dispositivo in grado di gestire le Account AWS autorizzazioni IAM.
1. Dal riquadro di navigazione a sinistra, scegli **Policies**.
1. Scegli **Crea policy**.
1. Scegli la scheda **JSON** e fornisci le seguenti autorizzazioni. Ciò fornisce l'accesso completo all'API Marketplace AWS Catalog. Puoi limitare l'accesso in base al tuo caso d'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. Scegli **Prossimo: Rivedi**.
1. Fornisci un nome per la politica (ad esempio,**CatalogAPIFullAccess**), quindi scegli **Crea politica**.
1. Utilizzando la console IAM, scegli gli utenti, i gruppi o i ruoli a cui desideri collegare la policy.
### Accedi all'API Marketplace AWS Catalog
Per accedere all'API Marketplace AWS Catalog, utilizza il seguente endpoint client HTTP.
```
catalog.marketplace.us-east-1.amazonaws.com
```
### Ottieni l'ID del prodotto dalla console AWS Data Exchange
Prima di poter utilizzare l'API Marketplace AWS Catalog per pubblicare nuovi set di dati, ottieni l'ID del prodotto dalla AWS Data Exchange console. Vai alla **dashboard del prodotto**, quindi copia l'ID del prodotto per cui desideri pubblicare i set di dati. Puoi anche utilizzare l'[API Marketplace AWS Catalog](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html) per trovare l'ID del tuo prodotto, utilizzando l'`ListEntities`azione con il tipo di **DataProduct@1.0** entità.
### Avvia una richiesta di modifica
**Per avviare una richiesta di modifica per aggiungere un set di dati nel prodotto di prova**
1. Copia l'ID dell'entità che ottieni seguendo le istruzioni riportate in[Ottieni l'ID del prodotto dalla console AWS Data Exchange](#get-data-set-exchange-product-id).
1. Effettua una `StartChangeSet` richiesta con un tipo di `AddDataSets` modifica.
**Nota**
Per informazioni sull'utilizzo dei set di modifiche nell'API Marketplace AWS Catalog, consulta [Lavorare con i set di modifiche](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets). Per ulteriori informazioni sull'utilizzo dell'identificatore per le entità, consulta [Identificatore](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#identifier).
**Richiesta di esempio**
```
https://catalog.marketplace.us-east-1.amazonaws.com/StartChangeSet
```
**Esempio di corpo della richiesta**
```
{
"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\" } ] }"
}
]
}
```
**Esempio di risposta**
```
{
"ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh"
}
```
### Controlla lo stato del set di modifiche
Dopo aver utilizzato l'operazione `StartChangeSet` API per avviare la richiesta di modifica, è possibile utilizzare l'`DescribeChangeSet`operazione per verificarne lo stato. Fornisci l'ID del set di modifiche restituito nella risposta dell'`StartChangeSet`API.
**Richiesta di esempio**
```
https://catalog.marketplace.us-east-1.amazonaws.com/DescribeChangeSet?catalog=AWSMarketplace&changeSetId=cs-bnEXAMPLE4mkz9oh
```
**Esempio di corpo della richiesta**
```
{
"changeSetId":"cs-bnEXAMPLE4mkz9oh"
}
```
**Esempio di risposta**
```
{
"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 eccezioni
Le seguenti eccezioni possono verificarsi quando si utilizza l'API Marketplace AWS Catalog con: AWS Data Exchange
**DATA\$1SET\$1NOT\$1FOUND**
Ciò accade quando il set di dati richiesto non è stato trovato. Per risolvere il problema, assicurati che non vi sia un errore di battitura nell'ARN del set di dati e che Account AWS il set di dati sia di tua proprietà, quindi riprova.
**INVALID\$1INPUT**
La richiesta non può essere elaborata a causa di un input non valido. Per risolvere questo problema, assicurati che non vi sia un errore di battitura nella richiesta e che il prodotto non superi il numero massimo di set di dati consentiti.
**DATA\$1SET\$1ALREADY\$1PUBLISHED**
Ciò accade quando il set di dati è già stato aggiunto in precedenza al prodotto.
**DATA\$1SET\$1DUPLICATE\$1PROVIDED**
Ciò accade quando lo stesso set di dati viene fornito più di una volta nella richiesta.