Struct RecordSetClient 

pub struct RecordSetClient { /* private fields */ }

Calls RecordSetService.

Record sets: every record of one name and type in a hosted zone. A zone holds one record set per name and type, whatever its kind. A CNAME is alone at its name and never at the zone’s apex. The apex’s SOA and NS records are the platform’s, written from the zone’s name servers; they aren’t record sets, and no NS record delegates a name below the apex.

A change is recorded when its method answers, and answered wherever the zone is served. BatchChangeRecordSets makes several changes at once, all or none.

Implementations

impl RecordSetClient

pub fn new(client: &Client) -> Self

Returns a client of RecordSetService that sends its calls through client.

pub fn service(&self) -> &Service

The endpoint the client sends its calls to, which also serves the operations its methods answer with.

pub fn with_options(&self, options: CallOptions) -> Self

The same client, whose calls are sent as options says instead of as the Client’s settings do, such as a mutation that must not be sent twice: .with_options(CallOptions::new().max_attempts(1)). See CallOptions.

pub async fn get_record_set( &self, request: GetRecordSetRequest, ) -> Result<RecordSet, Error>

Returns a record set.

pub async fn list_record_sets( &self, request: ListRecordSetsRequest, ) -> Result<ListRecordSetsResponse, Error>

Lists a zone’s record sets by dns_name, then by type.

pub fn all_record_sets( &self, request: ListRecordSetsRequest, ) -> Pages<RecordSet>

Returns everything list_record_sets lists from request’s page on, fetching the next page as the stream reaches it. A page that fails ends the stream with its error.

pub async fn create_record_set( &self, request: CreateRecordSetRequest, ) -> Result<RecordSet, Error>

Creates a record set. Refused with CONFLICT when the zone holds a record set of that name and type, or when a CNAME would share its name. Refused with BAD_REQUEST for a name outside the zone, a value its type doesn’t take, an alias to a Floating IP outside the zone’s project, or once the project’s or organization’s quota of record sets is used up. An alias to a Floating IP that was created moments ago may be refused with SERVICE_UNAVAILABLE, retryable.

pub async fn update_record_set( &self, request: UpdateRecordSetRequest, ) -> Result<RecordSet, Error>

Replaces a record set’s TTL or what it answers with: ttl, basic or alias, or *. Naming one kind in update_mask replaces the kind the record set had. With *, a TTL left out keeps the record set’s; naming ttl without one sets the default, 300 seconds. Its name and type stay; another type is a new record set.

pub async fn delete_record_set( &self, request: DeleteRecordSetRequest, ) -> Result<Empty, Error>

Deletes a record set.

pub async fn batch_change_record_sets( &self, request: BatchChangeRecordSetsRequest, ) -> Result<BatchChangeRecordSetsResponse, Error>

Deletes, replaces and creates record sets of one zone together, all or none. The zone is checked as the changes leave it, not after each change, so a CNAME may take the place of the A record set it replaces in one call. A batch makes 1 to 1000 changes, and names a record set once at most across deletions and updates. Each change is refused as its own method would refuse it, naming the change; then none is made.

Trait Implementations

impl Clone for RecordSetClient

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RecordSetClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.