AWS SDK for .NET Documentation
Amazon.Route53.Model Namespace
AmazonAmazon.Route53.Model Did this page help you?   Yes   No    Tell us about it...
 
Declaration Syntax
C#
namespace Amazon.Route53.Model
Types
All TypesClasses
IconTypeDescription
AliasTarget

Alias resource record sets only: Information about the domain to which you are redirecting traffic.

For more information and an example, see Creating Alias Resource Record Sets in the Amazon Route 53 Developer Guide

.


Change

A complex type that contains the information for each change in a change batch request.


ChangeBatch

A complex type that contains an optional comment and the changes that you want to make with a change batch request.


ChangeInfo

A complex type that describes change information about changes made to your hosted zone.

This element contains an ID that you use when performing a GetChange action to get detailed information about the change.


ChangeResourceRecordSetsRequest
Container for the parameters to the ChangeResourceRecordSets operation.

Use this action to create or change your authoritative DNS information. To use this action, send a POST request to the 2013-04-01/hostedzone/hosted Zone ID/rrset resource. The request body must include an XML document with a ChangeResourceRecordSetsRequest element.

Changes are a list of change items and are considered transactional. For more information on transactional changes, also known as change batches, see Creating, Changing, and Deleting Resource Record Sets Using the Route 53 API in the Amazon Route 53 Developer Guide .

IMPORTANT:Due to the nature of transactional changes, you cannot delete the same resource record set more than once in a single change batch. If you attempt to delete the same change batch more than once, Route 53 returns an InvalidChangeBatch error.

In response to a ChangeResourceRecordSets request, your DNS data is changed on all Route 53 DNS servers. Initially, the status of a change is PENDING . This means the change has not yet propagated to all the authoritative Route 53 DNS servers. When the change is propagated to all hosts, the change returns a status of INSYNC .

Note the following limitations on a ChangeResourceRecordSets request:

- A request cannot contain more than 100 Change elements.

- A request cannot contain more than 1000 ResourceRecord elements.

The sum of the number of characters (including spaces) in all Value elements in a request cannot exceed 32,000 characters.


ChangeResourceRecordSetsResponse
Returns information about the ChangeResourceRecordSetsResult response and response metadata.

ChangeResourceRecordSetsResult

A complex type containing the response for the request.


CreateHealthCheckRequest
Container for the parameters to the CreateHealthCheck operation.

This action creates a new health check.

To create a new health check, send a POST request to the 2013-04-01/healthcheck resource. The request body must include an XML document with a CreateHealthCheckRequest element. The response returns the CreateHealthCheckResponse element that contains metadata about the health check.


CreateHealthCheckResponse
Returns information about the CreateHealthCheckResult response and response metadata.

CreateHealthCheckResult

A complex type containing the response information for the new health check.


CreateHostedZoneRequest
Container for the parameters to the CreateHostedZone operation.

This action creates a new hosted zone.

To create a new hosted zone, send a POST request to the 2013-04-01/hostedzone resource. The request body must include an XML document with a CreateHostedZoneRequest element. The response returns the CreateHostedZoneResponse element that contains metadata about the hosted zone.

Route 53 automatically creates a default SOA record and four NS records for the zone. The NS records in the hosted zone are the name servers you give your registrar to delegate your domain to. For more information about SOA and NS records, see NS and SOA Records that Route 53 Creates for a Hosted Zone in the Amazon Route 53 Developer Guide .

When you create a zone, its initial status is PENDING . This means that it is not yet available on all DNS servers. The status of the zone changes to INSYNC when the NS and SOA records are available on all Route 53 DNS servers.


CreateHostedZoneResponse
Returns information about the CreateHostedZoneResult response and response metadata.

CreateHostedZoneResult

A complex type containing the response information for the new hosted zone.


DelegationSet

A complex type that contains name server information.


DelegationSetNotAvailableException
AmazonRoute53 exception

DeleteHealthCheckRequest
Container for the parameters to the DeleteHealthCheck operation.

This action deletes a health check. To delete a health check, send a DELETE request to the 2013-04-01/healthcheck/health check ID resource.

IMPORTANT: You can delete a health check only if there are no resource record sets associated with this health check. If resource record sets are associated with this health check, you must disassociate them before you can delete your health check. If you try to delete a health check that is associated with resource record sets, Route 53 will deny your request with a HealthCheckInUse error. For information about disassociating the records from your health check, see ChangeResourceRecordSets.


DeleteHealthCheckResponse
Returns information about the DeleteHealthCheckResult response and response metadata.

DeleteHealthCheckResult

Empty response for the request.


DeleteHostedZoneRequest
Container for the parameters to the DeleteHostedZone operation.

This action deletes a hosted zone. To delete a hosted zone, send a DELETE request to the 2013-04-01/hostedzone/hosted zone ID resource.

For more information about deleting a hosted zone, see Deleting a Hosted Zone in the Amazon Route 53 Developer Guide .

IMPORTANT: You can delete a hosted zone only if there are no resource record sets other than the default SOA record and NS resource record sets. If your hosted zone contains other resource record sets, you must delete them before you can delete your hosted zone. If you try to delete a hosted zone that contains other resource record sets, Route 53 will deny your request with a HostedZoneNotEmpty error. For information about deleting records from your hosted zone, see ChangeResourceRecordSets.


DeleteHostedZoneResponse
Returns information about the DeleteHostedZoneResult response and response metadata.

DeleteHostedZoneResult

A complex type containing the response information for the request.


GetChangeRequest
Container for the parameters to the GetChange operation.

This action returns the current status of a change batch request. The status is one of the following values:

- PENDING indicates that the changes in this request have not replicated to all Route 53 DNS servers. This is the initial status of all change batch requests.

- INSYNC indicates that the changes have replicated to all Amazon Route 53 DNS servers.


GetChangeResponse
Returns information about the GetChangeResult response and response metadata.

GetChangeResult

A complex type that contains the ChangeInfo element.


GetHealthCheckRequest
Container for the parameters to the GetHealthCheck operation.

To retrieve the health check, send a GET request to the 2013-04-01/healthcheck/health check ID resource.


GetHealthCheckResponse
Returns information about the GetHealthCheckResult response and response metadata.

GetHealthCheckResult

A complex type containing information about the specified health check.


GetHostedZoneRequest
Container for the parameters to the GetHostedZone operation.

To retrieve the delegation set for a hosted zone, send a GET request to the 2013-04-01/hostedzone/hosted zone ID resource. The delegation set is the four Route 53 name servers that were assigned to the hosted zone when you created it.


GetHostedZoneResponse
Returns information about the GetHostedZoneResult response and response metadata.

GetHostedZoneResult

A complex type containing information about the specified hosted zone.


HealthCheck

A complex type that contains identifying information about the health check.


HealthCheckAlreadyExistsException
AmazonRoute53 exception

HealthCheckConfig

A complex type that contains the health check configuration.


HealthCheckInUseException
AmazonRoute53 exception

HostedZone

A complex type that contain information about the specified hosted zone.


HostedZoneAlreadyExistsException
AmazonRoute53 exception

HostedZoneConfig

A complex type that contains an optional comment about your hosted zone. If you don't want to specify a comment, you can omit the HostedZoneConfig and Comment elements from the XML document.


HostedZoneNotEmptyException
AmazonRoute53 exception

IncompatibleVersionException
AmazonRoute53 exception

InvalidChangeBatchException
AmazonRoute53 exception

InvalidDomainNameException
AmazonRoute53 exception

InvalidInputException
AmazonRoute53 exception

ListHealthChecksRequest
Container for the parameters to the ListHealthChecks operation.

To retrieve a list of your health checks, send a GET request to the 2013-04-01/healthcheck resource. The response to this request includes a HealthChecks element with zero, one, or multiple HealthCheck child elements. By default, the list of health checks is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. You can use the Marker parameter to control the health check that the list begins with.

NOTE: Amazon Route 53 returns a maximum of 100 items. If you set MaxItems to a value greater than 100, Amazon Route 53 returns only the first 100.


ListHealthChecksResponse
Returns information about the ListHealthChecksResult response and response metadata.

ListHealthChecksResult

A complex type that contains the response for the request.


ListHostedZonesRequest
Container for the parameters to the ListHostedZones operation.

To retrieve a list of your hosted zones, send a GET request to the 2013-04-01/hostedzone resource. The response to this request includes a HostedZones element with zero, one, or multiple HostedZone child elements. By default, the list of hosted zones is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. You can use the Marker parameter to control the hosted zone that the list begins with.

NOTE: Amazon Route 53 returns a maximum of 100 items. If you set MaxItems to a value greater than 100, Amazon Route 53 returns only the first 100.


ListHostedZonesResponse
Returns information about the ListHostedZonesResult response and response metadata.

ListHostedZonesResult

A complex type that contains the response for the request.


ListResourceRecordSetsRequest
Container for the parameters to the ListResourceRecordSets operation.

Imagine all the resource record sets in a zone listed out in front of you. Imagine them sorted lexicographically first by DNS name (with the labels reversed, like "com.amazon.www" for example), and secondarily, lexicographically by record type. This operation retrieves at most MaxItems resource record sets from this list, in order, starting at a position specified by the Name and Type arguments:

  • If both Name and Type are omitted, this means start the results at the first RRSET in the HostedZone.
  • If Name is specified but Type is omitted, this means start the results at the first RRSET in the list whose name is greater than or equal to Name.
  • If both Name and Type are specified, this means start the results at the first RRSET in the list whose name is greater than or equal to Name and whose type is greater than or equal to Type.
  • It is an error to specify the Type but not the Name.

Use ListResourceRecordSets to retrieve a single known record set by specifying the record set's name and type, and setting MaxItems = 1

To retrieve all the records in a HostedZone, first pause any processes making calls to ChangeResourceRecordSets. Initially call ListResourceRecordSets without a Name and Type to get the first page of record sets. For subsequent calls, set Name and Type to the NextName and NextType values returned by the previous response.

In the presence of concurrent ChangeResourceRecordSets calls, there is no consistency of results across calls to ListResourceRecordSets. The only way to get a consistent multi-page snapshot of all RRSETs in a zone is to stop making changes while pagination is in progress.

However, the results from ListResourceRecordSets are consistent within a page. If MakeChange calls are taking place concurrently, the result of each one will either be completely visible in your results or not at all. You will not see partial changes, or changes that do not ultimately succeed. (This follows from the fact that MakeChange is atomic)

The results from ListResourceRecordSets are strongly consistent with ChangeResourceRecordSets. To be precise, if a single process makes a call to ChangeResourceRecordSets and receives a successful response, the effects of that change will be visible in a subsequent call to ListResourceRecordSets by that process.


ListResourceRecordSetsResponse
Returns information about the ListResourceRecordSetsResult response and response metadata.

ListResourceRecordSetsResult

A complex type that contains information about the resource record sets that are returned by the request and information about the response.


NoSuchChangeException
AmazonRoute53 exception

NoSuchHealthCheckException
AmazonRoute53 exception

NoSuchHostedZoneException
AmazonRoute53 exception

PriorRequestNotCompleteException
AmazonRoute53 exception

ResourceRecord

A complex type that contains the value of the Value element for the current resource record set.


ResourceRecordSet

A complex type that contains information about the current resource record set.


TooManyHealthChecksException
AmazonRoute53 exception

TooManyHostedZonesException
AmazonRoute53 exception