# Auftrag domainUPDATE

Funktion

Der Auftrag dient dazu, Daten einer Domain zu ändern.

Voraussetzungen

Der Auftrag kann nur durchgeführt werden, wenn diese Domain bereits existiert und in der Verwaltung des RegAccs liegt, der den Auftrag erteilt.

Besonderheiten

- Der Inhaber einer Domain kann mit einem UPDATE nicht geändert werden. Hierfür must du den Auftrag CHHOLDER benutzen.
- Wenn du optionale Schlüsselwörter weglässt, werden vorhandene Werte dieser Schlüsselwörter gelöscht bzw. mit den Defaultwerten belegt.
- Wenn bei einem UPDATE-Auftrag neue Nameserver angegeben werden und dafür der Predelegation Check fehlschlägt, wird der Auftrag mit einem "Error" abgewiesen, und die Inhaberdaten nicht geändert.
- Durch einen Domain UPDATE-Auftrag kann sich die Reihenfolge der Nameserver ändern. In der Abfrage mit dem Domain INFO-Auftrag wird die Anordnung der Nameserver immer gleich ausgeben. Ein erneutes Update kann die Reihen folge wieder ändern.

Verifikation

- Ein Domain UPDATE-Auftrag löst automatisch eine Risikobewertung aus.

- Ein Domain UPDATE ist weiterhin möglich, wenn Kontakte ohne Telefonnummer oder E-Mail verwendet werden.

- Bei Übergabe an das Risk-Assessment wird eine Info erzeugt, wenn der neue Protokollstatus zu "pendingCreate" wechselt (Übergang "failed" → "pendingCreate").

Auftragsparameter

Ein Auftrag setzt sich zusammen aus den Feldern des Datenobjekts Domain und weiteren Parametern, die nachfolgend beschrieben werden:

K/V-Schlüsselwort | XML-Namensraum und Element | Vorkommen min - max | Typ / Länge | Wertebereich | Beschreibung
--- | --- | --- | --- | --- | ---
Action | domain:update | 1 | enumeration | update-erule | Auftragstyp
Version | - | 1 | enumeration | version-erule | Version, nur für Aufträge im Key/Value-Format relevant.
CtId | ctid | 0 - 1 | token 3 - 64 | Jedes sichtbare Unicode-Zeichen (nach Unicode Version 3.1) | Eindeutige Transaktions-ID vom Client

Häufige Fehler

- Die im Auftrag verwendete Domain existiert nicht.
- Ein im Auftrag angegebener Contact erfüllt nicht die Voraussetzungen, für die ihm zugedachte Rolle.
- Der im Auftrag angegebene Holder ist nicht identisch mit dem aktuellen Holder.

## Beispiele

- xml
- k/v

Kopieren

format: xml
request: domainUPDATE

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <registry-request xmlns="http://registry.denic.de/global/5.0" xmlns:domain="http://registry.denic.de/domain/5.0" xmlns:dnsentry="http://registry.denic.de/dnsentry/5.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <domain:update>
        <domain:handle>domain-example-nsentry.de</domain:handle>
        <domain:contact role="holder">DENIC-1000022-EXAMPLE-XML-PERSON</domain:contact>
        <domain:contact role="abusecontact">DENIC-1000022-EXAMPLE-XML-GR</domain:contact>
        <domain:contact role="generalrequest">DENIC-1000022-EXAMPLE-XML-ABUSE</domain:contact>
        <dnsentry:dnsentry xsi:type="dnsentry:A">
          <dnsentry:owner>domain-example-nsentry.de</dnsentry:owner>
          <dnsentry:rdata>
            <dnsentry:address>81.91.170.12</dnsentry:address>
          </dnsentry:rdata>
        </dnsentry:dnsentry>
      </domain:update>
      <ctid>xml-74ba5156</ctid>
    </registry-request>

Kopieren

format: xml
response: domainUPDATE
status: pendingCreate

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    <?xml version="1.0" encoding="UTF-8"?>

    <registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
      <tr:transaction>
        <tr:stid>a503e644-635c-4253-b598-84d0c2296a97</tr:stid>
        <tr:result>success</tr:result>
        <tr:ctid>xml-74ba5155</tr:ctid>
        <tr:result>success</tr:result>
        <tr:message level="info" code="53000080014">
          <tr:text>Domain "Status" is "pendingCreate"</tr:text>
        </tr:message>
      </tr:transaction>
    </registry-response>

Kopieren

format: k/v
request: domainUPDATE

    1
    2
    3
    4
    5
    6
    7
    Version: 5.0
    Action: UPDATE
    Domain: domain-example-nsentry.de
    Holder: DENIC-1000022-EXAMPLE-PERSON
    Generalrequest: DENIC-1000022-EXAMPLE-GR
    Abusecontact: DENIC-1000022-EXAMPLE-ABUSE
    Nsentry: domain-example-nsentry.de IN A 127.0.0.1

Kopieren

format: k/v
response: domainUPDATE
status: pendingCreate

    1
    2
    3
    Result: success
    STID: afdd1680-6d5e-4e94-a77a-8ef4a267c6b1
    Info: 53000080014 Domain "Status" is "pendingCreate"