Menerbitkan produk baru - AWS Data Exchange Panduan Pengguna
Menerbitkan produk yang berisi data berbasis fileMenerbitkan produk yang mengandung APIMenerbitkan produk yang berisi kumpulan data Amazon RedshiftMenerbitkan produk yang berisi akses data Amazon S3Menerbitkan produk yang berisi kumpulan AWS Lake Formation data izin data (Pratinjau)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menerbitkan produk baru

Topik berikut menjelaskan proses penerbitan produk baru AWS Data Exchange dengan menggunakan AWS Data Exchange konsol.

Video berikut menjelaskan lebih lanjut tentang cara mempublikasikan produk data baruAWS Data Exchange.

Menerbitkan produk yang berisi data berbasis file

Topik berikut menjelaskan proses pembuatan kumpulan data dan menerbitkan produk baru yang berisi data berbasis file AWS Data Exchange dengan menggunakan konsol. AWS Data Exchange Prosesnya memiliki langkah-langkah berikut:

Langkah 1: Buat aset

Aset adalah data yang masukAWS Data Exchange. Untuk informasi selengkapnya, lihat Aset.

Sebelum Anda membuat dan mempublikasikan produk data berbasis file baru, Anda harus:

  1. Buat file Anda.

    AWS Data Exchangemendukung semua jenis file.

  2. Simpan file Anda sebagai objek di Amazon Simple Storage Service (Amazon S3) atau di komputer lokal Anda.

    Untuk informasi selengkapnya tentang menyimpan file di Amazon S3, lihat Panduan Pengguna Amazon S3.

Langkah 2: Buat kumpulan data

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.

Untuk membuat kumpulan data

  1. Buka browser web Anda dan masuk ke AWS Data Exchangekonsol.

  2. Di panel navigasi sisi kiri, di bawah Publikasikan data, pilih Kumpulan data yang dimiliki.

  3. Di Kumpulan data yang dimiliki, pilih Buat kumpulan data untuk membuka panduan langkah pembuatan kumpulan data.

  4. Di Pilih tipe kumpulan data, pilih File.

  5. Di Tentukan kumpulan data, masukkan Nama dan Deskripsi untuk kumpulan data Anda. Untuk informasi selengkapnya, lihat Praktik terbaik kumpulan data.

  6. (Opsional) Di bawah Tambahkan tag - opsional, tambahkan tag.

  7. Pilih Buat kumpulan data.

Langkah 3: Buat revisi

Dalam prosedur berikut, Anda membuat revisi setelah membuat kumpulan data di AWS Data Exchange konsol. Untuk informasi selengkapnya, lihat Revisi.

Untuk membuat revisi

  1. Pada bagian Ikhtisar kumpulan data pada halaman detail kumpulan data:

    1. (Opsional) Pilih Edit nama untuk mengedit informasi tentang kumpulan data Anda.

    2. (Opsional) Pilih Hapus untuk menghapus kumpulan data.

  2. Di bagian Revisi, pilih Buat revisi.

  3. Di bawah Tentukan revisi, berikan komentar opsional untuk revisi Anda yang menjelaskan tujuan revisi.

  4. (Opsional) Di bawah Tambahkan tag - opsional, tambahkan tag yang terkait dengan sumber daya.

  5. Pilih Buat revisi.

  6. Tinjau, edit, atau hapus perubahan Anda dari langkah sebelumnya.

Langkah 4: Impor aset ke revisi

Dalam prosedur berikut, Anda mengimpor aset data, lalu menyelesaikan revisi di AWS Data Exchange konsol. Untuk informasi selengkapnya, lihat Aset.

Untuk mengimpor aset ke revisi

  1. Di bawah bagian Pekerjaan pada halaman detail kumpulan data, pilih Impor dari Amazon S3 atau Unggah (untuk mengunggah dari komputer Anda), tergantung di mana aset data untuk kumpulan data saat ini disimpan.

  2. Ikuti petunjuknya, tergantung pada pilihan Anda. Pekerjaan dimulai untuk mengimpor aset Anda ke kumpulan data Anda.

  3. Setelah pekerjaan selesai, bidang Negara bagian di bagian Pekerjaan diperbarui ke Selesai.

  4. Jika Anda memiliki lebih banyak data untuk ditambahkan, ulangi Langkah 1.

  5. Dalam ikhtisar Revisi, tinjau revisi Anda dan asetnya.

  6. Pilih Selesaikan revisi.

Anda telah berhasil menyelesaikan revisi untuk kumpulan data.

Anda dapat mengedit atau menghapus revisi sebelum menambahkannya ke produk.

Mengedit revisi

Untuk mengedit revisi setelah Anda menyelesaikannya

  1. Dalam ikhtisar Revisi, pilih De-finalize.

    Anda melihat pesan bahwa revisi tidak lagi dalam keadaan final.

  2. Untuk mengedit revisi, dari ikhtisar Revisi, pilih Tindakan, Edit.

  3. Buat perubahan Anda, lalu pilih Perbarui.

  4. Tinjau perubahan Anda, lalu pilih Selesaikan.

Hapus revisi

Untuk menghapus revisi setelah Anda menyelesaikannya

  1. Dalam Ikhtisar revisi, pilih Hapus.

  2. 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

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 Detail produk. Pastikan Anda memiliki semua detail yang diperlukan tentang produk dan penawaran Anda.

Untuk mempublikasikan produk baru

  1. Di panel navigasi kiri AWS Data Exchangekonsol, di bawah Publikasikan data, pilih Produk.

  2. Dari Produk, pilih Publikasikan produk baru untuk membuka panduan Publikasikan produk baru.

  3. Di bagian Visibilitas produk, pilih opsi visibilitas Produk dan konfigurasi informasi sensitif produk Anda, lalu pilih Berikutnya. Untuk informasi selengkapnya, silakan lihat Visibilitas produk dan Kategori informasi yang sensitif.

  4. Di bagian Tambahkan data, di bawah Kumpulan data yang dimiliki, pilih kotak centang di sebelah kumpulan data yang ingin Anda tambahkan, lalu pilih Tambah yang dipilih.

    catatan

    Kumpulan data yang Anda pilih harus memiliki revisi yang diselesaikan. Kumpulan data tanpa revisi akhir tidak dapat 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.

    2. Pergi ke Pilih aturan akses revisi, pilih aturan akses revisi yang ingin Anda tetapkan untuk kumpulan data yang disertakan dalam produk ini, lalu pilih Berikutnya. Untuk detail selengkapnya, lihat Aturan akses revisi.

  5. Di bagian Tentukan produk, di bawah ikhtisar Produk, masukkan informasi tentang produk Anda, termasuk nama Produk, logo Produk, informasi kontak Dukungan, dan kategori Produk.

    Untuk informasi selengkapnya, lihat Detail produk.

  6. (Opsional) Di bagian Tentukan produk, di bawah Kamus dan sampel data — opsional, pilih kumpulan data dengan memilih tombol opsi di sebelah nama kumpulan data lalu pilih Edit.

    1. Dalam kotak dialog Edit, di bawah Unggah kamus data, pilih Tambahkan file untuk mengunggah kamus data baru.

      Anda dapat memilih satu kamus data, dalam format.csv, dengan ukuran maksimum 1 MB.

    2. Pilih kamus data yang disimpan dari komputer Anda, lalu 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.

    3. Pilih Pratinjau kamus data untuk mempratinjau itu.

    4. 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.

    5. Masukkan deskripsi untuk setiap sampel yang akan terlihat di halaman detail produk.

    6. Pilih Simpan.

  7. 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.

  8. Pilih Berikutnya.

  9. Konfigurasikan penawaran Anda.

    • Jika Anda membuat penawaran umum, di bagian Tambahkan penawaran publik, konfigurasikan penawaran Anda. Semua AWS Data Exchange produk dengan visibilitas yang disetel ke Publik memerlukan penawaran umum.

      1. Pilih opsi Harga dan durasi akses Anda untuk langganan.

      2. Pilih pengaturan pajak penjualan AS, perjanjian langganan data (DSA), dan kebijakan pengembalian dana Anda.

      3. (Opsional) Tetapkan verifikasi Langganan, yang memungkinkan Anda mengontrol siapa yang dapat berlangganan produk ini. Untuk informasi selengkapnya, lihat Verifikasi berlangganan untuk penyedia.

      4. Pilih opsi perpanjangan otomatis Offer Anda. Untuk informasi selengkapnya, lihat Membuat penawaran untukAWS Data Exchangeproduk.

      5. Pilih Berikutnya.

    • Jika Anda membuat penawaran pribadi, konfigurasikan detail penawaran di bagian Tambahkan penawaran khusus.

      1. Di bagian Informasi Akun Pelanggan, tambahkan setidaknya satu akun pelanggan yang ingin Anda perpanjang penawarannya.

      2. Pilih opsi Harga dan durasi akses Anda untuk langganan.

      3. Pilih tanggal kedaluwarsa Penawaran di mana pelanggan harus menerima penawaran.

      4. Pilih pengaturan pajak penjualan AS, perjanjian langganan data (DSA), dan kebijakan pengembalian dana Anda.

      5. Pilih opsi perpanjangan otomatis Offer Anda. Untuk informasi selengkapnya, lihat Membuat penawaran untukAWS Data Exchangeproduk.

      6. Pilih Berikutnya.

  10. Di bagian Tinjau & publikasikan, tinjau informasi produk Anda dan kemudian perluas pratinjau halaman Produk untuk melihat tampilannya setelah dipublikasikan.

  11. 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 Exchangemenyiapkan 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 Exchangekonsol.

  2. Dari panel navigasi kiri, di bawah Publikasikan data, pilih Produk.

  3. Dari Produk, pilih tombol di sebelah produk yang ingin Anda salin.

  4. Pilih dropdown Tindakan, lalu pilih Buat salinan.

  5. 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.

Menerbitkan produk yang mengandung API

Gambaran Umum

Topik berikut menjelaskan proses pembuatan kumpulan data REST API dan memublikasikan produk baru yang berisi APIAWS Data Exchange. Anda dapat menyelesaikan proses dengan menggunakan AWS Data Exchange konsol atauAWS Command Line Interface.

Setelah menyiapkan API REST Amazon API Gateway, Anda dapat membuat kumpulan data API baruAWS 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 Exchangefitur 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:

Prasyarat

Sebelum Anda dapat mempublikasikan produk yang berisi API, Anda harus memenuhi prasyarat berikut:

  • Sebelum Anda dapat menggunakan apa pun Layanan AWSAWS Data Exchange, termasuk, Anda harus mendaftar AWS dan membuat pengguna administratif. Untuk informasi selengkapnya, lihat Memulai di Panduan AWS IAM Identity Center Pengguna.

  • Untuk membuat produkAWS 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 dan Bekerja dengan REST API di Panduan Pengembang Amazon API Gateway.

    catatan

    Hanya API Gateway API publik 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 kredensil. AWS Data Exchangebekerja dengan domain khusus dan pemetaan kunci domain.

    catatan

    AWS Data Exchangetidak 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 Exchangeakan memanggil API Gateway REST API Anda dengan kredensyal 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 kredensi dan menjalankan API Anda.

API Anda dipanggil sesuai spesifikasi permintaan integrasi API.

Untuk informasi lain, lihat topik berikut:

Keamanan set data API

AWS Data Exchangemengenkripsi lalu lintas ujung ke ujung menggunakan Transport Layer Security (TLS) 1.2. Semua metadata dienkripsi saat istirahat. AWS Data Exchangetidak 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 dalamPenerusan header), 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 Exchangemenghapus header apa pun yang terkait dengan otentikasi atau namespaced ke Amazon sebelum meneruskannya ke backend penyedia. Secara khusus, AWS Data Exchange menghapus:

  • Authentication header

  • Setiap header yang dimulai dengan x-amz

hostHeader akan ditimpa sebagai konsekuensi dari proxy.

Langkah 1: Perbarui kebijakan sumber daya API

Jika Anda memiliki API REST Amazon API Gateway yang memenuhi Prasyarat, 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": "<account-id>"}}
}

  2. 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.

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.

Anda menggunakan AWS Data Exchange konsol atau AWS Command Line Interface untuk membuat kumpulan data API:

Membuat kumpulan data API (konsol)
Untuk membuat kumpulan data API (konsol)

  1. Buka browser web Anda dan masuk ke AWS Data Exchangekonsol.

  2. Di panel navigasi sisi kiri, di bawah Data saya, pilih Kumpulan data yang dimiliki.

  3. Di Kumpulan data yang dimiliki, pilih Buat kumpulan data untuk membuka panduan langkah pembuatan kumpulan data.

  4. Di Pilih jenis kumpulan data, pilih Amazon API Gateway API.

  5. Di Tentukan kumpulan data, masukkan Nama dan Deskripsi untuk kumpulan data Anda. Untuk informasi selengkapnya, lihat Praktik terbaik kumpulan data.

  6. (Opsional) Di bawah Tambahkan tag - opsional, tambahkan tag.

  7. 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"
}

  2. Perhatikan Jenis Aset baru dariAPI_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.

Anda menggunakan AWS Data Exchange konsol atau AWS Command Line Interface untuk membuat revisi:

Membuat revisi (konsol)
Untuk membuat revisi (konsol)

  1. Pada bagian Ikhtisar kumpulan data pada halaman detail kumpulan data:

    1. (Opsional) Pilih Edit nama untuk mengedit informasi tentang kumpulan data Anda.

    2. (Opsional) Pilih Hapus untuk menghapus kumpulan data.

  2. Pada bagian Revisi, pilih Buat revisi.

  3. Di bawah Tentukan revisi, berikan komentar opsional untuk revisi Anda yang menjelaskan tujuan revisi.

  4. (Opsional) Di bawah Tambahkan tag - opsional, tambahkan tag yang terkait dengan sumber daya.

  5. Pilih Buat revisi.

  6. Tinjau, edit, atau hapus perubahan Anda dari langkah sebelumnya.

Anda sekarang siap untuk menambahkan aset API ke revisi.

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"
}

  2. Tambahkan aset API ke revisi.

    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.

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)
Untuk menambahkan aset ke revisi (konsol)

  1. Di bagian aset API pada halaman detail kumpulan data, pilih Tambahkan tahap API.

  2. 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 AndaAkun AWS.

    1. Jika Anda memilih API di yang lain Akun AWS, masukkan ID API dan nama API Stage di kotak input.

    2. 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.

  3. 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.

  4. 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.

    2. Untuk spesifikasi OpenAPI 3.0, baik:

      1. Masukkan atau salin dan tempel file spesifikasi OpenAPI 3.0.

      2. Pilih Impor dari file.JSON, lalu pilih file.json dari komputer lokal Anda untuk diimpor.

        Spesifikasi yang diimpor muncul di kotak.

      3. Pilih Impor dari Amazon API Gateway, lalu pilih spesifikasi yang akan diimpor.

        Spesifikasi yang diimpor muncul di kotak.

    3. 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.

  5. Pilih tahap Add API.

    Pekerjaan dimulai untuk mengimpor aset Anda (dalam hal ini, API) ke kumpulan data Anda.

    catatan

    Jika Anda tidak memiliki API di Amazon API Gateway, Anda akan diminta untuk membuatnya.

  6. Setelah pekerjaan selesai, bidang Negara bagian di bagian Pekerjaan diperbarui ke Selesai.

  7. Jika Anda memiliki lebih banyak API untuk ditambahkan, ulangi Langkah 2.

  8. Di bawah ikhtisar Revisi, tinjau revisi Anda dan asetnya.

  9. Pilih Finalisasi.

Anda telah berhasil menyelesaikan revisi untuk kumpulan data.

Anda dapat mengedit revisi atau menghapus revisi sebelum menambahkannya ke produk.

Anda sekarang siap untuk mempublikasikan produk data API baru.

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"
}

  2. 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.

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.

  2. Untuk mengedit revisi, dari ikhtisar Revisi, pilih Tindakan, Edit.

  3. Buat perubahan Anda, lalu pilih Perbarui.

  4. Tinjau perubahan Anda dan kemudian pilih Finalize.

Hapus revisi
Untuk menghapus revisi setelah Anda menyelesaikannya

  1. Pada ikhtisar Revisi, pilih Hapus.

  2. 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 berisi API

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 Detail produk. 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 API. Untuk informasi selengkapnya tentang cara memublikasikan produk baru menggunakan API AWS Marketplace Katalog, lihatMenggunakan AWS Data Exchange dengan API AWS Marketplace Katalog.

Menerbitkan produk baru yang berisi API (konsol)
Untuk memublikasikan produk baru yang berisi API

  1. Dari panel navigasi kiri AWS Data Exchangekonsol, di bawah Publikasikan data, pilih Produk.

  2. Dari Produk, pilih Publikasikan produk baru untuk membuka panduan Publikasikan produk baru.

  3. 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.

    2. Pilih konfigurasi informasi Sensitif produk Anda.

      Untuk informasi selengkapnya, lihat Kategori informasi yang sensitif.

    3. Pilih Berikutnya.

  4. 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.

    2. 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.

    3. 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.

    4. Pilih Berikutnya.

  5. 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 Detail produk.

    2. (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.

      2. 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.

      3. Pilih Pratinjau kamus data untuk melihat pratinjau kamus data.

      4. 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.

      5. Masukkan deskripsi untuk setiap sampel yang akan terlihat di halaman detail produk.

      6. Pilih Simpan.

  6. 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.

  7. Pilih Berikutnya.

  8. 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).

      2. Di bagian Informasi Akun Pelanggan, tambahkan setidaknya satu akun pelanggan yang ingin Anda perpanjang penawarannya.

    2. Pilih opsi Harga dan durasi akses Anda untuk langganan.

    3. 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

      2. Masukkan atau perbarui nama tampilan Biaya, yang terlihat pada faktur pelanggan.

      3. Jika Anda menggunakan biaya terukur yang telah ditentukan sebelumnya, Kunci dibuat secara otomatis, tidak dapat diedit, dan tidak perlu dikirim kembali di header respons.

      4. 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.

        contoh Kunci kustom

        Jika Anda memiliki kunci khusus yang dipanggil VertexCount dan kunci khusus lainnya dipanggilEdgeCount, 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

      5. Masukkan harga yang dikenakan pelanggan per unit di Harga/unit.

      6. (Opsional) Masukkan jumlah unit untuk menampilkan contoh biaya dalam kalkulator biaya terukur.

      7. (Opsional) Masukkan Deskripsi singkat tentang biaya terukur yang muncul di halaman detail produk.

      8. Pilih Tambahkan.

      9. (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.

    4. Hanya untuk penawaran pribadi, pilih tanggal kedaluwarsa Penawaran di mana pelanggan harus menerima penawaran.

    5. Pilih pengaturan Pajak, Perjanjian Langganan Data (DSA), dan kebijakan Pengembalian Dana.

    6. (Opsional) Hanya untuk penawaran umum, atur verifikasi Langganan, yang memungkinkan Anda mengontrol siapa yang dapat berlangganan produk ini. Untuk informasi selengkapnya, lihat Verifikasi berlangganan untuk penyedia.

    7. Pilih opsi perpanjangan otomatis Offer Anda. Untuk informasi selengkapnya, lihat Membuat penawaran untukAWS Data Exchangeproduk.

    8. Pilih Berikutnya.

  9. Di bagian Tinjau & publikasikan, tinjau informasi produk Anda.

    1. Perluas pratinjau halaman Produk untuk melihat bagaimana halaman produk akan terlihat setelah publikasi.

    2. (Opsional) Pilih tombol Edit di bagian mana pun untuk mengedit bagian itu.

  10. 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 Exchangemenyiapkan 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 Exchangekonsol.

  2. Dari panel navigasi kiri, di bawah Publikasikan data, pilih Produk.

  3. Dari Produk, pilih tombol di sebelah produk yang ingin Anda salin.

  4. Pilih dropdown Tindakan, lalu pilih Buat salinan.

  5. 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.

Menerbitkan produk yang berisi kumpulan data Amazon Redshift

Gambaran Umum

Kumpulan data Amazon Redshift berisi AWS Data Exchange datashares untuk Amazon Redshift. Ketika pelanggan berlangganan produk yang berisi datashares, mereka diberikan akses hanya-baca ke tabel, tampilan, skema, dan fungsi yang ditentukan pengguna yang ditambahkan oleh penyedia data ke datashare.

Sebagai penyedia data, Anda membuat datashare AWS Data Exchange untuk Amazon Redshift di klaster Anda. Kemudian, Anda menambahkan ke datashare skema, tabel, tampilan, dan fungsi yang ditentukan pengguna yang ingin diakses oleh pelanggan. Anda kemudian mengimpor datashare keAWS Data Exchange, membuat kumpulan data, menambahkannya ke produk, dan mempublikasikan produk. Pelanggan diberikan akses ke datashare setelah berlangganan.

Setelah menyiapkan data Amazon Redshift di Amazon Redshift, Anda dapat membuat set data Amazon Redshift baru. AWS Data Exchange Anda kemudian dapat membuat revisi, dan menambahkan aset data Amazon Redshift. Ini memungkinkan permintaan ke AWS Data Exchange titik akhir untuk diproxy melalui ke datashare Amazon Redshift Anda. Anda kemudian dapat menambahkan kumpulan data ini ke produk dan menambahkan harga. Kemudian, calon pelanggan dapat melihat produk Anda dan berlangganan di AWS Data Exchange katalog.

Topik berikut menjelaskan proses pembuatan kumpulan data Amazon Redshift dan menerbitkan produk baru dengan kumpulan data Amazon Redshift menggunakan konsol. AWS Data Exchange Prosesnya memiliki langkah-langkah berikut:

Langkah 1: Buat aset datashare Amazon Redshift

Aset adalah data yang masukAWS Data Exchange. Untuk informasi selengkapnya, lihat Aset.

Untuk membuat aset datashare Amazon Redshift

  1. Buat datashare dalam cluster Amazon Redshift Anda.

    Untuk informasi selengkapnya tentang cara membuat datashare, lihat Bekerja dengan AWS Data Exchange datashares sebagai produser di Panduan Pengembang Database Amazon Redshift.

    catatan

    Sebaiknya atur datashare Anda agar dapat diakses publik. Jika tidak, pelanggan dengan cluster yang dapat diakses publik tidak akan dapat mengkonsumsi data Anda.

  2. Langkah 2: Buat kumpulan data Amazon Redshift.

Langkah 2: Buat kumpulan data Amazon Redshift

Kumpulan data Amazon Redshift mencakup AWS Data Exchange datashares untuk Amazon Redshift. Untuk informasi selengkapnya, lihat Kumpulan data Amazon Redshift.

Untuk membuat kumpulan data Amazon Redshift

  1. Buka browser web Anda dan masuk ke AWS Data Exchangekonsol.

  2. Di panel navigasi sisi kiri, di bawah Publikasikan data, pilih Kumpulan data yang dimiliki.

  3. Di Kumpulan data yang dimiliki, pilih Buat kumpulan data untuk membuka panduan langkah pembuatan kumpulan data.

  4. Di Pilih jenis kumpulan data, pilih Amazon Redshift datashare.

  5. Di Tentukan kumpulan data, masukkan Nama dan Deskripsi untuk kumpulan data Anda. Untuk informasi selengkapnya, lihat Praktik terbaik kumpulan data.

  6. Di bawah Tambahkan tag - opsional, tambahkan tag.

  7. Pilih Buat.

Langkah 3: Buat revisi

Dalam prosedur berikut, Anda membuat revisi setelah membuat kumpulan data di AWS Data Exchange konsol. Untuk informasi selengkapnya, lihat Revisi.

Untuk membuat revisi

  1. Pada bagian Ikhtisar kumpulan data pada halaman detail kumpulan data:

    1. (Opsional) Pilih Edit nama untuk mengedit informasi tentang kumpulan data Anda.

    2. (Opsional) Pilih Hapus untuk menghapus kumpulan data.

  2. Pada bagian Revisi, pilih Buat revisi.

  3. Di bawah Tentukan revisi, berikan komentar opsional untuk revisi Anda yang menjelaskan tujuan revisi.

  4. Di bawah Tambahkan tag — opsional, tambahkan tag yang terkait dengan sumber daya.

  5. Pilih Buat.

  6. Tinjau, edit, atau hapus perubahan Anda dari langkah sebelumnya.

Langkah 4: Tambahkan aset datashare Amazon Redshift ke revisi

Dalam prosedur berikut, Anda menambahkan aset Amazon Redshift datashare ke revisi, lalu menyelesaikan revisi di konsol. AWS Data Exchange Untuk informasi selengkapnya, lihat Aset.

Untuk menambahkan aset ke revisi

  1. Di bawah bagian AWS Data Exchangedatashares untuk Amazon Redshift pada halaman detail kumpulan data, pilih Tambahkan datashares.

  2. Di bawah AWS Data Exchangedatashares untuk Amazon Redshift, pilih datashares lalu pilih Add datashare (s).

    catatan

    Anda dapat menambahkan hingga 20 datashares ke revisi.

    Pekerjaan mulai mengimpor aset Anda ke dalam revisi Anda.

  3. Setelah pekerjaan selesai, bidang Negara bagian di bagian Pekerjaan diperbarui ke Selesai.

  4. Jika Anda memiliki lebih banyak data untuk ditambahkan, ulangi Langkah 1.

  5. Di bawah ikhtisar Revisi, tinjau revisi Anda dan asetnya.

  6. Pilih Finalisasi.

Anda telah berhasil menyelesaikan revisi untuk kumpulan data.

Anda dapat mengedit atau menghapus revisi sebelum menambahkannya ke produk.

Langkah 5: Publikasikan produk baru yang berisi kumpulan data Amazon Redshift

Setelah membuat setidaknya satu kumpulan data dan menyelesaikan revisi dengan aset, Anda siap mempublikasikan produk dengan kumpulan data Amazon Redshift. Untuk informasi selengkapnya, lihat Detail produk. Pastikan Anda memiliki semua detail yang diperlukan tentang produk dan penawaran Anda.

Untuk mempublikasikan produk baru yang berisi kumpulan data Amazon Redshift

  1. Dari panel navigasi kiri AWS Data Exchangekonsol, di bawah Publikasikan data, pilih Produk.

  2. Dari Produk, pilih Publikasikan produk baru untuk membuka panduan Publikasikan produk baru.

  3. Di bagian Visibilitas produk, pilih opsi visibilitas Produk dan konfigurasi informasi sensitif produk Anda, lalu pilih Berikutnya. Untuk informasi selengkapnya, silakan lihat Visibilitas produk dan Kategori informasi yang sensitif.

  4. Di bagian Tambahkan data, di bawah Kumpulan data yang dimiliki, pilih kotak centang di samping kumpulan data yang ingin Anda tambahkan, lalu pilih Tambah yang dipilih.

    catatan

    Kumpulan data yang Anda pilih harus memiliki revisi yang diselesaikan. Kumpulan data tanpa revisi akhir tidak akan 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.

    2. Pergi ke Pilih aturan akses revisi, pilih aturan akses revisi yang ingin Anda tetapkan untuk kumpulan data yang disertakan dalam produk ini, lalu pilih Berikutnya.

      Untuk detail selengkapnya, lihat Aturan akses revisi.

  5. Di bagian Tentukan produk, di bawah ikhtisar Produk, masukkan informasi tentang produk Anda, termasuk nama Produk, logo Produk, informasi kontak Dukungan, dan kategori Produk.

    Untuk informasi selengkapnya, lihat Detail produk.

  6. (Opsional) Di bagian Tentukan produk, di bawah Kamus dan sampel data — opsional, pilih kumpulan data dengan memilih tombol opsi di sebelah nama kumpulan data lalu pilih Edit.

    Untuk informasi selengkapnya, silakan lihat Kamus data dan Sampel.

    1. Dalam kotak dialog Edit, di bawah Unggah kamus data, pilih Tambahkan file untuk mengunggah kamus data baru.

      Anda dapat memilih satu kamus data, dalam format.csv, dengan ukuran maksimum 1 MB.

    2. 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.

    3. Pilih Pratinjau kamus data untuk mempratinjau itu.

    4. 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.

    5. Masukkan deskripsi untuk setiap sampel yang akan terlihat di halaman detail produk.

    6. Pilih Simpan.

  7. 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.

  8. Pilih Berikutnya.

  9. Konfigurasikan penawaran Anda.

    • Jika Anda membuat penawaran umum, di bagian Tambahkan penawaran publik, konfigurasikan penawaran Anda. Semua AWS Data Exchange produk dengan visibilitas yang disetel ke Publik memerlukan penawaran umum.

      1. Pilih opsi Harga dan durasi akses Anda untuk langganan.

      2. Pilih pengaturan pajak penjualan AS, perjanjian langganan data (DSA), dan kebijakan pengembalian dana Anda.

      3. (Opsional) Tetapkan verifikasi Langganan, yang memungkinkan Anda mengontrol siapa yang dapat berlangganan produk ini. Untuk informasi selengkapnya, lihat Verifikasi berlangganan untuk penyedia.

      4. Pilih opsi perpanjangan otomatis Offer Anda. Untuk informasi selengkapnya, lihat Membuat penawaran untukAWS Data Exchangeproduk.

      5. Pilih Berikutnya.

    • Jika Anda membuat penawaran pribadi, konfigurasikan detail penawaran di bagian Tambahkan penawaran khusus.

      1. Di bagian Informasi Akun Pelanggan, tambahkan setidaknya satu akun pelanggan yang ingin Anda perpanjang penawarannya.

      2. Pilih opsi Harga dan durasi akses Anda untuk langganan.

      3. Pilih tanggal kedaluwarsa Penawaran di mana pelanggan harus menerima penawaran.

      4. Pilih pengaturan pajak penjualan AS, perjanjian langganan data (DSA), dan kebijakan pengembalian dana Anda.

      5. Pilih opsi perpanjangan otomatis Offer Anda. Untuk informasi selengkapnya, lihat Membuat penawaran untukAWS Data Exchangeproduk.

      6. Pilih Berikutnya.

  10. Di bagian Tinjau & publikasikan, tinjau informasi produk Anda dan kemudian perluas pratinjau halaman Produk untuk melihat tampilannya setelah dipublikasikan.

  11. 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 Exchangemenyiapkan 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 Exchangekonsol.

  2. Dari panel navigasi kiri, di bawah Publikasikan data, pilih Produk.

  3. Dari Produk, pilih tombol di sebelah produk yang ingin Anda salin.

  4. Pilih dropdown Tindakan, lalu pilih Buat salinan.

  5. Lanjutkan melalui Publikasikan alur kerja produk, dengan detail yang sudah diisi, berdasarkan produk yang Anda pilih di Langkah 3. Untuk informasi selengkapnya, lihat Langkah 5: Publikasikan produk baru.

Menerbitkan produk yang berisi akses data Amazon S3

Gambaran Umum

Dengan AWS Data Exchange untuk Amazon S3, penyedia dapat berbagi akses langsung ke bucket Amazon S3 atau awalan tertentu dan objek Amazon S3. Penyedia juga menggunakan AWS Data Exchange untuk secara otomatis mengelola langganan, hak, penagihan, dan pembayaran.

Sebagai penyedia data, Anda dapat berbagi akses langsung ke seluruh bucket Amazon S3 atau awalan tertentu dan objek Amazon S3 tanpa membuat atau mengelola salinan. Objek Amazon S3 bersama ini dapat dienkripsi sisi server dengan kunci terkelola pelanggan yang disimpan di AWS Key Management Service () atau dengan (AWS KMSSSE-S3). Kunci yang dikelola AWS Untuk informasi selengkapnya tentang memantau kunci KMS dan memahami konteks enkripsi, lihat. Manajemen kunci untuk akses data Amazon S3 Saat pelanggan berlangganan produk data Anda, AWS Data Exchange secara otomatis menyediakan jalur akses Amazon S3 dan memperbarui kebijakan sumber dayanya atas nama Anda untuk memberikan akses hanya-baca kepada pelanggan. Pelanggan dapat menggunakan alias jalur akses Amazon S3 di tempat-tempat di mana mereka menggunakan nama bucket Amazon S3 untuk mengakses data di Amazon S3.

Ketika langganan berakhir, izin pelanggan dicabut. Jika Anda memilih untuk mengakhiri perjanjian dengan pelanggan lebih awal, hubungi AWS Support. Anda dapat menambahkan ketentuan langganan dalam Perjanjian Langganan Data (DSA).

Sebelum Anda dapat mempublikasikan produk yang berisi akses data Amazon S3, Anda harus memenuhi prasyarat berikut:

Prasyarat

  • Konfirmasikan bahwa bucket Amazon S3 yang menghosting data dikonfigurasi dengan pengaturan yang diberlakukan pemilik bucket Amazon S3 yang diaktifkan ACL Dinonaktifkan. Untuk informasi selengkapnya, lihat Mengontrol kepemilikan objek dan menonaktifkan ACL untuk bucket Anda di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

  • Objek bersama Anda harus berada di kelas Penyimpanan Standar Amazon S3, atau dikelola menggunakan S3 Intelligent Tiering, agar pelanggan berhasil mengaksesnya. Jika mereka berada di kelas penyimpanan lain, atau jika Anda telah mengaktifkan Intelligent Tiering dengan Deep Archive, pelanggan Anda akan menerima kesalahan karena mereka tidak akan memiliki izin untuk RestoreObject melakukannya.

  • Konfirmasikan bahwa bucket Amazon S3 yang menampung data telah menonaktifkan enkripsi atau dienkripsi dengan kunci terkelola Amazon S3 (SSE-S3) atau kunci terkelola pelanggan yang disimpan di (AWS KMS). AWS Key Management Service

  • Jika Anda menggunakan kunci yang dikelola pelanggan, Anda harus memiliki yang berikut:

    1. Izin IAM untuk kms:CreateGrant pada kunci KMS. Anda dapat mengakses izin ini melalui kebijakan utama, kredensi IAM, atau melalui AWS KMS hibah pada kunci KMS. Untuk informasi selengkapnya tentang manajemen kunci dan memahami cara AWS Data Exchange menggunakan hibah AWS KMS, lihat. Membuat AWS KMS hibah

      Untuk memberikan akses, tambahkan izin ke pengguna, grup, atau peran Anda:

      Pengguna membutuhkan akses terprogram jika mereka ingin berinteraksi dengan AWS di luar AWS Management Console. Cara memberikan akses terprogram bergantung pada jenis pengguna yang mengakses AWS.

      Untuk memberi pengguna akses terprogram, pilih salah satu opsi berikut.

      Pengguna mana yang membutuhkan akses terprogram? Ke Oleh

      Identitas tenaga kerja

      (Pengguna yang dikelola di Pusat Identitas IAM)

      		 Gunakan kredensial sementara untuk menandatangani permintaan terprogram ke AWS CLI, SDK AWS, atau API AWS.

      Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan.
      IAM Gunakan kredensial sementara untuk menandatangani permintaan terprogram ke AWS CLI, SDK AWS, atau API AWS. Ikuti petunjuk dalam Menggunakan kredensial sementara dengan sumber daya AWS di Panduan Pengguna IAM.
      IAM

      (Tidak disarankan)

      Gunakan kredensial jangka panjang untuk menandatangani permintaan terprogram ke AWS CLI, AWS SDK, atau API AWS.

      Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan.

      Berikut ini adalah contoh kebijakan JSON yang menunjukkan bagaimana Anda dapat menambahkan ke kebijakan kunci kunci KMS.

      
{
      "Sid": "AllowCreateGrantPermission",
      "Effect": "Allow",
      "Principal": {
"AWS": "<IAM identity who will call Dataexchange API>"             
      },
      "Action": "kms:CreateGrant",
      "Resource": "*"
}

      Kebijakan berikut menunjukkan contoh penambahan kebijakan untuk identitas IAM yang digunakan.

      
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Sid": "AllowCreateGrantPermission",
            "Action": [
                 "kms:CreateGrant
            ],
            "Resource": [
              <Enter KMS Key ARNs in your account>                
            ]
        }
    ]
}
      catatan

      Kunci KMS lintas akun juga diizinkan jika kms:CreateGrant izin pada kunci KMS diperoleh melalui langkah sebelumnya. Jika akun lain memiliki kunci, Anda harus memiliki izin pada kebijakan kunci dan kredenal IAM Anda seperti yang dijelaskan dalam contoh di atas.

    2. Pastikan Anda menggunakan kunci KMS untuk mengenkripsi objek yang ada dan yang baru di bucket Amazon S3 menggunakan fitur kunci bucket Amazon S3. Untuk detail selengkapnya, lihat Mengonfigurasi Kunci Bucket S3 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

      • Untuk objek baru yang ditambahkan ke bucket Amazon S3, Anda dapat mengatur enkripsi kunci bucket Amazon S3 secara default. Jika objek yang ada telah dienkripsi tanpa menggunakan fitur kunci Amazon S3Bucket, objek ini harus dimigrasikan untuk menggunakan kunci bucket Amazon S3 untuk enkripsi.

        Untuk mengaktifkan kunci bucket Amazon S3 untuk objek yang ada, gunakan operasi. copy Untuk informasi selengkapnya, lihat Mengonfigurasi kunci bucket Amazon S3 di tingkat objek menggunakan operasi batch.

      • AWSkunci KMS terkelola atau Kunci milik AWS tidak didukung. Anda dapat bermigrasi dari skema enkripsi yang tidak didukung ke skema yang saat ini didukung. Untuk informasi selengkapnya, lihat Mengubah enkripsi Amazon S3 Anda di Blog AWS Penyimpanan.

    3. Setel bucket Amazon S3 yang menghosting data untuk mempercayai titik akses yang AWS Data Exchange dimiliki. Anda harus memperbarui kebijakan bucket Amazon S3 ini untuk memberikan AWS Data Exchange izin untuk membuat jalur akses Amazon S3 dan memberikan atau menghapus akses pelanggan atas nama Anda. Jika pernyataan kebijakan tidak ada, Anda harus mengedit kebijakan bucket untuk menambahkan lokasi Amazon S3 ke kumpulan data Anda.

      Contoh kebijakan ditunjukkan di bawah ini. Ganti <Bucket ARN> dengan nilai yang sesuai.

      {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "*"
            },
            "Action": [
                "s3:GetObject",
                "s3:ListBucket"
            ],
            "Resource": [
                "<Bucket ARN>",
                "<Bucket ARN>/*"
            ],
            "Condition": {
                "StringEquals": {
                    "s3:DataAccessPointAccount": [
                        "337040091392",
                        "504002150500",
                        "366362662752",
                        "330489627928",
                        "291973504423",
                        "461002523379",
                        "036905324694",
                        "540564263739",
                        "675969394711",
                        "108584782536",
                        "844053218156"
                    ]
                }
            }
        }
    ]
}

Anda dapat mendelegasikan berbagi data AWS Data Exchange ke seluruh bucket Amazon S3. Namun, Anda dapat membuat cakupan delegasi ke awalan dan objek tertentu dari bucket yang ingin Anda bagikan dalam kumpulan data. Berikut ini adalah contoh kebijakan cakupan. Ganti <Bucket ARN> dan "mybucket/folder1/*" dengan informasi Anda sendiri.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "DelegateToAdxGetObjectsInFolder1",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": [
        "s3:GetObject"
      ],
      "Resource": [
        "arn:aws:s3:::mybucket/folder1/*"
      ],
      "Condition": {
        "StringEquals": {
          "s3:DataAccessPointAccount": [
            "337040091392",
            "504002150500",
            "366362662752",
            "330489627928",
            "291973504423",
            "461002523379",
            "036905324694",
            "540564263739",
            "675969394711",
            "108584782536",
            "844053218156"
          ]
        }
      }
    },
    {
      "Sid": "DelegateToAdxListObjectsInFolder1",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": "s3:ListBucket",
      "Resource": "arn:aws:s3:::mybucket",
      "Condition": {
        "StringLike": {
          "s3:prefix": [
            "folder1/*"
          ]
        },
        "StringEquals": {
          "s3:DataAccessPointAccount": [
            "337040091392",
            "504002150500",
            "366362662752",
            "330489627928",
            "291973504423",
            "461002523379",
            "036905324694",
            "540564263739",
            "675969394711",
            "108584782536",
            "844053218156"
          ]
        }
      }
    }
  ]
}

Demikian pula, untuk cakupan akses hanya ke satu file, penyedia dapat menggunakan kebijakan berikut.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "DelegateToAdxGetMyFile",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": [
        "s3:GetObject"
      ],
      "Resource": [
        "arn:aws:s3:::mybucket/folder1/myfile"
      ],
      "Condition": {
        "StringEquals": {
          "s3:DataAccessPointAccount": [
            "337040091392",
            "504002150500",
            "366362662752",
            "330489627928",
            "291973504423",
            "461002523379",
            "036905324694",
            "540564263739",
            "675969394711",
            "108584782536",
            "844053218156"
          ]
        }
      }
    }
  ]
}

Topik berikut menjelaskan proses pembuatan kumpulan data Amazon S3 dan menerbitkan produk baru dengan kumpulan data Amazon S3 menggunakan konsol. AWS Data Exchange Prosesnya memiliki langkah-langkah berikut:

Langkah 1: Buat kumpulan data Amazon S3

Untuk membuat kumpulan data Amazon S3

  1. Di panel navigasi sisi kiri, di bawah Publikasikan data, pilih Kumpulan data yang dimiliki.

  2. Di panel navigasi sisi kiri, di bawah Publikasikan data, pilih Kumpulan data yang dimiliki.

  3. Di Kumpulan data yang dimiliki, pilih Buat kumpulan data untuk membuka panduan langkah pembuatan kumpulan data.

  4. Di Pilih jenis kumpulan data, pilih akses data Amazon S3.

  5. Di Tentukan kumpulan data, masukkan Nama dan Deskripsi untuk kumpulan data Anda. Untuk informasi selengkapnya, lihat Praktik terbaik kumpulan data.

  6. (Opsional) Di bawah Tambahkan tag - opsional, tambahkan tag.

  7. Pilih Buat kumpulan data dan lanjutkan.

Langkah 2: Konfigurasikan akses data Amazon S3

Pilih bucket Amazon S3 atau lokasi bucket Amazon S3 yang ingin Anda sediakan untuk pelanggan. Anda dapat memilih seluruh bucket Amazon S3, atau menentukan hingga lima awalan atau objek dalam bucket Amazon S3. Untuk menambahkan lebih banyak bucket Amazon S3, Anda harus membuat berbagi data Amazon S3 lainnya.

Untuk mengonfigurasi akses data Amazon S3 bersama

  1. Pada halaman Konfigurasikan akses data Amazon S3, pilih Pilih lokasi Amazon S3.

  2. Di Pilih lokasi Amazon S3, masukkan nama bucket Amazon S3 Anda di bilah pencarian atau pilih bucket Amazon S3, awalan, atau file Amazon S3 Anda dan pilih Tambahkan yang dipilih. Kemudian, pilih Tambahkan lokasi.

    catatan

    Sebaiknya pilih folder tingkat atas tempat sebagian besar objek dan awalan disimpan sehingga penyedia tidak perlu mengkonfigurasi ulang awalan atau objek mana yang akan dibagikan.

  3. Dalam detail Konfigurasi, pilih konfigurasi Requester Pays Anda. Ada dua opsi:

    • Aktifkan Pembayaran Pemohon (disarankan) — Pemohon akan membayar semua permintaan dan transfer di bucket Amazon S3. Kami merekomendasikan opsi ini karena membantu melindungi terhadap biaya yang tidak diinginkan dari permintaan dan transfer pelanggan.

    • Nonaktifkan Pembayaran Pemohon — Anda membayar permintaan dan transfer pelanggan di bucket Amazon S3.

      Untuk informasi selengkapnya tentang Pembayaran Pemohon, lihat Objek di Bucket Pembayaran Peminta di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

  4. Pilih Kebijakan Bucket yang paling sesuai dengan kebutuhan Anda. Pilih Umum untuk menggunakan satu kebijakan bucket untuk seluruh bucket Amazon S3 Anda. Ini adalah konfigurasi satu kali dan konfigurasi tambahan tidak diperlukan untuk berbagi awalan atau objek di masa mendatang. Pilih Spesifik untuk menggunakan kebijakan bucket yang khusus untuk lokasi Amazon S3 yang dipilih. Bucket Amazon S3 bersama Anda memerlukan kebijakan bucket untuk membuat kumpulan data akses data Amazon S3 dengan sukses dan ACL tidak dapat diaktifkan.

    1. Untuk menonaktifkan ACL, navigasikan ke izin bucket Anda dan setel Object Ownership ke Bucket owner yang diberlakukan.

    2. Untuk menambahkan kebijakan bucket, salin pernyataan bucket ke clipboard Anda. Di konsol Amazon S3, dari tab izin Amazon S3, pilih Edit di bagian kebijakan bucket, tempelkan kebijakan bucket ke dalam pernyataan, dan Simpan perubahan.

  5. Jika bucket Amazon S3 berisi objek yang dienkripsi menggunakan kunci yang dikelola AWS KMS pelanggan, Anda harus membagikan semua kunci KMS tersebut. AWS Data Exchange Untuk informasi tentang prasyarat yang diperlukan saat menggunakan kunci KMS untuk mengenkripsi objek di bucket Amazon S3, lihat. Menerbitkan produk yang berisi akses data Amazon S3 Untuk berbagi kunci KMS iniAWS Data Exchange, lakukan hal berikut:

    1. Dari halaman akses data Configure Amazon S3, di kunci KMS yang dikelola Pelanggan, pilih Pilih dari Anda AWS KMS keys atau Masukkan AWS KMS key ARN dan pilih AWS KMS keyssemua yang sedang digunakan untuk mengenkripsi lokasi bersama Amazon S3. AWS Data Exchangemenggunakan kunci KMS ini untuk membuat hibah bagi pelanggan untuk mengakses lokasi bersama Anda. Untuk informasi lebih lanjut, lihat Hibah di AWS KMS.

    catatan

    AWS KMSmemiliki batas 50.000 hibah per kunci KMS termasuk hibah yang sudah ada sebelumnya.

  6. Tinjau lokasi Amazon S3, kunci KMS yang dipilih, dan detail konfigurasi, lalu pilih Simpan dan lanjutkan.

Langkah 3: Tinjau dan selesaikan kumpulan data

Tinjau dan selesaikan kumpulan data yang baru Anda buat. Jika Anda ingin membuat dan menambahkan akses data Amazon S3 lain untuk berbagi akses ke bucket, awalan, objek Amazon S3 tambahan, pilih Tambahkan akses data Amazon S3 lainnya.

catatan

Kami merekomendasikan hal ini saat perlu berbagi akses ke data yang dihosting di bucket Amazon S3 yang berbeda dari yang sebelumnya dipilih di akses data Amazon S3 awal.

Jika Anda ingin membuat perubahan sebelum penerbitan, Anda dapat menyimpan kumpulan data sebagai draf dengan memilih Simpan draf. Kemudian, pilih Selesaikan kumpulan data untuk menambahkannya ke produk Anda.

Langkah 4: Tambahkan kumpulan data Amazon S3 ke produk AWS Data Exchange

Dalam prosedur berikut, Anda menambahkan kumpulan data Anda ke AWS Data Exchange produk baru atau yang sudah ada.

Untuk menambahkan kumpulan data ke produk AWS Data Exchange baru atau yang sudah ada

  1. Pada halaman Kumpulan data yang dimiliki, di bawah Ringkasan kumpulan data, Anda dapat Mengedit nama, Menghapus, atau Membuat produk dari kumpulan data.

  2. Lengkapi pembuatan produk yang menentukan deskripsi produk, kasus penggunaan, metadata, harga, serta syarat dan ketentuan.

  3. Tinjau dan publikasikan produk setelah selesai.

    catatan

    Saat pelanggan berlangganan produk Anda, pelanggan menerima izin akses untuk membaca dan menggunakan data Anda menggunakan jalur akses Amazon S3 yang dibuat atas nama Anda.

Langkah 5: Publikasikan produk baru yang berisi akses ke Amazon S3

Setelah Anda membuat setidaknya satu set data dan menyelesaikan revisi dengan aset, Anda dapat mempublikasikan produk dengan akses data Amazon S3. Untuk informasi selengkapnya, lihat Detail produk. Pastikan Anda memiliki semua detail yang diperlukan tentang produk dan penawaran Anda.

catatan

Anda tidak perlu membuat revisi baru saat memperbarui objek Amazon S3 bersama kecuali lokasi Amazon S3 telah diubah dan objek ini tidak dapat diakses oleh pelanggan.

Untuk mempublikasikan produk baru yang berisi akses ke Amazon S3

  1. Dari panel navigasi kiri AWS Data Exchangekonsol, di bawah Publikasikan data, pilih Produk.

  2. Dari Produk, pilih Publikasikan produk baru untuk membuka panduan Publikasikan produk baru.

  3. Di bagian Visibilitas produk, pilih opsi visibilitas Produk dan konfigurasi informasi sensitif produk Anda, lalu pilih Berikutnya. Untuk informasi selengkapnya, silakan lihat Visibilitas produk dan Kategori informasi yang sensitif.

  4. Di bagian Tambahkan data, di bawah Kumpulan data yang dimiliki, pilih kotak centang di samping kumpulan data yang ingin Anda tambahkan, lalu pilih Tambah yang 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.

    2. Pergi ke Pilih aturan akses revisi, pilih aturan akses revisi yang ingin Anda tetapkan untuk kumpulan data yang disertakan dalam produk ini, lalu pilih Berikutnya.

      Untuk detail selengkapnya, lihat Aturan akses revisi.

  5. Di bagian Tentukan produk, di bawah ikhtisar Produk, masukkan informasi tentang produk Anda, termasuk nama Produk, logo Produk, informasi kontak Dukungan, dan kategori Produk.

    Untuk informasi selengkapnya, lihat Detail produk.

  6. (Opsional) Di bagian Tentukan produk, di bawah Kamus dan sampel data — opsional, pilih kumpulan data dengan memilih tombol opsi di sebelah nama kumpulan data lalu pilih Edit.

    Untuk informasi selengkapnya, silakan lihat Kamus data dan Sampel.

    1. Dalam kotak dialog Edit, di bawah Unggah kamus data, pilih Tambahkan file untuk mengunggah kamus data baru.

      Anda dapat memilih satu kamus data, dalam format.csv, dengan ukuran maksimum 1 MB.

    2. 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.

    3. Pilih Pratinjau kamus data untuk melihat pratinjau kamus data.

    4. 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.

    5. Masukkan deskripsi untuk setiap sampel yang akan terlihat di halaman detail produk.

    6. Pilih Simpan.

  7. 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 berikan detail produk spesifik Anda di templat.

  8. Pilih Berikutnya.

  9. Konfigurasikan penawaran Anda.

    • Jika Anda membuat penawaran umum, di bagian Tambahkan penawaran publik, konfigurasikan penawaran Anda. Semua AWS Data Exchange produk dengan visibilitas yang disetel ke Publik memerlukan penawaran umum.

      1. Pilih opsi Harga dan durasi akses Anda untuk langganan.

      2. Pilih pengaturan pajak penjualan AS, perjanjian langganan data (DSA), dan kebijakan pengembalian dana Anda.

      3. (Opsional) Tetapkan verifikasi Langganan untuk mengontrol siapa yang dapat berlangganan produk ini. Untuk informasi selengkapnya, lihat Verifikasi berlangganan untuk penyedia.

      4. Pilih opsi perpanjangan otomatis Offer Anda. Untuk informasi selengkapnya, lihat Membuat penawaran untukAWS Data Exchangeproduk.

      5. Pilih Berikutnya.

    • Jika Anda membuat penawaran pribadi, konfigurasikan detail penawaran di bagian Tambahkan penawaran khusus.

      1. Di bagian Informasi Akun Pelanggan, tambahkan setidaknya satu akun pelanggan yang ingin Anda perpanjang penawarannya.

      2. Pilih opsi Harga dan durasi akses Anda untuk langganan.

      3. Pilih tanggal kedaluwarsa Penawaran di mana pelanggan harus menerima penawaran.

      4. Pilih pengaturan pajak penjualan AS, perjanjian langganan data (DSA), dan kebijakan pengembalian dana Anda.

      5. Pilih opsi perpanjangan otomatis Offer Anda. Untuk informasi selengkapnya, lihat Membuat penawaran untukAWS Data Exchangeproduk.

      6. Pilih Berikutnya.

  10. Di bagian Tinjau & publikasikan, tinjau informasi produk Anda dan kemudian perluas pratinjau halaman Produk untuk melihat tampilannya setelah dipublikasikan.

  11. 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 Exchangemenyiapkan dan menerbitkan produk Anda. Pada halaman ikhtisar Produk, status produk Anda adalah Menunggu persetujuan. Status berubah menjadi Diterbitkan setelah produk 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 dapat disalin, tetapi penawaran publik dapat disalin.

Untuk menyalin produk

  1. Buka browser web Anda dan masuk ke AWS Data Exchangekonsol.

  2. Dari panel navigasi kiri, di bawah Publikasikan data, pilih Produk.

  3. Dari Produk, pilih opsi di sebelah produk yang ingin Anda salin.

  4. Pilih daftar dropdown Tindakan, lalu pilih Buat salinan.

  5. Lanjutkan melalui Publikasikan alur kerja produk, dengan detail yang sudah diisi, berdasarkan produk yang Anda pilih di Langkah 3. Untuk informasi selengkapnya, lihat Langkah 5: Publikasikan produk baru.

Menerbitkan produk yang berisi kumpulan AWS Lake Formation data izin data (Pratinjau)

Gambaran Umum

Jika Anda tertarik untuk menerbitkan produk yang berisi kumpulan AWS Lake Formation data izin data selama Pratinjau ini, hubungi AWS Support.

Kumpulan AWS Lake Formation data izin data berisi sekumpulan LF-tag dan izin untuk data yang dikelola oleh. AWS Lake Formation Saat pelanggan berlangganan produk yang berisi izin data Lake Formation, mereka diberikan akses hanya-baca ke database, tabel, dan kolom yang terkait dengan LF-tag yang ditambahkan ke kumpulan data.

Sebagai penyedia data, Anda mulai dengan membuat LF-tag AWS Lake Formation dan mengaitkan tag tersebut dengan data yang ingin Anda sediakan untuk pelanggan. Untuk informasi selengkapnya tentang menandai sumber daya Anda di Lake Formation, lihat kontrol akses berbasis Tag Lake Formation di Panduan AWS Lake FormationPengembang. Kemudian Anda mengimpor LF-tag dan satu set izin data ke dalam AWS Data Exchange sebagai aset. Pelanggan diberikan akses ke data yang terkait dengan LF-tag tersebut saat berlangganan.

Topik berikut menjelaskan proses penerbitan produk yang berisi izin AWS Lake Formation data. Prosesnya memiliki langkah-langkah berikut:

Langkah 1: Buat kumpulan AWS Lake Formation data (Pratinjau)

Untuk membuat kumpulan AWS Lake Formation data

  1. Buka browser web Anda dan masuk ke AWS Data Exchangekonsol.

  2. Dari panel navigasi kiri, di bawah Publikasikan data, pilih Produk.

  3. Di Kumpulan data yang dimiliki, pilih Buat kumpulan data untuk membuka panduan langkah pembuatan kumpulan data.

  4. Di Pilih jenis kumpulan data, pilih izin AWS Lake Formation data.

  5. Di set data Define, masukkan Nama dan Deskripsi untuk kumpulan data Anda. Untuk informasi selengkapnya, lihat Praktik terbaik kumpulan data.

  6. Di bawah Tambahkan tag — opsional, pilih Tambahkan tag baru.

  7. Pilih Buat kumpulan data dan lanjutkan.

Langkah 2: Buat izin AWS Lake Formation data (Pratinjau)

AWS Data Exchangemenggunakan LF-tag untuk memberikan izin data. Pilih LF-tag yang terkait dengan data yang ingin Anda bagikan untuk memberikan izin pelanggan ke data.

Untuk membuat izin AWS Lake Formation data

  1. Pada halaman izin data Create Lake Formation, pilih Add LF-tag.

  2. Masukkan Kunci dan pilih Nilai LF-Tag Anda.

  3. Pilih Pratinjau sumber daya untuk melihat bagaimana tag LF Anda diinterpretasikan.

    1. Dari sumber daya Pratinjau, pilih sumber daya katalog data terkait Anda.

      catatan

      Pastikan untuk mencabut IAMAllowedPrincipals grup pada sumber daya berikut. Untuk informasi selengkapnya, lihat Mencabut kredensil keamanan sementara peran IAM di Panduan Pengguna IAM.

  4. Tinjau interpretasi ekspresi LF-tag di kotak dialog di bawah ini dan Izin yang terkait dengan kumpulan data.

  5. Untuk akses Layanan, pilih peran layanan yang ada yang memungkinkan AWS Data Exchange untuk mengambil peran dan mengakses, memberikan, dan mencabut hak atas izin data Lake Formation atas nama Anda. Kemudian pilih Buat izin data Lake Formation. Untuk informasi selengkapnya tentang membuat peran untuk peranLayanan AWS, lihat Membuat peran untuk mendelegasikan izin ke peran. Layanan AWS

  6. Di bagian Tentukan produk, di bawah ikhtisar Produk, masukkan informasi tentang produk Anda, termasuk nama Produk, logo Produk, informasi kontak Dukungan, dan kategori Produk.

    Untuk informasi selengkapnya, lihat Detail produk.

  7. (Opsional) Di bagian Tentukan produk, di bawah Kamus dan sampel data — opsional, pilih kumpulan data dengan memilih tombol opsi di sebelah nama kumpulan data lalu pilih Edit.

    Untuk informasi selengkapnya, silakan lihat Kamus data dan Sampel.

    1. Dalam kotak dialog Edit, di bawah Unggah kamus data, pilih Tambahkan file untuk mengunggah kamus data baru.

      Anda dapat memilih satu kamus data, dalam format.csv, dengan ukuran maksimum 1 MB.

    2. 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.

    3. Pilih Pratinjau kamus data untuk melihat pratinjau kamus data.

    4. 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.

    5. Masukkan deskripsi untuk setiap sampel yang akan terlihat di halaman detail produk.

    6. Pilih Simpan.

  8. 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 berikan detail produk spesifik Anda di templat.

  9. Pilih Berikutnya.

  10. Konfigurasikan penawaran Anda.

    • Jika Anda membuat penawaran umum, di bagian Tambahkan penawaran publik, konfigurasikan penawaran Anda. Semua AWS Data Exchange produk dengan visibilitas yang disetel ke Publik memerlukan penawaran umum.

      1. Pilih opsi Harga dan durasi akses Anda untuk langganan.

      2. Pilih pengaturan pajak penjualan AS, perjanjian langganan data (DSA), dan kebijakan pengembalian dana Anda.

      3. (Opsional) Tetapkan verifikasi Langganan untuk mengontrol siapa yang dapat berlangganan produk ini. Untuk informasi selengkapnya, lihat Verifikasi berlangganan untuk penyedia.

      4. Pilih opsi perpanjangan otomatis Offer Anda. Untuk informasi selengkapnya, lihat Membuat penawaran untukAWS Data Exchangeproduk.

      5. Pilih Berikutnya.

    • Jika Anda membuat penawaran pribadi, konfigurasikan detail penawaran di bagian Tambahkan penawaran khusus.

      1. Di bagian Informasi Akun Pelanggan, tambahkan setidaknya satu akun pelanggan yang ingin Anda perpanjang penawarannya.

      2. Pilih opsi Harga dan durasi akses Anda untuk langganan.

      3. Pilih tanggal kedaluwarsa Penawaran di mana pelanggan harus menerima penawaran.

      4. Pilih pengaturan pajak penjualan AS, perjanjian langganan data (DSA), dan kebijakan pengembalian dana Anda.

      5. Pilih opsi perpanjangan otomatis Offer Anda. Untuk informasi selengkapnya, lihat Membuat penawaran untukAWS Data Exchangeproduk.

      6. Pilih Berikutnya.

  11. Di bagian Tinjau & publikasikan, tinjau informasi produk Anda dan kemudian perluas pratinjau halaman Produk untuk melihat tampilannya setelah dipublikasikan.

  12. 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 Exchangemenyiapkan dan menerbitkan produk Anda. Pada halaman ikhtisar Produk, status produk Anda adalah Menunggu persetujuan. Status berubah menjadi Diterbitkan setelah produk dipublikasikan.

Langkah 3: Tinjau dan selesaikan

Setelah membuat izin AWS Lake Formation data (Pratinjau), Anda dapat Meninjau dan menyelesaikan kumpulan data Anda.

Untuk meninjau dan menyelesaikan

  1. Tinjau detail dan Tag kumpulan Data Anda di Langkah 1 untuk akurasi.

  2. Tinjau ekspresi LF-tag Anda, Tambahkan izin data Lake Formation lainnya (opsional), Sumber daya katalog data terkait, dan detail pekerjaan.

    catatan

    Job dihapus 90 hari setelah dibuat.

  3. Pilih Finalisasi.

Langkah 5: (Opsional) Buat revisi

Untuk membuat revisi

  1. Dari bagian Kumpulan data yang dimiliki, pilih kumpulan data yang ingin Anda tambahkan revisi.

  2. Pilih tab Revisi.

  3. Di bagian Revisi, pilih Buat revisi.

  4. Pada halaman izin data Revise Lake Formation, pilih Add LF-tag.

  5. Tinjau Izin untuk Database dan Tabel.

  6. Dari akses Layanan, pilih peran layanan yang ada, lalu pilih izin data Create Lake Formation.

Langkah 6: Publikasikan produk baru yang berisi kumpulan AWS Lake Formation data (Pratinjau)

Setelah Anda membuat setidaknya satu set data dan menyelesaikan revisi dengan aset, Anda siap untuk mempublikasikan produk dengan AWS Lake Formation kumpulan data. Untuk informasi selengkapnya, lihat Detail produk. Pastikan Anda memiliki semua detail yang diperlukan tentang produk Anda.

Untuk mempublikasikan produk baru yang berisi kumpulan AWS Lake Formation data (Pratinjau)

  1. Buka browser web Anda dan masuk ke AWS Data Exchangekonsol.

  2. Dari panel navigasi kiri, di bawah Publikasikan data, pilih Produk.

  3. Dari Produk, pilih Publikasikan produk baru untuk membuka panduan Publikasikan produk baru.

  4. Di bagian Visibilitas produk, pilih opsi visibilitas Produk dan Konfigurasi informasi sensitif produk Anda, lalu pilih Berikutnya. Untuk informasi selengkapnya, silakan lihat Visibilitas produk dan Kategori informasi yang sensitif.

  5. Di bagian Tambahkan data, di bawah Kumpulan data yang dimiliki, pilih kotak centang di samping kumpulan data yang ingin Anda tambahkan, lalu pilih Tambah yang 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.

    2. Pergi ke Pilih aturan akses revisi, pilih aturan akses revisi yang ingin Anda tetapkan untuk kumpulan data yang disertakan dalam produk ini, lalu pilih Berikutnya.

      Untuk detail selengkapnya, lihat Aturan akses revisi.

Pertimbangan saat menerbitkan kumpulan AWS Lake Formation data izin data (Pratinjau)

Untuk memastikan pengalaman pelanggan yang optimal, kami sangat menyarankan untuk tidak melakukan modifikasi berikut pada izin apa pun yang berisi produk Anda AWS Data Exchange untuk kumpulan data Lake Formation (Pratinjau) dengan pelanggan aktif untuk produk tersebut.

  • Sebaiknya jangan menghapus atau memodifikasi peran IAM yang diteruskan ke produk yang dipublikasikan AWS Data Exchange yang berisi AWS Lake Formation kumpulan data. Jika Anda menghapus atau memodifikasi peran IAM tersebut, masalah berikut akan terjadi:

    • Akun AWSyang memiliki akses ke izin data Lake Formation mungkin mempertahankan akses tanpa batas waktu.

    • Akun AWSyang berlangganan produk Anda tetapi belum menerima akses ke izin data Lake Formation akan gagal menerima akses.

    AWS Data Exchangetidak akan bertanggung jawab atas peran IAM apa pun yang Anda hapus atau modifikasi.

  • Kami menyarankan agar Anda tidak mencabut izin AWS Lake Formation data yang diberikan dari peran IAM yang diteruskan ke produk yang dipublikasikan yang AWS Data Exchange berisi kumpulan data. AWS Lake Formation Jika Anda mencabut izin data yang diberikan dari peran IAM tersebut, masalah berikut akan terjadi:

    • Akun AWSyang memiliki akses ke izin data Lake Formation mungkin mempertahankan akses tanpa batas waktu.

    • Akun AWSyang berlangganan produk Anda tetapi belum menerima akses ke izin data Lake Formation akan gagal menerima akses.

  • Kami menyarankan untuk tidak mencabut izin AWS Lake Formation data yang diberikan dari langganan aktif ke produk Akun AWS yang dipublikasikan yang berisi kumpulan data. AWS Lake Formation Jika Anda mencabut izin data yang diberikan dari Akun AWS berlangganan produk Anda, akun tersebut akan kehilangan akses, menciptakan pengalaman pelanggan yang buruk.

  • Sebaiknya atur versi lintas akun di versi 3 Anda AWS Glue Data Catalog saat menerbitkan produk yang berisi kumpulan AWS Lake Formation data. Jika Anda menurunkan versi lintas akun Katalog Data Lake Anda saat menerbitkan produk yang berisi kumpulan AWS Lake Formation data, Akun AWS yang berlangganan produk Anda tetapi belum menerima akses ke izin data Lake Formation mungkin gagal mendapatkan akses ke data.