REST Resource: domain

משאב: RdapDomain

אובייקט דומיין כפי שמוגדר בסעיף 5.3 של RFC 7483. חסרים 'וריאציות', 'publicIds' או 'רשת' במפרט.

ייצוג 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, כפי שמתואר בסעיף 3 של RFC 7483.

unicodeName

string

מחרוזת שמכילה שם דומיין עם תוויות U, כפי שמתואר בסעיף 3 ב-RFC 7483.

nameservers[]

object (RdapNameserver)

מערך אובייקטים של שרתי שמות.

secureDNS

object (SecureDns)

השם של השדה הזה הוא פתרון עקיף לכך שהוא מקודד בשדה JSON בשם 'secureDNS'.

entities[]

object (RdapEntity)

צריך ליצור קשר עם יישויות מהדומיין הזה.

status[]

string

רשימת סטטוסים שחלים על הישות. לדוגמה: "העדכון אסור".

remarks[]

object (Remark)

הערות שקשורות לדומיין.

port43

string

שרת WHOIS לדומיין הזה. דוגמה: "Whois.google.com".

events[]

object (Event)

אירועים שמשפיעים על הדומיין הזה.

jsonResponse

object (HttpBody)

תשובת HTTP עם סוג התוכן המוגדר כ-'application/json+rdap'.

rdapConformance[]

string

רמת תאימות ל-RDAP. יש למלא אותו רק אם הדומיין הוא אובייקט ברמה העליונה של תשובה.

notices[]

object (Notice)

הודעות שקשורות לדומיין. יש למלא אותו רק אם הדומיין הוא אובייקט ברמה העליונה של תשובה.

lang

string

קוד שפת שגיאה. שדות של פרטי תגובה של שגיאות מוגדרים בסעיף 6 של RFC 7483.

errorCode

number

קוד HTTP של שגיאה. דוגמה: "501".

title

string

כותרת השגיאה.

description[]

string

תיאור השגיאה.

RdapNameserver

אובייקט של שרת שמות כפי שמוגדר בסעיף 5.2 של RFC 7483. חסרים 'כינוי', 'ישויות', 'סטטוס', 'remarks', 'קישורים', 'port43', 'אירועים' במפרט.

ייצוג JSON 
{
  "objectClassName": string,
  "ldhName": string,
  "unicodeName": string,
  "ipAddresses": [
    {
      object (IpAddressObject)
    }
  ]
}
שדות
objectClassName

string

צריך תמיד להגדיר את המחרוזת "nameserver".

ldhName

string

מחרוזת שמייצגת מזהה ייחודי במרשם של שרת השמות, כפי שמתואר בסעיף 3 ב-RFC 7483.

unicodeName

string

מחרוזת שמכילה את השם של DNS Unicode של שרת השמות, כפי שמתואר בסעיף 3 של RFC 7483.

ipAddresses[]

object (IpAddressObject)

כתובות ה-IP של שרת השמות הזה.

IpAddressObject

ייצוג JSON 
{
  "v4": [
    string
  ],
  "v6": [
    string
  ]
}
שדות
v4[]

string

מערך מחרוזות שמכילות כתובות IPv4 של שרת השמות.

v6[]

string

מערך מחרוזות שמכילות כתובות IPv6 של שרת השמות.

SecureDns

נתוני DNS של הדומיין. חסרים "אירועים", "קישורים" במפרט

ייצוג JSON 
{
  "zoneSigned": boolean,
  "delegationSigned": boolean,
  "maxSigLife": number,
  "dsData": [
    {
      object (DsData)
    }
  ],
  "keyData": [
    {
      object (KeyData)
    }
  ]
}
שדות
zoneSigned

boolean

הערך הוא True אם האזור נחתם. אחרת, הערך הוא False.

delegationSigned

boolean

הערך הוא True אם יש רשומות DS ברמת ההורה, False אם לא.

maxSigLife

number

מייצג את משך החיים של החתימה, בשניות, שיש להשתמש בו במהלך יצירת רשומת ה-RRSIG DS באזור ההורה.

dsData[]

object (DsData)

רשומות DNS DS כפי שמתואר על ידי RFC 4034.

keyData[]

object (KeyData)

רשומות DNSKEY של הדומיין כפי שצוין על ידי RFC 4034.

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

חסרים "אירועים", "קישורים" במפרט

ייצוג JSON 
{
  "flags": number,
  "protocol": number,
  "publicKey": string,
  "algorithm": number
}
שדות
flags

number

ערך שדה סימון ברשומת DNSKEY כפי שצוין על ידי RFC 4034.

protocol

number

ערך שדה הפרוטוקול של רשומת ה-DNSKEY כפי שצוין ב-RFC 4034.

publicKey

string

מפתח ציבורי ברשומת DNSKEY כפי שצוין על ידי RFC 4034.

algorithm

number

שדה אלגוריתם של רשומת DNSKEY כפי שצוין על ידי RFC 4034.

RdapEntity

אובייקט ישות כפי שמוגדר בסעיף 5.1 של RFC 7483. חסר "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)

המזהה הציבורי של הישות, אם יש כזו.

entities[]

object (RdapEntity)

לישויות יכולות להיות גם ישויות אחרות מוטמעות במערך. אפשר להשתמש כך כדי לבנות מודל של ארגון עם אנשים ספציפיים שאחראים על תפקידי אחריות.

אנחנו משתמשים בשם הזה כדי לייצג איש קשר בנושא התנהלות פוגעת: ישויות עם תפקיד "רשם" באובייקט דומיין צריכות להיות אובייקט של ישות פנימית עם התפקיד abuse (שימוש לרעה) ו- vCard תואם עם כתובות הטלפון וכתובות האימייל של איש הקשר בנושא התנהלות פוגעת.
status[]

string

רשימת סטטוסים שחלים על הישות. דוגמה: 'פרטי'.

remarks[]

object (Remark)

הערות שקשורות לישות.

port43

string

שרת WHOIS לדומיין הזה. דוגמה: "Whois.google.com".

events[]

object (Event)

אירועים שהתרחשו בישות הזו.

PublicId

מזהים ציבוריים שמוגדרים בסעיף 4.8 של RFC 7483.

ייצוג JSON 
{
  "type": string,
  "identifier": string
}
שדות
type

string

סוג המזהה. דוגמה: "מזהה רשם IANA".

identifier

string

הטקסט של התעודה המזהה. דוגמה: '1'.

הערה

מוסיף הערות לאובייקט שמוגדר בסעיף 4.3 של RFC 7483.

ייצוג JSON 
{
  "type": string,
  "title": string,
  "description": [
    string
  ],
  "links": [
    {
      object (Link)
    }
  ]
}
שדות
type

string

צריך להזין ערכים בהתאם לסעיף 10.2.1 של RFC 7483 הספציפי לאובייקט יחיד: "האובייקט נחתך עקב הרשאה", "האובייקט נקטע עקב טעינה עודפת", "האובייקט נחתך עקב סיבות בלתי מוסברות", "האובייקט צונזר עקב הרשאה".

title

string

כותרת התגובה.

description[]

string

הטקסט בפועל של ההערה.

אירוע

אובייקט אירועים שמוגדר בסעיף 4.5 של RFC 7483.

ייצוג JSON 
{
  "eventAction": string,
  "eventDate": string,
  "eventActor": string,
  "links": [
    {
      object (Link)
    }
  ]
}
שדות
eventAction

string

הפעולה שהתרחשה באירוע הזה. דוגמה: 'רישום'.

eventDate

string (Timestamp format)

חותמת הזמן של האירוע. דוגמה: '1990-12-31T23:59:59Z'.

חותמת זמן בפורמט 'Zulu' לפי RFC3339 UTC, מדויקת עד ננו-שניות. דוגמה: "2014-10-02T15:01:23.045123456Z"
eventActor

string

הכינוי של גורם האירוע. דוגמה: "SOMEID-LUNARNIC". עם זאת, יש סוג אחד של אירוע שאסור להגדיר בו את ה-eventActor. למידע על סוג האירוע הזה, אפשר לעיין בסעיף 5.1 ב-RFC 7483.

שיטות

get

 מחפשים פרטי RDAP לדומיין לפי שם.