com.wavefront.api

Interface SourceTagAPI

@Path(value="/")
public interface SourceTagAPI

API for source tag operations.

Author:

vasily@wavefront.com

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	appendTag(String id, String tagValue) Add a single tag to a source.
javax.ws.rs.core.Response	removeDescription(String id) Remove description from a source.
javax.ws.rs.core.Response	removeTag(String id, String tagValue) Remove a single tag from a source.
javax.ws.rs.core.Response	setDescription(String id, String description) Set description for a source.
javax.ws.rs.core.Response	setTags(String id, List<String> tagValuesToSet) Sets tags for a host, overriding existing tags.

Method Detail

appendTag

@PUT
 @Path(value="v2/source/{id}/tag/{tagValue}")
 @Produces(value="application/json")
javax.ws.rs.core.Response appendTag(@PathParam(value="id")
                                                                                                                            String id,
                                                                                                                            @PathParam(value="tagValue")
                                                                                                                            String tagValue)

Add a single tag to a source.

Parameters:

id - source ID.

tagValue - tag to add.

removeTag

@DELETE
 @Path(value="v2/source/{id}/tag/{tagValue}")
 @Produces(value="application/json")
javax.ws.rs.core.Response removeTag(@PathParam(value="id")
                                                                                                                               String id,
                                                                                                                               @PathParam(value="tagValue")
                                                                                                                               String tagValue)

Remove a single tag from a source.

Parameters:

id - source ID.

tagValue - tag to remove.

setTags

@POST
 @Path(value="v2/source/{id}/tag")
 @Consumes(value="application/json")
 @Produces(value="application/json")
javax.ws.rs.core.Response setTags(@PathParam(value="id")
                                                                                                                                                     String id,
                                                                                                                                                     List<String> tagValuesToSet)

Sets tags for a host, overriding existing tags.

Parameters:

id - source ID.

tagValuesToSet - tags to set.

setDescription

@POST
 @Path(value="v2/source/{id}/description")
 @Consumes(value="application/json")
 @Produces(value="application/json")
javax.ws.rs.core.Response setDescription(@PathParam(value="id")
                                                                                                                                                                    String id,
                                                                                                                                                                    String description)

Set description for a source.

Parameters:

id - source ID.

description - description.

removeDescription

@DELETE
 @Path(value="v2/source/{id}/description")
 @Produces(value="application/json")
javax.ws.rs.core.Response removeDescription(@PathParam(value="id")
                                                                                                                                    String id)

Remove description from a source.

Parameters:

id - source ID.