Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menerbitkan produk yang AWS Data Exchange mengandung APIs
Topik berikut menjelaskan proses pembuatan kumpulan data REST API dan menerbitkan produk baru yang berisi APIs pada AWS Data Exchange. Anda dapat menyelesaikan proses dengan menggunakan AWS Data Exchange konsol atau AWS Command Line Interface.
Setelah menyiapkan API REST Amazon API Gateway, Anda dapat membuat kumpulan data API baru AWS Data Exchange. Anda kemudian dapat membuat revisi, dan menambahkan aset API.
Membuat dan memublikasikan aset API memungkinkan permintaan pelanggan ke AWS Data Exchange titik akhir untuk di-proxy melalui API Gateway API Anda. Anda kemudian dapat menambahkan kumpulan data ini ke produk dan menambahkan harga. Kemudian, pelanggan dapat melihat produk Anda dan berlangganan di AWS Marketplace katalog dan AWS Data Exchange katalog.
AWS Data Exchange fitur yang tersedia termasuk aturan akses revisi, produk pribadi, penawaran pribadi, dan verifikasi berlangganan.
Anda hanya dapat memilih harga berbasis kontrak, harga biaya terukur (di mana harga kontrak adalah $0), atau kombinasi harga terukur dan kontrak.
Anda dapat memilih biaya terukur standar, atau Anda dapat menentukan biaya terukur khusus. Ada tiga jenis biaya meteran standar yang tersedia:
+ Per permintaan API
+ Per permintaan API yang berhasil
+ Per unit data yang ditransfer dalam byte
**catatan**
Biaya terukur berlaku untuk semua set data API dalam suatu produk. Oleh karena itu, jika Anda ingin membebankan harga yang berbeda untuk dimensi yang sama untuk kumpulan data API yang berbeda, sebaiknya Anda membuat kumpulan data ini dalam produk yang berbeda.
Prosesnya memiliki langkah-langkah berikut:
**Topics**
+ [Prasyarat](#publish-api-prereq)
+ [Langkah 1: Perbarui kebijakan sumber daya API](#update-API-resource-policy)
+ [Langkah 2: Buat kumpulan data API](#create-api-data-set)
+ [Langkah 3: Buat revisi](#create-api-revision)
+ [Langkah 4: Tambahkan aset API ke revisi](#add-api-asset)
+ [Langkah 5: Publikasikan produk baru yang mengandung APIs](#publish-api-data-product)
+ [Langkah 6: (Opsional) Salin produk](#copy-api-product)
## Prasyarat
Sebelum Anda dapat mempublikasikan produk yang mengandung APIs, Anda harus memenuhi prasyarat berikut:
+ Sebelum Anda dapat menggunakan apa pun Layanan AWS AWS Data Exchange, termasuk, Anda harus mendaftar AWS dan membuat pengguna administratif. Untuk informasi selengkapnya, lihat [Memulai](https://docs.aws.amazon.com//singlesignon/latest/userguide/getting-started.html) di *Panduan AWS IAM Identity Center Pengguna*.
+ Untuk membuat produk AWS Data Exchange, Anda harus mendaftarkan diri Akun AWS sebagai AWS Marketplace Penjual. Gunakan akun ini untuk membuat kumpulan data Anda. Akun dengan sumber daya API Gateway tidak perlu berada di akun yang sama yang membuat kumpulan data.
+ REST API Anda harus berada di Amazon API Gateway dengan integrasi yang menggunakan model permintaan dan respons yang sesuai untuk mengakses data Anda, seperti Amazon DynamoDB atau. AWS Lambda Untuk informasi selengkapnya, lihat [Mengembangkan REST API di API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-develop.html) dan [Bekerja dengan REST APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-rest-api.html) di *Panduan Pengembang Amazon API Gateway*.
**catatan**
Hanya API Gateway publik APIs yang didukung.
+ API REST API Gateway Anda harus dapat mengautentikasi dan mengotorisasi panggilan dari prinsipal AWS Data Exchange layanan. Setiap permintaan dari API Anda AWS Data Exchange menggunakan protokol Signature Version 4 (SigV4) yang ditandatangani dengan AWS Data Exchange kredensi. AWS Data Exchange bekerja dengan domain khusus dan pemetaan kunci domain.
**catatan**
AWS Data Exchange tidak mendukung Amazon Cognito, No-Auth, dan otorisasi. AWS Lambda
+ Jika API Gateway REST API Anda menggunakan sistem identitas khusus untuk otentikasi dan otorisasi, konfigurasikan untuk menggunakan autentikasi IAM dan impor skema OpenAPI yang menjelaskan API Anda. AWS Data Exchange akan memanggil API Gateway REST API Anda dengan kredensi layanannya sendiri dan menyertakan informasi pelanggan seperti ID akun.
+ API Gateway REST API Anda bertanggung jawab untuk mengintegrasikan dengan backend Anda. Untuk melakukannya, lakukan salah satu hal berikut:
+ Lampirkan token otentikasi berumur panjang ke setiap permintaan yang datang melalui API Gateway REST API Anda yang dapat diverifikasi oleh backend.
+ Gunakan API Gateway untuk menjalankan fungsi Lambda yang dapat menghasilkan kredensil dan menjalankan API Anda.
API Anda dipanggil sesuai [spesifikasi permintaan integrasi API](#api-request-spec).
Untuk informasi selengkapnya, lihat topik berikut:
**Topics**
+ [Keamanan set data API](#api-data-set-security)
+ [Spesifikasi permintaan integrasi API](#api-request-spec)
+ [Penerusan header](#header-forwarding)
### Keamanan set data API
AWS Data Exchange mengenkripsi lalu lintas ujung ke ujung menggunakan Transport Layer Security (TLS) 1.2. Semua metadata dienkripsi saat istirahat. AWS Data Exchange tidak akan menyimpan permintaan pelanggan atau tanggapan dari backend Anda. Kami hanya mengekstrak metadata pengukuran yang diperlukan untuk penagihan.
### Spesifikasi permintaan integrasi API
API pada AWS Data Exchange melewati semua header (kecuali untuk header yang tercantum dalam[Penerusan header](#header-forwarding)), isi, metode http, jalur, dan string kueri apa adanya dari permintaan pelanggan dan menambahkan header berikut.
```
// These headers help prevent Confused Deputy attacks. They enable the SourceAccount
// and SourceArn variables in IAM policies.
'x-amz-source-account': ACCOUNT_ID,
'x-amz-source-arn': `arn:aws:dataexchange:${REGION}:${OWNER_ACCOUNT_ID}:data-sets/${DATA_SET_ID}/revisions/${REVISION_ID}/assets/${ASSET_ID}`,
// These headers identify the API Asset in Data Exchange.
'x-amzn-dataexchange-asset-id': ASSET_ID,
'x-amzn-dataexchange-data-set-id': DATA_SET_ID,
'x-amzn-dataexchange-revision-id': REVISION_ID,
// This header identifies the Data Exchange Product.
'x-amzn-dataexchange-product-id': PRODUCT_ID,
// This header identifies the caller of Data Exchange. It will contain subscriber
// information.
'x-amzn-dataexchange-requester-account-id': REQUESTER_ACCOUNT_ID,
// Providers can attach custom metadata in the form of key/value pairs
// to a particular subscription. We will send these key/value pairs as stringified
// JSON.
'x-amz-dataexchange-subscription-metadata': STRINGIFIED_METADATA,
```
### Penerusan header
AWS Data Exchange menghapus header apa pun yang terkait dengan otentikasi atau namespaced ke Amazon sebelum meneruskannya ke backend penyedia. Secara khusus, AWS Data Exchange menghapus:
+ Header `Authentication`
+ Setiap header yang dimulai dengan `x-amz`
`host`Header akan ditimpa sebagai konsekuensi dari proxy.
## Langkah 1: Perbarui kebijakan sumber daya API
Jika Anda memiliki API REST Amazon API Gateway yang memenuhi [Prasyarat](#publish-api-prereq), Anda harus memperbarui kebijakan sumber daya API untuk memberikan AWS Data Exchange kemampuan untuk menjalankan API Anda saat pelanggan membuat permintaan untuk mendapatkan skema API Anda.
**Untuk memperbarui kebijakan sumber daya API**
1. Tambahkan kebijakan berikut ke kebijakan sumber daya API Anda:
```
{
"Effect": "Allow",
"Principal": {"Service": "dataexchange.amazonaws.com"},
"Action": "execute-api:Invoke",
"Resource": "*",
"Condition": {"StringEquals": {"aws:SourceAccount": ""}}
}
```
1. Ganti `account-id` dengan akun yang akan membuat kumpulan data API.
Akun dengan sumber daya API Gateway tidak perlu berada di akun yang sama yang membuat kumpulan data.
Kebijakan ini membatasi izin ini untuk panggilan yang dilakukan oleh prinsipal AWS Data Exchange layanan dan mengharuskan hanya akun Anda yang dapat mengotorisasi AWS Data Exchange untuk berintegrasi dengan API Anda.
**catatan**
Jika Anda memiliki kebijakan sumber daya yang secara eksplisit menolak AWS Data Exchange melakukan pemanggilan ini, Anda harus menghapus atau membatasi penolakan ini.
Anda sekarang siap untuk [membuat kumpulan data API](#create-api-data-set).
## Langkah 2: Buat kumpulan data API
Kumpulan data AWS Data Exchange bersifat dinamis dan berversi menggunakan revisi, dengan setiap revisi berisi setidaknya satu aset. Untuk informasi selengkapnya, lihat [Data di AWS Data Exchange](data-sets.md).
Anda menggunakan AWS Data Exchange konsol atau AWS Command Line Interface untuk membuat kumpulan data API:
+ [Membuat kumpulan data API (konsol)](#create-api-ds-console)
+ [Membuat kumpulan data API (AWS CLI)](#create-api-ds-cli)
### Membuat kumpulan data API (konsol)
**Untuk membuat kumpulan data API (konsol)**
1. Buka browser web Anda dan masuk ke [AWS Data Exchange konsol](https://console.aws.amazon.com/dataexchange).
1. Di panel navigasi sisi kiri, di bawah **Data saya**, pilih **Kumpulan data yang dimiliki**.
1. Di **Kumpulan data yang dimiliki**, pilih **Buat kumpulan data** untuk membuka panduan **langkah pembuatan kumpulan data**.
1. Di **Pilih jenis kumpulan data**, pilih **Amazon API Gateway API**.
1. Di **Tentukan kumpulan data**, masukkan **Nama** dan **Deskripsi** untuk kumpulan data Anda. Untuk informasi selengkapnya, lihat [Praktik terbaik kumpulan data](data-sets.md#data-set-best-practices).
1. (Opsional) Di bawah **Tambahkan tag - opsional**, tambahkan tag.
1. Pilih **Buat**.
Anda sekarang siap untuk membuat revisi.
### Membuat kumpulan data API (AWS CLI)
**Untuk membuat kumpulan data API (CLI)**
1. Gunakan `create-data-set` perintah untuk membuat kumpulan data API:
```
$ AWS dataexchange create-data-set \
--asset-type API_GATEWAY_API \
--description 'Data Set Description' \
--name 'Data Set Name'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID",
"AssetType": "API_GATEWAY_API",
"CreatedAt": "2021-09-11T00:16:46.349000+00:00",
"Description": "Data Set Description",
"Id": "$DATA_SET_ID",
"Name": "Data Set Name",
"Origin": "OWNED",
"UpdatedAt": "2021-09-11T00:16:46.349000+00:00"
}
```
1. Perhatikan Jenis Aset baru dari`API_GATEWAY_API`.
Anda sekarang siap untuk membuat revisi.
## Langkah 3: Buat revisi
Dalam prosedur berikut, Anda membuat revisi setelah Anda membuat kumpulan data. Untuk informasi selengkapnya, lihat [Revisi](data-sets.md#revisions).
Anda menggunakan AWS Data Exchange konsol atau AWS Command Line Interface untuk membuat revisi:
+ [Membuat revisi (konsol)](#create-api-revision-console)
+ [Membuat revisi ()AWS CLI](#create-api-revision-cli)
### Membuat revisi (konsol)
**Untuk membuat revisi (konsol)**
1. Pada bagian **Ikhtisar kumpulan data** dari halaman detail kumpulan data:
1. (Opsional) Pilih **Edit nama** untuk mengedit informasi tentang kumpulan data Anda.
1. (Opsional) Pilih **Hapus** untuk menghapus kumpulan data.
1. Pada bagian **Revisi**, pilih **Buat revisi**.
1. Di bawah **Tentukan revisi**, berikan komentar opsional untuk revisi Anda yang menjelaskan tujuan revisi.
1. (Opsional) Di bawah **Tambahkan tag - opsional**, tambahkan tag yang terkait dengan sumber daya.
1. Pilih **Buat revisi**.
1. Tinjau, edit, atau hapus perubahan Anda dari langkah sebelumnya.
Anda sekarang siap untuk [menambahkan aset API ke revisi](#add-api-asset).
### Membuat revisi ()AWS CLI
**Untuk membuat revisi ()AWS CLI**
1. Gunakan `create-revision` perintah untuk membuat revisi:
```
$ AWS dataexchange create-revision \
--data-set-id $DATA_SET_ID \
--comment 'First Atlas Revision'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID",
"Comment": "First Atlas Revision",
"CreatedAt": "2021-09-11T00:18:49.160000+00:00",
"DataSetId": "$DATA_SET_ID",
"Finalized": false,
"Id": "$REVISION_ID",
"UpdatedAt": "2021-09-11T00:18:49.160000+00:00"
}
```
1. [Tambahkan aset API ke revisi](#add-api-asset).
**catatan**
Anda perlu mengetahui ID API Gateway REST API yang ingin Anda impor serta tahapannya.
## Langkah 4: Tambahkan aset API ke revisi
Aset API berisi informasi yang dibutuhkan pelanggan untuk melakukan panggilan ke API Anda. Untuk informasi selengkapnya, lihat [Aset](data-sets.md#assets).
Dalam prosedur berikut, Anda mengimpor aset data, dan kemudian menyelesaikan revisi.
Anda menggunakan AWS Data Exchange konsol atau AWS CLI untuk menambahkan aset ke revisi:
+ [Menambahkan aset API ke revisi (konsol)](#add-api-assets)
+ [Menambahkan aset API ke revisi ()AWS CLI](#add-api-assets-cli)
### Menambahkan aset API ke revisi (konsol)
**Untuk menambahkan aset ke revisi (konsol)**
1. Di bagian **aset API** pada halaman detail kumpulan data, pilih **Tambahkan tahap API**.
1. **Pada tahap Pilih API**, untuk **Amazon API Gateway API**, masukkan API di kotak input atau pilih salah satu dari berikut ini dari daftar drop-down:
+ **API di yang lain Akun AWS** - ini adalah API lintas akun yang telah diberikan izin untuk Anda akses.
+ **Dalam hal ini Akun AWS** - ini adalah API di Anda Akun AWS.
1. Jika Anda memilih **API di yang lain Akun AWS**, masukkan ID API dan **nama API Stage** di kotak input.
1. Jika Anda memilih **Dalam hal ini Akun AWS**, pilih **nama API Stage** dari daftar drop-down
**catatan**
Anda dapat membuat tahap API baru dengan memilih **Create new** dan mengikuti langkah-langkah dalam modal **Create new API di Amazon API Gateway**. Setelah tahap baru dibuat, ulangi Langkah 2.
1. **Di bawah **Konfigurasi lanjutan — opsional**, Anda dapat memilih untuk **Menyambungkan paket penggunaan Amazon API Gateway yang ada** untuk menggunakan pembatasan dan batas kuota seperti yang ditentukan dalam paket penggunaan yang ada, dan memasukkan kunci API.**
1. Di bawah **API Dokumen untuk pelanggan**, berikan detail tentang API yang akan dilihat pelanggan setelah mereka berlangganan produk Anda.
1. Untuk **nama API**, masukkan nama yang dapat digunakan pelanggan untuk mengidentifikasi aset API.
**catatan**
Jika **Dalam ini Akun AWS** dipilih, **nama API** secara otomatis diisi, yang dapat Anda modifikasi jika perlu.
Jika **API di yang lain Akun AWS** dipilih, **nama API** diisi dengan nama default, yang harus Anda modifikasi sehingga pelanggan dapat dengan mudah memahami apa itu.
1. Untuk **spesifikasi OpenAPI 3.0**, baik:
1. Masukkan atau salin dan tempel file spesifikasi OpenAPI 3.0.
1. Pilih **Impor dari file.JSON**, lalu pilih file.json dari komputer lokal Anda untuk diimpor.
Spesifikasi yang diimpor muncul di kotak.
1. Pilih **Impor dari Amazon API Gateway**, lalu pilih spesifikasi yang akan diimpor.
Spesifikasi yang diimpor muncul di kotak.
1. Untuk **Dokumentasi tambahan - opsional**, masukkan informasi tambahan apa pun yang berguna bagi pelanggan untuk mengetahui tentang API Anda. Markdown didukung.
**catatan**
Anda tidak dapat mengedit spesifikasi OpenAPI dan dokumentasi tambahan setelah menambahkan aset ini ke revisi.
Jika Anda ingin memperbarui informasi ini, dan revisi belum selesai, Anda dapat mengganti aset.
Jika Anda ingin memperbarui informasi ini, dan revisi selesai, Anda dapat membuat revisi baru dengan aset yang diperbarui.
1. Pilih **tahap Add API**.
Pekerjaan dimulai untuk mengimpor aset Anda (dalam hal ini, API) ke dalam kumpulan data Anda.
**catatan**
Jika Anda tidak memiliki API di Amazon API Gateway, Anda akan diminta untuk membuatnya.
1. Setelah pekerjaan selesai, bidang **Negara** bagian di bagian **Pekerjaan** diperbarui ke **Selesai.**
1. Jika Anda memiliki lebih banyak APIs untuk ditambahkan, ulangi Langkah 2.
1. Di bawah **ikhtisar Revisi**, tinjau revisi Anda dan asetnya.
1. Pilih **Finalisasi**.
Anda telah berhasil menyelesaikan revisi untuk kumpulan data.
Anda dapat [mengedit revisi](#edit-api-revision) atau [menghapus revisi](#delete-api-revision) sebelum menambahkannya ke produk.
Anda sekarang siap untuk [mempublikasikan produk data API baru](#publish-api-data-product).
### Menambahkan aset API ke revisi ()AWS CLI
Anda dapat menambahkan aset API dengan menjalankan `IMPORT_ASSET_FROM_API_GATEWAY_API` pekerjaan.
**Untuk menambahkan aset API ke revisi (AWS CLI):**
1. Gunakan `create-job` perintah untuk menambahkan aset API ke revisi:
```
$ AWS dataexchange create-job \
--type IMPORT_ASSET_FROM_API_GATEWAY_API \
--details '{"ImportAssetFromApiGatewayApi":{"DataSetId":"$DATA_SET_ID","RevisionId":"$REVISION_ID","ApiId":"$API_ID","Stage":"$API_STAGE","ProtocolType":"REST"}}'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/$JOB_ID",
"CreatedAt": "2021-09-11T00:38:19.875000+00:00",
"Details": {
"ImportAssetFromApiGatewayApi": {
"ApiId": "$API_ID",
"DataSetId": "$DATA_SET_ID",
"ProtocolType": "REST",
"RevisionId": "$REVISION_ID",
"Stage": "$API_STAGE"
}
},
"Id": "$JOB_ID",
"State": "WAITING",
"Type": "IMPORT_ASSET_FROM_API_GATEWAY_API",
"UpdatedAt": "2021-09-11T00:38:19.875000+00:00"
}
$ AWS dataexchange start-job --job-id $JOB_ID
$ AWS dataexchange get-job --job-id $JOB_ID
{
"Arn": "arn:aws:dataexchange:us-east-1:0123456789012:jobs/$JOB_ID",
"CreatedAt": "2021-09-11T00:38:19.875000+00:00",
"Details": {
"ImportAssetFromApiGatewayApi": {
"ApiId": "$API_ID",
"DataSetId": "$DATA_SET_ID",
"ProtocolType": "REST",
"RevisionId": "$REVISION_ID",
"Stage": "$API_STAGE"
"ApiEndpoint": "string",
"ApiKey": "string",
"ApiName": "string",
"ApiDescription": "string",
"ApiSpecificationDownloadUrl": "string",
"ApiSpecificationDownloadUrlExpiresAt": "string"
}
},
"Id": "$JOB_ID",
"State": "COMPLETED",
"Type": "IMPORT_ASSET_FROM_API_GATEWAY_API",
"UpdatedAt": "2021-09-11T00:38:52.538000+00:00"
}
```
1. Gunakan `list-revision-assets` perintah untuk mengonfirmasi bahwa aset baru dibuat dengan benar:
```
$ AWS dataexchange list-revision-assets \
--data-set-id $DATA_SET_ID \
--revision-id $REVISION_ID
{
"Assets": [
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID/assets/$ASSET_ID",
"AssetDetails": {
"ApiGatewayApiAsset": {
"ApiEndpoint": "https://$API_ID.execute-api.us-east-1.amazonaws.com/$API_STAGE",
"ApiId": "$API_ID",
"ProtocolType": "REST",
"Stage": "$API_STAGE"
}
},
"AssetType": "API_GATEWAY_API",
"CreatedAt": "2021-09-11T00:38:52.457000+00:00",
"DataSetId": "$DATA_SET_ID",
"Id": "$ASSET_ID",
"Name": "$ASSET_ID/$API_STAGE",
"RevisionId": "$REVISION_ID",
"UpdatedAt": "2021-09-11T00:38:52.457000+00:00"
}
]
}
```
Anda sekarang siap untuk [mempublikasikan produk data API](#publish-api-data-product).
### Mengedit revisi
**Untuk mengedit revisi setelah Anda menyelesaikannya**
1. Pada **ikhtisar Revisi**, pilih **De-finalize**.
Anda melihat pesan bahwa revisi tidak lagi dalam keadaan final.
1. **Untuk mengedit revisi, dari **ikhtisar Revisi**, pilih **Tindakan**, Edit.**
1. Buat perubahan Anda, lalu pilih **Perbarui**.
1. Tinjau perubahan Anda dan kemudian pilih **Finalize**.
### Hapus revisi
**Untuk menghapus revisi setelah Anda menyelesaikannya**
1. Pada **ikhtisar Revisi**, pilih **Hapus**.
1. Ketik **Delete** kotak dialog **Hapus revisi**, lalu pilih **Hapus**.
**Awas**
Ini menghapus revisi dan semua asetnya. Tindakan ini tidak dapat dibatalkan.
## Langkah 5: Publikasikan produk baru yang mengandung APIs
Setelah Anda membuat setidaknya satu set data dan menyelesaikan revisi dengan aset, Anda siap untuk mempublikasikan kumpulan data tersebut sebagai bagian dari produk. Untuk informasi selengkapnya, lihat [Praktik terbaik produk di AWS Data Exchange](product-details.md). Pastikan Anda memiliki semua detail yang diperlukan tentang produk dan penawaran Anda.
Anda menggunakan AWS Data Exchange konsol atau API AWS Marketplace Katalog untuk memublikasikan produk baru yang berisi APIs. Untuk informasi selengkapnya tentang cara memublikasikan produk baru menggunakan API AWS Marketplace Katalog, lihat[Menggunakan AWS Data Exchange dengan API AWS Marketplace Katalog](appendices.md).
+ [Menerbitkan produk baru yang berisi APIs (konsol)](#publish-api-product-console)
### Menerbitkan produk baru yang berisi APIs (konsol)
**Untuk mempublikasikan produk baru yang mengandung APIs**
1. Dari panel navigasi kiri [AWS Data Exchange konsol](https://console.aws.amazon.com/dataexchange), di bawah **Publikasikan data**, pilih **Produk**.
1. Dari **Produk**, pilih **Publikasikan produk baru** untuk membuka panduan **Publikasikan produk baru**.
1. Dalam **visibilitas Produk**:
1. Pilih **opsi visibilitas Produk produk** Anda sebagai **Publik** atau **Pribadi**.
Semua AWS Data Exchange produk dengan visibilitas yang disetel ke **Publik** memerlukan penawaran umum.
Untuk informasi selengkapnya, lihat [Visibilitas produk di AWS Data Exchange](product-visibility.md).
1. Pilih konfigurasi **informasi Sensitif** produk Anda.
Untuk informasi selengkapnya, lihat [Kategori informasi sensitif di AWS Data Exchange](sensitive-information.md).
1. Pilih **Berikutnya**.
1. Di **Tambahkan data**:
1. Di bawah **Kumpulan data yang dimiliki**, pilih kotak centang di samping kumpulan data yang ingin Anda tambahkan, lalu pilih **Tambah dipilih**.
**catatan**
Kumpulan data yang Anda pilih harus memiliki revisi yang diselesaikan. Kumpulan data tanpa revisi akhir tidak ditambahkan.
1. Buka **Kumpulan data yang dipilih** untuk meninjau pilihan Anda.
Anda dapat meninjau **Nama** kumpulan data, **Jenis** kumpulan data, dan stempel waktu kapan kumpulan data **terakhir** diperbarui.
1. Buka **Pilih aturan akses revisi, dan pilih aturan** akses revisi yang ingin Anda tetapkan untuk kumpulan data yang disertakan dalam produk ini.
Untuk informasi selengkapnya, lihat [Aturan akses revisi di AWS Data Exchange](best-practices-revisions.md).
1. Pilih **Berikutnya**.
1. Dalam **Tentukan produk**:
1. Di bawah **ikhtisar Produk**, masukkan informasi tentang produk Anda, termasuk **nama Produk****, logo Produk**, informasi **kontak Support**, dan **kategori Produk**.
Untuk informasi selengkapnya, lihat [Praktik terbaik produk di AWS Data Exchange](product-details.md).
1. **(Opsional) Di bawah **Kamus dan sampel data — opsional**, pilih kumpulan data dengan memilih tombol opsi di sebelah nama kumpulan data dan kemudian pilih Edit.**
1. Di kotak dialog **Edit**, pilih **Unggah** untuk mengunggah kamus data baru.
Anda dapat memilih satu kamus data, dalam format.csv, dengan ukuran maksimum 1 MB.
1. Pilih kamus data yang disimpan dari komputer Anda dan kemudian pilih **Buka**.
File kamus data.csv muncul di kotak dialog **Edit**.
**catatan**
Kamus data Anda harus sesuai dengan template kamus AWS Data Exchange data. Jika Anda tidak memiliki kamus data tersimpan untuk diunggah, Anda dapat memilih tautan **templat kamus data kosong** atau tautan **kamus data contoh** di AWS Data Exchange konsol.
1. Pilih **Pratinjau kamus data** untuk melihat pratinjau kamus data.
1. Di bawah **Sampel - opsional**, pilih **Unggah sampel**, pilih sampel dari komputer Anda, lalu pilih **Buka**.
Sampel muncul di kotak dialog **Edit**.
**catatan**
Anda dapat mengunggah hingga 10 sampel dengan ukuran maksimum 50 MB. Sampel dalam format.csv dapat dipratinjau.
1. Masukkan deskripsi untuk setiap sampel yang akan terlihat di halaman detail produk.
1. Pilih **Simpan**.
1. Di bawah **definisi Produk**, masukkan **deskripsi singkat** dan **deskripsi panjang** produk Anda.
Jika Anda ingin menggunakan templat untuk deskripsi panjang Anda, pilih **Terapkan templat**, pilih jenis templat Anda, lalu isi templat dengan detail produk spesifik Anda.
1. Pilih **Berikutnya**.
1. Konfigurasikan penawaran Anda di **Tambahkan penawaran umum** (untuk penawaran umum) atau **Tambahkan penawaran khusus** (untuk penawaran pribadi):
Semua AWS Data Exchange produk dengan visibilitas yang disetel ke **Publik** memerlukan penawaran umum.
1. Hanya untuk penawaran pribadi:
1. Pilih salah satu **jenis Penawaran** yang terdaftar: **Penawaran pribadi, Penawaran** **pribadi yang diperbarui**, atau **Bawa Langganan Anda Sendiri (BYOS**).
1. Di bagian **Informasi Akun Pelanggan**, tambahkan setidaknya satu akun pelanggan yang ingin Anda perpanjang penawarannya.
1. Pilih opsi **Harga dan durasi akses** Anda untuk berlangganan.
1. Untuk **biaya terukur - opsional**, pilih **Tambah**.
1. Untuk **Menambahkan biaya terukur**, pilih jenis biaya untuk panggilan API dari daftar **Jenis**:
+ **Per permintaan API**
+ **Per permintaan API yang berhasil**
+ **Per unit data yang ditransfer dalam byte**
+ **Biaya meteran kustom baru**
1. Masukkan atau perbarui **nama tampilan Biaya**, yang terlihat pada faktur pelanggan.
1. Jika Anda menggunakan **biaya terukur yang telah ditentukan sebelumnya**, **Kunci** dibuat secara otomatis, tidak dapat diedit, dan tidak perlu dikirim kembali di header respons.
1. Jika Anda membuat **biaya terukur kustom Baru**, masukkan **Kunci**, yang merupakan pengenal untuk biaya terukur di header respons API (maksimum 15 karakter).
**Kunci** ini harus dikirim kembali sebagai bagian dari header `x-amz-dataexchange-metering` respons.
**Example Kunci kustom**
Jika Anda memiliki kunci khusus yang dipanggil **VertexCount** dan kunci khusus lainnya dipanggil**EdgeCount**, header respons “x-amz-dataexchange-metering” dapat memiliki nilai `VertexCount=3,EdgeCount=10` atau Anda dapat mengembalikan dua baris header terpisah:
`x-amz-dataexchange-metering: VertextCount=3`
`x-amz-dataexchange-metering: EdgeCount=10`
1. Masukkan harga yang dikenakan pelanggan per unit di **Harga/unit**.
1. (Opsional) Masukkan jumlah unit untuk menampilkan contoh biaya dalam **kalkulator biaya terukur**.
1. (Opsional) Masukkan **Deskripsi singkat tentang** biaya terukur yang muncul di halaman detail produk.
1. Pilih **Tambahkan**.
1. (Opsional) Ulangi untuk menambahkan biaya terukur tambahan.
Urutan biaya terukur muncul di halaman detail produk. Anda tidak dapat menyusun ulang mereka.
**catatan**
Setelah penawaran dibuat, Anda dapat mengedit harga dan deskripsi biaya terukur. Untuk informasi selengkapnya, lihat [Memperbarui detail produk dan penawaran di AWS Data Exchange](update-product-details.md).
1. Hanya untuk penawaran pribadi, pilih **tanggal kedaluwarsa Penawaran** di mana pelanggan harus menerima penawaran.
1. Pilih **pengaturan Pajak**, **Perjanjian Langganan Data (DSA)**, dan **kebijakan Pengembalian Dana**.
1. (Opsional) Hanya untuk penawaran umum, atur **verifikasi Langganan**, yang memungkinkan Anda mengontrol siapa yang dapat berlangganan produk ini. Untuk informasi selengkapnya, lihat [Verifikasi langganan untuk penyedia di AWS Data Exchange](subscription-verification-pro.md).
1. Pilih opsi **perpanjangan otomatis OOffer** Anda. Untuk informasi selengkapnya, lihat [Membuat penawaran untuk AWS Data Exchange produk](prepare-offers.md).
1. Pilih **Berikutnya**.
1. Di bagian **Tinjau & publikasikan**, tinjau informasi produk Anda.
1. Perluas **pratinjau halaman Produk** untuk melihat bagaimana halaman produk akan terlihat setelah publikasi.
1. (Opsional) Pilih tombol **Edit** di bagian mana pun untuk mengedit bagian itu.
1. Jika Anda yakin ingin membuat produk dan penawaran publik terlihat dan tersedia untuk semua orang, pilih **Publikasikan**.
Anda sekarang telah menyelesaikan bagian manual penerbitan produk data dengan penawaran umum. AWS Data Exchange menyiapkan dan menerbitkan produk Anda.
Pada halaman **ikhtisar Produk**, status produk Anda adalah **Menunggu persetujuan** dan kemudian berubah menjadi **Diterbitkan** setelah dipublikasikan.
## Langkah 6: (Opsional) Salin produk
Setelah Anda membuat produk pertama Anda, Anda dapat menyalin detailnya dan penawaran publik untuk membuat produk baru.
**catatan**
Anda dapat menyalin produk publik, pribadi, diterbitkan, atau tidak dipublikasikan. Penawaran khusus yang terkait dengan produk tidak akan disalin, tetapi penawaran publik akan disalin.
**Untuk menyalin produk**
1. Buka browser web Anda dan masuk ke [AWS Data Exchange konsol](https://console.aws.amazon.com/dataexchange).
1. Dari panel navigasi kiri, di bawah **Publikasikan data**, pilih **Produk**.
1. Dari **Produk**, pilih tombol di sebelah produk yang ingin Anda salin.
1. Pilih dropdown **Tindakan**, lalu pilih **Buat** salinan.
1. Lanjutkan melalui **Publikasikan alur kerja produk baru**, dengan detail yang sudah diisi, berdasarkan produk yang Anda pilih di Langkah 3. Untuk informasi selengkapnya, lihat [Langkah 5: Publikasikan produk baru](publish-data-product.md#publish-products).