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 位址的字串陣列。

安全型

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

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

boolean

如果區域已簽署，則傳回 True，否則傳回 False。
delegationSigned

boolean

如果父項中有 DS 記錄，則傳回 True，否則為 False。
maxSigLife

number

代表在父項區域中建立 RRSIG DS 記錄時使用的簽名生命週期。
dsData[]

object (DsData)

DNS DS 記錄，如 RFC 4034 中所述。
keyData[]

object (KeyData)

RFC 4034 所指定的網域 DNSKEY 記錄。

DSD

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 記錄的摘要類型欄位。

金鑰資料

規格缺少「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

代表實體的登錄專屬識別碼的字串。
vcardArray[]

value (Value format)

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

string

字串陣列，每個字串都代表物件與其最接近的包含物件之間的關係。

publicIds[]

object (PublicId)

實體的公開 ID (如果有的話)。
entities[]

object (RdapEntity)

實體也可以將其他實體嵌入陣列中。這個機構可用於為特定成員擔任特定職責，為機構建立模型。

我們用這個來代表濫用的聯絡人： 網域物件中具備「註冊商」角色的實體應該具有「abuse」角色的內部實體物件，以及具有濫用聯絡人聯絡人的電話號碼和電子郵件地址的相應的 vCard 物件。
status[]

string

套用至實體的狀態清單。例如「private」。
remarks[]

object (Remark)

與實體相關的備註。

port43

string

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

events[]

object (Event)

此實體發生的事件。

公開 ID

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

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

string

身分證件類型。例如：「IANA Registrar ID」。
identifier

string

ID 的文字。例如：「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 資訊。