com.netflix.genie.web.controllers

Class CommandRestController

java.lang.Object

com.netflix.genie.web.controllers.CommandRestController

@RestController
 @RequestMapping(value="/api/v3/commands")
public class CommandRestController
extends java.lang.Object

REST end-point for supporting commands.

Since:

3.0.0

Constructor Summary

Constructors

Constructor and Description
CommandRestController(CommandPersistenceService commandPersistenceService, CommandResourceAssembler commandResourceAssembler, ApplicationResourceAssembler applicationResourceAssembler, ClusterResourceAssembler clusterResourceAssembler) Constructor.

Method Summary

Modifier and Type	Method and Description
void	addApplicationsForCommand(java.lang.String id, java.util.List<java.lang.String> applicationIds) Add applications for the given command.
void	addConfigsForCommand(java.lang.String id, java.util.Set<java.lang.String> configs) Add new configuration files to a given command.
void	addDependenciesForCommand(java.lang.String id, java.util.Set<java.lang.String> dependencies) Add new dependency files for a given command.
void	addTagsForCommand(java.lang.String id, java.util.Set<java.lang.String> tags) Add new tags to a given command.
org.springframework.http.ResponseEntity<java.lang.Void>	createCommand(@Valid com.netflix.genie.common.dto.Command command) Create a Command configuration.
void	deleteAllCommands() Delete all applications from database.
void	deleteCommand(java.lang.String id) Delete a command.
java.util.List<ApplicationResource>	getApplicationsForCommand(java.lang.String id) Get the applications configured for a given command.
java.util.Set<ClusterResource>	getClustersForCommand(java.lang.String id, java.util.Set<java.lang.String> statuses) Get all the clusters this command is associated with.
CommandResource	getCommand(java.lang.String id) Get Command configuration for given id.
org.springframework.hateoas.PagedResources<CommandResource>	getCommands(java.lang.String name, java.lang.String user, java.util.Set<java.lang.String> statuses, java.util.Set<java.lang.String> tags, org.springframework.data.domain.Pageable page, org.springframework.data.web.PagedResourcesAssembler<com.netflix.genie.common.dto.Command> assembler) Get Command configuration based on user parameters.
java.util.Set<java.lang.String>	getConfigsForCommand(java.lang.String id) Get all the configuration files for a given command.
java.util.Set<java.lang.String>	getDependenciesForCommand(java.lang.String id) Get all the dependency files for a given command.
java.util.Set<java.lang.String>	getTagsForCommand(java.lang.String id) Get all the tags for a given command.
void	patchCommand(java.lang.String id, com.github.fge.jsonpatch.JsonPatch patch) Patch a command using JSON Patch.
void	removeAllApplicationsForCommand(java.lang.String id) Remove the applications from a given command.
void	removeAllConfigsForCommand(java.lang.String id) Delete the all configuration files from a given command.
void	removeAllDependenciesForCommand(java.lang.String id) Delete the all dependency files from a given command.
void	removeAllTagsForCommand(java.lang.String id) Delete the all tags from a given command.
void	removeApplicationForCommand(java.lang.String id, java.lang.String appId) Remove the application from a given command.
void	removeTagForCommand(java.lang.String id, java.lang.String tag) Remove an tag from a given command.
void	setApplicationsForCommand(java.lang.String id, java.util.List<java.lang.String> applicationIds) Set the applications for the given command.
void	updateCommand(java.lang.String id, com.netflix.genie.common.dto.Command updateCommand) Update command configuration.
void	updateConfigsForCommand(java.lang.String id, java.util.Set<java.lang.String> configs) Update the configuration files for a given command.
void	updateDependenciesForCommand(java.lang.String id, java.util.Set<java.lang.String> dependencies) Update the dependency files for a given command.
void	updateTagsForCommand(java.lang.String id, java.util.Set<java.lang.String> tags) Update the tags for a given command.

Methods inherited from class java.lang.Object

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

Constructor Detail

CommandRestController

@Autowired
public CommandRestController(CommandPersistenceService commandPersistenceService,
                                        CommandResourceAssembler commandResourceAssembler,
                                        ApplicationResourceAssembler applicationResourceAssembler,
                                        ClusterResourceAssembler clusterResourceAssembler)

Constructor.

Parameters:

commandPersistenceService - The command configuration service to use.

commandResourceAssembler - The assembler to use to convert commands to command HAL resources

applicationResourceAssembler - The assembler to use to convert applications to application HAL resources

clusterResourceAssembler - The assembler to use to convert clusters to cluster HAL resources

Method Detail

createCommand

@PostMapping(consumes="application/json")
 @ResponseStatus(value=CREATED)
public org.springframework.http.ResponseEntity<java.lang.Void> createCommand(@RequestBody @Valid
                                                                                                                                                       @Valid com.netflix.genie.common.dto.Command command)
                                                                                                                                                throws com.netflix.genie.common.exceptions.GenieException

Create a Command configuration.

Parameters:

command - The command configuration to create

Returns:

The command created

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

getCommand

@GetMapping(value="/{id}",
            produces="application/hal+json")
 @ResponseStatus(value=OK)
public CommandResource getCommand(@PathVariable(value="id")
                                                                                                                                     java.lang.String id)
                                                                                                                              throws com.netflix.genie.common.exceptions.GenieException

Get Command configuration for given id.

Parameters:

id - unique id for command configuration

Returns:

The command configuration

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

getCommands

@GetMapping(produces="application/hal+json")
 @ResponseStatus(value=OK)
public org.springframework.hateoas.PagedResources<CommandResource> getCommands(@RequestParam(value="name",required=false) @Nullable
                                                                                                                                                       java.lang.String name,
                                                                                                                                                       @RequestParam(value="user",required=false) @Nullable
                                                                                                                                                       java.lang.String user,
                                                                                                                                                       @RequestParam(value="status",required=false) @Nullable
                                                                                                                                                       java.util.Set<java.lang.String> statuses,
                                                                                                                                                       @RequestParam(value="tag",required=false) @Nullable
                                                                                                                                                       java.util.Set<java.lang.String> tags,
                                                                                                                                                       @PageableDefault(size=64,sort="updated",direction=DESC)
                                                                                                                                                       org.springframework.data.domain.Pageable page,
                                                                                                                                                       org.springframework.data.web.PagedResourcesAssembler<com.netflix.genie.common.dto.Command> assembler)
                                                                                                                                                throws com.netflix.genie.common.exceptions.GenieException

Get Command configuration based on user parameters.

Parameters:

name - Name for command (optional)

user - The user who created the configuration (optional)

statuses - The statuses of the commands to get (optional)

tags - The set of tags you want the command for.

page - The page to get

assembler - The paged resources assembler to use

Returns:

All the Commands matching the criteria or all if no criteria

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

updateCommand

@PutMapping(value="/{id}",
            consumes="application/json")
 @ResponseStatus(value=NO_CONTENT)
public void updateCommand(@PathVariable(value="id")
                                                                                                                                 java.lang.String id,
                                                                                                                                 @RequestBody
                                                                                                                                 com.netflix.genie.common.dto.Command updateCommand)
                                                                                                                          throws com.netflix.genie.common.exceptions.GenieException

Update command configuration.

Parameters:

id - unique id for the configuration to update.

updateCommand - the information to update the command with

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

patchCommand

@PatchMapping(value="/{id}",
              consumes="application/json")
 @ResponseStatus(value=NO_CONTENT)
public void patchCommand(@PathVariable(value="id")
                                                                                                                                    java.lang.String id,
                                                                                                                                    @RequestBody
                                                                                                                                    com.github.fge.jsonpatch.JsonPatch patch)
                                                                                                                             throws com.netflix.genie.common.exceptions.GenieException

Patch a command using JSON Patch.

Parameters:

id - The id of the command to patch

patch - The JSON Patch instructions

Throws:

com.netflix.genie.common.exceptions.GenieException - On error

deleteAllCommands

@DeleteMapping
 @ResponseStatus(value=NO_CONTENT)
public void deleteAllCommands()
                                                                         throws com.netflix.genie.common.exceptions.GenieException

Delete all applications from database.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

deleteCommand

@DeleteMapping(value="/{id}")
 @ResponseStatus(value=NO_CONTENT)
public void deleteCommand(@PathVariable(value="id")
                                                                                           java.lang.String id)
                                                                                    throws com.netflix.genie.common.exceptions.GenieException

Delete a command.

Parameters:

id - unique id for configuration to delete

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

addConfigsForCommand

@PostMapping(value="/{id}/configs",
             consumes="application/json")
 @ResponseStatus(value=NO_CONTENT)
public void addConfigsForCommand(@PathVariable(value="id")
                                                                                                                                                  java.lang.String id,
                                                                                                                                                  @RequestBody
                                                                                                                                                  java.util.Set<java.lang.String> configs)
                                                                                                                                           throws com.netflix.genie.common.exceptions.GenieException

Add new configuration files to a given command.

Parameters:

id - The id of the command to add the configuration file to. Not null/empty/blank.

configs - The configuration files to add. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

getConfigsForCommand

@GetMapping(value="/{id}/configs",
            produces="application/json")
 @ResponseStatus(value=OK)
public java.util.Set<java.lang.String> getConfigsForCommand(@PathVariable(value="id")
                                                                                                                                                                   java.lang.String id)
                                                                                                                                                            throws com.netflix.genie.common.exceptions.GenieException

Get all the configuration files for a given command.

Parameters:

id - The id of the command to get the configuration files for. Not NULL/empty/blank.

Returns:

The active set of configuration files.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

updateConfigsForCommand

@PutMapping(value="/{id}/configs",
            consumes="application/json")
 @ResponseStatus(value=NO_CONTENT)
public void updateConfigsForCommand(@PathVariable(value="id")
                                                                                                                                                   java.lang.String id,
                                                                                                                                                   @RequestBody
                                                                                                                                                   java.util.Set<java.lang.String> configs)
                                                                                                                                            throws com.netflix.genie.common.exceptions.GenieException

Update the configuration files for a given command.

Parameters:

id - The id of the command to update the configuration files for. Not null/empty/blank.

configs - The configuration files to replace existing configuration files with. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

removeAllConfigsForCommand

@DeleteMapping(value="/{id}/configs")
 @ResponseStatus(value=NO_CONTENT)
public void removeAllConfigsForCommand(@PathVariable(value="id")
                                                                                                                java.lang.String id)
                                                                                                         throws com.netflix.genie.common.exceptions.GenieException

Delete the all configuration files from a given command.

Parameters:

id - The id of the command to delete the configuration files from. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

addDependenciesForCommand

@PostMapping(value="/{id}/dependencies",
             consumes="application/json")
 @ResponseStatus(value=NO_CONTENT)
public void addDependenciesForCommand(@PathVariable(value="id")
                                                                                                                                                            java.lang.String id,
                                                                                                                                                            @RequestBody
                                                                                                                                                            java.util.Set<java.lang.String> dependencies)
                                                                                                                                                     throws com.netflix.genie.common.exceptions.GenieException

Add new dependency files for a given command.

Parameters:

id - The id of the command to add the dependency file to. Not null/empty/blank.

dependencies - The dependency files to add. Not null.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

getDependenciesForCommand

@GetMapping(value="/{id}/dependencies",
            produces="application/json")
 @ResponseStatus(value=OK)
public java.util.Set<java.lang.String> getDependenciesForCommand(@PathVariable(value="id")
                                                                                                                                                                             java.lang.String id)
                                                                                                                                                                      throws com.netflix.genie.common.exceptions.GenieException

Get all the dependency files for a given command.

Parameters:

id - The id of the command to get the dependency files for. Not NULL/empty/blank.

Returns:

The set of dependency files.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

updateDependenciesForCommand

@PutMapping(value="/{id}/dependencies",
            consumes="application/json")
 @ResponseStatus(value=NO_CONTENT)
public void updateDependenciesForCommand(@PathVariable(value="id")
                                                                                                                                                             java.lang.String id,
                                                                                                                                                             @RequestBody
                                                                                                                                                             java.util.Set<java.lang.String> dependencies)
                                                                                                                                                      throws com.netflix.genie.common.exceptions.GenieException

Update the dependency files for a given command.

Parameters:

id - The id of the command to update the dependency files for. Not null/empty/blank.

dependencies - The dependency files to replace existing dependency files with. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

removeAllDependenciesForCommand

@DeleteMapping(value="/{id}/dependencies")
 @ResponseStatus(value=NO_CONTENT)
public void removeAllDependenciesForCommand(@PathVariable(value="id")
                                                                                                                          java.lang.String id)
                                                                                                                   throws com.netflix.genie.common.exceptions.GenieException

Delete the all dependency files from a given command.

Parameters:

id - The id of the command to delete the dependency files from. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

addTagsForCommand

@PostMapping(value="/{id}/tags",
             consumes="application/json")
 @ResponseStatus(value=NO_CONTENT)
public void addTagsForCommand(@PathVariable(value="id")
                                                                                                                                            java.lang.String id,
                                                                                                                                            @RequestBody
                                                                                                                                            java.util.Set<java.lang.String> tags)
                                                                                                                                     throws com.netflix.genie.common.exceptions.GenieException

Add new tags to a given command.

Parameters:

id - The id of the command to add the tags to. Not null/empty/blank.

tags - The tags to add. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

getTagsForCommand

@GetMapping(value="/{id}/tags",
            produces="application/json")
 @ResponseStatus(value=OK)
public java.util.Set<java.lang.String> getTagsForCommand(@PathVariable(value="id")
                                                                                                                                                             java.lang.String id)
                                                                                                                                                      throws com.netflix.genie.common.exceptions.GenieException

Get all the tags for a given command.

Parameters:

id - The id of the command to get the tags for. Not NULL/empty/blank.

Returns:

The active set of tags.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

updateTagsForCommand

@PutMapping(value="/{id}/tags",
            consumes="application/json")
 @ResponseStatus(value=NO_CONTENT)
public void updateTagsForCommand(@PathVariable(value="id")
                                                                                                                                             java.lang.String id,
                                                                                                                                             @RequestBody
                                                                                                                                             java.util.Set<java.lang.String> tags)
                                                                                                                                      throws com.netflix.genie.common.exceptions.GenieException

Update the tags for a given command.

Parameters:

id - The id of the command to update the tags for. Not null/empty/blank.

tags - The tags to replace existing configuration files with. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

removeAllTagsForCommand

@DeleteMapping(value="/{id}/tags")
 @ResponseStatus(value=NO_CONTENT)
public void removeAllTagsForCommand(@PathVariable(value="id")
                                                                                                          java.lang.String id)
                                                                                                   throws com.netflix.genie.common.exceptions.GenieException

Delete the all tags from a given command.

Parameters:

id - The id of the command to delete the tags from. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

removeTagForCommand

@DeleteMapping(value="/{id}/tags/{tag}")
 @ResponseStatus(value=NO_CONTENT)
public void removeTagForCommand(@PathVariable(value="id")
                                                                                                            java.lang.String id,
                                                                                                            @PathVariable(value="tag")
                                                                                                            java.lang.String tag)
                                                                                                     throws com.netflix.genie.common.exceptions.GenieException

Remove an tag from a given command.

Parameters:

id - The id of the command to delete the tag from. Not null/empty/blank.

tag - The tag to remove. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

addApplicationsForCommand

@PostMapping(value="/{id}/applications",
             consumes="application/json")
 @ResponseStatus(value=NO_CONTENT)
public void addApplicationsForCommand(@PathVariable(value="id")
                                                                                                                                                            java.lang.String id,
                                                                                                                                                            @RequestBody
                                                                                                                                                            java.util.List<java.lang.String> applicationIds)
                                                                                                                                                     throws com.netflix.genie.common.exceptions.GenieException

Add applications for the given command.

Parameters:

id - The id of the command to add the applications to. Not null/empty/blank.

applicationIds - The ids of the applications to add. Not null.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

getApplicationsForCommand

@GetMapping(value="/{id}/applications",
            produces="application/hal+json")
 @ResponseStatus(value=OK)
public java.util.List<ApplicationResource> getApplicationsForCommand(@PathVariable(value="id")
                                                                                                                                                                                     java.lang.String id)
                                                                                                                                                                              throws com.netflix.genie.common.exceptions.GenieException

Get the applications configured for a given command.

Parameters:

id - The id of the command to get the application files for. Not NULL/empty/blank.

Returns:

The active applications for the command.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

setApplicationsForCommand

@PutMapping(value="/{id}/applications",
            consumes="application/json")
 @ResponseStatus(value=NO_CONTENT)
public void setApplicationsForCommand(@PathVariable(value="id")
                                                                                                                                                          java.lang.String id,
                                                                                                                                                          @RequestBody
                                                                                                                                                          java.util.List<java.lang.String> applicationIds)
                                                                                                                                                   throws com.netflix.genie.common.exceptions.GenieException

Set the applications for the given command.

Parameters:

id - The id of the command to add the applications to. Not null/empty/blank.

applicationIds - The ids of the applications to set in order. Not null.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

removeAllApplicationsForCommand

@DeleteMapping(value="/{id}/applications")
 @ResponseStatus(value=NO_CONTENT)
public void removeAllApplicationsForCommand(@PathVariable(value="id")
                                                                                                                          java.lang.String id)
                                                                                                                   throws com.netflix.genie.common.exceptions.GenieException

Remove the applications from a given command.

Parameters:

id - The id of the command to delete the applications from. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

removeApplicationForCommand

@DeleteMapping(value="/{id}/applications/{appId}")
 @ResponseStatus(value=NO_CONTENT)
public void removeApplicationForCommand(@PathVariable(value="id")
                                                                                                                              java.lang.String id,
                                                                                                                              @PathVariable(value="appId")
                                                                                                                              java.lang.String appId)
                                                                                                                       throws com.netflix.genie.common.exceptions.GenieException

Remove the application from a given command.

Parameters:

id - The id of the command to delete the application from. Not null/empty/blank.

appId - The id of the application to remove from the command. Not null/empty/blank.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error

getClustersForCommand

@GetMapping(value="/{id}/clusters",
            produces="application/hal+json")
 @ResponseStatus(value=OK)
public java.util.Set<ClusterResource> getClustersForCommand(@PathVariable(value="id")
                                                                                                                                                                        java.lang.String id,
                                                                                                                                                                        @RequestParam(value="status",required=false) @Nullable
                                                                                                                                                                        java.util.Set<java.lang.String> statuses)
                                                                                                                                                                 throws com.netflix.genie.common.exceptions.GenieException

Get all the clusters this command is associated with.

Parameters:

id - The id of the command to get the clusters for. Not NULL/empty/blank.

statuses - The statuses of the clusters to get

Returns:

The list of clusters.

Throws:

com.netflix.genie.common.exceptions.GenieException - For any error