com.netflix.genie.client

Class CommandClient

java.lang.Object

com.netflix.genie.client.CommandClient

public class CommandClient
extends java.lang.Object

Client library for the Command Service.

Since:

3.0.0

Constructor Summary

Constructors

Constructor and Description
CommandClient(@NotNull retrofit2.Retrofit retrofit) Constructor.
CommandClient(@NotEmpty java.lang.String url, java.util.List<okhttp3.Interceptor> interceptors, GenieNetworkConfiguration genieNetworkConfiguration) Deprecated. Use CommandClient(Retrofit)

Method Summary

Modifier and Type	Method and Description
void	addApplicationsToCommand(java.lang.String commandId, java.util.List<java.lang.String> applicationIds) Method to add applications to a command.
void	addConfigsToCommand(java.lang.String commandId, java.util.Set<java.lang.String> configs) Method to add configs to a command.
void	addDependenciesToCommand(java.lang.String commandId, java.util.Set<java.lang.String> dependencies) Method to add dependencies to a command.
void	addTagsToCommand(java.lang.String commandId, java.util.Set<java.lang.String> tags) Method to add tags to a command.
java.lang.String	createCommand(Command command) Create a command ing genie.
void	deleteAllCommands() Method to delete all commands from Genie.
void	deleteCommand(java.lang.String commandId) Method to delete a command from Genie.
java.util.List<Application>	getApplicationsForCommand(java.lang.String commandId) Method to get all the applications for a command.
java.util.List<Cluster>	getClustersForCommand(java.lang.String commandId) Method to get all the clusters for a command.
Command	getCommand(java.lang.String commandId) Method to get a Command from Genie.
java.util.List<Command>	getCommands() Method to get a list of all the commands.
java.util.List<Command>	getCommands(java.lang.String name, java.lang.String user, java.util.List<java.lang.String> statusList, java.util.List<java.lang.String> tagList) Method to get a list of all the commands from Genie for the query parameters specified.
java.util.Set<java.lang.String>	getConfigsForCommand(java.lang.String commandId) Method to get all the configs for a command.
java.util.Set<java.lang.String>	getDependenciesForCommand(java.lang.String commandId) Method to get all the dependency files for an command.
java.util.Set<java.lang.String>	getTagsForCommand(java.lang.String commandId) Method to get all the tags for a command.
void	patchCommand(java.lang.String commandId, com.github.fge.jsonpatch.JsonPatch patch) Method to patch a command using json patch instructions.
void	removeAllApplicationsForCommand(java.lang.String commandId) Remove all applications for this command.
void	removeAllConfigsForCommand(java.lang.String commandId) Remove all configs for this command.
void	removeAllDependenciesForCommand(java.lang.String commandId) Remove all dependencies for this command.
void	removeAllTagsForCommand(java.lang.String commandId) Remove all tags for this command.
void	removeApplicationFromCommand(java.lang.String commandId, java.lang.String applicationId) Remove an application from a command.
void	removeTagFromCommand(java.lang.String commandId, java.lang.String tag) Remove a tag from a command.
void	updateApplicationsForCommand(java.lang.String commandId, java.util.List<java.lang.String> applicationIds) Method to update applications for a command.
void	updateCommand(java.lang.String commandId, Command command) Method to updated a command.
void	updateConfigsForCommand(java.lang.String commandId, java.util.Set<java.lang.String> configs) Method to update configs for a command.
void	updateDependenciesForCommand(java.lang.String commandId, java.util.Set<java.lang.String> dependencies) Method to update dependencies for a command.
void	updateTagsForCommand(java.lang.String commandId, java.util.Set<java.lang.String> tags) Method to update tags for a command.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CommandClient

public CommandClient(@NotNull
                     @NotNull retrofit2.Retrofit retrofit)

Constructor.

Parameters:

retrofit - The configured Retrofit client to a Genie server

CommandClient

@Deprecated
public CommandClient(@NotEmpty
                                 @NotEmpty java.lang.String url,
                                 @Nullable
                                 java.util.List<okhttp3.Interceptor> interceptors,
                                 @Nullable
                                 GenieNetworkConfiguration genieNetworkConfiguration)
                          throws GenieClientException

Deprecated. Use CommandClient(Retrofit)

Constructor.

Parameters:

url - The endpoint URL of the Genie API. Not null or empty

interceptors - Any interceptors to configure the client with, can include security ones

genieNetworkConfiguration - The network configuration parameters. Could be null

Throws:

GenieClientException - On error

Method Detail

createCommand

public java.lang.String createCommand(Command command)
                               throws java.io.IOException,
                                      GenieClientException

Create a command ing genie.

Parameters:

command - A command object.

Returns:

id Id of the command created.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

getCommands

public java.util.List<Command> getCommands()
                                    throws java.io.IOException,
                                           GenieClientException

Method to get a list of all the commands.

Returns:

A list of commands.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

getCommands

public java.util.List<Command> getCommands(java.lang.String name,
                                           java.lang.String user,
                                           java.util.List<java.lang.String> statusList,
                                           java.util.List<java.lang.String> tagList)
                                    throws java.io.IOException,
                                           GenieClientException

Method to get a list of all the commands from Genie for the query parameters specified.

Parameters:

name - The name of the commands.

user - The user who created the command.

statusList - The list of Command statuses.

tagList - The list of tags.

Returns:

A list of commands.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

getCommand

public Command getCommand(java.lang.String commandId)
                   throws java.io.IOException,
                          GenieClientException

Method to get a Command from Genie.

Parameters:

commandId - The id of the command to get.

Returns:

The command details.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

deleteCommand

public void deleteCommand(java.lang.String commandId)
                   throws java.io.IOException,
                          GenieClientException

Method to delete a command from Genie.

Parameters:

commandId - The id of the command.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

deleteAllCommands

public void deleteAllCommands()
                       throws java.io.IOException,
                              GenieClientException

Method to delete all commands from Genie.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

patchCommand

public void patchCommand(java.lang.String commandId,
                         com.github.fge.jsonpatch.JsonPatch patch)
                  throws java.io.IOException,
                         GenieClientException

Method to patch a command using json patch instructions.

Parameters:

commandId - The id of the command.

patch - The patch object specifying all the instructions.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

updateCommand

public void updateCommand(java.lang.String commandId,
                          Command command)
                   throws java.io.IOException,
                          GenieClientException

Method to updated a command.

Parameters:

commandId - The id of the command.

command - The updated command object to use.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

getConfigsForCommand

public java.util.Set<java.lang.String> getConfigsForCommand(java.lang.String commandId)
                                                     throws java.io.IOException,
                                                            GenieClientException

Method to get all the configs for a command.

Parameters:

commandId - The id of the command.

Returns:

The set of configs for the command.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

addConfigsToCommand

public void addConfigsToCommand(java.lang.String commandId,
                                java.util.Set<java.lang.String> configs)
                         throws java.io.IOException,
                                GenieClientException

Method to add configs to a command.

Parameters:

commandId - The id of the command.

configs - The set of configs to add.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

updateConfigsForCommand

public void updateConfigsForCommand(java.lang.String commandId,
                                    java.util.Set<java.lang.String> configs)
                             throws java.io.IOException,
                                    GenieClientException

Method to update configs for a command.

Parameters:

commandId - The id of the command.

configs - The set of configs to add.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

removeAllConfigsForCommand

public void removeAllConfigsForCommand(java.lang.String commandId)
                                throws java.io.IOException,
                                       GenieClientException

Remove all configs for this command.

Parameters:

commandId - The id of the command.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

getDependenciesForCommand

public java.util.Set<java.lang.String> getDependenciesForCommand(java.lang.String commandId)
                                                          throws java.io.IOException,
                                                                 GenieClientException

Method to get all the dependency files for an command.

Parameters:

commandId - The id of the command.

Returns:

The set of dependencies for the command.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues

addDependenciesToCommand

public void addDependenciesToCommand(java.lang.String commandId,
                                     java.util.Set<java.lang.String> dependencies)
                              throws java.io.IOException,
                                     GenieClientException

Method to add dependencies to a command.

Parameters:

commandId - The id of the command.

dependencies - The set of dependencies to add.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues

updateDependenciesForCommand

public void updateDependenciesForCommand(java.lang.String commandId,
                                         java.util.Set<java.lang.String> dependencies)
                                  throws java.io.IOException,
                                         GenieClientException

Method to update dependencies for a command.

Parameters:

commandId - The id of the command.

dependencies - The set of dependencies to add.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues

removeAllDependenciesForCommand

public void removeAllDependenciesForCommand(java.lang.String commandId)
                                     throws java.io.IOException,
                                            GenieClientException

Remove all dependencies for this command.

Parameters:

commandId - The id of the command.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues

getApplicationsForCommand

public java.util.List<Application> getApplicationsForCommand(java.lang.String commandId)
                                                      throws java.io.IOException,
                                                             GenieClientException

Method to get all the applications for a command.

Parameters:

commandId - The id of the command.

Returns:

The set of applications for the command.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

getClustersForCommand

public java.util.List<Cluster> getClustersForCommand(java.lang.String commandId)
                                              throws java.io.IOException,
                                                     GenieClientException

Method to get all the clusters for a command.

Parameters:

commandId - The id of the command.

Returns:

The set of clusters for the command.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

addApplicationsToCommand

public void addApplicationsToCommand(java.lang.String commandId,
                                     java.util.List<java.lang.String> applicationIds)
                              throws java.io.IOException,
                                     GenieClientException

Method to add applications to a command.

Parameters:

commandId - The id of the command.

applicationIds - The set of applications ids to add.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

updateApplicationsForCommand

public void updateApplicationsForCommand(java.lang.String commandId,
                                         java.util.List<java.lang.String> applicationIds)
                                  throws java.io.IOException,
                                         GenieClientException

Method to update applications for a command.

Parameters:

commandId - The id of the command.

applicationIds - The set of application ids to add.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

removeApplicationFromCommand

public void removeApplicationFromCommand(java.lang.String commandId,
                                         java.lang.String applicationId)
                                  throws java.io.IOException,
                                         GenieClientException

Remove an application from a command.

Parameters:

commandId - The id of the command.

applicationId - The id of the application to remove.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

removeAllApplicationsForCommand

public void removeAllApplicationsForCommand(java.lang.String commandId)
                                     throws java.io.IOException,
                                            GenieClientException

Remove all applications for this command.

Parameters:

commandId - The id of the command.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

getTagsForCommand

public java.util.Set<java.lang.String> getTagsForCommand(java.lang.String commandId)
                                                  throws java.io.IOException,
                                                         GenieClientException

Method to get all the tags for a command.

Parameters:

commandId - The id of the command.

Returns:

The set of configs for the command.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

addTagsToCommand

public void addTagsToCommand(java.lang.String commandId,
                             java.util.Set<java.lang.String> tags)
                      throws java.io.IOException,
                             GenieClientException

Method to add tags to a command.

Parameters:

commandId - The id of the command.

tags - The set of tags to add.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

updateTagsForCommand

public void updateTagsForCommand(java.lang.String commandId,
                                 java.util.Set<java.lang.String> tags)
                          throws java.io.IOException,
                                 GenieClientException

Method to update tags for a command.

Parameters:

commandId - The id of the command.

tags - The set of tags to add.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

removeTagFromCommand

public void removeTagFromCommand(java.lang.String commandId,
                                 java.lang.String tag)
                          throws java.io.IOException,
                                 GenieClientException

Remove a tag from a command.

Parameters:

commandId - The id of the command.

tag - The tag to remove.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.

removeAllTagsForCommand

public void removeAllTagsForCommand(java.lang.String commandId)
                             throws java.io.IOException,
                                    GenieClientException

Remove all tags for this command.

Parameters:

commandId - The id of the command.

Throws:

GenieClientException - If the response received is not 2xx.

java.io.IOException - For Network and other IO issues.