Update keygroup

Purpose

to update the contents of a keygroup.

Note

a keygroup update updates the whole object at once (there are no <add>, <chg> or <rem> sections as with others EPP objects).

The command structure is identical to the one for the <create> nsgroup and has the same remarks.

Please refer to the examples to see a complete request.

Examples

An update keygroup command looks like:

<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
    xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1">
  <command>
    <update>
      <keygroup:update xmlns:keygroup="http://www.dns.be/xml/epp/keygroup-1.0">
      <keygroup:name>mykeygroup</keygroup:name>
        <keygroup:key>
          <secDNS:flags>257</secDNS:flags>
          <secDNS:protocol>3</secDNS:protocol>
          <secDNS:alg>8</secDNS:alg>
          <secDNS:pubKey>AwEAAeJ11kXTLdxgQvU0vZx72vGq3jQ8uCySa6LlUG5AKTtzOVorAAAA</secDNS:pubKey>
        </keygroup:key>
        <keygroup:key>
          <secDNS:flags>257</secDNS:flags>
          <secDNS:protocol>3</secDNS:protocol>
          <secDNS:alg>8</secDNS:alg>
          <secDNS:pubKey>AwEAAeJ11kXTLdxgQvU0vZx72vGq3jQ8uCySa6LlUG5AKTtzOVorBBBB</secDNS:pubKey>
        </keygroup:key>
      </keygroup:update>
    </update>
    <clTRID>update-keygroup</clTRID>
  </command>
</epp>

In case of successful update, the EPP server responds with a standard EPP response message:

<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <response>
    <result code="1000">
      <msg>Command completed successfully</msg>
    </result>
    <trID>
      <clTRID>update-keygroup</clTRID>
      <svTRID>dnsbe-342998</svTRID>
    </trID>
  </response>
</epp>

Note

When updating a keygroup, you are replacing all existing keys by the set provided in the update command. So, if you want to keep the existing keys and just add another one, you need to respecify the old ones and add the new one.