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

应始终设置为字符串“网域”。

handle

string

一个字符串，表示网域对象实例的注册表唯一标识符。
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

错误说明。

Rdap 域名服务器

RFC 7483 第 5.2 节中定义的域名服务器对象。规范中缺少“handle”、“entity”、“status”、“remarks”、“links”、“port43”、“events”。

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

string

应始终设置为字符串“nameserver”。

ldhName

string

一个字符串，表示域名服务器的注册表唯一标识符（如 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

网域的 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 记录。

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 记录的摘要类型字段。

密钥数据

规范中缺少“events”和“links”。

JSON 表示法 
{
  "flags": number,
  "protocol": number,
  "publicKey": string,
  "algorithm": number
}
字段
flags

number

DNSKEY 记录中的标记字段值（由 RFC 4034 指定）。

protocol

number

RFC 4034 指定的 DNSKEY 记录的协议字段值。

publicKey

string

DNSKEY 记录中的公钥（由 RFC 4034 指定）。

algorithm

number

DNSKEY 记录的算法字段，由 RFC 4034 指定。

Rdap 实体

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

ID 类型。例如：“IANA 注册商 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 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒。示例："2014-10-02T15:01:23.045123456Z"。
eventActor

string

事件操作者的句柄。例如：“SOMEID-LUNARNIC”。不过，有一种类型的事件不能有 eventActor。如需了解此类事件，请参阅 RFC 7483 的第 5.1 节。

方法

get

 根据名称查找网域的 RDAP 信息。