#61 added support for delete droplet by tag name api

Author: jeevatkm

src/main/java/com/myjeeva/digitalocean/DigitalOcean.java

@@ -276,6 +276,20 @@ Droplets createDroplets(Droplet droplet)
   Delete deleteDroplet(Integer dropletId)
       throws DigitalOceanException, RequestUnsuccessfulException;
 
+  /**
+   * Method destroys one or more of your droplet by given tag name; this is irreversible.
+   * 
+   * @param tagName the associated tag name with droplet
+   * @return {@link Delete}
+   * @throws DigitalOceanException if request had interruption [
+   *         <code>HTTP status code &gt;= 400 &amp;&amp; &lt; 510</code>]
+   * @throws RequestUnsuccessfulException if any RESTful request unsuccessful from wrapper method
+   * 
+   * @since v2.9
+   */
+  Delete deleteDropletByTagName(String tagName)
+      throws DigitalOceanException, RequestUnsuccessfulException;
+
   /**
    * For an individual droplet; Method retrieves a list of droplets that are running on the same
    * physical server (any other droplets that share the same physical hardware).

src/main/java/com/myjeeva/digitalocean/common/ApiAction.java

@@ -69,6 +69,7 @@ public enum ApiAction {
   CREATE_DROPLET("/droplets", "droplet", RequestMethod.POST, Droplet.class),
   CREATE_DROPLETS("/droplets", "droplets", RequestMethod.POST, Droplets.class),
   DELETE_DROPLET("/droplets/%s", "response", RequestMethod.DELETE, Delete.class),
+  DELETE_DROPLET_BY_TAG_NAME("/droplets", "response", RequestMethod.DELETE, Delete.class),
   REBOOT_DROPLET("/droplets/%s/actions", "action", RequestMethod.POST, Action.class),
   POWER_CYCLE_DROPLET("/droplets/%s/actions", "action", RequestMethod.POST, Action.class),
   SHUTDOWN_DROPLET("/droplets/%s/actions", "action", RequestMethod.POST, Action.class),

src/main/java/com/myjeeva/digitalocean/impl/DigitalOceanClient.java

@@ -331,6 +331,16 @@ public Delete deleteDroplet(Integer dropletId) throws DigitalOceanException,
     return (Delete) perform(new ApiRequest(ApiAction.DELETE_DROPLET, params)).getData();
   }
 
+  @Override
+  public Delete deleteDropletByTagName(String tagName)
+      throws DigitalOceanException, RequestUnsuccessfulException {
+    checkEmptyAndThrowError(tagName, "Missing required parameter - tagName.");
+
+    Map<String, String> queryParams = new HashMap<String, String>();
+    queryParams.put("tag_name", tagName);
+    return (Delete) perform(new ApiRequest(ApiAction.DELETE_DROPLET_BY_TAG_NAME, null, queryParams, null)).getData();
+  }
+
   @Override
   public Droplets getDropletNeighbors(Integer dropletId, Integer pageNo)
       throws DigitalOceanException, RequestUnsuccessfulException {

src/test/java/com/myjeeva/digitalocean/DigitalOceanIntegrationTest.java

@@ -263,6 +263,16 @@ public void testDeleteDroplet() throws DigitalOceanException, RequestUnsuccessfu
     LOG.info("Delete Request Object: " + result);
   }
 
+  @Test
+  public void testDeleteDropletByTagName()
+      throws DigitalOceanException, RequestUnsuccessfulException {
+
+    Delete result = apiClient.deleteDropletByTagName("delete-me");
+
+    assertNotNull(result);
+    LOG.info("Delete by tag name Request Object: " + result);
+  }
+
   @Test
   public void testGetDropletNeighbors() throws DigitalOceanException, RequestUnsuccessfulException {