Dengan data PTR yang dapat dikonfigurasi, Anda dapat menentukan data balik DNS yang terkait dengan alamat IP eksternal instance VM, sehingga aplikasi yang mengandalkan data ini dapat beroperasi sebagaimana mestinya.
Beberapa aplikasi memerlukan data DNS terbalik (data PTR) untuk menyelesaikan alamat IP ke nama domain. Misalnya, aplikasi yang menggunakan SMTP memerlukan data PTR yang mengarah ke domain dari mana email dikirim. Tanpa data tersebut, filter spam dapat menandai email dengan reputasi rendah, yang menyebabkan email tersebut masuk ke folder spam atau tidak terkirim sama sekali.
Anda hanya dapat menambahkan data PTR ke antarmuka jaringan utama instance VM. Data PTR tidak tersedia untuk frontend load balancer, Cloud NAT, atau alamat IP non-VM lainnya.
Catatan PTR IPv6 hanya tersedia jika antarmuka jaringan utama instance terhubung ke subnet stack ganda atau khusus IPv6 yang memiliki rentang alamat IPv6 eksternal. Untuk antarmuka jaringan dual-stack, Anda dapat memiliki catatan PTR IPv4 dan IPv6 terpisah.
Untuk membuat data PTR kustom untuk mengganti nama PTR DNS internal yang dibuat otomatis, lihat Zona pencarian balik yang dikelola.
Sebelum memulai
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS layanan dan API.
Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke
Compute Engine dengan memilih salah satu opsi berikut:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
- Set a default region and zone.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .
Verifikasi kepemilikan domain Anda
Sebelum membuat VM dengan data PTR kustom, verifikasi bahwa Anda adalah pemilik nama domain. Memverifikasi kepemilikan adalah tindakan keamanan untuk membuktikan kepada Google bahwa Anda adalah pemilik domain.
Anda dapat memverifikasi nama domain dengan 2 cara:
- Jika memiliki Akun Google, Anda dapat melakukan verifikasi menggunakan Search Console.
- Jika memiliki akun Google atau non-Google, Anda dapat melakukan verifikasi dengan menambahkan alamat IP VM ke konfigurasi DNS.
Verifikasi menggunakan Search Console
- Buka Search Console dan login menggunakan Akun Google yang akan Anda gunakan untuk menambahkan catatan PTR ke instance Anda. Anda dapat memverifikasi kepemilikan domain dengan beberapa akun.
- Masukkan nama domain PTR.
- Klik Lanjutkan.
- Ikuti petunjuknya, lalu klik Buka Properti.
- Klik Setelan (ada di menu sebelah kiri di dekat bagian bawah), lalu klik Verifikasi Kepemilikan.
Setelah Anda memverifikasi bahwa Anda adalah pemilik domain, di panel Setelan, klik Pengguna untuk melihat pemilik terverifikasi lainnya. Untuk menambahkan data PTR di domain lain, klik pemilih properti di sebelah kiri yang menampilkan domain Anda saat ini. Klik Tambahkan properti untuk menambahkan domain tersebut.
Jika nama domain Anda tidak langsung diverifikasi, gunakan Metode yang Direkomendasikan untuk mendapatkan verifikasi.
Verifikasi dengan menambahkan alamat IP VM ke konfigurasi DNS Anda
- Jika VM Anda belum ada, cadangkan alamat IP eksternal statis regional dan gunakan nanti selama pembuatan VM.
- Tambahkan data "A" dengan alamat IP eksternal VM ke konfigurasi DNS domain Anda.
Membuat instance VM dengan data PTR
Anda dapat menetapkan data PTR saat membuat instance baru. Untuk menambahkan data PTR untuk instance yang ada, baca Menambahkan data PTR.
Konsol
Di konsol Trusted Cloud , buka halaman Create an instance.
Tentukan detail VM.
Luaskan bagian Opsi lanjutan, lalu lakukan hal berikut:
- Luaskan bagian Networking.
- Buat satu atau beberapa antarmuka jaringan untuk digunakan dengan VM ini. Atau, Anda dapat menggunakan antarmuka jaringan default.
- Di bagian Antarmuka jaringan, luaskan antarmuka jaringan pertama, yang merupakan antarmuka jaringan utama.
- Di bagian Data PTR DNS publik, pilih setiap jenis data PTR yang ingin ditambahkan.
- Di kolom Nama domain PTR, masukkan nama domain untuk setiap jenis data PTR yang ingin Anda tambahkan.
- Di kolom Alamat IPv4 eksternal atau Alamat IPv6 eksternal, pilih alamat IP yang Anda cadangkan sebelumnya. Jika Anda telah memverifikasi alamat IP VM melalui konfigurasi DNS, Anda harus menentukan alamat tersebut.
- Untuk mengonfirmasi setelan antarmuka jaringan, klik Selesai.
Konfigurasi properti yang tersisa untuk VM baru Anda.
Di bagian bawah halaman, klik Buat.
Setelah VM dimulai, Anda dapat menjalankan pencarian balik DNS di alamat IP eksternal VM untuk mengonfirmasi bahwa data PTR berfungsi seperti yang diharapkan.
gcloud
Untuk membuat instance baru dengan catatan PTR IPv4 terkait, gunakan perintah
gcloud instances create
.gcloud compute instances create INSTANCE_NAME \ --image-family IMAGE_FAMILY \ --image-project IMAGE_PROJECT \ --public-ptr \ --public-ptr-domain DOMAIN_NAME \ --address=IP_ADDRESS
Ganti kode berikut:
INSTANCE_NAME
: nama instance VM baru.IMAGE_FAMILY
: salah satu kelompok image yang tersedia.IMAGE_PROJECT
: project yang menjadi dasar penyelesaian semua referensi gambar dan kelompok gambar. Trusted Cloud Jika Anda tidak memberikan nama project, project default saat ini akan digunakan.DOMAIN_NAME
: nama domain yang akan ditambahkan ke instance ini.IP_ADDRESS
: alamat IP yang sebelumnya Anda cadangkan. Jika Anda telah memverifikasi alamat IP VM melalui konfigurasi DNS, Anda harus menentukan alamat tersebut.
Untuk membuat instance baru dengan data PTR IPv6 terkait, lakukan langkah-langkah berikut:
REST
Untuk membuat instance baru dengan data PTR IPv4, buat permintaan
POST
ke metodeinstances.insert
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "name": "INSTANCE_NAME", "disks": [ { "initializeParams": { "sourceImage": "projects/debian-cloud/global/images/family/debian-10" }, "boot": true } ], "networkInterfaces": [ { "network": "NETWORK", "accessConfigs": [ { "type": "ONE_TO_ONE_NAT", "name": "External NAT", "natIP": "IP_ADDRESS", "publicPtrDomainName": "DOMAIN_NAME", "setPublicPtr": true } ] } ] }
Ganti kode berikut:
PROJECT_ID
: ID project Anda.ZONE
: zona instance Anda.MACHINE_TYPE
: jenis mesin.INSTANCE_NAME
: nama instance.NETWORK
: URL jaringan.IP_ADDRESS
: alamat IP yang sebelumnya Anda cadangkan. Jika Anda telah memverifikasi alamat IP VM melalui konfigurasi DNS, Anda harus menentukan alamat tersebut.DOMAIN_NAME
: nama domain yang akan ditambahkan.
Untuk membuat instance baru dengan data PTR IPv6, lakukan hal berikut:
Menambahkan data PTR
Anda dapat menambahkan data PTR dengan memperbarui konfigurasi akses pada antarmuka jaringan utama,
nic0
, dari instance VM.Konsol
Di konsol Trusted Cloud , buka halaman VM instances.
Klik instance yang ingin diedit.
Klik Edit.
Di bagian Antarmuka jaringan, klik antarmuka jaringan utama.
Di bagian Data PTR DNS publik, pilih setiap jenis data PTR yang ingin ditambahkan.
Di kolom Nama domain PTR, masukkan nama domain untuk setiap jenis data PTR yang ingin ditambahkan.
Klik Selesai, lalu klik Simpan.
gcloud
Jika VM Anda tidak memiliki konfigurasi akses, tambahkan konfigurasi menggunakan perintah
gcloud compute instances add-access-config
.gcloud compute instances add-access-config INSTANCE_NAME
Ganti
INSTANCE_NAME
dengan nama instance Anda.Perbarui konfigurasi akses untuk menambahkan data PTR menggunakan perintah
gcloud compute instances update-access-config
. Untuk menambahkan catatan PTR IPv4 dan IPv6, gunakan perintah berikut satu per satu.Untuk IPv4:
gcloud compute instances update-access-config INSTANCE_NAME \ --public-ptr \ --public-ptr-domain DOMAIN_NAME
Untuk IPv6:
gcloud compute instances update-access-config INSTANCE_NAME \ --ipv6-public-ptr-domain=DOMAIN_NAME
Ganti kode berikut:
INSTANCE_NAME
: nama instance yang akan diupdate.DOMAIN_NAME
: nama domain yang akan ditambahkan.
REST
Jika VM Anda tidak memiliki konfigurasi akses, tambahkan konfigurasi akses dengan membuat permintaan
POST
ke metodeinstances.addAccessConfig
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addAccessConfig?networkInterface="nic0"
Perbarui konfigurasi akses untuk menambahkan data PTR dengan membuat permintaan
POST
ke metodeinstances.updateAccessConfig
. Untuk menambahkan data PTR IPv4 dan IPv6, buat permintaan berikut secara terpisah.Untuk IPv4:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0 { "setPublicPtr": true, "publicPtrDomainName": "DOMAIN_NAME", "type": "ONE_TO_ONE_NAT" }
Untuk IPv6:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0 { "publicPtrDomainName": "DOMAIN_NAME", "type": "DIRECT_IPV6" }
Ganti kode berikut:
PROJECT_ID
: ID project.ZONE
: zona instance.INSTANCE_NAME
: nama instance.DOMAIN_NAME
: nama domain yang akan ditambahkan.
Menghapus data PTR
Untuk menghapus data PTR, perbarui konfigurasi akses pada antarmuka jaringan utama,
nic0
, dari instance VM. Saat Anda menghapus data PTR, Trusted Cloud akan merespons pencarian DNS terbalik dengan nama domain yang sepenuhnya memenuhi syarat secara default, yaitugoogleusercontent.com
.Konsol
Di konsol Trusted Cloud , buka halaman VM instances.
Klik instance yang ingin diedit.
Klik Edit.
Di bagian Antarmuka jaringan, klik antarmuka jaringan utama.
Di bagian Data PTR DNS publik, hapus centang pada kotak untuk setiap jenis data PTR yang ingin dihapus.
Klik Selesai, lalu klik Simpan.
gcloud
Untuk menghapus catatan PTR, gunakan perintah
gcloud compute instances update-access-config
. Untuk menghapus data PTR IPv4 dan IPv6, gunakan perintah berikut secara terpisah.Untuk IPv4:
gcloud compute instances update-access-config INSTANCE_NAME \ --no-public-ptr
Untuk IPv6:
gcloud compute instances update-access-config INSTANCE_NAME \ --no-ipv6-public-ptr
Ganti
INSTANCE_NAME
dengan nama instance yang akan diupdate.REST
Untuk menghapus data PTR, buat permintaan
POST
ke metodeinstances.updateAccessConfig
. Untuk menghapus catatan PTR IPv4 dan IPv6, buat permintaan berikut secara terpisah.Untuk IPv4:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0 { "setPublicPtr": false, "type": "ONE_TO_ONE_NAT" }
Untuk IPv6:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0 { "publicPtrDomainName": "", "type": "DIRECT_IPV6" }
Ganti kode berikut:
PROJECT_ID
: ID project.ZONE
: zona instance.INSTANCE_NAME
: nama instance.
Batasan
Saat VM dimigrasikan ke host lain sebagai bagian dari proses migrasi langsung selama event pemeliharaan, logika data PTR tidak menangani beberapa kasus ekstrem dengan benar dan mengembalikan Data PTR DNS ke nama domain yang sepenuhnya memenuhi syarat (FQDN)
googleusercontent.com
. Untuk memulihkan fungsi, terapkan kembali data PTR.Jika Anda menghentikan VM yang memiliki data PTR IPv6, pendaftaran data PTR IPv6 akan dibatalkan untuk sementara dan tidak terlihat di VM. Data akan ditambahkan kembali secara otomatis saat Anda memulai ulang VM.
Langkah berikutnya
- Untuk mengetahui ringkasan cara mengonfigurasi dan mengelola alamat IP eksternal statis untuk resource Anda, lihat Mencadangkan alamat IP eksternal statis.
- Untuk mempelajari cara membuat dan mengelola instance virtual machine, lihat Membuat dan memulai instance VM.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-08 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-08 UTC."],[[["PTR records allow the reverse DNS lookup of a VM's external IP address to its domain name, which is crucial for applications like SMTP to avoid being flagged by spam filters."],["PTR records can only be applied to the primary network interface of a VM instance and are not available for load balancer frontends, Cloud NAT, or non-VM IP addresses."],["To add or update a PTR record, you must first verify domain ownership either through Google Search Console or by adding the VM's IP address to your DNS configuration."],["PTR records can be added or updated on an existing VM instance through the Google Cloud console, `gcloud` command-line tool, or REST API by modifying the primary network interface settings."],["IPv6 PTR records are available for instances with primary network interface connected to dual-stack or IPv6-only subnets with external IPv6 address range."]]],[]] -