Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bagikan produk portal di API Gateway
Anda dapat berbagi produk portal di seluruh Akun AWS penggunaan AWS RAM. Ketika Anda berbagi produk portal, akun lain dapat menggunakan produk portal Anda di portal mereka sendiri. Dengan produk portal bersama, Anda dapat membuat satu katalog organisasi APIs dan menerapkan standar tata kelola di seluruh ekosistem API Anda. Pada saat yang sama, berbagi produk portal memberikan fleksibilitas bagi penyedia API untuk mengembangkan, menguji, dan memelihara APIs di akun mereka sendiri.
## Pertimbangan-pertimbangan
Pertimbangan berikut dapat memengaruhi cara Anda berbagi sumber daya portal:
+ Saat Anda membagikan produk Anda dengan akun lain, akun tersebut tidak dapat mengubah properti REST API Anda. Ini termasuk titik akhir integrasi, strategi otorisasi, atau konfigurasi tahap.
+ Ketika Anda menambahkan produk portal akun lain ke portal Anda, pemilik produk portal tidak dapat melihat atau mengontrol properti lain dari portal Anda. Pemilik produk portal hanya tahu bahwa produk tersebut digunakan di portal Anda.
+ Produk portal API Gateway dibagikan di Wilayah AWS level tersebut.
+ Anda dapat menggunakan satu pembagian sumber daya dengan beberapa prinsipal, dan setelah Anda membuat pembagian sumber daya, Anda dapat menambahkan lebih banyak prinsipal ke dalamnya. Kami menyarankan bahwa jika memungkinkan, Anda menggunakan kembali bagian sumber daya Anda.
+ Jika kedua akun berada di organisasi yang sama menggunakan AWS Organizations, pembagian sumber daya secara otomatis diterima. Anda masih perlu membuat pembagian sumber daya menggunakan AWS RAM.
+ Jika kedua akun berada dalam organisasi yang sama menggunakan AWS Organizations dan berbagi sumber daya dalam organisasi Anda diaktifkan, setiap prinsipal di organisasi yang Anda bagikan secara otomatis diberikan akses ke pembagian sumber daya. Tidak perlu undangan dan Anda dapat melewati pembagian sumber daya.
+ Jika akun yang Anda bagikan produk tidak menerima pembagian sumber daya dalam waktu **12 jam**, Anda harus membagikan sumber daya lagi.
+ Setelah Anda membuat pembagian sumber daya, AWS RAM perbarui kebijakan berbagi produk produk Anda untuk mencegah akses ke prinsipal tanpa akses eksplisit. `allow` Untuk informasi selengkapnya, lihat [Menentukan apakah permintaan diizinkan atau ditolak dalam akun](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_evaluation-logic.html#policy-eval-denyallow) di Panduan Pengguna IAM.
Kebijakan sumber daya yang diperbarui akan terlihat seperti berikut:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"apigateway:GetProduct",
"apigateway:ListEndpoints",
"apigateway:ListPages",
"apigateway:GetEndpoint",
"apigateway:GetPage"
],
"Resource": [
"arn:aws:apigateway:us-east-1:111122223333:/portalproducts/product-id",
"arn:aws:apigateway:us-east-1:111122223333:/portalproducts/product-id/*"
]
}
]
}
```
AWS RAM telah mencegah prinsipal tanpa mengizinkan akses eksplisit untuk menambahkan produk Anda ke portal mereka, dengan menambahkan yang berikut:
```
"StringNotEquals": { "aws:PrincipalAccount": "555555555555" }
```
Untuk mempelajari cara berbagi produk, lihat[Bagikan produk portal Anda dengan pemilik portal di API Gateway](apigateway-portals-share-products.md). Untuk mempelajari cara menambahkan produk yang dibagikan dengan Anda ke portal Anda, lihat[Menambahkan produk portal bersama ke portal Anda di API Gateway](apigateway-portals-use-shared-products.md).
# Bagikan produk portal Anda dengan pemilik portal di API Gateway
Sebagai pemilik produk, Anda dapat berbagi produk Anda dengan pemilik portal di Akun AWS penggunaan lain AWS RAM. Anda mempertahankan kontrol penuh atas semua halaman produk dan halaman akhir REST produk.
## Pertimbangan-pertimbangan
Pertimbangan berikut dapat memengaruhi cara Anda berbagi produk portal:
+ Anda dapat berbagi atau membatalkan berbagi produk portal Anda kapan saja. Jika Anda membatalkan pembagian produk portal saat sedang digunakan di portal yang diterbitkan, pemilik portal tidak akan dapat melihat produk portal, melihat pembaruan apa pun yang dibuat untuk itu, atau menerbitkan ulang atau melihat pratinjau portal hingga mereka menghapus produk portal.
+ Anda dapat melihat produk portal yang telah Anda bagikan dengan akun lain.
+ Anda tidak dapat memodifikasi portal apa pun yang berisi produk portal Anda, kecuali Anda membuat portal sendiri.
## Bagikan produk portal Anda
Prosedur berikut menunjukkan cara membuat berbagi sumber daya.
------
#### [ Konsol Manajemen AWS ]
Untuk menggunakan Konsol Manajemen AWS, lihat [Membuat bagian sumber daya AWS RAM di](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing-create.html) *Panduan AWS RAM Pengguna*.
Untuk **Pilih jenis sumber daya**, pilih **Produk API Gateway**.
------
#### [ AWS CLI ]
Berikut ini [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html)membuat pembagian sumber daya untuk nama domain kustom pribadi Anda. Diperlukan beberapa menit untuk menyelesaikan sumber daya dan asosiasi utama. Untuk kepala sekolah, berikan ID akun atau ID Organizations, seperti. `arn:aws:organizations::123456789012:organization/o-1234abcd` Anda dapat memberikan beberapa prinsip untuk berbagi sumber daya Anda.
```
aws ram create-resource-share \
--region us-west-2 \
--name portal-product-resource-share \
--permission-arns arn:aws:ram::aws:permission/AWSRAMDefaultPermissionAPIGatewayDeveloperPortalProduct \
--resource-arns arn:aws:apigateway:us-west-2:111122223333:/portalproducts/p000000000 \
--principals 222222222222
```
------
Untuk membatalkan pembagian produk portal Anda, gunakan AWS RAM untuk menghapus pembagian sumber daya.
Kapan saja, Anda dapat memodifikasi kebijakan berbagi produk untuk memodifikasi prinsipal mana yang dapat menggunakan produk portal Anda di portal mereka.
**Untuk memperbarui kebijakan berbagi produk**
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Di panel navigasi utama, pilih **produk Portal**.
1. Pilih produk.
1. Di tab **Berbagi produk**, untuk **kebijakan berbagi produk**, pilih **Kelola kebijakan berbagi produk**.
1. Jika Anda belum pernah membagikan produk Anda sebelumnya, kebijakan berbagi produk Anda akan menolak semua akses ke akun lain ke produk portal Anda. Anda perlu memperbarui kebijakan untuk mengizinkan akses akun tertentu ke produk portal Anda.
1. Setelah memperbarui kebijakan berbagi produk, pilih **Simpan perubahan**.
# Menambahkan produk portal bersama ke portal Anda di API Gateway
Sebagai pemilik portal, Anda dapat menggunakan produk portal yang dibagikan dengan Anda oleh akun lain di portal Anda. Anda mempertahankan kontrol penuh atas portal Anda.
## Pertimbangan-pertimbangan
Pertimbangan berikut dapat memengaruhi cara Anda berbagi sumber daya portal:
+ Anda harus menerima pembagian sumber daya produk dari pemilik produk untuk menggunakan produk mereka di portal Anda. Jika Anda dan pemilik produk berada di Organizations yang sama, AWS RAM dapat menyelesaikan beberapa langkah berbagi untuk Anda.
+ Jika pemilik produk tidak membagikan produk saat berada di portal yang dipublikasikan, produk akan tetap terlihat di portal, tetapi Anda tidak akan dapat mempublikasikan portal lagi sampai Anda menghapus produk ini. Adalah tanggung jawab Anda sebagai pemilik portal untuk menghapus produk dari portal Anda, karena pemilik produk tidak dapat melakukannya untuk Anda.
+ Anda dapat melihat produk portal, halaman produk, dan halaman titik akhir REST produk, tetapi Anda tidak dapat memodifikasi sumber daya ini.
+ Jika suatu produk dibagikan dengan Anda, Anda tidak dapat membagikannya dengan akun lain.
## (Opsional) Terima pembagian sumber daya
Setelah pemilik produk Anda membuat pembagian sumber daya, Anda memiliki **waktu 12 jam** untuk menerimanya. Jika Anda berada di organisasi yang sama menggunakan AWS Organizations sebagai pemilik produk, pembagian secara otomatis diterima. Jika Anda berada di organisasi yang mengaktifkan sumber daya bersama otomatis, sumber daya akan dibagikan secara otomatis dengan Anda.
------
#### [ Konsol Manajemen AWS ]
*Untuk menggunakan Konsol Manajemen AWS, lihat [Menerima dan menolak undangan berbagi sumber daya](https://docs.aws.amazon.com/ram/latest/userguide/working-with-shared-invitations.html) di Panduan Pengguna.AWS RAM *
------
#### [ AWS CLI ]
Untuk menemukan semua sumber daya yang dibagikan dengan Anda, gunakan [get-resource-share-invitations](https://docs.aws.amazon.com/cli/latest/reference/ram/get-resource-share-invitations.html)perintah berikut:
```
aws ram get-resource-share-invitations \
--region us-west-2
```
Gunakan ARN berbagi sumber daya yang dihasilkan untuk menerima undangan berbagi sumber daya. [accept-resource-share-invitation](https://docs.aws.amazon.com/cli/latest/reference/ram/accept-resource-share-invitation.html)Perintah berikut menerima pembagian sumber daya.
```
aws ram accept-resource-share-invitation \
--resource-share-invitation-arn arn:aws:ram:us-west-2:123456789012:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE \
--region us-west-2
```
------
## Tambahkan produk bersama ke portal Anda
Setelah Anda menerima pembagian sumber daya, Anda menambahkan produk ke portal Anda.
------
#### [ Konsol Manajemen AWS ]
**Untuk menambahkan produk bersama ke portal Anda**
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Di panel navigasi utama, pilih **Portal**.
1. Pilih portal.
1. Di tab **Produk**, untuk **produk Portal**, pilih **Tambahkan produk**.
1. Tambahkan produk ke portal Anda. Produk bersama ditampilkan seperti `shared` dalam daftar produk.
1. Pilih **Simpan perubahan**.
------
#### [ AWS CLI ]
Untuk menemukan semua produk portal yang dibagikan dengan Anda, gunakan `get-portal-products` perintah berikut:
```
aws apigatewayv2 get-portal-products \
--resource-owner OTHER_ACCOUNTS \
--region us-west-2
```
Untuk menambahkan produk portal bersama ke portal Anda, gunakan `update-portal` perintah berikut:
```
aws apigateway update-portal \
--included-portal-product-arns arn:aws:apigateway:us-west-2:111122223333:/portalproducts/p000000000 \
--region us-west-2
```
------