Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Tambahkan kumpulan data ke AWS Data Exchange
**catatan**
Kumpulan data yang ditambahkan melalui API Katalog mengubah kumpulan tipe `AddDataSets` default ke metode penerbitan produk.
Untuk menambahkan kumpulan data ke AWS Data Exchange produk Anda, mulai kumpulan perubahan jenis`AddDataSets`. Untuk melakukannya, Anda dapat menggunakan operasi `StartChangeSet` API dan menentukan jenis perubahan, pengenal produk, jenis produk, dan detail termasuk kumpulan data Amazon Resource Name (ARN).
## Tutorial: Menambahkan set data baru ke produk data yang dipublikasikan
Tutorial ini memandu Anda melalui langkah-langkah rinci untuk menambahkan kumpulan AWS Data Exchange data baru ke produk yang diterbitkan. Tutorial ini memiliki langkah-langkah tingkat tinggi berikut.
**Topics**
+ [Siapkan izin IAM](#data-set-catalog-iam-permissions)
+ [Akses API AWS Marketplace Katalog](#data-set-access-catalog-api)
+ [Dapatkan ID produk Anda dari AWS Data Exchange konsol](#get-data-set-exchange-product-id)
+ [Memulai permintaan perubahan](#start-data-set-change-request)
+ [Periksa status set perubahan Anda](#check-data-set-change-status)
### Siapkan izin IAM
Sebelum memulai, Anda memerlukan izin AWS Identity and Access Management (IAM) untuk menggunakan API AWS Marketplace Katalog. Izin ini merupakan tambahan dari izin yang Anda butuhkan untuk menggunakan. AWS Data Exchange
1. Arahkan browser Anda ke konsol IAM dan masuk menggunakan Akun AWS yang dapat mengelola izin IAM.
1. Dari panel navigasi kiri, pilih **Kebijakan**.
1. Pilih **Buat kebijakan**.
1. Pilih tab **JSON**, dan berikan izin berikut. Ini memberikan akses penuh ke API AWS Marketplace Katalog. Anda dapat membatasi akses yang sesuai untuk kasus penggunaan Anda.
------
#### [ 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. Pilih **Berikutnya: Tinjauan**.
1. Berikan nama untuk kebijakan (misalnya,**CatalogAPIFullAccess**), lalu pilih **Buat Kebijakan**.
1. Menggunakan konsol IAM, pilih pengguna, grup, atau peran yang ingin dilampirkan kebijakan.
### Akses API AWS Marketplace Katalog
Untuk mengakses API AWS Marketplace Katalog, gunakan titik akhir klien HTTP berikut.
```
catalog.marketplace.us-east-1.amazonaws.com
```
### Dapatkan ID produk Anda dari AWS Data Exchange konsol
Sebelum Anda dapat menggunakan API AWS Marketplace Katalog untuk mempublikasikan kumpulan data baru, dapatkan ID produk Anda dari AWS Data Exchange konsol. Arahkan ke **Dasbor Produk**, lalu salin ID produk yang ingin Anda publikasikan kumpulan datanya. Anda juga dapat menggunakan [API AWS Marketplace Katalog](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html) untuk menemukan ID produk Anda, menggunakan `ListEntities` tindakan dengan tipe **DataProduct@1.0** entitas.
### Memulai permintaan perubahan
**Untuk memulai permintaan perubahan untuk menambahkan kumpulan data dalam produk pengujian**
1. Salin ID entitas yang Anda dapatkan dengan mengikuti instruksi di[Dapatkan ID produk Anda dari AWS Data Exchange konsol](#get-data-set-exchange-product-id).
1. Buat `StartChangeSet` permintaan dengan tipe `AddDataSets` perubahan.
**catatan**
Untuk informasi tentang bekerja dengan set perubahan di API AWS Marketplace Katalog, lihat [Bekerja dengan set perubahan](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets). Untuk informasi selengkapnya tentang bekerja dengan pengenal untuk entitas, lihat [Pengenal](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#identifier).
**Permintaan contoh**
```
https://catalog.marketplace.us-east-1.amazonaws.com/StartChangeSet
```
**Contoh badan permintaan**
```
{
"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\" } ] }"
}
]
}
```
**Contoh respon**
```
{
"ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh"
}
```
### Periksa status set perubahan Anda
Setelah Anda menggunakan operasi `StartChangeSet` API untuk memulai permintaan perubahan, Anda dapat menggunakan `DescribeChangeSet` operasi untuk memeriksa statusnya. Berikan ID set perubahan yang dikembalikan dalam respons `StartChangeSet` API.
**Permintaan contoh**
```
https://catalog.marketplace.us-east-1.amazonaws.com/DescribeChangeSet?catalog=AWSMarketplace&changeSetId=cs-bnEXAMPLE4mkz9oh
```
**Contoh badan permintaan**
```
{
"changeSetId":"cs-bnEXAMPLE4mkz9oh"
}
```
**Contoh respon**
```
{
"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 pengecualian
Pengecualian berikut dapat terjadi saat Anda menggunakan API AWS Marketplace Katalog dengan AWS Data Exchange:
**DATA\$1SET\$1NOT\$1FOUND**
Ini terjadi ketika kumpulan data yang diminta tidak ditemukan. Untuk mengatasi masalah ini, pastikan bahwa tidak ada kesalahan ketik dalam kumpulan data ARN dan bahwa Akun AWS Anda memiliki kumpulan data, dan coba lagi.
**INVALID\$1INPUT**
Permintaan tidak dapat diproses karena masukan yang tidak valid. Untuk mengatasi masalah ini, pastikan bahwa tidak ada kesalahan ketik dalam permintaan dan bahwa produk tidak melebihi jumlah maksimum kumpulan data yang diizinkan.
**DATA\$1SET\$1ALREADY\$1PUBLISHED**
Ini terjadi ketika kumpulan data sebelumnya telah ditambahkan ke produk.
**DATA\$1SET\$1DUPLICATE\$1PROVIDED**
Ini terjadi ketika kumpulan data yang sama disediakan lebih dari sekali dalam permintaan.