vinyldns-java

Java client for working with VinylDNS

Add to your maven project

Dependency

To pull the latest version from Sonatype, add a dependency to the pom.xml file corresponding to the Sonatype version you want to use:

<dependency>
  <groupId>io.vinyldns</groupId>
  <artifactId>vinyldns-java</artifactId>
  <version>0.9.4</version> <!-- Replace with the latest release version -->
</dependency>

To pull in a local package of vinyldns-java as a Maven dependency, the project needs to be published to your local Maven repository by running the following command from the project root folder:

mvn clean install

Usage

AWSCredentials credentials = new BasicAWSCredentials("my-key", "my-secret");
VinylDNSClientConfig config = new VinylDNSClientConfig("https://my-vinyldns-api.com", credentials);

VinylDNSClient client = new VinylDNSClientImpl(config);

VinylDNSResponse<ListZonesResponse> listZonesResponse = client.listZones(new ListZonesRequest());

Use with VINYLDNS_* environment variables

Alternatively, a VinylDNSClient can be instantiated via VINYLDNS_API_URL, VINYLDNS_ACCESS_KEY_ID, and VINYLDNS_SECRET_ACCESS_KEY environment variables. For example:

export VINYLDNS_API_URL=https://my-vinyldns-api.com
export VINYLDNS_ACCESS_KEY_ID="my-key"
export VINYLDNS_SECRET_ACCESS_KEY="my-secret"

Instantiate a client using the VINYLDNS_* environment variables:

VinylDNSClient client = new VinylDNSClientImpl();

VinylDNSResponse<ListZonesResponse> listZonesResponse = client.listZones(new ListZonesRequest());

See VinylDNSClient interface to get more methods

Testing

vinyldns-java has a suite of unit tests to run to test expected behavior. To run the suite of tests, run the following command from the project root folder:

mvn test