REST Resource: domain

資源：RdapDomain

RFC 7483 第 5.3 節中定義的網域物件。規格中缺少「variants」、「publicIds」、「network」。

JSON 表示法 
{
  "objectClassName": string,
  "handle": string,
  "ldhName": string,
  "unicodeName": string,
  "nameservers": [
    {
      object (RdapNameserver)
    }
  ],
  "secureDNS": {
    object (SecureDns)
  },
  "entities": [
    {
      object (RdapEntity)
    }
  ],
  "status": [
    string
  ],
  "remarks": [
    {
      object (Remark)
    }
  ],
  "links": [
    {
      object (Link)
    }
  ],
  "port43": string,
  "events": [
    {
      object (Event)
    }
  ],
  "jsonResponse": {
    object (HttpBody)
  },
  "rdapConformance": [
    string
  ],
  "notices": [
    {
      object (Notice)
    }
  ],
  "lang": string,
  "errorCode": number,
  "title": string,
  "description": [
    string
  ]
}
欄位
objectClassName

string

請一律設為「domain」字串。

handle

string

代表網域物件執行個體註冊資料庫專屬 ID 的字串。
ldhName

string

一種字串，說明 LDH 格式的網域名稱，如 RFC 7483 第 3 節所述。
unicodeName

string

包含網域名稱和 U 標籤的字串，如 RFC 7483 的第 3 節所述。
nameservers[]

object (RdapNameserver)

網域名稱伺服器物件的陣列。
secureDNS

object (SecureDns)

這個欄位的名稱是替代方案，因此會將格式轉換為名稱為「secureDNS」的 JSON 欄位。

entities[]

object (RdapEntity)

聯絡這個網域的實體。

status[]

string

實體套用的狀態清單。例如：「禁止更新」。
remarks[]

object (Remark)

與網域相關的附註。

port43

string

這個網域的 WHOIS 伺服器。例如「whois.google.com」。

events[]

object (Event)

影響這個網域的事件。
jsonResponse

object (HttpBody)

內容類型設為「application/json+rdap」的 HTTP 回應。
rdapConformance[]

string

RDAP 符合等級。只有在網域是回應的頂層物件時，才需要填寫。
notices[]

object (Notice)

與網域相關的通知。只有在網域是回應的頂層物件時，才需要填寫。
lang

string

錯誤代碼。RFC 7483 第 6 節中定義的錯誤回應資訊欄位。
errorCode

number

錯誤 HTTP 代碼。例如：「501」。
title

string

錯誤標題。

description[]

string

錯誤說明。

RdapNameserver

RFC 7483 第 5.2 節中定義的網域名稱伺服器物件。規格中缺少「handle」、「entities」、「status」、「remarks」、「links」、「port43」、「events」。

JSON 表示法 
{
  "objectClassName": string,
  "ldhName": string,
  "unicodeName": string,
  "ipAddresses": [
    {
      object (IpAddressObject)
    }
  ]
}
欄位
objectClassName

string

請一律設為「nameserver」字串。
ldhName

string

代表網域名稱伺服器登錄檔專屬 ID 的字串，如 RFC 7483 第 3 節所述。
unicodeName

string

包含名稱伺服器 DNS Unicode 名稱的字串，如 RFC 7483 第 3 節所述。

ipAddresses[]

object (IpAddressObject)

這個網域名稱伺服器的 IP 位址。

IpAddressObject

JSON 表示法 
{
  "v4": [
    string
  ],
  "v6": [
    string
  ]
}
欄位
v4[]

string

包含網域名稱伺服器 IPv4 位址的字串陣列。
v6[]

string

包含網域名稱伺服器 IPv6 位址的字串陣列。

SecureDns

網域的 DNS 資料。缺少規格中的「events」和「links」。

JSON 表示法 
{
  "zoneSigned": boolean,
  "delegationSigned": boolean,
  "maxSigLife": number,
  "dsData": [
    {
      object (DsData)
    }
  ],
  "keyData": [
    {
      object (KeyData)
    }
  ]
}
欄位
zoneSigned

boolean

如果可用區已經過簽署，傳回「是」，否則傳回「否」。
delegationSigned

boolean

如果父項中有 DS 記錄，則為「true」，否則傳回「false」。

maxSigLife

number

代表在父項可用區建立 RRSIG DS 記錄時要使用的簽章生命週期 (以秒為單位)。

dsData[]

object (DsData)

依據 RFC 4034 規定的 DNS DS 記錄。
keyData[]

object (KeyData)

RFC 4034 指定網域的 DNSKEY 記錄。

DsData

JSON 表示法 
{
  "keyTag": number,
  "algorithm": number,
  "digest": string,
  "digestType": number
}
欄位
keyTag

number

DNS DS 記錄的鍵標記欄位。

algorithm

number

DNS DS 記錄的演算法欄位。

digest

string

DNS DS 記錄的摘要欄位。

digestType

number

DNS DS 記錄的摘要類型欄位。

KeyData

缺少規格中的「events」和「links」。

JSON 表示法 
{
  "flags": number,
  "protocol": number,
  "publicKey": string,
  "algorithm": number
}
欄位
flags

number

依據 RFC 4034 指定的 DNSKEY 記錄來標記欄位值。
protocol

number

RFC 4034 指定 DNSKEY 記錄的通訊協定欄位值。
publicKey

string

根據 RFC 4034 指定的 DNSKEY 記錄中的公開金鑰，
algorithm

number

RFC 4034 指定 DNSKEY 記錄的演算法欄位。

RdapEntity

RFC 7483 第 5.1 節中定義的實體物件。規格中缺少「asEventActor」、「networks」、「autnums」。

JSON 表示法 
{
  "objectClassName": string,
  "handle": string,
  "vcardArray": [
    value
  ],
  "roles": [
    string
  ],
  "publicIds": [
    {
      object (PublicId)
    }
  ],
  "entities": [
    {
      object (RdapEntity)
    }
  ],
  "status": [
    string
  ],
  "remarks": [
    {
      object (Remark)
    }
  ],
  "links": [
    {
      object (Link)
    }
  ],
  "port43": string,
  "events": [
    {
      object (Event)
    }
  ]
}
欄位
objectClassName

string

應一律設為「entity」字串。
handle

string

代表實體登錄檔專屬 ID 的字串。
vcardArray[]

value (Value format)

含有實體聯絡資訊的 jCard
roles[]

string

字串陣列，每個字串代表物件與最接近的物件之間的關係。
publicIds[]

object (PublicId)

實體的公開 ID (如有)。

entities[]

object (RdapEntity)

實體也可以在陣列中嵌入其他實體。這可以用來建立機構模型，由特定人員擔任指定責任的員工。

我們會以此做為濫用聯絡人：網域物件中具備「註冊商」角色的實體，應具有具備「abuse」(濫用情形) 角色的內部實體物件，以及一個包含濫用聯絡人電話和電子郵件地址的對應 vCard。
status[]

string

實體套用的狀態清單。例如：「私人」。
remarks[]

object (Remark)

與實體相關的註解。

port43

string

這個網域的 WHOIS 伺服器。例如「whois.google.com」。

events[]

object (Event)

這個實體發生的事件。

PublicId

RFC 7483 第 4.8 節中定義的公開 ID。

JSON 表示法 
{
  "type": string,
  "identifier": string
}
欄位
type

string

身分證件類型。例如：「IANA 註冊商 ID」。
identifier

string

身分證件文字。例如：「1」。

備註

標示 RFC 7483 第 4.3 節中定義的物件。

JSON 表示法 
{
  "type": string,
  "title": string,
  "description": [
    string
  ],
  "links": [
    {
      object (Link)
    }
  ]
}
欄位
type

string

根據 RFC 7483 第 10.2.1 節的規定，輸入單一物件的值：「因授權而遭到截斷」、「因載入過多而遭到截斷的物件」、「因無法解釋的原因導致物件遭到截斷」、「因授權而遭到遮蓋」。
title

string

評論標題。

description[]

string

附註的實際文字。

活動

RFC 7483 第 4.5 節中定義的事件物件。

JSON 表示法 
{
  "eventAction": string,
  "eventDate": string,
  "eventActor": string,
  "links": [
    {
      object (Link)
    }
  ]
}
欄位
eventAction

string

這個事件中發生的動作。例如：「註冊」。
eventDate

string (Timestamp format)

事件時間戳記。例如：「1990-12-31T23:59:59Z」。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，範例："2014-10-02T15:01:23.045123456Z"。
eventActor

string

事件執行者的處理常式。例如：「SOMEID-LUNARNIC」。不過，有些類型的事件不能包含 eventActor。如要進一步瞭解該事件類型，請參閱 RFC 7483 的 5.1 節。

方法

get

 依名稱查詢網域的 RDAP 資訊。