新增、更新及刪除記錄

主控台

1. 前往 Google Cloud 控制台的「Cloud DNS 區域」頁面。

   前往 Cloud DNS 區域

2. 按一下要新增記錄的代管區域名稱。

3. 在「Zone details」(區域詳細資料) 頁面中，按一下「Add standard」(新增標準)。

4. 在「建立記錄集」頁面的「DNS 名稱」欄位中，輸入 DNS 區域的子網域，例如 mail。結尾的點會自動加上。

   如要建立萬用字元 DNS 記錄，請輸入星號，例如 *.example.com。

   系統不會自動建立頂層記錄。 如要在網域頂層建立資源記錄，請將「DNS 名稱」欄位留空。

5. 選取「資源記錄類型」，例如 MX。

6. 在「TTL」TTL欄位中，針對資源記錄存留時間輸入數字值，也就是記錄可快取的時間。這個值必須是正整數。

7. 從「TTL 單位」選單中選取時間單位，例如 minutes。

8. 視您選取的資源記錄類型而定，填入剩餘欄位。

9. 如要輸入其他資訊，請按一下「新增項目」。

10. 點選「建立」。

gcloud

如要新增資源記錄集，請使用 gcloud dns record-sets create 指令：

gcloud dns record-sets create RRSET_NAME \
    --rrdatas=RR_DATA \
    --ttl=TTL \
    --type=RRSET_TYPE \
    --zone=MANAGED_ZONE

更改下列內容：

• RRSET_NAME：與這個區域的 DNS 名稱相符的 DNS 名稱，做為傳入查詢的後置字串，例如 test.example.com
• RR_DATA：與資源記錄集相關聯的任意值，例如 198.51.100.5；您也可以輸入多個值，例如 rrdata1 rrdata2 rrdata3，例如 198.51.100.5 10.2.3.4...
• TTL：解析器快取這組資源記錄的存留時間 (以秒為單位)，例如 30
• RRSET_TYPE：這個資源記錄集的資源記錄類型，例如 A。
• MANAGED_ZONE：這個資源記錄集所屬的代管區域，例如 my-zone-name；這個資源記錄集的名稱必須以代管區域的 DNS 名稱為後置字串

API

如要新增資源記錄集，請使用 resourceRecordSets.create 方法：

POST https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets
{
    "name": "RRSET_NAME",
    "type": "RRSET_TYPE",
    "ttl": TTL,
    "rrdatas": [ RR_DATA ]
}

更改下列內容：

• PROJECT_ID：專案 ID
• MANAGED_ZONE：這個資源記錄集所屬的代管區域，例如 my-zone-name；這個資源記錄集的名稱必須以代管區域的 DNS 名稱為後置字串
• RRSET_NAME：與這個區域的 DNS 名稱相符的 DNS 名稱，做為傳入查詢的後置字串，例如 test.example.com
• RRSET_TYPE：這個資源記錄集的資源記錄類型，例如 A
• TTL：解析器快取這組資源記錄的存留時間 (以秒為單位)，例如 30
• RR_DATA：與資源記錄集相關聯的任意值，例如 "198.51.100.5"；您也可以在以半形逗號分隔的清單中輸入多個值，例如 "198.51.100.5","10.2.3.4"。

Terraform

resource "google_dns_managed_zone" "parent_zone" {
  name        = "sample-zone"
  dns_name    = "sample-zone.hashicorptest.com."
  description = "Test Description"
}

resource "google_dns_record_set" "default" {
  managed_zone = google_dns_managed_zone.parent_zone.name
  name         = "test-record.sample-zone.hashicorptest.com."
  type         = "A"
  rrdatas      = ["10.0.0.1", "10.1.0.1"]
  ttl          = 86400
}

gcloud

1. 如要開始交易，請使用 gcloud dns record-sets transaction start 指令：

   gcloud dns record-sets transaction start \
      --zone=MANAGED_ZONE
   

   將 MANAGED_ZONE 替換為要管理資源記錄集的代管區域名稱，例如 my-zone-name。

2. 如要將資源記錄集新增為交易的一部分，請使用 gcloud dns record-sets transaction add 指令：

   gcloud dns record-sets transaction add RR_DATA \
      --name=DNS_NAME \
      --ttl=TTL \
      --type=RECORD_TYPE \
      --zone=MANAGED_ZONE
   

   更改下列內容：

   • RR_DATA：與資源記錄集相關聯的任意值，例如 198.51.100.5；您也可以輸入多個值，例如 rrdata1 rrdata2 rrdata3，例如 198.51.100.5 10.2.3.4...
   • DNS_NAME：要新增的記錄集 DNS 或網域名稱，例如 test.example.com
   • TTL：記錄集的存留時間 (TTL)，以秒為單位，例如 300
   • RECORD_TYPE：記錄類型，例如 A。
   • MANAGED_ZONE：要管理資源記錄集的代管區域名稱，例如 my-zone-name

3. 如要執行交易，請使用 gcloud dns record-sets transaction execute 指令：

   gcloud dns record-sets transaction execute \
      --zone=MANAGED_ZONE
   

4. 如要新增萬用字元交易，請使用 gcloud dns record-sets transaction add 指令：

   gcloud dns record-sets transaction add \
      --zone=MANAGED_ZONE \
      --name=WILDCARD_DNS_NAME \
      --type=RECORD_TYPE \
      --ttl=TTL
   

   更改下列內容：

   • MANAGED_ZONE：要管理資源記錄集的代管區域名稱，例如 my-zone-name
   • WILDCARD_DNS_NAME：要新增的資源記錄集的 DNS 或網域名稱，例如 *.example.com. (請注意結尾的點)
   • RECORD_TYPE：記錄類型，例如 CNAME。
   • TTL：記錄集的存留時間，以秒為單位，例如 300

API

如要使用新的資源記錄集建立交易，請使用 changes.create 方法：

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/changes

{
  "deletions": []
  "additions": [
    {
      "name": DNS_NAME,
      "type": RECORD_TYPE,
      "ttl": TTL,
      "rrdatas": [
        RR_DATA
      ]
    }
  ]
}

更改下列內容：

• PROJECT_ID：您的專案 ID
• MANAGED_ZONE：受管理區域名稱或 ID
• DNS_NAME：記錄集的 DNS 或網域名稱，例如 test.example.com. (請注意結尾的點)
• RECORD_TYPE：記錄類型
• TTL：記錄集的存留時間 (TTL)，以秒為單位，例如 30
• RR_DATA：與資源記錄集相關聯的任意值，例如 198.51.100.5；您也可以輸入多個值，例如 rrdata1 rrdata2 rrdata3，例如 198.51.100.5 10.2.3.4...

主控台

1. 前往 Google Cloud 控制台的「Cloud DNS」頁面。

   前往 Cloud DNS

2. 在「儲存區」分頁中，點選要查看資源記錄集的儲存區。

   「區域詳細資料」頁面會顯示該區域中所有資源記錄集的詳細資料。

gcloud

如要查看區域的 DNS 記錄，請使用 gcloud dns record-sets list 指令：

gcloud dns record-sets list \
   --zone="ZONE_NAME"

將 ZONE_NAME 替換為專案中的 DNS 區域名稱。

此指令會以含有前 100 筆記錄的資源記錄集，輸出 JSON 回應。您可以指定下列額外參數：

• --limit：要列出的記錄集數量上限
• --name：只列出具有這個確切網域名稱的資源記錄集
• --type：只列出這類記錄；如果存在，也必須存在 --name 參數

API

如要查看區域的 DNS 記錄，請使用 resourceRecordSets.list 方法：

GET https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONErrsets

更改下列內容：

• PROJECT_ID：專案 ID
• MANAGED_ZONE：這個資源記錄集所屬的代管區域，例如 my-zone-name；這個資源記錄集的名稱必須以代管區域的 DNS 名稱為後置字串

主控台

1. 前往 Google Cloud 控制台的「Cloud DNS 區域」頁面。

   前往 Cloud DNS 區域

2. 按一下包含資源記錄集的區域。

3. 按一下要查看詳細資料的資源記錄集。

   「資源記錄集詳細資料」頁面會顯示資源記錄集的詳細資料。

gcloud

如要查看現有資源記錄集的詳細資料，請使用 gcloud dns record-sets describe 指令：

gcloud dns record-sets describe RRSET_NAME \
  --type=RRSET_TYPE \
  --zone=MANAGED_ZONE

更改下列內容：

• RRSET_NAME：與這個區域的 DNS 名稱相符的 DNS 名稱，做為傳入查詢的後置字串，例如 test.example.com
• RRSET_TYPE：這個資源記錄集的資源記錄類型，例如 A。
• MANAGED_ZONE：這個資源記錄集所屬的代管區域，例如 my-zone-name；這個資源記錄集的名稱必須以代管區域的 DNS 名稱為後置字串

API

如要取得現有資源記錄集的詳細資料，請使用 resourceRecordSets.get 方法：

GET https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE

更改下列內容：

• PROJECT_ID：專案 ID
• MANAGED_ZONE：這個資源記錄集所屬的代管區域，例如 my-zone-name；這個資源記錄集的名稱必須以代管區域的 DNS 名稱為後置字串
• RRSET_NAME：與這個區域的 DNS 名稱相符的 DNS 名稱，做為傳入查詢的後置字串，例如 test.example.com
• RRSET_TYPE：這個資源記錄集的記錄類型，例如 A。

主控台

如要對現有的資源記錄集套用部分更新，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Cloud DNS 區域」頁面。

   前往 Cloud DNS 區域

2. 按一下要更新資源記錄集的區域。

3. 在「區域詳細資料」頁面中，找到要更新的資源記錄集，然後按一下旁邊的「編輯」圖示 edit。

4. 進行必要更新後，按一下「儲存」。

gcloud

如要對現有資源記錄集套用部分更新，請使用 gcloud dns record-sets update 指令：

gcloud dns record-sets update RRSET_NAME \
    --rrdatas=RR_DATA \
    --ttl=TTL \
    --type=RRSET_TYPE \
    --zone=MANAGED_ZONE

更改下列內容：

• RRSET_NAME：與這個區域的 DNS 名稱相符的 DNS 名稱，做為傳入查詢的後置字串，例如 test.example.com
• RR_DATA：與資源記錄集相關聯的任意值，例如 198.51.100.5；您也可以輸入多個值，例如 rrdata1 rrdata2 rrdata3，例如 198.51.100.5 10.2.3.4...
• TTL：解析器快取這組資源記錄的存留時間 (以秒為單位)，例如 30
• RRSET_TYPE：這個資源記錄集的資源記錄類型，例如 A。
• MANAGED_ZONE：這個資源記錄集所屬的代管區域，例如 my-zone-name；這個資源記錄集的名稱必須以代管區域的 DNS 名稱為後置字串

API

如要對現有資源記錄集套用部分更新，請使用 resourceRecordSets.patch 方法：

PATCH https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE
{
  "ttl": TTL,
  "rrdatas": RR_DATA,
  "update_mask": {
      "paths": ["rrset.ttl", "rrset.rrdatas"]
  }
}

更改下列內容：

• PROJECT_ID：專案 ID
• MANAGED_ZONE：這個資源記錄集所屬的代管區域，例如 my-zone-name；這個資源記錄集的名稱必須以代管區域的 DNS 名稱為後置字串
• RRSET_NAME：與這個區域的 DNS 名稱相符的 DNS 名稱，做為傳入查詢的後置字串，例如 test.example.com
• RRSET_TYPE：這個資源記錄集的資源記錄類型，例如 A。
• TTL：解析器快取這組資源記錄的存留時間 (以秒為單位)，例如 30
• RR_DATA：與資源記錄集相關聯的任意值，例如 198.51.100.5；您也可以輸入多個值，例如 rrdata1 rrdata2 rrdata3，例如 198.51.100.5 10.2.3.4...

主控台

1. 前往 Google Cloud 控制台的「Cloud DNS」頁面。

   前往 Cloud DNS 區域

   區域的記錄會列在「區域詳細資料」頁面中。

2. 如要刪除區域中的資源記錄集，請按一下區域名稱。

3. 在要刪除的資源記錄集旁，選取核取方塊。

4. 按一下「刪除記錄集」。

gcloud

如要刪除現有資源記錄集，請使用 gcloud dns record-sets delete 指令：

gcloud dns record-sets delete RRSET_NAME \
    --type=RRSET_TYPE \
    --zone=MANAGED_ZONE

更改下列內容：

• RRSET_NAME：與這個區域的 DNS 名稱相符的 DNS 名稱，做為傳入查詢的後置字串，例如 test.example.com
• RRSET_TYPE：這個資源記錄集的資源記錄類型，例如 A。
• MANAGED_ZONE：這個資源記錄集所屬的代管區域，例如 my-zone-name；這個資源記錄集的名稱必須以代管區域的 DNS 名稱為後置字串

API

如要刪除現有的資源記錄集，請使用 resourceRecordSets.delete 方法：

DELETE https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE

更改下列內容：

• PROJECT_ID：專案 ID
• MANAGED_ZONE：這個資源記錄集所屬的代管區域，例如 my-zone-name；這個資源記錄集的名稱必須以代管區域的 DNS 名稱為後置字串
• RRSET_NAME：與這個區域的 DNS 名稱相符的 DNS 名稱，做為傳入查詢的後置字串，例如 test.example.com
• RRSET_TYPE：這個資源記錄集的資源記錄類型，例如 A。

gcloud

1. 如要匯入資源記錄集，請使用 dns record-sets import 指令：

   gcloud dns record-sets import -z=ZONE_NAME
   

   如要指定區域檔案的檔案格式，請使用先前的指令搭配 --zone-file-format 標記。如果省略這個標記，您必須提供 YAML 格式的區域檔案。

   將 ZONE_NAME 替換為區域的新名稱。

   • 使用 gcloud dns record-sets import 指令和 --replace-origin-ns 旗標時，系統會將區域的 NS 記錄，替換為區域檔案中指定的 NS 記錄。這些記錄必須與 Cloud DNS 指派的名稱伺服器相符，才能代管區域。也必須與上層 (委派) 區域中指定的 NS 記錄相符。根據預設，Cloud DNS 不會覆寫記錄。NS 如果使用這個標記，請務必確認 NS 記錄正確無誤。

   • 以 BIND 區域格式檔案匯入記錄集時，請移除表示區域頂點的 at 符號 (@)。在 BIND 區域格式檔案中，對於類似 example.com 的 DNS 名稱，@ 符號是指 example.com.。不過，在 Cloud DNS 中定義記錄名稱時，系統會將 @ 符號視為單純的符號。如要在 Cloud DNS 中為區域的頂層建立資源記錄集，請使用完整網域名稱，例如 example.com.。

     in.smtp              IN MX 5 gmail-smtp-in.l.google.com
     in.smtp.example.com. IN MX 5 gmail-smtp-in.l.google.com.example.com.
     

     如要匯入區域檔案，請在任何必須完全合格的網域名稱結尾加上尾隨點 (.)。

2. 如要匯出資源記錄集，請使用 dns record-sets export 指令。如要指定將資源記錄集匯出至 BIND 區域格式檔案，請使用 --zone-file-format 標記。例如：

   example.com. 21600 IN NS ns-gcp-private.googledomains.com.
   example.com. 21600 IN SOA ns-gcp-private.googledomains.com.
   cloud-dns-hostmaster.google.com. 1 21600 3600 259200 300
   host1.example.com. 300 IN A 192.0.2.91
   

   如果省略 --zone-file-format 標記，export 會將資源記錄集匯出至 YAML 格式記錄檔案：

   gcloud dns record-sets export example.zone -z=examplezonename
   

   例如：

   ---
   kind: dns#resourceRecordSet
   name: example.com.
   rrdatas:
   - ns-gcp-private.googledomains.com.
   ttl: 21600
   type: NS
   ---
   kind: dns#resourceRecordSet
   name: example.com.
   rrdatas:
   - ns-gcp-private.googledomains.com. cloud-dns-hostmaster.google.com. 1 21600 3600 259200 300
   ttl: 21600
   type: SOA
   ---
   kind: dns#resourceRecordSet
   name: host1.example.com.
   rrdatas:
   - 192.0.2.91
   ttl: 300
   type: A
   
   

   Cloud DNS 支援 ALIAS 記錄類型，但這並非標準 DNS 記錄類型，且 BIND 不支援。如果將資源記錄集匯出至 BIND，系統會略過 ALIAS 記錄。如果區域有路由政策，系統會將其匯出為資源記錄資料 (rrdata) 為空的記錄。