REST API Reference Version 3.1.0.0Search

Create

POST v1/application_servers

Description

Create a new application server.

Normal Response Codes

201

HTTP Error Codes

400 401 404 409 500 503

Detail Error Codes

Request

Parameter Type JSON Type Description Default Mandatory Deprecated
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'.   Yes  
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'.   Yes  
port NsPort number Application server port number. Integer value between 0-65535 representing TCP/IP TCP/IP port. Example: 1234. 65536 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'. '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