Membuat dan mengelola lampiran jaringan
Halaman ini menjelaskan cara administrator jaringan konsumen dapat membuat dan mengelola lampiran jaringan Private Service Connect. Lampiran jaringan memungkinkan jaringan VPC produsen layanan memulai koneksi ke jaringan VPC konsumen.
Sebelum memulai
- Anda harus mengaktifkan Compute Engine API di project Anda.
- Jika ingin secara manual menentukan project yang dapat terhubung ke lampiran jaringan, Anda perlu mengetahui ID project.
Peran
Untuk mendapatkan izin yang diperlukan untuk membuat, melihat, dan menghapus lampiran jaringan, minta administrator untuk memberi Anda peran IAM Compute Network Admin (roles/compute.networkAdmin) di project Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Membuat subnet
Saat membuat lampiran jaringan, Anda menetapkan satu subnet reguler. Subnet ini harus berada di region yang sama dengan lampiran jaringan. Satu subnet dapat dibagikan ke beberapa lampiran jaringan. Subnet dengan jenis stack dual-stack atau khusus IPv6 harus menggunakan rentang alamat IPv6 internal.
Untuk mengetahui informasi selengkapnya tentang cara membuat subnet, lihat Membuat dan mengelola jaringan VPC.
Membuat lampiran jaringan
Lampiran jaringan adalah resource regional yang merepresentasikan sisi konsumen koneksi antarmuka Private Service Connect. Lampiran jaringan harus berada di region yang sama dengan VM antarmuka Private Service Connect terkait.
Kebijakan otorisasi lampiran jaringan menentukan apakah lampiran jaringan dapat menerima koneksi dari antarmuka Private Service Connect.
Anda dapat memperbarui subnet, daftar penerimaan, daftar penolakan, dan deskripsi lampiran jaringan.
Membuat lampiran jaringan yang menerima koneksi secara manual
Anda dapat membuat lampiran jaringan yang menerima koneksi secara manual. Sebelum membuat lampiran jenis ini, pastikan Anda mengetahui ID project atau ID class layanan produsen yang ingin diterima.
Daftar penerimaan dan penolakan dapat berisi ID project atau ID kelas layanan, tetapi tidak boleh berupa campuran keduanya.
Konsol
Di konsol Cloud de Confiance , buka halaman Private Service Connect:
Klik Network attachments.
Klik Create network attachment.
Masukkan Name.
Pilih Network.
Pilih Region.
Pilih Subnetwork.
Lakukan salah satu hal berikut:
- Untuk menerima koneksi berdasarkan project ID:
- Pilih Accept connections for selected projects.
- Untuk setiap project yang ingin Anda terima, klik Add accepted project, lalu masukkan ID project yang ingin diterima.
- Opsional: Untuk setiap project yang koneksinya ingin Anda tolak secara eksplisit, klik Add rejected project, lalu masukkan project ID yang akan ditolak.
- Untuk menerima koneksi berdasarkan ID class layanan:
- Pilih Terima koneksi untuk class layanan yang dipilih.
- Untuk setiap class layanan yang ingin Anda setujui, klik Tambahkan class layanan yang disetujui, lalu pilih class layanan yang akan disetujui.
- Opsional: Untuk setiap class layanan yang ingin Anda tolak secara eksplisit, klik Add rejected service class, lalu pilih class layanan yang akan ditolak.
- Untuk menerima koneksi berdasarkan project ID:
Klik Create network attachment.
gcloud
Gunakan
perintah network-attachments create.
gcloud compute network-attachments create ATTACHMENT_NAME \
--region=REGION \
--connection-preference=ACCEPT_MANUAL \
--producer-accept-list=ACCEPTED_PRODUCERS \
--producer-reject-list=REJECTED_PRODUCERS \
--subnets=SUBNET_NAME
Ganti yang berikut ini:
ATTACHMENT_NAME: nama lampiran jaringan.REGION: region lampiran jaringan.ACCEPTED_PRODUCERS: daftar produsen yang dipisahkan koma yang diizinkan untuk terhubung ke lampiran jaringan ini. Anda dapat menentukan produser dengan salah satu cara berikut:- Menurut project ID: misalnya,
project-id-1,project-id-2. - Menurut ID class layanan: setiap ID harus menggunakan awalan
serviceclasses/—misalnya,serviceclasses/service-class1,serviceclasses/service-class2.
- Menurut project ID: misalnya,
REJECTED_PRODUCERS: daftar yang dipisahkan koma dari project ID atau ID class layanan yang ditolak secara eksplisit untuk terhubung ke lampiran jaringan ini. Tentukan produsen menggunakan format yang sama dengan daftar penerimaan konsumen.SUBNET_NAME: nama subnet yang akan dikaitkan dengan lampiran jaringan ini.
API
Buat permintaan POST ke metode networkAttachments.insert.
POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/networkAttachments
{
"connectionPreference": "ACCEPT_MANUAL",
"name": "ATTACHMENT_NAME",
"producerAcceptLists": [
"ACCEPTED_PRODUCERS"
],
"producerRejectLists": [
"REJECTED_PRODUCERS"
],
"subnetworks": [
"https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
]
}
Ganti yang berikut ini:
PROJECT_ID: ID project tempat lampiran jaringan dibuat.REGION: region lampiran jaringanATTACHMENT_NAME: nama lampiran jaringanACCEPTED_PRODUCERS: daftar produsen yang diizinkan untuk terhubung ke lampiran jaringan ini. Anda dapat menentukan produser dengan salah satu cara berikut:- Menurut project ID: misalnya,
"project-id-1", "project-id-2". - Menurut ID class layanan: setiap ID harus menggunakan awalan
serviceclasses/—misalnya,"serviceclasses/service-class1", "serviceclasses/service-class2".
- Menurut project ID: misalnya,
REJECTED_PRODUCERS: daftar project ID atau ID class layanan yang ditolak secara eksplisit untuk terhubung ke lampiran jaringan ini. Tentukan produsen menggunakan format yang sama dengan daftar penerimaan konsumen.SUBNET_NAME: nama subnet yang akan dikaitkan dengan lampiran jaringan.
Membuat lampiran jaringan yang secara otomatis menerima koneksi
Anda dapat membuat lampiran jaringan yang otomatis menerima koneksi dari antarmuka Private Service Connect mana pun yang merujuk ke lampiran jaringan.
Konsol
Di konsol Cloud de Confiance , buka halaman Private Service Connect:
Klik Network attachments.
Klik Create network attachment.
Masukkan Name.
Pilih Network.
Pilih Region.
Pilih Subnetwork.
Klik Automatically accept connections for all projects.
Klik Create network attachment.
gcloud
Gunakan
perintah network-attachments create.
gcloud compute network-attachments create ATTACHMENT_NAME \
--region=REGION \
--connection-preference=ACCEPT_AUTOMATIC \
--subnets=SUBNET_NAME
Ganti yang berikut ini:
ATTACHMENT_NAME: nama lampiran jaringan.REGION: region lampiran jaringan.SUBNET_NAME: nama subnet yang akan dikaitkan dengan lampiran jaringan ini.
API
Buat permintaan POST ke metode networkAttachments.insert.
POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/networkAttachments
{
"connectionPreference": "ACCEPT_AUTOMATIC",
"name": "ATTACHMENT_NAME",
"subnetworks": [
"https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
]
}
Ganti yang berikut ini:
PROJECT_ID: ID project tempat lampiran jaringan dibuat.REGION: region lampiran jaringanATTACHMENT_NAME: nama lampiran jaringanSUBNET_NAME: nama subnet yang akan dikaitkan dengan lampiran jaringan.
Membuat daftar lampiran jaringan
Konsol
Di konsol Cloud de Confiance , buka halaman Private Service Connect:
Klik Network attachments.
gcloud
Untuk mencantumkan semua lampiran jaringan dalam sebuah project, gunakan perintah
network-attachments list.gcloud compute network-attachments list
Untuk mencantumkan lampiran jaringan di beberapa region atau region tertentu, gunakan perintah
network-attachments list, lalu tentukan regionnya.gcloud compute network-attachments list --regions=REGIONS
Ganti
REGIONSdengan region atau beberapa region untuk mencantumkan lampiran jaringan. Anda dapat menyertakan beberapa region dalam daftar yang dipisahkan koma.
API
Untuk mencantumkan lampiran jaringan di region tertentu, buat permintaan GET ke metode networkAttachments.list.
GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/networkAttachments
Ganti yang berikut ini:
PROJECT_ID: ID project.REGION: region lampiran jaringan.
Mendeskripsikan lampiran jaringan
Anda dapat mendeskripsikan lampiran jaringan untuk melihat detailnya, termasuk koneksi antarmuka Private Service Connect yang terkait. Untuk setiap koneksi, Anda dapat melihat alamat IP yang ditetapkan untuk antarmuka Private Service Connect.
Konsol
Di konsol Cloud de Confiance , buka halaman Private Service Connect:
Klik Network attachments.
Pilih lampiran jaringan untuk melihat detailnya dan daftar project yang terhubung.
Untuk melihat koneksi antarmuka Private Service Connect individual untuk project, klik nama project.
Status koneksi project tidak selalu menentukan status koneksi antarmuka Private Service Connect dari project tersebut. Misalnya, jika Anda menambahkan project ke daftar penolakan setelah Anda menerima koneksi dari project tersebut, status project akan ditolak, tetapi koneksi yang ada akan tetap terbuka. Koneksi baru dari project tersebut akan ditolak.
gcloud
Gunakan
perintah network-attachments describe.
gcloud compute network-attachments describe ATTACHMENT_NAME \
--region=REGION
Ganti yang berikut ini:
ATTACHMENT_NAME: nama lampiran jaringan yang akan dijelaskan.REGION: region lampiran jaringan
Antarmuka Private Service Connect yang terhubung ditampilkan dalam format berikut:
connectionEndpoints:
- ipAddress: 10.6.0.59
projectIdOrNum: '123456789'
status: ACCEPTED
subnetwork: https://www.googleapis.com/compute/v1/projects/consumer-project-id/regions/us-central1/subnetworks/consumer-subnet
- ipAddress: 10.6.0.11
projectIdOrNum: '987654321'
status: ACCEPTED
subnetwork: https://www.googleapis.com/compute/v1/projects/consumer-project-id/regions/us-central1/subnetworks/consumer-subnet
```
API
Untuk mendeskripsikan jaringan dan melihat detailnya, buat permintaan GET ke metode networkAttachments.get.
GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME
Ganti yang berikut ini:
PROJECT_ID: ID project.REGION: region lampiran jaringan.ATTACHMENT_NAME: nama lampiran jaringan.
Antarmuka Private Service Connect yang terhubung ditampilkan dalam format berikut:
"connectionEndpoints": [
{
"status": "ACCEPTED",
"projectIdOrNum": "123456789",
"subnetwork": "https://www.googleapis.com/compute/v1/projects/consumer-project-id/regions/us-central1/subnetworks/consumer-subnet-1",
"ipAddress": "10.6.0.11"
},
{
"status": "ACCEPTED",
"projectIdOrNum": "987654321",
"subnetwork": "https://www.googleapis.com/compute/v1/projects/consumer-project-id/regions/us-central1/subnetworks/consumer-subnet-2",
"ipAddress": "10.6.0.59"
}
]
Memperbarui lampiran jaringan
Anda dapat memperbarui lampiran jaringan dengan mengganti subnet, deskripsi, atau—untuk lampiran jaringan yang dibuat untuk menerima koneksi secara manual—daftar terima atau tolak. Jika Anda perlu mengupdate kolom lain, hapus lampiran jaringan, lalu buat yang baru.
Jika Anda mengganti subnet lampiran jaringan, koneksi yang ada tidak akan terpengaruh. Koneksi yang dibuat setelah update menggunakan alamat IP dari subnet baru.
Jika Anda memperbarui daftar penerimaan atau penolakan lampiran jaringan, koneksi yang ada tidak akan terpengaruh. Koneksi yang dibuat setelah pembaruan diterima atau ditolak sesuai dengan daftar yang diperbarui.
Konsol
Di konsol Cloud de Confiance , buka halaman Private Service Connect:
Klik Network attachments.
Klik lampiran jaringan yang ingin Anda perbarui, lalu klik Edit.
Untuk mengganti subnetwork lampiran jaringan, klik Subnetwork, lalu pilih subnetwork baru.
Untuk memperbarui daftar penerimaan, lakukan hal berikut:
- Untuk menambahkan produser, klik Tambahkan project yang diizinkan atau Tambahkan class layanan yang diizinkan, lalu masukkan project ID atau pilih class layanan.
- Untuk menghapus produsen, arahkan kursor ke produsen, lalu klik Hapus project yang diterima atau Hapus class layanan yang diterima.
Untuk memperbarui daftar penolakan, lakukan hal berikut:
- Untuk menambahkan produser, klik Tambahkan project yang ditolak atau Tambahkan class layanan yang ditolak, lalu masukkan project ID atau pilih class layanan.
- Untuk menghapus produsen, arahkan pointer ke produsen, lalu klik Hapus project yang ditolak atau Hapus class layanan yang ditolak.
Klik Update network attachment.
gcloud
Gunakan
perintah network-attachments update.
Anda dapat memperbarui satu atau beberapa
kolom yang tercantum di sini, kecuali region, yang digunakan untuk mengidentifikasi
lampiran jaringan. Jika Anda memperbarui daftar penerimaan atau penolakan lampiran jaringan, Anda harus mengganti seluruh daftar dalam satu pembaruan.
gcloud compute network-attachments update ATTACHMENT_NAME \
--region=REGION \
--subnets=SUBNET \
--producer-accept-list=ACCEPTED_PRODUCERS \
--producer-reject-list=REJECTED_PRODUCERS \
--description=DESCRIPTION
Ganti kode berikut:
ATTACHMENT_NAME: nama lampiran jaringan.REGION: region lampiran jaringan. Flag ini digunakan untuk mengidentifikasi lampiran jaringan. Anda tidak dapat memperbarui region lampiran jaringan.SUBNET: nama subnet yang akan dikaitkan dengan lampiran jaringan ini.ACCEPTED_PRODUCERS: daftar produsen yang dipisahkan koma yang diizinkan untuk terhubung ke lampiran jaringan ini. Anda dapat menentukan produser dengan salah satu cara berikut:- Menurut project ID: misalnya,
project-id-1,project-id-2. - Menurut ID class layanan: setiap ID harus menggunakan awalan
serviceclasses/—misalnya,serviceclasses/service-class1,serviceclasses/service-class2.
- Menurut project ID: misalnya,
REJECTED_PRODUCERS: daftar yang dipisahkan koma dari project ID atau ID class layanan yang ditolak secara eksplisit untuk terhubung ke lampiran jaringan ini. Tentukan produsen menggunakan format yang sama dengan daftar penerimaan konsumen.DESCRIPTION: deskripsi lampiran jaringan.
API
- Kirim permintaan API untuk mendeskripsikan lampiran jaringan yang ingin Anda perbarui.
- Catat nilai untuk kolom
fingerprintlampiran jaringan. Buat permintaan
PATCHke metodenetworkAttachments.patch. Hapus kolom apa pun dari isi permintaan yang tidak ingin Anda ganti, kecualifingerprint. Jika memperbarui daftar penerimaan atau penolakan lampiran jaringan, Anda harus mengganti seluruh daftar dalam satu pembaruan.PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME { "fingerprint": "FINGERPRINT", "producerAcceptLists": [ "ACCEPTED_PRODUCERS" ], "producerRejectLists": [ "REJECTED_PRODUCERS" ], "subnetworks": [ "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME" ], "description": "DESCRIPTION" }Ganti kode berikut:
PROJECT_ID: ID project.REGION: region lampiran jaringan.ATTACHMENT_NAME: nama lampiran jaringan.FINGERPRINT: nilai untuk kolom sidik jari yang Anda temukan di langkah 2.ACCEPTED_PRODUCERS: daftar produsen yang diizinkan untuk terhubung ke lampiran jaringan ini. Anda dapat menentukan produser dengan salah satu cara berikut:- Menurut project ID: misalnya,
"project-id-1", "project-id-2". - Menurut ID class layanan: setiap ID harus menggunakan awalan
serviceclasses/—misalnya,"serviceclasses/service-class1", "serviceclasses/service-class2".
- Menurut project ID: misalnya,
REJECTED_PRODUCERS: daftar project ID atau ID class layanan yang ditolak secara eksplisit untuk terhubung ke lampiran jaringan ini. Tentukan produsen menggunakan format yang sama dengan daftar penerimaan konsumen.SUBNET_NAME: nama subnet baru yang akan dikaitkan dengan lampiran jaringan.DESCRIPTION: deskripsi yang diperbarui untuk lampiran jaringan.
Menghapus lampiran jaringan
Anda dapat menghapus lampiran jaringan jika tidak memiliki koneksi. Jika Anda ingin menghapus lampiran jaringan yang memiliki koneksi, produsen harus menghapus antarmuka Private Service Connect yang terkait terlebih dahulu.
Jika Anda menghapus lampiran jaringan, lalu membuat lampiran jaringan baru dengan nama yang sama,Cloud de Confiance akan memperlakukan lampiran jaringan tersebut sebagai dua resource terpisah.
Konsol
Di konsol Cloud de Confiance , buka halaman Private Service Connect:
Klik Network attachments.
Pilih lampiran jaringan, lalu klik Delete.
Klik Delete lagi untuk mengonfirmasi.
gcloud
Gunakan network-attachments delete perintah.
gcloud compute network-attachments delete ATTACHMENT_NAME \
--region=REGION
Ganti yang berikut ini:
ATTACHMENT_NAME: nama lampiran jaringan yang akan dijelaskan.REGION: region lampiran jaringan
API
Buat permintaan DELETE ke metode networkAttachments.delete.
DELETE https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME
Ganti yang berikut ini:
PROJECT_ID: ID project.REGION: region lampiran jaringan.ATTACHMENT_NAME: nama lampiran jaringan.
Apa langkah selanjutnya?
- Buat antarmuka Private Service Connect yang terhubung ke lampiran jaringan.
- Konfigurasi keamanan untuk jaringan yang memiliki lampiran jaringan.
- Mengelola tujuan tumpang-tindih di jaringan yang memiliki koneksi antarmuka Private Service Connect.