Class: Aws::Route53::Types::ChangeGuardrail

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-route53/lib/aws-sdk-route53/types.rb

Overview

A Change Guardrail and its status. A Change Guardrail checks each change to the records in a hosted zone, and rejects the change if the check fails.

When you submit a ChangeResourceRecordSets request, Route 53 checks each change against every guardrail that is turned on. If a check fails, Route 53 rejects the whole request and returns an error that identifies the guardrail. If every check passes, Route 53 applies the changes.

For example, suppose that ALIAS_TARGET_CHECK is turned on, and an alias record points to www.example.com. If you try to delete www.example.com, Route 53 rejects the request. To delete the record, first delete or change the alias record.

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#name ⇒ String

The name of the guardrail. Valid values are the following:

NS_FORMAT_CHECK

This guardrail rejects an NS record whose value looks like a Route 53 name server but isn't one.

NS_DELEGATION_AUTHORITY_CHECK

This guardrail rejects an NS record that delegates a subdomain to Route 53 name servers that don't host it.

This guardrail applies only to public hosted zones.

NS_OCCLUSION_CHECK

This guardrail rejects a change that leaves records under a delegated subdomain, where resolvers never use them.

ALIAS_TARGET_CHECK

This guardrail rejects deleting a record that an alias record in the same hosted zone points to.

ACTIVE_RECORD_CHECK

This guardrail rejects deleting a record that still receives DNS queries, if no other record with the same name and type remains to answer them.

ACTIVE_DELEGATION_CHECK

This guardrail rejects deleting the NS record for a subdomain while resolvers are still referred to it.

The tier of the hosted zone determines which guardrails it includes and which ones you can turn on.

Returns:

  • (String)


917
918
919
920
921
922
# File 'gems/aws-sdk-route53/lib/aws-sdk-route53/types.rb', line 917

class ChangeGuardrail < Struct.new(
  :name,
  :status)
  SENSITIVE = []
  include Aws::Structure
end

#status ⇒ String

The status of the guardrail. Valid values are the following:

ENABLED

ENABLED means that the guardrail is turned on.

DISABLED

DISABLED means that the guardrail is turned off.

Returns:

  • (String)


917
918
919
920
921
922
# File 'gems/aws-sdk-route53/lib/aws-sdk-route53/types.rb', line 917

class ChangeGuardrail < Struct.new(
  :name,
  :status)
  SENSITIVE = []
  include Aws::Structure
end