REST API Reference Version 3.1.0.0Search

Update

PUT v1/application_servers/id

Description

Modify attributes of the specified application server.

Normal Response Codes

200

HTTP Error Codes

400 401 404 409 500 503

Detail Error Codes

Request

Parameter Type JSON Type Description Mandatory Deprecated
id NsObjectID string Identifier for the application server. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'. Yes  
name NsObjectName string Name for the application server. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'. No  
hostname NsFqdn string Application server hostname. String of up to 255 alphanumeric characters; - and . are allowed after the first and before the last character. Example: 'example-1.com'. No  
port NsPort number Application server port number. Integer value between 0-65535 representing TCP/IP TCP/IP port. Example: 1234. No  
username NsDescription string Application server username. String of up to 255 printable ASCII characters. Example: '99.9999% availability'. No  
description NsDescription string Text description of application server. String of up to 255 printable ASCII characters. Example: '99.9999% availability'. No  
password NsFlexiblePassword string Application server password. A password with few constraints. A string of up to 255 characters. Example: 'password_25-24'. No  
server_type NsAppServerType string enum Application server type ({invalid|vss|vmware}). Possible values: 'vss', 'vmware'. No  
metadata NsKeyValues Array of NsKeyValue Key-value pairs that augment an application server's attributes. List of key-value pairs. Keys must be unique and non-empty. When creating an object, values must be non-empty. When updating an object, an empty value causes the corresponding key to be removed. No  

JSON Request

Response

Parameter Type JSON Type Description Deprecated
id NsObjectID string Identifier for the application server. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  
name NsObjectName string Name for the application server. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'.  
hostname NsFqdn string Application server hostname. String of up to 255 alphanumeric characters; - and . are allowed after the first and before the last character. Example: 'example-1.com'.  
port NsPort number Application server port number. Integer value between 0-65535 representing TCP/IP TCP/IP port. Example: 1234.  
username NsDescription string Application server username. String of up to 255 printable ASCII characters. Example: '99.9999% availability'.  
description NsDescription string Text description of application server. String of up to 255 printable ASCII characters. Example: '99.9999% availability'.  
server_type NsAppServerType string enum Application server type ({invalid|vss|vmware}). Possible values: 'vss', 'vmware'.  
metadata NsKeyValues Array of NsKeyValue Key-value pairs that augment an application server's attributes. List of key-value pairs. Keys must be unique and non-empty. When creating an object, values must be non-empty. When updating an object, an empty value causes the corresponding key to be removed.  
creation_time NsTime number Time when this application server was created. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.  
last_modified NsTime number Time when this application server was last modified. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.  

JSON Response