

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

# AWS Cloud Map ruang nama
<a name="working-with-namespaces"></a>

Namespace adalah entitas logis AWS Cloud Map yang digunakan untuk mengelompokkan layanan aplikasi di bawah nama umum dan tingkat kemampuan ditemukan. Saat Anda membuat namespace, Anda menentukan yang berikut:
+ Nama yang Anda ingin aplikasi Anda gunakan untuk menemukan instance.
+ Metode di mana contoh layanan yang Anda daftarkan AWS Cloud Map dapat ditemukan. Anda dapat memutuskan apakah sumber daya Anda perlu ditemukan secara publik melalui internet, secara pribadi di virtual private cloud (VPC) tertentu, atau hanya dengan panggilan API.

Berikut ini adalah konsep umum tentang ruang nama.
+ Ruang nama khusus untuk tempat Wilayah AWS mereka dibuat. Untuk digunakan AWS Cloud Map di beberapa wilayah, Anda harus membuat ruang nama di setiap wilayah.
+ Jika Anda membuat namespace untuk memungkinkan misalnya penemuan oleh kueri DNS di VPC, AWS Cloud Map secara otomatis membuat zona yang dihosting Route 53 pribadi. Zona yang dihosting ini dapat dikaitkan dengan beberapa VPCs. Untuk informasi selengkapnya, lihat [Mengaitkan VPCWith HostedZone](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AssociateVPCWithHostedZone.html) di *Referensi API Amazon Route 53*.

**Topics**
+ [Membuat AWS Cloud Map namespace untuk mengelompokkan layanan aplikasi](creating-namespaces.md)
+ [Daftar ruang AWS Cloud Map nama](listing-namespaces.md)
+ [Menghapus namespace AWS Cloud Map](deleting-namespaces.md)
+ [Ruang AWS Cloud Map nama bersama](sharing-namespaces.md)

# Membuat AWS Cloud Map namespace untuk mengelompokkan layanan aplikasi
<a name="creating-namespaces"></a>

Anda dapat membuat namespace untuk mengelompokkan layanan untuk aplikasi Anda dengan nama ramah yang memungkinkan penemuan sumber daya aplikasi melalui panggilan API atau kueri DNS.

## Opsi penemuan instance
<a name="working-with-namespaces-instance-discovery"></a>

Tabel berikut merangkum berbagai opsi penemuan instance AWS Cloud Map dan jenis namespace yang sesuai yang dapat Anda buat, tergantung pada layanan dan penyiapan aplikasi Anda.


| Jenis namespace | Metode penemuan instance | Cara kerjanya | Informasi tambahan | 
| --- | --- | --- | --- | 
| HTTP  | Panggilan API  | Sumber daya dalam aplikasi Anda dapat menemukan sumber daya lain hanya dengan memanggil DiscoverInstances API. |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloud-map/latest/dg/creating-namespaces.html)  | 
| DNS privat | Panggilan API dan kueri DNS di VPC | Saat Anda membuat namespace DNS pribadi, AWS Cloud Map buat zona host pribadi Amazon Route 53 yang sesuai. Sumber daya dalam aplikasi Anda dapat menemukan sumber daya lain dengan memanggil `DiscoverInstances` API, dan dengan menanyakan server nama di zona host Route 53 pribadi yang dibuat secara otomatis. AWS Cloud Map  Zona host yang dibuat oleh AWS Cloud Map memiliki nama yang sama dengan namespace dan berisi catatan DNS yang memiliki nama dalam format. *service-name* *namespace-name*.  Penyelesai Route 53 menyelesaikan kueri DNS yang berasal dari VPC menggunakan catatan di zona yang dihosting privat. Jika zona yang di-hosting privat tidak termasuk catatan yang cocok dengan nama domain dalam kueri DNS, Route 53 menanggapi kueri dengan `NXDOMAIN` (domain yang tidak ada).   |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloud-map/latest/dg/creating-namespaces.html)  | 
| DNS Publik | Panggilan API dan kueri DNS publik | Saat Anda membuat namespace DNS publik, AWS Cloud Map buat zona host publik Amazon Route 53 yang sesuai. Sumber daya dalam aplikasi Anda dapat menemukan sumber daya lain dengan memanggil `DiscoverInstances` API dan dengan menanyakan server nama di zona host Route 53 publik yang dibuat secara otomatis. AWS Cloud Map  Zona yang dihosting publik memiliki nama yang sama dengan namespace dan berisi catatan DNS yang memiliki nama dalam format. *service-name* *namespace-name*.  Nama namespace dalam hal ini harus berupa nama domain yang telah Anda daftarkan.   |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloud-map/latest/dg/creating-namespaces.html)  | 

## Prosedur
<a name="create-namespace-steps"></a>

Anda dapat mengikuti langkah-langkah ini untuk membuat namespace menggunakan AWS CLI, Konsol Manajemen AWS, atau SDK untuk Python.

------
#### [ Konsol Manajemen AWS ]

1. Masuk ke Konsol Manajemen AWS dan buka AWS Cloud Map konsol di [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/).

1. Pilih **Buat namespace**.

1. Untuk **nama Namespace**, masukkan nama yang akan digunakan untuk menemukan instance.
**catatan**  
Ruang nama yang dikonfigurasi untuk kueri DNS publik harus diakhiri dengan domain tingkat atas. Misalnya, `.com`.
Anda dapat menentukan nama domain yang diinternasionalisasi (IDN) jika Anda mengubah namanya menjadi Punycode terlebih dahulu. Untuk informasi tentang pengubah online, lakukan pencarian internet di "punycode converter".  
Anda juga dapat mengubah nama domain yang diinternasionalisasi menjadi Punycode saat Anda membuat namespace secara terprogram. Misalnya, jika Anda menggunakan Java, Anda dapat mengkonversi nilai Unicode ke Punycode dengan menggunakan `toASCII` metode perpustakaan java.net.IDN.

1. **(Opsional) Untuk **deskripsi Namespace**, masukkan informasi tentang namespace yang akan terlihat di halaman **Namespaces dan di bawah informasi Namespace**.** Anda dapat menggunakan informasi ini untuk mengidentifikasi namespace dengan mudah.

1. Untuk **penemuan Instance**, Anda dapat memilih antara **panggilan API, panggilan** **API, dan kueri DNS VPCs**, serta **panggilan API dan kueri DNS publik** untuk membuat ruang nama HTTP, DNS pribadi, atau DNS publik. Untuk informasi selengkapnya, lihat [Opsi penemuan instance](#working-with-namespaces-instance-discovery).

   Berdasarkan pilihan Anda, ikuti langkah-langkah ini.
   + Jika Anda memilih **panggilan API dan kueri DNS di VPCs**, untuk **VPC**, pilih virtual private cloud (VPC) yang ingin Anda kaitkan dengan namespace.
   + Jika Anda memilih **panggilan API dan kueri DNS dalam VPCs** atau **panggilan API dan kueri DNS publik**, untuk **TTL**, tentukan nilai numerik dalam hitungan detik. Nilai time to live (TTL) menentukan berapa lama DNS menyelesaikan informasi cache untuk catatan DNS start of authority (SOA) dari zona host Route 53 yang dibuat dengan namespace Anda. Untuk informasi selengkapnya tentang TTL, lihat [TTL (detik) di Panduan](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-values-shared.html#rrsets-values-common-ttl) *Pengembang Amazon Route 53*.

1. (Opsional) Di bawah **Tag**, pilih **Tambahkan tag** lalu tentukan kunci dan nilai untuk menandai namespace Anda. Anda dapat menentukan satu tanda atau lebih untuk ditambahkan ke namespace Anda. Tag memungkinkan Anda untuk mengkategorikan AWS sumber daya Anda sehingga Anda dapat lebih mudah mengelolanya. Untuk informasi selengkapnya, lihat [Menandai sumber daya Anda AWS Cloud Map](using-tags.md).

1. Pilih **Buat namespace**. Anda dapat melihat status operasi dengan menggunakan [ListOperations](https://docs.aws.amazon.com/cloud-map/latest/api/API_ListOperations.html). Untuk informasi selengkapnya, lihat [ListOperations](https://docs.aws.amazon.com/cloud-map/latest/api/API_ListOperations.html)di *Referensi AWS Cloud Map API* 

------
#### [ AWS CLI ]
+ 

  Buat namespace dengan perintah untuk jenis penemuan instance yang Anda inginkan (ganti *red* nilainya dengan milik Anda sendiri).
  + Buat namespace HTTP menggunakan. `[create-http-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-http-namespace.html)` Contoh layanan yang terdaftar menggunakan namespace HTTP dapat ditemukan menggunakan `DiscoverInstances` permintaan, tetapi tidak dapat ditemukan menggunakan DNS.

    ```
    aws servicediscovery create-http-namespace --name name-of-namespace
    ```
  + Buat namespace pribadi berdasarkan DNS dan hanya terlihat di dalam VPC Amazon tertentu menggunakan. `[create-private-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-private-dns-namespace.html)` Anda dapat menemukan instance yang terdaftar dengan namespace DNS pribadi dengan menggunakan permintaan atau menggunakan DNS `DiscoverInstances`

    ```
    aws servicediscovery create-private-dns-namespace --name name-of-namespace --vpc vpc-xxxxxxxxx
    ```
  + Buat namespace publik berdasarkan DNS yang terlihat di internet menggunakan. `[create-public-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-public-dns-namespace.html)` Anda dapat menemukan instans yang didaftarkan dengan namespace DNS publik dengan menggunakan permintaan `DiscoverInstances` atau menggunakan DNS.

    ```
    aws servicediscovery create-public-dns-namespace --name name-of-namespace
    ```

------
#### [ AWS SDK for Python (Boto3) ]

1. Jika Anda belum `Boto3` menginstal, Anda dapat menemukan petunjuk untuk menginstal, mengkonfigurasi, dan menggunakan `Boto3` [di sini](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation).

1. Impor `Boto3` dan gunakan `servicediscovery` sebagai layanan Anda.

   ```
   import boto3
   client = boto3.client('servicediscovery')
   ```

1. 

   Buat namespace dengan perintah untuk tipe penemuan instance yang Anda inginkan (ganti *red* nilainya dengan milik Anda sendiri):
   + Buat namespace HTTP menggunakan. `create_http_namespace()` Contoh layanan yang terdaftar menggunakan namespace HTTP dapat ditemukan menggunakan`discover_instances()`, tetapi tidak dapat ditemukan menggunakan DNS.

     ```
     response = client.create_http_namespace(
         Name='name-of-namespace',
     )
     # If you want to see the response
     print(response)
     ```
   + Buat namespace pribadi berdasarkan DNS dan hanya terlihat di dalam VPC Amazon tertentu menggunakan. `create_private_dns_namespace()` Anda dapat menemukan instance yang terdaftar dengan namespace DNS pribadi dengan menggunakan salah satu atau menggunakan DNS `discover_instances()`

     ```
     response = client.create_private_dns_namespace(
         Name='name-of-namespace',
         Vpc='vpc-1c56417b',
     )
     # If you want to see the response
     print(response)
     ```
   + Buat namespace publik berdasarkan DNS yang terlihat di internet menggunakan. `create_public_dns_namespace()` Anda dapat menemukan instance yang terdaftar dengan namespace DNS publik dengan menggunakan salah satu atau `discover_instances()` menggunakan DNS.

     ```
     response = client.create_public_dns_namespace(
         Name='name-of-namespace',
     )
     # If you want to see the response
     print(response)
     ```
   + Contoh keluaran respons

     ```
     {
         'OperationId': 'gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd',
         'ResponseMetadata': {
             '...': '...',
         },
     }
     ```

------

## Langkah selanjutnya
<a name="create-namespace-next-steps"></a>

Setelah membuat namespace, Anda dapat membuat layanan di namespace untuk mengelompokkan sumber daya aplikasi yang secara kolektif melayani tujuan tertentu dalam aplikasi Anda. Layanan bertindak sebagai templat untuk mendaftarkan sumber daya aplikasi sebagai instance. Untuk informasi selengkapnya tentang membuat AWS Cloud Map layanan, lihat[Membuat AWS Cloud Map layanan untuk komponen aplikasi](creating-services.md).

# Daftar ruang AWS Cloud Map nama
<a name="listing-namespaces"></a>

Setelah membuat ruang nama, Anda dapat melihat daftar ruang nama yang telah Anda buat dengan mengikuti langkah-langkah ini.

------
#### [ Konsol Manajemen AWS ]

1. Masuk ke Konsol Manajemen AWS dan buka AWS Cloud Map konsol di [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/).

1. Di panel navigasi, pilih **Namespaces** untuk melihat daftar ruang nama. Anda dapat memesan ruang nama berdasarkan nama, deskripsi, mode penemuan instance, pemilik, atau ID namespace. Anda juga dapat memasukkan nama namespace atau ID ke dalam kolom pencarian untuk mencari dan melihat namespace tertentu.

------
#### [ AWS CLI ]
+ Buat daftar ruang nama dengan perintah. `[list-namespaces](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/list-namespaces.html)`

  ```
  aws servicediscovery list-namespaces
  ```

------
#### [ AWS SDK for Python (Boto3) ]

1. Jika Anda belum `Boto3` menginstal, Anda dapat menemukan petunjuk untuk menginstal, mengkonfigurasi, dan menggunakan `Boto3` [di sini](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation).

1. Impor `Boto3` dan gunakan `servicediscovery` sebagai layanan Anda.

   ```
   import boto3
   client = boto3.client('servicediscovery')
   ```

1. Daftar ruang nama dengan. `list_namespaces()`

   ```
   response = client.list_namespaces()
   # If you want to see the response
   print(response)
   ```

   Contoh keluaran respons

   ```
   {
       'Namespaces': [
           {
               'Arn': 'arn:aws::servicediscovery:us-west-2:123456789012:namespace/ns-xxxxxxxxxxxxxxx',
               'CreateDate': 1585354387.357,
               'Id': 'ns-xxxxxxxxxxxxxxx',
               'Name': 'myFirstNamespace',
               'Properties': {
                   'DnsProperties': {
                       'HostedZoneId': 'Z06752353VBUDTC32S84S',
                   },
                   'HttpProperties': {
                       'HttpName': 'myFirstNamespace',
                   },
               },
               'Type': 'DNS_PRIVATE',
           },
           {
               'Arn': 'arn:aws::servicediscovery:us-west-2:123456789012:namespace/ns-xxxxxxxxxxxxxxx',
               'CreateDate': 1586468974.698,
               'Description': 'My second namespace',
               'Id': 'ns-xxxxxxxxxxxxxxx',
               'Name': 'mySecondNamespace.com',
               'Properties': {
                   'DnsProperties': {
                   },
                   'HttpProperties': {
                       'HttpName': 'mySecondNamespace.com',
                   },
               },
               'Type': 'HTTP',
           },
           {
               'Arn': 'arn:aws::servicediscovery:us-west-2:123456789012:namespace/ns-xxxxxxxxxxxxxxx',
               'CreateDate': 1587055896.798,
               'Id': 'ns-xxxxxxxxxxxxxxx',
               'Name': 'myThirdNamespace.com',
               'Properties': {
                   'DnsProperties': {
                       'HostedZoneId': 'Z09983722P0QME1B3KC8I',
                   },
                   'HttpProperties': {
                       'HttpName': 'myThirdNamespace.com',
                   },
               },
               'Type': 'DNS_PRIVATE',
           },
       ],
       'ResponseMetadata': {
           '...': '...',
       },
   }
   ```

------

# Menghapus namespace AWS Cloud Map
<a name="deleting-namespaces"></a>

Setelah selesai menggunakan namespace, Anda dapat menghapusnya. Saat menghapus namespace, Anda tidak lagi dapat menggunakannya untuk mendaftar atau menemukan instans layanan.

**catatan**  
 Saat Anda menghapus namespace DNS, AWS Cloud Map menghapus zona host Amazon Route 53 yang sesuai yang dibuat selama pembuatan namespace.

Sebelum menghapus namespace, Anda harus membatalkan pendaftaran semua instance layanan dan kemudian menghapus semua layanan yang dibuat di namespace. Untuk informasi selengkapnya, lihat [Membatalkan pendaftaran instance layanan AWS Cloud Map](deregistering-instances.md) dan [Menghapus layanan AWS Cloud Map](deleting-services.md).

Setelah membatalkan pendaftaran instance dan menghapus layanan yang dibuat di namespace, ikuti langkah-langkah berikut untuk menghapus namespace.

------
#### [ Konsol Manajemen AWS ]

1. Masuk ke Konsol Manajemen AWS dan buka AWS Cloud Map konsol di [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/).

1. Di panel navigasi, pilih **Namespace**.

1. **Pilih namespace yang ingin Anda hapus, lalu pilih Hapus.**

1. Konfirmasikan bahwa Anda ingin menghapus layanan dengan memilih **Hapus** lagi.

------
#### [ AWS CLI ]
+ Hapus namespace dengan `[delete-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/delete-namespace.html)` perintah (ganti *red* nilainya dengan milik Anda). Jika namespace masih berisi satu atau beberapa layanan, permintaan gagal.

  ```
  aws servicediscovery delete-namespace --id ns-xxxxxxxxxxx
  ```

------
#### [ AWS SDK for Python (Boto3) ]

1. Jika Anda belum `Boto3` menginstal, Anda dapat menemukan petunjuk untuk menginstal, mengkonfigurasi, dan menggunakan `Boto3` [di sini](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation).

1. Impor `Boto3` dan gunakan `servicediscovery` sebagai layanan Anda.

   ```
   import boto3
   client = boto3.client('servicediscovery')
   ```

1. Hapus namespace dengan `delete_namespace()` (ganti *red* nilainya dengan milik Anda). Jika namespace masih berisi satu atau beberapa layanan, permintaan gagal.

   ```
   response = client.delete_namespace(
       Id='ns-xxxxxxxxxxx',
   )
   # If you want to see the response
   print(response)
   ```

   Contoh keluaran respons

   ```
   {
       'OperationId': 'gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk',
       'ResponseMetadata': {
           '...': '...',
       },
   }
   ```

------

# Ruang AWS Cloud Map nama bersama
<a name="sharing-namespaces"></a>

AWS Cloud Map memungkinkan pemilik namespace untuk berbagi ruang nama mereka dengan orang lain Akun AWS atau di dalam organisasi AWS Organizations untuk penemuan layanan lintas akun dan registri layanan yang disederhanakan. Ini memungkinkan penggunaan ruang nama yang lebih mudah dikelola oleh orang lain Akun AWS atau tim dalam Organisasi. AWS 

AWS Cloud Map terintegrasi dengan AWS Resource Access Manager (AWS RAM) untuk mengaktifkan berbagi sumber daya. AWS RAM adalah layanan yang memungkinkan Anda untuk berbagi beberapa AWS Cloud Map sumber daya dengan yang lain Akun AWS atau melalui AWS Organizations. Dengan AWS RAM, Anda berbagi sumber daya yang Anda miliki dengan membuat *pembagian sumber daya*. Pembagian sumber daya menentukan sumber daya yang akan dibagikan, dan konsumen yang akan dibagikan. Konsumen dapat mencakup:
+ Spesifik Akun AWS di dalam organisasinya di AWS Organizations
+ Unit organisasi di dalam organisasinya di AWS Organizations
+ Seluruh organisasinya di AWS Organizations

Untuk informasi selengkapnya AWS RAM, lihat *[Panduan AWS RAM Pengguna](https://docs.aws.amazon.com/ram/latest/userguide/)*.

Topik ini menjelaskan cara berbagi sumber daya yang Anda miliki, dan cara menggunakan sumber daya yang dibagikan dengan Anda.

**Topics**
+ [Pertimbangan untuk berbagi ruang nama](#sharing-considerations)
+ [Berbagi AWS Cloud Map namespace](sharing-share.md)
+ [Berhenti berbagi AWS Cloud Map namespace](sharing-unshare.md)
+ [Mengidentifikasi AWS Cloud Map namespace bersama](sharing-identify.md)
+ [Memberikan izin untuk berbagi namespace](#granting-perms-to-share)
+ [Tanggung jawab dan izin untuk ruang nama bersama](#sharing-perms)
+ [Tagihan dan pengukuran](#sharing-billing)
+ [Kuota](#sharing-quotas)

## Pertimbangan untuk berbagi ruang nama
<a name="sharing-considerations"></a>
+ Untuk berbagi namespace, Anda harus memilikinya di. Akun AWS Ini berarti bahwa sumber daya harus dialokasikan atau disediakan di akun Anda. Anda tidak dapat berbagi namespace yang telah dibagikan dengan Anda.
+ Untuk berbagi namespace dengan organisasi atau unit organisasi AWS Organizations, Anda harus mengaktifkan berbagi dengan. AWS Organizations Untuk informasi selengkapnya, lihat [Mengaktifkan Berbagi dengan AWS Organizations](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-orgs) di *Panduan AWS RAM Pengguna*.
+ Untuk penemuan layanan menggunakan kueri DNS di namespace DNS pribadi bersama, pemilik namespace harus memanggil `create-vpc-association-authorization` dengan ID zona host pribadi yang terkait dengan namespace dan VPC konsumen.

  ```
  aws route53 create-vpc-association-authorization --hosted-zone-id Z1234567890ABC --vpc VPCRegion=us-east-1,VPCId=vpc-12345678
  ```

  Konsumen namespace perlu menelepon `associate-vpc-with-hosted-zone` dengan ID zona host pribadi.

  ```
  aws route53 associate-vpc-with-hosted-zone --hosted-zone-id Z1234567890ABC --vpc VPCRegion=us-east-1,VPCId=vpc-12345678
  ```

  Untuk informasi selengkapnya, lihat [Mengaitkan VPC Amazon dan zona host pribadi yang Anda buat dengan Akun AWS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zone-private-associate-vpcs-different-accounts.html) berbeda di Panduan Pengembang *Amazon Route 53*.
+ Setelah menemukan lokasi up-to-date jaringan layanan yang terkait dengan namespace DNS bersama, mungkin perlu untuk mengkonfigurasi konektivitas antar-VPC untuk berkomunikasi dengan layanan jika mereka berbeda. VPCs Ini dapat dicapai dengan menggunakan koneksi VPC Peering. Untuk informasi selengkapnya, lihat [Membuat atau menghapus koneksi Peering VPC di panduan Peering](https://docs.aws.amazon.com/vpc/latest/peering/create-vpc-peering-connection.html) *VPC Amazon Virtual Private Cloud*.
+ Anda tidak dapat `ListOperations` menggunakan daftar operasi pada ruang nama bersama yang dilakukan oleh akun lain.
+ Penandaan tidak didukung untuk ruang nama bersama.

# Berbagi AWS Cloud Map namespace
<a name="sharing-share"></a>

 Ketika Anda berbagi AWS Cloud Map namespace yang Anda miliki dengan orang lain Akun AWS (konsumen), Anda mengaktifkan akun ini untuk menemukan lokasi up-to-date jaringan layanan di namespace tanpa perlu kredensil sementara.

Untuk berbagi namespace, Anda harus menambahkannya ke berbagi sumber daya. Berbagi sumber daya adalah AWS RAM sumber daya yang memungkinkan Anda berbagi sumber daya Akun AWS. Pembagian sumber daya menentukan sumber daya yang akan dibagikan, dan konsumen yang akan berbagi dengan mereka. [Untuk menambahkan namespace ke pembagian sumber daya baru, Anda harus terlebih dahulu membuat pembagian sumber daya menggunakan konsol.AWS RAM](https://console.aws.amazon.com/ram)

Jika Anda adalah bagian dari organisasi AWS Organizations dan berbagi dalam organisasi Anda diaktifkan, konsumen di organisasi Anda secara otomatis diberikan akses ke namespace bersama. Jika tidak, konsumen menerima undangan untuk bergabung dengan pembagian sumber daya dan diberikan akses ke namespace bersama setelah menerima undangan.

Anda dapat membagikan namespace yang Anda miliki menggunakan AWS RAM konsol atau. AWS CLI

------
#### [ AWS RAM console ]

**Untuk berbagi namespace yang Anda miliki menggunakan konsol AWS RAM**  
Lihat [Membuat berbagi sumber daya AWS RAM di](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing-create.html) *Panduan AWS RAM Pengguna*.

------
#### [ AWS CLI ]

**Untuk berbagi namespace yang Anda miliki menggunakan AWS CLI**  
Gunakan perintah AWS RAM [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).

------

# Berhenti berbagi AWS Cloud Map namespace
<a name="sharing-unshare"></a>

Ketika namespace tidak lagi dibagikan, namespace dan layanan serta instance apa pun yang terkait dengannya tidak dapat lagi diakses oleh konsumen. Akun AWS Ini termasuk sumber daya yang dibuat di namespace oleh konsumen ketika mereka memiliki akses ke namespace.

Untuk berhenti berbagi namespace yang Anda miliki, Anda harus menghapusnya dari pembagian sumber daya. Anda dapat melakukan ini menggunakan AWS RAM konsol atau AWS CLI.

------
#### [ AWS RAM console ]

**Untuk berhenti berbagi namespace yang Anda miliki menggunakan konsol AWS RAM**  
Lihat [Memperbarui Sumber Daya Bersama](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing-update.html) di *Panduan Pengguna AWS RAM *.

------
#### [ AWS CLI ]

**Untuk berhenti berbagi namespace yang Anda miliki menggunakan AWS CLI**  
Gunakan perintah [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).

------

# Mengidentifikasi AWS Cloud Map namespace bersama
<a name="sharing-identify"></a>

Pemilik dan konsumen dapat mengidentifikasi ruang nama bersama menggunakan AWS Cloud Map konsol dan. AWS CLI Pemilik namespace dapat diidentifikasi dengan menggunakan properti. `ResourceOwner` Akun AWS Yang membuat layanan atau mendaftarkan instance di namespace bersama dapat diidentifikasi dengan menggunakan properti. `CreatedByAccount`

------
#### [ AWS Cloud Map console ]

**Untuk mengidentifikasi namespace bersama menggunakan konsol AWS Cloud Map**

1. Masuk ke Konsol Manajemen AWS dan buka AWS Cloud Map konsol di [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/).

1. Pada halaman **Namespaces**, di bawah **Resource Owner**, Anda dapat menemukan ID Akun AWS yang memiliki namespace.

1. Pilih **nama Domain** dari namespace yang ingin Anda identifikasi.

1. Pada *namespace-name* halaman **Namespace:**, di bagian **informasi Namespace**, di bawah **Pemilik sumber daya**, Anda dapat menemukan ID yang memiliki namespace. Akun AWS 

------
#### [ AWS CLI ]

Untuk mengidentifikasi namespace bersama menggunakan AWS CLI, gunakan perintah [list-namespaces](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/list-namespaces.html). Perintah mengembalikan ruang nama yang Anda miliki dan ruang nama yang dibagikan dengan Anda. `ResourceOwner`Kolom menunjukkan ID AWS akun pemilik namespace.

`list-namespaces`Panggilan berikut dilakukan dengan akun`111122223333`.

```
aws servicediscovery list-namespaces
```

Output:

```
{
    "Namespaces": [
        {
            "Arn": "arn:aws:servicediscovery:us-west-2:111122223333:namespace/ns-abcdef01234567890",
            "CreateDate": 1585354387.357,
            "Id": "ns-abcdef01234567890",
            "Name": "local",
            "Properties": {
                "DnsProperties": {
                    "HostedZoneId": "Z06752353VBUDTC32S84S"
                },
                "HttpProperties": {
                    "HttpName": "local"
                 }
            },
            "Type": "DNS_PRIVATE",
            "ServiceCount": 2,
           "ResourceOwner": "111122223333"
        },
        {
            "Arn": "arn:aws:servicediscovery:us-west-2:444455556666:namespace/ns-021345abcdef6789",
            "CreateDate": 1586468974.698,
            "Description": "Shared second namespace",
            "Id": "ns-021345abcdef6789",
            "Name": "My-second-namespace",
            "Properties": {
                "DnsProperties": {},
                "HttpProperties": {
                    "HttpName": "Shared-second-namespace"
                }
            },
            "Type": "HTTP",
            "ServiceCount": 0,
            "ResourceOwner": "444455556666"
        }
    ]
}
```

Dalam skenario ini, namespace `ns-abcdef01234567890` dibuat dan dimiliki oleh `111122223333` dan namespace dibuat dan dimiliki `ns-021345abcdef6789` oleh. `444455556666` Namespace `ns-021345abcdef6789` dibagikan dengan akun `111122223333` berdasarkan akun. `444455556666`

------

## Memberikan izin untuk berbagi namespace
<a name="granting-perms-to-share"></a>

Satu set izin minimum diperlukan untuk prinsipal IAM untuk berbagi namespace. Sebaiknya gunakan `AWSCloudMapFullAccess` dan kebijakan `AWSResourceAccessManagerFullAccess` terkelola untuk memastikan kepala sekolah IAM Anda memiliki izin yang diperlukan untuk berbagi dan menggunakan ruang nama bersama.

Jika Anda menggunakan kebijakan IAM khusus, tindakan `servicediscovery:PutResourcePolicy``servicediscovery:GetResourcePolicy`, dan `servicediscovery:DeleteResourcePolicy` tindakan diperlukan untuk berbagi ruang nama. Ini adalah tindakan IAM khusus izin. Jika prinsipal IAM tidak memiliki izin ini diberikan, kesalahan akan terjadi saat mencoba berbagi namespace menggunakan. AWS RAM

Untuk informasi selengkapnya tentang cara AWS RAM menggunakan IAM, lihat [Cara AWS RAM menggunakan IAM](https://docs.aws.amazon.com/ram/latest/userguide/security-iam-policies.html) di *AWS RAM Panduan Pengguna*.

## Tanggung jawab dan izin untuk ruang nama bersama
<a name="sharing-perms"></a>

Pemilik dan konsumen namespace dapat melakukan tindakan yang berbeda pada namespace bersama.

### Izin untuk pemilik
<a name="perms-owner"></a>

Pemilik namespace dapat melakukan tindakan berikut pada namespace bersama:
+ Akses layanan yang terkait dengan namespace, termasuk layanan yang dibuat oleh akun konsumen dan instans yang terdaftar pada layanan ini.
+ Mencabut akses ke namespace, termasuk akses ke layanan yang dibuat oleh akun konsumen dan instans yang terdaftar pada layanan ini.
+ Konfigurasikan izin untuk akun lain untuk mendaftar dan membatalkan pendaftaran instance di layanan yang dibuat di namespace bersama oleh konsumen atau pemilik namespace.
+ Hapus layanan dan instans deregister, termasuk layanan yang dibuat dan instans yang didaftarkan oleh akun konsumen.
+ Memperbarui atau menghapus namespace bersama.

### Izin untuk konsumen
<a name="perms-consumer"></a>

Konsumen namespace dapat melakukan tindakan berikut pada namespace bersama:
+ Buat dan hapus layanan di namespace.
+ Daftar dan deregister instance dalam layanan yang dibuat di namespace.
+ Temukan instance yang terdaftar ke layanan yang dibuat di namespace.

Konsumen tidak dapat memperbarui atau menghapus namespace bersama. Setelah kehilangan akses ke namespace bersama, akun konsumen juga akan kehilangan akses ke layanan yang mereka buat di namespace.

## Tagihan dan pengukuran
<a name="sharing-billing"></a>

Pemilik ditagih untuk setiap instance yang mereka daftarkan di namespace bersama dan pemeriksaan kesehatan Route 53 yang dibuat saat mereka mendaftarkan instance ini. Konsumen ditagih untuk setiap kasus yang mereka daftarkan di namespace dan setiap pemeriksaan kesehatan Route 53 yang dibuat saat mereka mendaftarkan instans ini. Jika namespace bersama adalah namespace DNS, pemilik namespace ditagih untuk catatan DNS Route 53 yang dibuat saat layanan dibuat di namespace. Pemilik ditagih untuk setiap `DiscoverInstancesRevision` panggilan `DiscoverInstances` yang mereka buat. Konsumen ditagih untuk setiap `DiscoverInstances` `DiscoverInstancesRevision` panggilan yang mereka lakukan.

## Kuota
<a name="sharing-quotas"></a>

Ruang nama bersama hanya dihitung terhadap ruang nama pemilik namespace per kuota Wilayah. Instans yang didaftarkan oleh konsumen di namespace bersama dihitung terhadap instance pemilik per kuota namespace. Jika konsumen membuat layanan di namespace bersama, setiap instance yang terdaftar dalam layanan dihitung terhadap instans konsumen per kuota layanan. Jika pemilik membuat layanan di namespace bersama, setiap instance yang terdaftar dalam layanan dihitung terhadap instans pemilik per kuota layanan.