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

一个字符串，表示网域对象实例的注册表唯一标识符。

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

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

如果区域已签名，则为 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 记录的 Digest 字段。

digestType

number

DNS DS 记录的摘要类型字段。

KeyData

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

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

number

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

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)

实体还可以在数组中嵌入其他实体。此模型可用于建立包含履行指定责任角色的特定人员的组织模型。

我们使用此 ID 来表示滥用联系人：网域对象内具有角色“registrar”的实体应该具有角色为“abuse”的内部实体对象，以及包含滥用行为联系人的电话号码和电子邮件地址的相应 vCard。
status[]

string

应用于实体的状态列表。例如：“private”。

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

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 信息。