REST Resource: domain

משאב: RdapDomain

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

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

שרת RdapName

אובייקט שרת שמות כפי שמוגדר בסעיף 5.2 של RFC 7483. חסרים המאפיינים " לטיפול", "ישויות", "סטטוס", "הערות", "קישורים", "יציאה43", "אירועים".

ייצוג 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.

נתוני מפתח

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

ייצוג 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

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

handle

string

מחרוזת המייצגת מזהה ייחודי של המרשם של הישות.

vcardArray[]

value (Value format)

jCard עם הפרטים ליצירת קשר עם הישות

roles[]

string

מערך של מחרוזות, כל אחת מהן מייצגת את הקשר בין אובייקט לאובייקט שמכיל אותו.

publicIds[]

object (PublicId)

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

entities[]

object (RdapEntity)

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

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

string

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

remarks[]

object (Remark)

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

port43

string

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

events[]

object (Event)

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

מזהה ציבורי

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

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

string

סוג התעודה המזהה. לדוגמה: "IANA Registrar ID".

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 של דומיינים לפי שם.