新增、更新及刪除記錄

主控台

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

   前往 Cloud DNS 區域

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

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

4. 在「Create record set」頁面的「DNS name」欄位中，輸入 DNS 區域的子網域，例如 mail。系統會自動在結尾加上尾點。

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

   小寫的 at 符號 (@) 不會自動建立頂層記錄。如要在網域頂層建立資源記錄，請將「DNS 名稱」欄位留空。

5. 選取「Resource record type」(資源記錄類型)，例如 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 名稱會以此區域的 DNS 名稱做為後置字串，例如 test.example.com
• RR_DATA：與資源記錄集相關聯的任意值，例如 198.51.100.5；您也可以輸入多個值，rrdata1 rrdata2 rrdata3，例如 198.51.100.5 10.2.3.4...
• TTL：解析器快取此資源記錄集合的 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：解析器快取此資源記錄集合的 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. 按一下要查看詳細資料的資源記錄集。

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

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 名稱會以此區域的 DNS 名稱做為後置字串，例如 test.example.com
• RR_DATA：與資源記錄集相關聯的任意值，例如 198.51.100.5；您也可以輸入多個值，rrdata1 rrdata2 rrdata3，例如 198.51.100.5 10.2.3.4...
• TTL：解析器快取此資源記錄集合的 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：解析器快取此資源記錄集合的 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. 按一下「Delete record sets」。

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 記錄是否正確。

   • 匯入記錄集時，請將代表區域頂層的 at 符號 (@) 移除，在 BIND 區域格式檔案中，如果 DNS 名稱為 example.com，則 @ 符號代表 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) 的記錄。