Command

A Command represents an operation that needs to be executed on an entity (NSG, Gateway, ...) which requires little processing by VSD, but may result in a long activity on the external entity. An example would be to trigger an action on VSD so that a Gateway download a new image. VSDs handling of the request is limited to generating a message to be sent to the device on which the download process is expected. The device then acts on the request and proceeds with the download... That may be a long process. The commands API is similar to the Jobs API with regards to triggering operations on objects.

Overview

command enum (NSG_DOWNLOAD_OS_IMAGE | NSG_UPGRADE_TO_IMAGE | UNKNOWN) required   creation only   filterable   orderable  
commandInformation string read only   autogenerated  
detailedStatus string read only   autogenerated  
detailedStatusCode integer read only   autogenerated   filterable   orderable  
entityScope enum (ENTERPRISE | GLOBAL) autogenerated  
externalID string filterable   orderable   locally unique  
lastUpdatedBy string autogenerated  
status enum (COMPLETE | FAILED | STARTED | UNKNOWN) read only   autogenerated   filterable   orderable  
summary string required   read only   autogenerated  

API Resource

/commands/id
delete get put

Parents

/nsgateways/id/commands
get post

Children

This object has no children.

Members

This object has no members.

Attributes documentation

command enum required   creation only   filterable   orderable  
Discussion

Specifies the type of command that is stated for execution on the system receiving the operation request. A request for download, a request for upgrade, a request for revocation, ...

Charateristics

Allowed values: NSG_DOWNLOAD_OS_IMAGE, NSG_UPGRADE_TO_IMAGE, UNKNOWN
Default value: UNKNOWN
SDK attribute: command

commandInformation string read only   autogenerated  
Discussion

Informative details on what command is to be executed. It complements the commandType attribute. An example of a value could be a URL, a version number, a UUID of another object, ...

Charateristics

Format: free
Max length: 1023
SDK attribute: commandInformation

detailedStatus string read only   autogenerated  
Discussion

A string representing the detailed status of the operation that was triggered by the execution of the Command instance.

Charateristics

Format: free
Max length: 255
SDK attribute: detailedStatus

detailedStatusCode integer read only   autogenerated   filterable   orderable  
Discussion

A numerical code mapping to a list of detailed statuses that can apply to a Command instance.

Charateristics

Default value: 0
Max value: 65535
SDK attribute: detailedStatusCode

entityScope enum autogenerated  
Discussion

Specify if scope of entity is Data center or Enterprise level

Charateristics

Allowed values: ENTERPRISE, GLOBAL
SDK attribute: entityScope

externalID string filterable   orderable   locally unique  
Discussion

External object ID. Used for integration with third party systems

Charateristics

Format: free
SDK attribute: externalID

lastUpdatedBy string autogenerated  
Discussion

ID of the user who last updated the object.

Charateristics

Format: free
SDK attribute: lastUpdatedBy

status enum read only   autogenerated   filterable   orderable  
Discussion

The status of the Command from a VSD perspective.

Charateristics

Allowed values: COMPLETE, FAILED, STARTED, UNKNOWN
Default value: UNKNOWN
SDK attribute: status

summary string required   read only   autogenerated  
Discussion

A generated summary for the action giving some general context on the command executed.

Charateristics

Format: free
Min length: 1
Max length: 255
SDK attribute: summary