@Generated(value="OracleSDKGenerator", comments="API Version: 20180115") public class DnsAsyncClient extends BaseAsyncClient implements DnsAsync
Async client implementation for Dns service.
There are two ways to use async client: 1. Use AsyncHandler: using AsyncHandler, if the response
to the call is an InputStream
, like getObject Api in object storage service,
developers need to process the stream in AsyncHandler, and not anywhere else, because the stream
will be closed right after the AsyncHandler is invoked.
2. Use Java Future: using Java Future, developers need to close the stream after they are done
with the Java Future.
Accessing the result should be done in a mutually exclusive manner, either through the Future or
the AsyncHandler, but not both. If the Future is used, the caller should pass in null as the
AsyncHandler. If the AsyncHandler is used, it is still safe to use the Future to determine
whether or not the request was completed via Future.isDone/isCancelled.
Please refer to
https://github.com/oracle/oci-java-sdk/blob/master/bmc-examples/src/main/java/ResteasyClientWithObjectStorageExample.java
Modifier and Type | Class and Description |
---|---|
static class |
DnsAsyncClient.Builder
Builder class for this client.
|
Modifier and Type | Field and Description |
---|---|
String |
clientCommonLibraryVersion
Compatible SDK version, provided by the codegen.
|
Optional<String> |
minimumClientCommonLibraryVersionFromClient
Minimum compatible SDK version, maybe provided by the codegen.
|
static Service |
SERVICE
Service instance for Dns.
|
Constructor and Description |
---|
DnsAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory)
Deprecated.
Use the
builder instead. |
DnsAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators)
Deprecated.
Use the
builder instead. |
DnsAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Deprecated.
Use the
builder instead. |
DnsAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Deprecated.
Use the
builder instead. |
DnsAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Deprecated.
Use the
builder instead. |
DnsAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration)
Deprecated.
Use the
builder instead. |
DnsAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator)
Deprecated.
Use the
builder instead. |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
getEndpoint, refreshClient, setEndpoint, useRealmSpecificEndpointTemplate
close
public static final Service SERVICE
Service instance for Dns.
public final String clientCommonLibraryVersion
@Deprecated public DnsAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DnsAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)@Deprecated public DnsAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DnsAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
@Deprecated public DnsAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DnsAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
@Deprecated public DnsAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DnsAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
@Deprecated public DnsAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DnsAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
- ClientBuilderBase.additionalClientConfigurators
@Deprecated public DnsAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DnsAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
- ClientBuilderBase.additionalClientConfigurators
endpoint
- ClientBuilderBase.endpoint(java.lang.String)
@Deprecated public DnsAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see DnsAsyncClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
- ClientBuilderBase.additionalClientConfigurators
endpoint
- ClientBuilderBase.endpoint(java.lang.String)
signingStrategyRequestSignerFactories
- ClientBuilderBase.signingStrategyRequestSignerFactories
public static DnsAsyncClient.Builder builder()
Create a builder for this client.
public void setRegion(Region region)
DnsAsync
Sets the region to call (ex, Region.US_PHOENIX_1).
Note, this will call setEndpoint
after resolving the
endpoint. If the service is not available in this region, however, an
IllegalArgumentException will be raised.
public void setRegion(String regionId)
DnsAsync
Sets the region to call (ex, ‘us-phoenix-1’).
Note, this will first try to map the region ID to a known Region and call setRegion
.
If no known Region could be determined, it will create an endpoint based on the default
endpoint format (Region.formatDefaultRegionEndpoint(Service, String)
and then call setEndpoint
.
public Future<ChangeResolverCompartmentResponse> changeResolverCompartment(ChangeResolverCompartmentRequest request, AsyncHandler<ChangeResolverCompartmentRequest,ChangeResolverCompartmentResponse> handler)
DnsAsync
Moves a resolver into a different compartment along with its protected default view and any endpoints.
Zones in the default view are not moved. VCN-dedicated resolvers are initially created in the same compartment as their corresponding VCN, but can then be moved to a different compartment.
changeResolverCompartment
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeSteeringPolicyCompartmentResponse> changeSteeringPolicyCompartment(ChangeSteeringPolicyCompartmentRequest request, AsyncHandler<ChangeSteeringPolicyCompartmentRequest,ChangeSteeringPolicyCompartmentResponse> handler)
DnsAsync
Moves a steering policy into a different compartment.
changeSteeringPolicyCompartment
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeTsigKeyCompartmentResponse> changeTsigKeyCompartment(ChangeTsigKeyCompartmentRequest request, AsyncHandler<ChangeTsigKeyCompartmentRequest,ChangeTsigKeyCompartmentResponse> handler)
DnsAsync
Moves a TSIG key into a different compartment.
changeTsigKeyCompartment
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeViewCompartmentResponse> changeViewCompartment(ChangeViewCompartmentRequest request, AsyncHandler<ChangeViewCompartmentRequest,ChangeViewCompartmentResponse> handler)
DnsAsync
Moves a view into a different compartment.
To change the compartment of a protected view, change the compartment of its corresponding resolver.
changeViewCompartment
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ChangeZoneCompartmentResponse> changeZoneCompartment(ChangeZoneCompartmentRequest request, AsyncHandler<ChangeZoneCompartmentRequest,ChangeZoneCompartmentResponse> handler)
DnsAsync
Moves a zone into a different compartment.
Protected zones cannot have their compartment changed. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
*Note:** All SteeringPolicyAttachment objects associated with this zone will also be moved into the provided compartment.
changeZoneCompartment
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateResolverEndpointResponse> createResolverEndpoint(CreateResolverEndpointRequest request, AsyncHandler<CreateResolverEndpointRequest,CreateResolverEndpointResponse> handler)
DnsAsync
Creates a new resolver endpoint in the same compartment as the resolver.
createResolverEndpoint
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateSteeringPolicyResponse> createSteeringPolicy(CreateSteeringPolicyRequest request, AsyncHandler<CreateSteeringPolicyRequest,CreateSteeringPolicyResponse> handler)
DnsAsync
Creates a new steering policy in the specified compartment. For more information on creating policies with templates, see Traffic Management API Guide.
createSteeringPolicy
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateSteeringPolicyAttachmentResponse> createSteeringPolicyAttachment(CreateSteeringPolicyAttachmentRequest request, AsyncHandler<CreateSteeringPolicyAttachmentRequest,CreateSteeringPolicyAttachmentResponse> handler)
DnsAsync
Creates a new attachment between a steering policy and a domain, giving the policy permission to answer queries for the specified domain. A steering policy must be attached to a domain for the policy to answer DNS queries for that domain.
For the purposes of access control, the attachment is automatically placed into the same compartment as the domain's zone.
createSteeringPolicyAttachment
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateTsigKeyResponse> createTsigKey(CreateTsigKeyRequest request, AsyncHandler<CreateTsigKeyRequest,CreateTsigKeyResponse> handler)
DnsAsync
Creates a new TSIG key in the specified compartment. There is no opc-retry-token
header
since TSIG key names must be globally unique.
createTsigKey
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateViewResponse> createView(CreateViewRequest request, AsyncHandler<CreateViewRequest,CreateViewResponse> handler)
DnsAsync
Creates a new view in the specified compartment.
createView
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateZoneResponse> createZone(CreateZoneRequest request, AsyncHandler<CreateZoneRequest,CreateZoneResponse> handler)
DnsAsync
Creates a new zone in the specified compartment.
Private zones must have a zone type of `PRIMARY`. Creating a private zone at or under `oraclevcn.com` within the default protected view of a VCN-dedicated resolver is not permitted.
createZone
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateZoneFromZoneFileResponse> createZoneFromZoneFile(CreateZoneFromZoneFileRequest request, AsyncHandler<CreateZoneFromZoneFileRequest,CreateZoneFromZoneFileResponse> handler)
DnsAsync
Creates a new zone from a zone file in the specified compartment. Not supported for private zones.
createZoneFromZoneFile
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteDomainRecordsResponse> deleteDomainRecords(DeleteDomainRecordsRequest request, AsyncHandler<DeleteDomainRecordsRequest,DeleteDomainRecordsResponse> handler)
DnsAsync
Deletes all records at the specified zone and domain.
When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
deleteDomainRecords
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteRRSetResponse> deleteRRSet(DeleteRRSetRequest request, AsyncHandler<DeleteRRSetRequest,DeleteRRSetResponse> handler)
DnsAsync
Deletes all records in the specified RRSet.
When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
deleteRRSet
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteResolverEndpointResponse> deleteResolverEndpoint(DeleteResolverEndpointRequest request, AsyncHandler<DeleteResolverEndpointRequest,DeleteResolverEndpointResponse> handler)
DnsAsync
Deletes the specified resolver endpoint.
Note that attempting to delete a resolver endpoint in the DELETED lifecycle state will result in a `404` response to be consistent with other operations of the API. Resolver endpoints may not be deleted if they are referenced by a resolver rule.
deleteResolverEndpoint
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteSteeringPolicyResponse> deleteSteeringPolicy(DeleteSteeringPolicyRequest request, AsyncHandler<DeleteSteeringPolicyRequest,DeleteSteeringPolicyResponse> handler)
DnsAsync
Deletes the specified steering policy.
A `204` response indicates that the delete has been successful. Deletion will fail if the policy is attached to any zones. To detach a policy from a zone, see `DeleteSteeringPolicyAttachment`.
deleteSteeringPolicy
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteSteeringPolicyAttachmentResponse> deleteSteeringPolicyAttachment(DeleteSteeringPolicyAttachmentRequest request, AsyncHandler<DeleteSteeringPolicyAttachmentRequest,DeleteSteeringPolicyAttachmentResponse> handler)
DnsAsync
Deletes the specified steering policy attachment. A 204
response indicates that the delete
has been successful.
deleteSteeringPolicyAttachment
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteTsigKeyResponse> deleteTsigKey(DeleteTsigKeyRequest request, AsyncHandler<DeleteTsigKeyRequest,DeleteTsigKeyResponse> handler)
DnsAsync
Deletes the specified TSIG key.
deleteTsigKey
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteViewResponse> deleteView(DeleteViewRequest request, AsyncHandler<DeleteViewRequest,DeleteViewResponse> handler)
DnsAsync
Deletes the specified view.
Note that attempting to delete a view in the DELETED lifecycleState will result in a `404` response to be consistent with other operations of the API. Views cannot be deleted if they are referenced by non-deleted zones or resolvers. Protected views cannot be deleted.
deleteView
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteZoneResponse> deleteZone(DeleteZoneRequest request, AsyncHandler<DeleteZoneRequest,DeleteZoneResponse> handler)
DnsAsync
Deletes the specified zone and all its steering policy attachments.
A `204` response indicates that the zone has been successfully deleted. Protected zones cannot be deleted. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
deleteZone
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDomainRecordsResponse> getDomainRecords(GetDomainRecordsRequest request, AsyncHandler<GetDomainRecordsRequest,GetDomainRecordsResponse> handler)
DnsAsync
Gets a list of all records at the specified zone and domain.
The results are sorted by `rtype` in alphabetical order by default. You can optionally filter and/or sort the results using the listed parameters. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
getDomainRecords
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetRRSetResponse> getRRSet(GetRRSetRequest request, AsyncHandler<GetRRSetRequest,GetRRSetResponse> handler)
DnsAsync
Gets a list of all records in the specified RRSet.
The results are sorted by `recordHash` by default. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
getRRSet
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetResolverResponse> getResolver(GetResolverRequest request, AsyncHandler<GetResolverRequest,GetResolverResponse> handler)
DnsAsync
Gets information about a specific resolver.
Note that attempting to get a resolver in the DELETED lifecycleState will result in a `404` response to be consistent with other operations of the API.
getResolver
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetResolverEndpointResponse> getResolverEndpoint(GetResolverEndpointRequest request, AsyncHandler<GetResolverEndpointRequest,GetResolverEndpointResponse> handler)
DnsAsync
Gets information about a specific resolver endpoint.
Note that attempting to get a resolver endpoint in the DELETED lifecycle state will result in a `404` response to be consistent with other operations of the API.
getResolverEndpoint
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetSteeringPolicyResponse> getSteeringPolicy(GetSteeringPolicyRequest request, AsyncHandler<GetSteeringPolicyRequest,GetSteeringPolicyResponse> handler)
DnsAsync
Gets information about the specified steering policy.
getSteeringPolicy
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetSteeringPolicyAttachmentResponse> getSteeringPolicyAttachment(GetSteeringPolicyAttachmentRequest request, AsyncHandler<GetSteeringPolicyAttachmentRequest,GetSteeringPolicyAttachmentResponse> handler)
DnsAsync
Gets information about the specified steering policy attachment.
getSteeringPolicyAttachment
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetTsigKeyResponse> getTsigKey(GetTsigKeyRequest request, AsyncHandler<GetTsigKeyRequest,GetTsigKeyResponse> handler)
DnsAsync
Gets information about the specified TSIG key.
getTsigKey
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetViewResponse> getView(GetViewRequest request, AsyncHandler<GetViewRequest,GetViewResponse> handler)
DnsAsync
Gets information about a specific view.
Note that attempting to get a view in the DELETED lifecycleState will result in a `404` response to be consistent with other operations of the API.
getView
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetZoneResponse> getZone(GetZoneRequest request, AsyncHandler<GetZoneRequest,GetZoneResponse> handler)
DnsAsync
Gets information about the specified zone, including its creation date, zone type, and serial.
When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
getZone
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetZoneContentResponse> getZoneContent(GetZoneContentRequest request, AsyncHandler<GetZoneContentRequest,GetZoneContentResponse> handler)
DnsAsync
Gets the requested zone’s zone file.
getZoneContent
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetZoneRecordsResponse> getZoneRecords(GetZoneRecordsRequest request, AsyncHandler<GetZoneRecordsRequest,GetZoneRecordsResponse> handler)
DnsAsync
Gets all records in the specified zone.
The results are sorted by `domain` in alphabetical order by default. For more information about records, see [Resource Record (RR) TYPEs](https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4). When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
getZoneRecords
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListResolverEndpointsResponse> listResolverEndpoints(ListResolverEndpointsRequest request, AsyncHandler<ListResolverEndpointsRequest,ListResolverEndpointsResponse> handler)
DnsAsync
Gets a list of all endpoints within a resolver. The collection can be filtered by name or lifecycle state. It can be sorted on creation time or name both in ASC or DESC order. Note that when no lifecycleState query parameter is provided, the collection does not include resolver endpoints in the DELETED lifecycle state to be consistent with other operations of the API.
listResolverEndpoints
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListResolversResponse> listResolvers(ListResolversRequest request, AsyncHandler<ListResolversRequest,ListResolversResponse> handler)
DnsAsync
Gets a list of all resolvers within a compartment.
The collection can be filtered by display name, id, or lifecycle state. It can be sorted on creation time or displayName both in ASC or DESC order. Note that when no lifecycleState query parameter is provided, the collection does not include resolvers in the DELETED lifecycleState to be consistent with other operations of the API.
listResolvers
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListSteeringPoliciesResponse> listSteeringPolicies(ListSteeringPoliciesRequest request, AsyncHandler<ListSteeringPoliciesRequest,ListSteeringPoliciesResponse> handler)
DnsAsync
Gets a list of all steering policies in the specified compartment.
listSteeringPolicies
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListSteeringPolicyAttachmentsResponse> listSteeringPolicyAttachments(ListSteeringPolicyAttachmentsRequest request, AsyncHandler<ListSteeringPolicyAttachmentsRequest,ListSteeringPolicyAttachmentsResponse> handler)
DnsAsync
Lists the steering policy attachments in the specified compartment.
listSteeringPolicyAttachments
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListTsigKeysResponse> listTsigKeys(ListTsigKeysRequest request, AsyncHandler<ListTsigKeysRequest,ListTsigKeysResponse> handler)
DnsAsync
Gets a list of all TSIG keys in the specified compartment.
listTsigKeys
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListViewsResponse> listViews(ListViewsRequest request, AsyncHandler<ListViewsRequest,ListViewsResponse> handler)
DnsAsync
Gets a list of all views within a compartment.
The collection can be filtered by display name, id, or lifecycle state. It can be sorted on creation time or displayName both in ASC or DESC order. Note that when no lifecycleState query parameter is provided, the collection does not include views in the DELETED lifecycleState to be consistent with other operations of the API.
listViews
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListZoneTransferServersResponse> listZoneTransferServers(ListZoneTransferServersRequest request, AsyncHandler<ListZoneTransferServersRequest,ListZoneTransferServersResponse> handler)
DnsAsync
Gets a list of IP addresses of OCI nameservers for inbound and outbound transfer of zones in the specified compartment (which must be the root compartment of a tenancy) that transfer zone data with external master or downstream nameservers.
listZoneTransferServers
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListZonesResponse> listZones(ListZonesRequest request, AsyncHandler<ListZonesRequest,ListZonesResponse> handler)
DnsAsync
Gets a list of all zones in the specified compartment.
The collection can be filtered by name, time created, scope, associated view, and zone type. Filtering by view is only supported for private zones.
listZones
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<PatchDomainRecordsResponse> patchDomainRecords(PatchDomainRecordsRequest request, AsyncHandler<PatchDomainRecordsRequest,PatchDomainRecordsResponse> handler)
DnsAsync
Updates records in the specified zone at a domain.
You can update one record or all records for the specified zone depending on the changes provided in the request body. You can also add or remove records using this function. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
patchDomainRecords
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<PatchRRSetResponse> patchRRSet(PatchRRSetRequest request, AsyncHandler<PatchRRSetRequest,PatchRRSetResponse> handler)
DnsAsync
Updates records in the specified RRSet.
When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
patchRRSet
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<PatchZoneRecordsResponse> patchZoneRecords(PatchZoneRecordsRequest request, AsyncHandler<PatchZoneRecordsRequest,PatchZoneRecordsResponse> handler)
DnsAsync
Updates a collection of records in the specified zone.
You can update one record or all records for the specified zone depending on the changes provided in the request body. You can also add or remove records using this function. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
patchZoneRecords
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<PromoteZoneDnssecKeyVersionResponse> promoteZoneDnssecKeyVersion(PromoteZoneDnssecKeyVersionRequest request, AsyncHandler<PromoteZoneDnssecKeyVersionRequest,PromoteZoneDnssecKeyVersionResponse> handler)
DnsAsync
Promotes a specified DnssecKeyVersion
on the zone.
If the `DnssecKeyVersion` identified in the request body is a key signing key (KSK) that is replacing another `DnssecKeyVersion`, then the old `DnssecKeyVersion` is scheduled for removal from the zone.
For key signing keys (KSKs), you must create the DS record with the new key information **before** promoting the new key to establish a chain of trust. To avoid a service disruption, remove the old DS record as soon as its TTL (time to live) expires.
For more information, see [DNSSEC](https://docs.cloud.oracle.com/iaas/Content/DNS/Concepts/dnssec.htm).
promoteZoneDnssecKeyVersion
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<StageZoneDnssecKeyVersionResponse> stageZoneDnssecKeyVersion(StageZoneDnssecKeyVersionRequest request, AsyncHandler<StageZoneDnssecKeyVersionRequest,StageZoneDnssecKeyVersionResponse> handler)
DnsAsync
Stages a new DnssecKeyVersion
on the zone. Staging is a process that generates a new
"successor" key version that replaces an existing "predecessor" key version. Note: A
new key-signing key (KSK) version is inert until you update the parent zone DS records.
For more information, see the [DNSSEC](https://docs.cloud.oracle.com/iaas/Content/DNS/Concepts/dnssec.htm) documentation.
stageZoneDnssecKeyVersion
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateDomainRecordsResponse> updateDomainRecords(UpdateDomainRecordsRequest request, AsyncHandler<UpdateDomainRecordsRequest,UpdateDomainRecordsResponse> handler)
DnsAsync
Replaces records in the specified zone at a domain with the records specified in the request body.
If a specified record does not exist, it will be created. If the record exists, then it will be updated to represent the record in the body of the request. If a record in the zone does not exist in the request body, the record will be removed from the zone. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
updateDomainRecords
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateRRSetResponse> updateRRSet(UpdateRRSetRequest request, AsyncHandler<UpdateRRSetRequest,UpdateRRSetResponse> handler)
DnsAsync
Replaces records in the specified RRSet.
When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
updateRRSet
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateResolverResponse> updateResolver(UpdateResolverRequest request, AsyncHandler<UpdateResolverRequest,UpdateResolverResponse> handler)
DnsAsync
Updates the specified resolver with your new information.
updateResolver
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateResolverEndpointResponse> updateResolverEndpoint(UpdateResolverEndpointRequest request, AsyncHandler<UpdateResolverEndpointRequest,UpdateResolverEndpointResponse> handler)
DnsAsync
Updates the specified resolver endpoint with your new information.
updateResolverEndpoint
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateSteeringPolicyResponse> updateSteeringPolicy(UpdateSteeringPolicyRequest request, AsyncHandler<UpdateSteeringPolicyRequest,UpdateSteeringPolicyResponse> handler)
DnsAsync
Updates the configuration of the specified steering policy.
updateSteeringPolicy
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateSteeringPolicyAttachmentResponse> updateSteeringPolicyAttachment(UpdateSteeringPolicyAttachmentRequest request, AsyncHandler<UpdateSteeringPolicyAttachmentRequest,UpdateSteeringPolicyAttachmentResponse> handler)
DnsAsync
Updates the specified steering policy attachment with your new information.
updateSteeringPolicyAttachment
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateTsigKeyResponse> updateTsigKey(UpdateTsigKeyRequest request, AsyncHandler<UpdateTsigKeyRequest,UpdateTsigKeyResponse> handler)
DnsAsync
Updates the specified TSIG key.
updateTsigKey
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateViewResponse> updateView(UpdateViewRequest request, AsyncHandler<UpdateViewRequest,UpdateViewResponse> handler)
DnsAsync
Updates the specified view with your new information.
updateView
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateZoneResponse> updateZone(UpdateZoneRequest request, AsyncHandler<UpdateZoneRequest,UpdateZoneResponse> handler)
DnsAsync
Updates the zone with the specified information.
Global secondary zones may have their external masters updated. For more information about secondary zones, see [Manage DNS Service Zone](https://docs.cloud.oracle.com/iaas/Content/DNS/Tasks/managingdnszones.htm). When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
updateZone
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateZoneRecordsResponse> updateZoneRecords(UpdateZoneRecordsRequest request, AsyncHandler<UpdateZoneRecordsRequest,UpdateZoneRecordsResponse> handler)
DnsAsync
Replaces records in the specified zone with the records specified in the request body.
If a specified record does not exist, it will be created. If the record exists, then it will be updated to represent the record in the body of the request. If a record in the zone does not exist in the request body, the record will be removed from the zone. When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is required.
updateZoneRecords
in interface DnsAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.protected ClientConfigurator getDefaultConfigurator()
public void useRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)
useOfRealmSpecificEndpointTemplateEnabled
- This flag can be set to true or false to
enable or disable the use of realm-specific endpoint template respectivelypublic final void populateServiceParametersInEndpoint(String endpoint, Map<String,Object> requiredParametersMap)
endpoint
- The endpoint template in userequiredParametersMap
- Map of parameter name as key and value set in request path or
query parameter as valuepublic final void updateBaseEndpoint(String endpoint)
endpoint
- The updated endpoint to usepublic final void setEndpoint(String endpoint)
public final String getEndpoint()
public final void refreshClient()
HttpClient
. This will call ClientConfigurator
s again, and
can be used to e.g. refresh the SSL certificate.public final void close()
close
in interface AutoCloseable
public String getClientCommonLibraryVersion()
public Optional<String> getMinimumClientCommonLibraryVersionFromClient()
protected <REQ extends BmcRequest<?>,RESP extends BmcResponse,RESP_BUILDER extends BmcResponse.Builder<RESP>> ClientCall<REQ,RESP,RESP_BUILDER> clientCall(REQ request, Supplier<RESP_BUILDER> responseBuilder)
Copyright © 2016–2024. All rights reserved.