Retrieve zone information (GET /v1.0/hostedzone/{zoneId})
Retrieves zone information.
Specification of the zone information to be retrieved is performed using the zone ID which is included in the request URL.
Zone and name server information are retrieved.
*The zone ID is the same value as the zone name.
Request headers
n/a
Request parameters
n/a
Request elements
n/a
HTTP status
Status
The following error codes can be returned for the request.
- 200:
- Normal completion
- 400:
- Invalid zone ID
- 404:
- A zone with the specified ID does not exist
| Data type | Cardinality |
|---|---|
| Int | 1..1 |
Response elements (normal completion)
GetHostedZoneResponse
Envelope of the response.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| - | 1..1 | None | HostedZone DelegationSet |
HostedZone
Envelope of the zone information.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| - | 1..1 | GetHostedZoneResponse | Id Name CallerReference Config ResourceRecordSetCount |
Id
Zone ID. Same value as the zone name.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| xsd:string | 1..1 | HostedZone | None |
Name
Zone name. Normalized value.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| xsd:string | 1..1 | HostedZone | None |
CallerReference
Zone identifier. Same value as the zone name.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| xsd:string | 1..1 | HostedZone | None |
Config
Envelope of appended information.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| - | 1..1 | HostedZone | Comment |
Comment
Comment.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| xsd:string | 0..1 | Config | None |
ResourceRecordSetCount
Number of records registered in the host zone.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| xsd:string | 1..1 | HostedZone | None |
DelegationSet
Envelope of the name server information.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| - | 1..1 | GetHostedZoneResponse | NameServers |
NameServers
Envelope of the name server list.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| - | 1..1 | DelegationSet | NameServer |
NameServer
Name server allocated to the zone.
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| xsd:string | 1..n | NameServers | None |
Example of Request
GET /hostedzone/example.com HTTP/1.1
Date: Fri, 06 Jun 2014 11:00:37 GMT
Content-Length: . . .
Host: dns.gls.cloud.global.fujitsu.com
Accept: application/xml
X-Auth-Token: MIIFvgY. . .
Example of Response
HTTP/1.1 200 OK
Date: Fri, 06 Jun 2014 11:00:38 GMT
Content-Length: . . .
Content-Type: application/xml
x-fj-request-id: d96bd874-9bf2-11e1-8ee7-c98a0037a2b6
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
< GetHostedZoneResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
<HostedZone>
<Id>example.com</Id>
<Name>example.com</Name>
<CallerReference>example.com</CallerReference>
<Config>
<Comment>comment</Comment>
</Config>
<ResourceRecordSetCount>0</ResourceRecordSetCount>
</HostedZone>
<DelegationSet>
<NameServers>
<NameServer>ns0.dns.nifcloud.com</NameServer>
<NameServer>ns1.dns.nifcloud.com</NameServer>
</NameServers>
</DelegationSet>
</GetHostedZoneResponse>