Create/delete record (POST v1.0/hostedzone/{zoneId}/rrset)

Request Headers

n/a

Request Parameter

n/a

Request Elements

ChangeResourceRecordSetsRequest

Request envelope.

ChangeBatch

Envelope of record transaction.

Comment

Comment for the record transaction.

Changes

Envelope of change content list.

Change

Envelope of change content.

Action

Type of record operation. CREATE or DELETE.

ResourceRecordSet

Envelope of the record information.

Name

Record name.

Input limitation:

Halfwidth alphanumeric characters (a-z,0-9) , wild-cards (*) , at marks (@) and hyphens (-) are available.

Specify 1 or more and 63 or less character

Wildcards can be specified for A, AAAA, MX, and CNAME records, as long as

Weight and Failover are not specified.

The at mark (@) can be specified for A, AAAA, MX, and TXT records, as long as Failover is not specified.

Type

Record type.

NS, A, AAAA, CNAME, MX, TXT, LBR, SRV.

SetIdentifier

Record identification information.

Weight

Weighting value. 0 to 100.

XniftyDefaultHost

Default host information.

Failover

Failover type. PRIMARY or SECONDARY.

XniftyHealthCheckConfig

Envelope of health check information.

IPAddress

Health check destination IP address.

Port

Health check destination port.

Protocol

Health check type. HTTP, HTTPS, TCP.

ResourcePath

Health check destination path.

FullyQualifiedDomainName

Health check destination domain name.

TTL

TTL value. 60 to 86400 seconds. If omitted, the zone TTL will be used.

ResourceRecords

Envelope of record response information list.

ResourceRecord

Envelope of record response information.

Value

Record response value. Multibyte domains can be set for CNAME, MX and NS records.

XniftyComment

Comment. Specify up to 255 fullwidth characters.

HTTP status

Status

The following error codes can be returned for the request.

Response elements (normal completion)

ChangeResourceRecordSetsResponse

Envelope of the response.

ChangeInfo

Envelope of the update request information.

Id

Update request ID.

The ID is used by the GetChange API to retrieve update request information.

Status

Current status of an update request.

PENDING or INSYNC.

SubmittedAt

Datetime when update request was issued. Format: YYYY-MM-DDThh:mm:ss.SSSZ

Example of Request

POST /hostedzone/example.com/rrset 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. . .
<?xml version="1.0" encoding="UTF-8"?>
< ChangeResourceRecordSetsRequest xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <ChangeBatch>
    <Changes>
      <Change>
        <Action>CREATE</Action>
        <ResourceRecordSet>
          <Name>server.example.com</Name>
          <Type>A</Type>
          <TTL>60</TTL>
          <ResourceRecords>
             <ResourceRecord>
               <Value>222.158.xxx.yyy</Value>
             </ResourceRecord>
          </ResourceRecords>
        </ResourceRecordSet>
      </Change>
    </Changes>
  </ChangeBatch>
</ChangeResourceRecordSetsRequest>    
     

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"?>
< ChangeResourceRecordSetsResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <ChangeInfo>
    <Id>7a782d43939d7ff538ff1ee19dbdd5a0</Id>
    <Status>INSYNC</Status>
    <SubmittedAt>2014-06-06T11:00:38.178Z</SubmittedAt>
  </ChangeInfo>
</ChangeResourceRecordSetsResponse>   
     

Failover settings

• Failover settings

  The failover settings are specified using Failover tags. They can only be specified for A and AAAA records.

  • PRIMARY: Only 1 record can be set.
  • SECONDARY: Multiple settings are possible.
• Heath check

  Health checks are to be specified in the failover settings.

  Settings are to be specified by XniftyHealthCheckConfig tag.

  Health check rules

  • Individual health checks specified for each record are executed.
  • Health check is performed at 5-minute intervals.

  • During a health check, a check of whether packets can be sent to the target server via

    the Internet is performed.

  • When a failover occurs, a host switches over to the other host in the group that has the

    same Name tag and same Type tag.

  • Ensure that all the same record name is used for all records in the same group.
  • Set a global IP address as the target IP address.

  • Configure the network and OS (firewall service, security group rules, OS firewall, etc.)

    so that packets reach the target IP address.

  • When the FullyQualifiedDomainName tag is set, the value reaches the value of the Host header.
  • When ResourcePath tag is set, that value becomes a path to helth check. When this tag is not set, " /" becomes a path to helth check.

  • If multiple records are specified for [Secondary], priority is given to the record that was

    registered first.

  • The Health check is usually done only on the Primary.

  • Health checks are normally only performed for primary servers.

  • If an abnormality occurs in a health check for [Primary], health checks will be

    performed for both [Primary] and [Secondary].

  • The relationships of the server statuses of [Primary] and [Secondary] and the

    allocation destinations are as follows.

  • Please refer IaaS Features Handbook (Network - DNS service - Failover Function) for the relationships of the server statuses of [Primary] and [Secondary] and the allocation destinations.

  
  <XniftyHealthCheckConfig>
    <IPAddress>targetIpAddr</IPAddress>
    <Port>targetPortNum</Port>
    <Protocol>targetProtocol</Protocol>
    <ResourcePath>targetUrlPathSection</ResourcePath>
    <FullyQualifiedDomainName>httpHeaderHostInfo</FullyQualifiedDomainName>
  </XniftyHealthCheckConfig>         
         

  CAUTION:

  When using failover, it is recommended to set the record TTL to 60 seconds.
• Example failover settings (ResourceRecordSet)

  
  <ResourceRecordSet>
   
   <Name>server.example.com</Name>
    <Type>A</Type>
    <Failover>PRIMARY</Failover>
    <XniftyHealthCheckConfig>
      <IPAddress>222.158.xxx.yyy</IPAddress>
      <Port>80</Port>
      <Protocol>HTTP</Protocol>
    </XniftyHealthCheckConfig>
    <ResourceRecords>
      <ResourceRecord>
        <Value>222.158.xxx.yyy</Value>
      </ResourceRecord>
    </ResourceRecords>
  </ResourceRecordSet>
  <ResourceRecordSet>
   
    <Name>server.example.com</Name>
    <Type>A</Type>
    <Failover>SECONDARY</Failover>
    <XniftyHealthCheckConfig>
      <IPAddress>222.158.xxx.zzz</IPAddress>
      <Port>80</Port>
      <Protocol>HTTP</Protocol>
    </XniftyHealthCheckConfig>
    <ResourceRecords>
      <ResourceRecord>
        <Value>222.158.xxx.zzz</Value>
      </ResourceRecord>
    </ResourceRecords>
  </ResourceRecordSet>           
           

LBR settings

• Settings for latency-based routing (LBR)

  For the LBR settings, set the type to "LBR".

  Inside the Value tags, the area and host are delimited by a halfwidth space.

  
  <Value>area host<Value>           
           

  For area, specify the nearest area.

  10:

  Japan

  20:

  Asia

  30:

  North America

  For host, specify the value to be returned when there is access from the specified area. Registered A/AAAA records can be specified in the same zone.

  Use sub-domain notation instead of FQDN for the host.

  (in the LBR setting example below, www.example.com is specified as the default zone and registered in Japan, while www2.example.com is registered in Asia.)

  Inside the XniftyDefaultHost tags, specify the value to be returned when there is access from outside the specified area.

• Example LBR settings (ResourceRecordSet)

  
  <Changes>
    <Change>
      <Action>CREATE</Action>
      <ResourceRecordSet>
        <Name>server.example.com</Name>
        <Type>LBR</Type>
        <XniftyDefaultHost>www</XniftyDefaultHost>
        <ResourceRecords>
          <ResourceRecord>
            <Value>10 www,20 www2</Value>
          </ResourceRecord>
        </ResourceRecords>
      </ResourceRecordSet>
    </Change>
  </Changes>           
           

Weighted round robin settings

• Settings for a weighted round robin

  Specify the weighting value in the Weight tags. They can only be specified for A and AAAA records.

  The record hit rate varies according to the specified weighting value.

• Notes
  • If there are no records with a weighting of 100 in the weighting setting value, the target record may not be returned when resolving the name.
  • When the weighting setting value is set to 0, the hit rate will be 0, so no value will be returned.
  • For normal record registration, when records of the same host/same record type are registered, they are handled as a weighting of 100.
• Example weighted round robin settings (ResourceRecordSet)

  
  <ResourceRecordSet>
    <Name>server.example.com</Name>
    <Type>A</Type>
    <Weight>100</Weight>
    <TTL>60</TTL>
    <ResourceRecords>
      <ResourceRecord>
        <Value>222.158.xxx.yyy</Value>
      </ResourceRecord>
    </ResourceRecords>
  </ResourceRecordSet>
  <ResourceRecordSet>
    <Name>server.example.com</Name>
    <Type>A</Type>
    <Weight>100</Weight>
    <TTL>60</TTL>
    <ResourceRecords>
      <ResourceRecord>
        <Value>222.158.xxx.zzz</Value>
      </ResourceRecord>
    </ResourceRecords>
  </ResourceRecordSet>           
           

MX record settings

• MX record settings

  Separate the priority from the host using a halfwidth space in the Value tag inside the ResourceRecord.

  
  <Value>priority host</Value>           
           

• Example MX record settings

  Priority:

  10

  Host:

  mail.example.com

  
  <ResourceRecordSet>
    <Name>@</Name>
    <Type>MX</Type>
    <TTL>60</TTL>
    <ResourceRecords>
      <ResourceRecord>
        <Value>10 mail.example.com</Value>
      </ResourceRecord>
    </ResourceRecords>
  </ResourceRecordSet>           
           

PTR record settings

• PTR record settings

  Currently, PTR records cannot be set.

SRV record settings

• SRV record settings

  In the record name (the value of the Name tag), specify the service name and the protocol name (Example: _ftp._tcp) in the format "_<service name>._<protocol name>"

  In the value (the value of the Value tag), specify the priority, weighting, port number, and target, in this order, separated by single-byte blank spaces.

  
  <Value>Priority Weighting PortNumber Target</Value>
           

• Example of SRV record settings

  Priority:

  1

  Weighting:

  2

  Port number:

  21

  Target:

  ftp-server-01.example.com

  
  <ResourceRecordSet>
    <Name>_ftp._tcp</Name>
    <Type>SRV</Type>
    <TTL>3600</TTL>
    <ResourceRecords>
      <ResourceRecord>
        <Value>1 2 21 ftp-server-01.example.com</Value>
      </ResourceRecord>
    </ResourceRecords>
  </ResourceRecordSet>
           

• The zone ID specified in the URL when issuing an API request is registered in the domain name of the SRV record (Example: example.com).
• Notes
  • Specify the target value using the format "<record name of A record existing in same zone>.<domain name>".

    Example where the record name of the A record is "ftp-server-01" and the domain name is "example.com"

    "ftp-server-01.example.com".

• Domain name of the SRV record
  • Zone ID specified at the execution of API request is registered to the domain name of SRV recored. (Example: example.com)
• Notes
  • Specify the target value using the format "<record name of A record existing in same zone>.<domain name>".

    For example, where the record name of the A record is "ftp-server-01" and the domain name is "example.com",

    Please specify "ftp-server-01.example.com".

  • The target value can be specified in multibyte domains.
  • The weighting in SRV records is not handled as a weighted round robin function.
• Supplement
  • Refer to RFC-2782 for the specifications of SRV records.