SRS Registry Transactions¶
The following registry-only SRS XML transactions below can be used by the registry to query and update the SRS.
AdjustRegistrarAccount¶
Used to resolve “dodgy billing” errors in the SRS, or to generate credits for other reasons.
<NZSRSRequest VerMajor="1" VerMinor="0" RegistrarId="1">
<AdjustRegistrarAccount
ActionId="REF Credit internetnz.net.nz 2014-01-07"
DomainName="internetnz.net.nz"
ActionType="Credit"
Months="1"
RegistrarId="60">
<TransactionDate Year="2014" Month="01" Day="10" Hour="20" Minute="42" Second="47" />
<!-- 2014-01-10 20:42:47+13:00 -->
<BillPeriodStart Year="2013" Month="10" Day="17" Hour="10" Minute="24" Second="05" />
<!-- 2013-10-17 10:24:05+13:00 -->
<BillPeriodEnd Year="2013" Month="11" Day="17" Hour="10" Minute="24" Second="05" />
<!-- 2013-11-17 10:24:05+13:00 -->
<AuditText>
<![CDATA[Credit to 128 for 1 month renewal of internetnz.net.nz in 2014-01. Refer to WR#219789 ]]>
</AuditText>
</AdjustRegistrarAccount>
</NZSRSRequest>
AccessControlListAdd¶
Used to add or remove IP addresses or ranges from the ACL white/backlists.
Resource lists:
Resource |
List |
Description |
|---|---|---|
srs |
whitelist |
IP addresses allowed to connect to SRS as the given registrar |
r2 |
r3 |
r4 |
Add 127.0.0.1 to droplist ACL:
<NZSRSRequest RegistrarId="1" VerMajor="4" VerMinor="2">
<AccessControlListAdd ActionId="Add IP to droplist API 127.0.0.1" List="whitelist" Resource="droplist">
<AccessControlListEntry Address="127.0.0.1" Comment="Localhost - Main IP"/>
<AuditText>Add IP to whitelist ACL</AuditText>
</AccessControlListAdd>
</NZSRSRequest>
Add 127.0.0.1 to availability ACL:
<NZSRSRequest RegistrarId="1" VerMajor="4" VerMinor="2">
<AccessControlListAdd ActionId="Add IP to availability API 127.0.0.1" List="whitelist" Resource="availability">
<AccessControlListEntry Address="127.0.0.1" Comment="localhost - Availability API"/>
<AuditText>Whitelist add</AuditText>
</AccessControlListAdd>
</NZSRSRequest>
AccessControlListRemove¶
BilledUntilAdjustment¶
BuildDNSZoneFiles¶
DeferredIncomeDetailQry¶
DeferredIncomeSummaryQry¶
GenerateDomainReport¶
RunLogQry¶
RunLogCreate¶
RegistrarCreate¶
Registry transaction used to add a new registrar.
Syntax:
element.RegistrarCreate =
element RegistrarCreate {
attribute ActionId { UID },
attribute Name { text },
attribute AccRef { text },
attribute RegistrarId { RegistrarId },
attribute URL { text }?,
element.RegistrarPublicContact,
element.RegistrarSRSContact,
element.DefaultTechnicalContact,
element.EncryptKeys,
element.EPPAuth?,
element.Allowed2LDs?,
element.Roles?,
element.AuditText?
}
<NZSRSRequest VerMajor="1" VerMinor="0" RegistrarId="1">
<RegistrarCreate Name="Example Registrar" AccRef="n/a" URL="http://www.exampleregistrar.com" ActionId="Registrar-945_20160101" RegistrarId="945">
<RegistrarPublicContact Email="registry@exampleregistrar.com" Name="Crazy Domains FZ-LLC ">
<PostalAddress
Address1="80 Boulcott Street"
Address2=""
City="Wellington"
PostalCode="6011"
CountryCode="NZ"/>
<Phone CountryCode="64" AreaCode="4" LocalNumber="944 2222"/>
<Fax CountryCode="64" AreaCode="4" LocalNumber="844 2222"/>
</RegistrarPublicContact>
<RegistrarSRSContact Email="srs@exampleregistrar.com" Name="SRS Contact">
<PostalAddress
Address1="80 Boulcott Street"
Address2=""
City="Wellington"
PostalCode="6011"
CountryCode="NZ"/>
<Phone CountryCode="64" AreaCode="4" LocalNumber="944 2222"/>
<Fax CountryCode="64" AreaCode="4" LocalNumber="844 2222"/>
</RegistrarSRSContact>
<DefaultTechnicalContact Email="tech@exampleregistrar.com" Name="Technical Contact">
<PostalAddress
Address1="80 Boulcott Street"
Address2=""
City="Wellington"
PostalCode="6011"
CountryCode="NZ"/>
<Phone CountryCode="64" AreaCode="4" LocalNumber="944 2222"/>
<Fax CountryCode="64" AreaCode="4" LocalNumber="844 2222"/>
</DefaultTechnicalContact>
<EncryptKeys>
<EncryptKey/>
</EncryptKeys>
<EPPAuth Password="max14chars" />
<Allowed2LDs/>
<Roles/>
<AuditText>Initial Load</AuditText>
</RegistrarCreate>
</NZSRSRequest>
RegistrarUpdate¶
Transaction which can be used by both the registrar and registry to update the registrar profile. Certain settings such as the registrar name and GPG keys can only be changed by the registry.
Attribute / <Element> |
Required |
Note / Default value |
|---|---|---|
ActionID |
yes |
|
RegistrarPublicContact |
no |
|
RegistrarSRSContact |
no |
|
DefaultTechnicalContact |
no |
|
URL |
no |
|
RegistrarPublicContact |
no |
|
RegistrarSRSContact |
no |
|
DefaultTechnicalContact |
no |
|
EncryptKeys |
no |
|
EPPAuth |
no |
|
Allowed2LDs |
no |
|
Roles |
no |
|
AuditText |
no |
element.RegistrarCreate =
element RegistrarCreate {
attribute ActionId { UID },
attribute Name { text },
attribute AccRef { text },
attribute RegistrarId { RegistrarId },
attribute URL { text }?,
element.RegistrarPublicContact,
element.RegistrarSRSContact,
element.DefaultTechnicalContact,
element.EncryptKeys,
element.EPPAuth?,
element.Allowed2LDs?,
element.Roles?,
element.AuditText?
}
<RegistrarUpdate ActionId="Update 945 - Example 1">
<RegistrarPublicContact HandleId="public-945"/>
<RegistrarSRSContact HandleId="srs-945"/>
<DefaultTechnicalContact HandleId="default-945"/>
<EncryptKeys>
<EncryptKey><![CDATA[-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.4.10 (GNU/Linux)
mQENBFEvtokBCADEl7rbGaHBn5NhlMvvsEO3LthvkxLgLUIdpETm3ixwYrXT8Ayz
EbpXLQFbhB3MfUlUYbuzVSvLDtoVCo/pLOZI89SzzXmvlYGJzuKHNctZ5zis1eF6
xnJAr4tb0fAd2wzTELNslv8maIm4RunIJGWlGN4iSv4XXAv3YAFZzn6NFVA+LXBe
/D9N6C2H+TcwQYES76RQYd8aQJCYchuLH1RtIvJQnZFXAHpTyuUHk6lW22ARRWHI
mFhdlRAbUvvbmM9IWuFFuewlsqioX672knMcgAYA2xILfUxLEu6QK15SR0SKJoPP
sZfzrloEipUu5nkufTBClGJGmuo02koCyPA/ABEBAAG0EVNSU1RFU1QgRVBQIFBy
b3h5iQE+BBMBAgAoBQJRL7aJAhsDBQkDwmcABgsJCAcDAgYVCAIJCgsEFgIDAQIe
AQIXgAAKCRDSaqQhoywjG3eBCACiVwuL2xO9W9vFGy4Oaygk72kQ3QswWXgUOLca
VLH2U5P9nYSL+LD2OaqInyd4ctWkQ8Ek/wBXKUdte/HfrlJbX/wDWHAp8c6vkPAg
L0MLTJOIoWAxCy95CZBkimx8wfSB1OwPB4M6wnGrcqjYhk6ym8eXglczEgcLxLXK
INBhj2pzvIyHm7n/kxXZexqCQ/nwFvTro9aGJ1hSVPH7d3rgEyot5IAd1NhyjlCK
rsjBvp1WzxJPyQ8vRc8bBCC+yeqVui3lntzYAsv0PGlbjyeeWSJw/Fcuwt9hnxzK
dOFVvvQYz8Z8HYvI27AEmAqPFRJ5pjMmS9yZuuiDsNDkOObHuQENBFEvtokBCADd
xfj1tMK9eMt7kz39i47LEUU9HNpdbB3b3YW0MqBHazpB4AuV2QQlsvcgQO1hRFyP
MP0cbgW1mfumDBX25YWKlZtZJW9GZGJVmWsMCm2qE0L972+Md+RYs88tWouHmTqv
NcBgEERIpme3Txk9ePNovdAbxlhqt5ky9Cgql5tNAkUThin44og5QjyZQG8oSv1j
WD3zKew9pcJ6EiTyTdLYzhRj3OKLeFK3QLjVme+1tgLFIEs8HMTocCiW+KZyTkAk
6HL+tLspEmWsymgebQS4iaXTlHCxG4JyzND4ICYhlX0Rus65zJ7T9KOacbWryVTl
JgWPUiVqyHiBOEdoja/ZABEBAAGJASUEGAECAA8FAlEvtokCGwwFCQPCZwAACgkQ
0mqkIaMsIxtgAggApXwGMKApQr442TPF5dNJxXVtVK9o5rQKFOzSWp82TOdIiKaz
LEOwBTM0fH6ZJoTZs/LdbXrWtsTyFnJJqTQo68ZHoIB56Npz+m8Lc90C4TBtKyaE
TXn42d3av0vtXHixpnFiCaJ28x2587F5Mel7AzRi9y8pCZxZP9hhoCgmLKX7XwvS
osWFXRq8ViwzVReU+p+lt1K5HiQDoTaGm09avxSAlGWlspsI148U71/F9K2uN66P
tHHCjLBhJh/7hr2LKes/WS+Zyx7bccm7e4nFVJiIr3mD8saHr7UCiSYlLaKa+4hL
h798dDI28Ka+iP/VukUtes1bpLFuZxkfK2uG/g==
=3fJA
-----END PGP PUBLIC KEY BLOCK-----]]></EncryptKey>
<EncryptKey><![CDATA[-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.2.6 (GNU/Linux)
mQGiBEjbBQARBACkD+7m4xRpK7luxpHRYG1DGExBC7EopeXrfH8ddeOkzl1zj4l+
y2Qiu1UlW0kunGIhsH6Z1gx+SQBojw8ZmqO67TOaDVtY18a9/YWNb0lXaVL/IPIv
iQ6SXrKz4LpAcZJ8aJbLwcErBa683D9zvd1QSDdtstfN8TrgRg52eC9ROwCgvEj6
T9MdtRxDxj6NcRzawuw801cEAJ/HgapqjztWYf/DBTq2ZwUj6c/pumgctE6LuK03
5ukuBRrWS4RsnCbue5xDZUGeWAXrBI0VMpMbYmknx9igJeZvqTZjEA5fCjtmnC7Q
t8GJN5pf3j1zsBToBnynd7YnX1Bb3KJpTi/wdjsQohN6V5D/1SloPXPRSm6nANJd
SPsmA/94TEmMsm6tw+TUeFkbnd6bjI/5qBMHny8KWb1FbSWNs8sWr2Yw7lMbZVxj
PpWmfb5P//X2qLWYkL2QYadDiGoAUMEeJw40+HYoc+H02PcEL2sY4g8HjJV6j2JN
CktkDsZ8fjAzGSft4Qc3H1xgVYrGuixbPwf3tuJESPJyfAvCJLQwTlogUmVnaXN0
cnkgT1RFIDxyZWdpc3RyYXIuc3VwcG9ydEBpcG1pcnJvci5jb20+iF4EExECAB4F
AkjbBQACGwMGCwkIBwMCAxUCAwMWAgECHgECF4AACgkQjVK8Jqtikg0DcgCfU4KI
Ol91LAVGbOdqcgIayYK9zskAn0F+D3Gg7vQcwAhk4VZm5TfCBRVHuQINBEjbBQgQ
CACvRhDV+pU3ec4Eu9JlekDeXNINTGhdb/9krNMer1GtTDxqQlcJaHBKmUnrlJlf
8J3qJmRzvoBz8jLH9JPKUitr8dtsBWAhh60jonOgYwK9Y4d0CsMgfD9lzXbYU31W
luti8HqbSCeey06FPewqyj1nEGCQsnG9LC6nexbrA0SRlYsLnXJmKrGRr8/qGaoc
RwnZsGMcGpdMEPYz1NJ2ueTeJLUNqw4OcpKgPJPG4zZQNR7TMeePSzeCjGsN9WnY
/vR5c4H2/J0dNu0r4jTYztUk2HEJ86AzHO06jsoYnhdSxjJTkKe+VFYS/Z2QTQyY
39zeOAZSN93fFKR+fvl6TTm3AAMHB/4qKyDvM0kKXpGGhdqLwT0kwr00+da1lB7D
D5QSVAIICRd9PhpRwOKl2b4P+IdsBTG0EbH/FjSrGp1mZYeH4TQ2l+U8Bz3CxZ6Y
Dkji0gZ3nXKfuRcbXS8W+8nw92lsb80/LNAasxd1riPX+MoQy+SaEr6euhQHH6eP
J8tayo5nDspTzql53Ke588Q9KGdlwnmHHJb/610tXIT9xDLDPlMEGsYtz/lezzyA
hnK6S9nQiPwHaouO4el7yfklcoUdN4HYtp/kUITAnIkjjSUWE0Yp2mSyIYHwQXog
3Nua+x5SfiYiPOamD8CrqIX557jxs/OFO6UId2HNLC7mlqfhRB80iEkEGBECAAkF
AkjbBQgCGwwACgkQjVK8Jqtikg1angCeOz/TCIwa6ZPQFsmr2V3pSUGaOH4An0kY
LvahUDdp1vadFwuIWBL+iECY
=FlDQ
-----END PGP PUBLIC KEY BLOCK-----]]></EncryptKey>
<EncryptKey><![CDATA[-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.2.6 (GNU/Linux)
mQGiBFDBTZwRBACapB08aDWtIK/X7VqsWRHkW0oIpW6t9SkmbqJfL9aWtbAyaval
P/OF9fjLLEaYq8vdf5qOnUSGYgdedDckduv1hbeQcP0TjUkUgP6FBJo9hOcTaTRy
yOa9MzZ1r9MFlR0k7Avtd5H+Zi08Y9pJKDVRI36lAtjlV82jo52lr5i8HwCg8cYz
AUGH4owSHKWnOmMeFLQWA70D/i3ad144vLLRUNU2y5i6Q6xgqRxa63gFd1K5TSTL
yglfo+utSy/SGHbeD1UynUXKdKnMzNtzZI3JM9FfXvHAAyK8dXU/79FfE6x3B5S/
MLCXLoMeMu4xNcsb2AG9Bwzryi4wCiph+SSQjiy8339+YCzJ4o3QD8jPdsk8gWW2
/IRWA/9DWDP6Elqymcet+CfItKpBDjX2gfx4obRKjEV3GS9iww3RWoNB7JWA1FhC
IrNY0ocnlRJQeCcPZ86GYfR8bhlOPJ8QgDKoAPxKaLLZPt9hUJg70i42JtOdAsD4
LBuwo8GC72Y6WMWL6XFFAKHwZWLQgk4tu/A19VH/YftcmAgPb7Q7TlogUmVnaXN0
cmFyIFN1cHBvcnQgKE9URSkgPHJlZ2lzdHJhci5zdXBwb3J0QGlwbWlycm9yLmNv
bT6IXgQTEQIAHgUCUMFNnAIbAwYLCQgHAwIDFQIDAxYCAQIeAQIXgAAKCRATSsEM
5moZgxFNAKCWjFtNwcZYZ9J4kUKk078JdXlUhgCg4KHAvxtdhVB7yE4NsZzAENHu
6oS5AQ0EUMFNnBAEAMWoBpU/0xQXUZiJ7TgIcvGRVvvwml6wPwwWKm31PUe63SuY
qNo7o5DIMwllESiuPJlNGAvFTHLpsQA/8UGI+HfGx58FmgoIueX71oUVATkC4788
qAXR0pp9ihfuE+Vdjxwf9nNOLLWuUGmGFfFL02etv525EI+k359cDr5LUYiDAAMG
A/9XtMUtFaNfmAcQ5/FughXMGzSOCkt4hB1YlgfnA+PZN36cEue78cVeVx6iOEw6
FhQY1gntoTOIOBpRRl1UYykmRCCNbskEYCvYQu5xpjXu995i1IDiHtyFN1pSiKpO
J7zfJCkVCrU20DIgCptH/jlRSZ2dSUKQSh7UYn/qwVkaeIhJBBgRAgAJBQJQwU2c
AhsMAAoJEBNKwQzmahmDj2sAnA/BjvjsM7dBiAaR+4hlAm32ebjoAKDm8QE3DTXt
KEfyrmkm53K0wMSAhQ==
=OeWf
-----END PGP PUBLIC KEY BLOCK-----]]></EncryptKey>
</EncryptKeys>
<EPPAuth Password="max14chars"/>
<Roles>
<Role RoleName="Registrar"/>
<Role RoleName="Connect"/>
<Role RoleName="Whois"/>
<Role RoleName="Query"/>
<Role RoleName="CreateDomain"/>
<Role RoleName="UpdateDomain"/>
<Role RoleName="TransferDomain"/>
<Role RoleName="CancelDomain"/>
<Role RoleName="UncancelDomain"/>
<Role RoleName="UpdateRegistrar"/>
<Role RoleName="QueryRegACL"/>
</Roles>
<AuditText>Re-set EPP password and add EPP roles</AuditText>
</RegistrarUpdate>