4. Antworten auf Suchanfragen

Dieser Abschnitt bewahrt den RFC-Text zur RDAP-RIR-Suche, einschliesslich rirSearch1, ips, autnums, ipSearchResults, autnumSearchResults, Beziehungs-Links, JSON-Beispielen, Antwortverhalten, Rueckwaertssuche, Konformitaet und IANA-Registrierungen.

Originaler RFC-Text

4.  Antworten auf Suchanfragen

4.1.  Suchen mit Einzelergebnis

   Die Relationen "rdap-up" und "rdap-top" sind Suchen mit
   Einzelergebnis.  Bei der Verarbeitung dieser Suchen gibt der Server,
   falls es ein Suchergebnis gibt, dieses Objekt so zurueck, als waere es
   direkt ueber eine Lookup-URL angefordert worden (siehe Section 3.1 von
   [RFC9082]).  Gibt es kein Suchergebnis, gibt der Server den
   HTTP-Antwortcode 404 (Not Found) [RFC9110] zurueck.

4.2.  Suchen mit mehreren Ergebnissen

   Die Relationen "rdap-down" und "rdap-bottom" sind Suchen mit mehreren
   Ergebnissen.  Wie bei [RFC9083] haben Antworten auf diese Suchen die
   Form eines Arrays von Objektinstanzen, wobei jede Instanz eine fuer die
   Suche geeignete Objektklasse ist (d. h. eine Suche, die mit /ips
   beginnt, liefert ein Array von IP-Netzobjektinstanzen, und eine Suche,
   die mit /autnums beginnt, liefert ein Array von Autonomous-System-
   Number-Objektinstanzen).  Die IP-Netzobjektklasse ist in Section 5.4
   von [RFC9083] definiert, und die Autonomous-System-Number-Objektklasse
   ist in Section 5.5 von [RFC9083] definiert.  Die Objektinstanz-Arrays
   sind im Antwortobjekt enthalten.

   Die Namen der Arrays lauten wie folgt:

   *  fuer /ips-Suchen lautet das Array "ipSearchResults"; und

   *  fuer /autnums-Suchen lautet das Array "autnumSearchResults".

   Das Folgende ist ein gekuerztes Beispiel einer Antwort fuer eine
   IPv4-Netzsuche:

   {
     "rdapConformance": [ "rdap_level_0", "rirSearch1",
                          "ips", "ipSearchResults", ... ],
     ...
     "ipSearchResults": [
       {
         "objectClassName": "ip network",
         "handle": "XXXX-RIR",
         "startAddress": "192.0.2.0",
         "endAddress": "192.0.2.127",
         ...
       },
       {
         "objectClassName": "ip network",
         "handle": "YYYY-RIR",
         "startAddress": "192.0.2.0",
         "endAddress": "192.0.2.255",
         ...
       }
     ]
   }

                   Abbildung 8: Antwort auf IPv4-Netzsuche

   Das Folgende ist ein gekuerztes Beispiel einer Antwort fuer eine
   IPv6-Netzsuche:

   {
     "rdapConformance": [ "rdap_level_0", "rirSearch1",
                          "ips", "ipSearchResults", ... ],
     ...
     "ipSearchResults": [
       {
         "objectClassName": "ip network",
         "handle": "XXXX-RIR",
         "startAddress": "2001:db8:a::",
         "endAddress": "2001:db8:a:ffff:ffff:ffff:ffff:ffff",
         ...
       },
       {
         "objectClassName": "ip network",
         "handle": "YYYY-RIR",
         "startAddress": "2001:db8::",
         "endAddress": "2001:db8:ffff:ffff:ffff:ffff:ffff:ffff",
         ...
       }
     ]
   }

                   Abbildung 9: Antwort auf IPv6-Netzsuche

   Das Folgende ist ein gekuerztes Beispiel einer Antwort auf eine Suche
   nach Autonomous System Number:

   {
     "rdapConformance": [ "rdap_level_0", "rirSearch1",
                          "autnums", "autnumSearchResults", ... ],
     ...
     "autnumSearchResults": [
       {
         "objectClassName": "autnum",
         "handle": "XXXX-RIR",
         "startAutnum": 64496,
         "endAutnum": 64496,
         ...
       },
       {
         "objectClassName": "autnum",
         "handle": "YYYY-RIR",
         "startAutnum": "64497",
         "endAutnum": "64497",
         ...
       }
     ]
   }

                       Abbildung 10: Antwort auf ASN-Suche

   Antworten auf Beziehungssuchen fuer Reverse-Domain-Objekte haben gemaess
   [RFC9083] dieselbe Form wie eine Standardantwort auf eine Domainsuche.

   Wenn die Suche vom Server verarbeitet werden kann, es aber keine
   Suchergebnisse gibt, gibt der Server den HTTP-Antwortcode 404 (Not
   Found) [RFC9110] zurueck, wobei der Antwortkoerper ein leeres
   Ergebnisarray enthaelt.