| Oracle® Enterprise Manager Ops Center Cloud Infrastructure API and CLI Reference Guide 12c Release 1 (12.1.1.0.0) Part Number E25150-03 |
|
|
PDF · Mobi · ePub |
| Oracle® Enterprise Manager Ops Center Cloud Infrastructure API and CLI Reference Guide 12c Release 1 (12.1.1.0.0) Part Number E25150-03 |
|
|
PDF · Mobi · ePub |
This chapter can be used as reference to use the Cloud Infrastructure CLI once installed. It includes a description, syntax, options, and examples for each command.
All the Cloud Infrastructure CLI commands have one of two common prefixes:
akm: Use only for access key related commands.
akm-create-access-key
iaas: Use for all others cloud computing management commands.
iaas-create-volume
Every Cloud Infrastructure CLI command have some common options. Depending on the command prefix options vary. The following table list the command options, description, and indicate if it is a required for the command.
| Command Type | Option | Description | Required |
|---|---|---|---|
| akm and iaas | --base-url <base_url> |
Base URL of the Enterprise Controller where the Web service is running. https://<EnterpriseControllerhost>. |
Yes |
| akm | --user | The username for authentication. | Yes |
| akm | --password-file|-p <pw_file> |
Path to the password file for authentication. If this option is not supplied, the cloud user will instead be prompted for a password interactively | No |
| iaas | --access-key-file|-a <access_key_file>* |
Path of the file storing the access key. | Yes |
| akm and iaas | --help|-h | Explains the command usage and its arguments. | No |
| akm and iaas | --header|-H | Adds a header row to the output. | No |
| akm and iaas | --sep <separator> |
Specifies a column separator character. he default separator is TAB. | No |
| akm and iaas | --xml | Displays the output result in XML format., the default output is in table format. | No |
| akm and iaas | --verbose|-v | Starts the command in verbose mode. | No |
| akm and iaas | --debug|-D | Starts the command in debug mode. | No |
Alternatively, the value for the common required options can also be specified via environment variables: IAAS_PASSWORD_FILE, IAAS_BASE_URL, IAAS_USER, and IAAS_ACCESS_KEY_FILE.
Each command is delivered as separate file. There is also a short version for each command. Some command options also have a short version.
The following CLI commands are described in this section:
Creates an access key for a cloud user.
akm-create-access-key|akm-cak [--base-url <base_url>] [--debug] [--header]
[--user <user name>] [--help]
[--password-file <password_file>]
[--sep <separator>][--xml]
[--trust-store <truststore_file>]
[--for-user <username>]
--account <account-id> [--verbose]
--access-key-file <access_key_file>
This command delivers the access key ID and the access key file containing the private key of the newly created access key for the specified cloud user. The command also registers the access key to the specified account.
The access key file created by this command is used for authentication of every iaas command.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Username of the cloud user. The command validates the cloud user in the Oracle Enterprise Manager Ops Center instance and verify the cloud user has the correct privileges for the specified account. If this option is not specified, the user name is taken from the value set in the IAAS_USER environment variable.
Displays the usage information for this command.
Complete path and name of the file that will store the access key created after using this command, for example /tmp/ak.file. If a path is not specified, the file is created in the current directory.
Complete path and name of the file containing the password of the cloud user, for example /tmp/akpsswd.file. If a path is not specified for this file, the command line interface looks for the file in the current directory. If this option is not specified, and the value is not set in the IAAS_PASSWORD_FILE environment variable, the cloud user is prompted for a password interactively.
Column separator character, the default separator is TAB.
Name of the file that stores the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore.
Username of another cloud user to create an access key on behalf of that cloud user. This option validates that the cloud user using this option has cloud administrator privileges.
Account ID of the account for which the access key is created. The command checks that the specified user is already registered for that account. To get the account ID, use the akm-describe-accounts command.
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates the access key with the ID AK_3. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| user | <username> |
| password-file | ~/pwd.file |
| account | ACC-e7ed508a-dad3-4866-a41a-bf8850163b2e |
| access-key-file | ak.file |
bash-3.2$ ./akm-create-access-key --base-url https://<EnterpriseControllerHostname>/ --user <username> --password-file ~/pwd.file --account ACC-e7ed508a-dad3-4866-a41a-bf8850163b2e -a ak.file AK_3 bash-3.2$
This example creates an access key with ID AK_4 using the value set in the environment variables. This example uses these option values:
| Option | Environment Variable | Environment Variable Value |
|---|---|---|
| base-url | IAAS_BASE_URL | https://<EnterpriseControllerHostname>/ |
| user | IAAS_USER | <username> |
| password-file | IAAS_PASSWORD_FILE | ~/pwd.file |
| account | N/A | ACC-g7fg508a-dad3-4866-a41a-bf8850163c3f |
| access-key-file | N/A | ak.file |
bash-3.2$ ./akm-create-access-key --account ACC-g7fg508a-dad3-4866-a41a-bf8850163c3f --access-key-file ak.file AK_4 bash-3.2$
In this example a cloud administrator creates, on behalf of a cloud user, an access key with ID AK_10. This example uses these option values:
| Option | Environment Variable | Environment Variable Value |
|---|---|---|
| base-url | IAAS_BASE_URL | https://<EnterpriseControllerHostname>/ |
| user | IAAS_USER | cloudadmin |
| for-user | N/A | <username>1 |
| password-file | IAAS_PASSWORD_FILE | ~/pwd.file |
| account | N/A | ACC-g7fg508a-dad3-4866-a41a-bf8850163c3f |
| access-key-file | N/A | ak.file |
bash-3.2$ ./akm-create-access-key --account ACC-g7fg508a-dad3-4866-a41a-bf8850163c3f --access-key-file ak.file --for-user <username>1 AK_10 bash-3.2$
(Success) The command returns the access key ID of the newly created access key. When using the akm-describe-access-keys command, the access key is listed.
(Failure) The command displays a descriptive error message and error code.
An access key is unregistered for the specified account.
akm-delete-access-key|akm-delak [--base-url <base_url>] [--debug] [--header]
[--user <user name>] [--help]
[--password-file <pw_file>]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
<access-key-id>
This command deletes the access key association to the account. The access key file is not deleted using this command but the access key is no longer usable.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Username of the cloud user. The command validates the cloud user in the Oracle Enterprise Manager Ops Center instance and verify the cloud user has the correct privileges for the specified account. If this option is not specified, the user name is taken from the value set in the IAAS_USER environment variable.
Displays the usage information for this command.
Name of the file containing the password of the cloud user. If a path is not specified for this file, the command line interface looks for the file in the current directory. If this option is not specified, and the value is not set in the IAAS_PASSWORD_FILE environment variable, the cloud user is prompted for a password interactively.
Column separator character, the default separator is TAB.
Name of the file that stores the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore.
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
Access key ID of the access key that will be unregistered. Note. Access key IDs are displayed in the UI or by using akm-describe-access-keys command.
This example unregisters an access key. This example uses these options and values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| user | <username> |
| password-file | ~/pwd.file |
| access-key-id | AK_3 |
bash-3.2$ ./akm-delete-access-key --base-url https://<EnterpriseControllerHostname>/ --user <username> --password-file ~/pwd.file AK_3bash-3.2$
This example unregisters an access key. This example uses these options and values:
| Option | Environment Variable | Environment Variable Value |
|---|---|---|
| base-url | IAAS_BASE_URL | https://<EnterpriseControllerHostname>/ |
| user | IAAS_USER | <username> |
| password-file | IAAS_PASSWORD_FILE | ~/pwd.file |
| access-key-id | N/A | AK_4 |
bash-3.2$ ./akm-delete-access-key AK_4 bash-3.2$
(Success) The command does not return any value, just the command prompt is returned. When using the akm-describe-access-keys command, the access key is not listed.
(Failure) The command displays a descriptive error message and error code.
Displays a list of the access keys of a cloud user
akm-describe-access-keys|akm-dak [--base-url <base_url>] [--debug] [--header]
[--user <user name>] [--help]
[--password-file <password_file>]
[--sep <separator>]
[--trust-store <truststore_file>]
[--for-user <username>]
[--xml]
This command list information of the access keys created for a cloud user. The command displays the access key ID, the account, and username of the cloud user for each access key available for the specified cloud user.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Username of the cloud user. The command validates the cloud user in the Oracle Enterprise Manager Ops Center instance and verify the cloud user has the correct privileges for the specified account. If this option is not specified, the user name is taken from the value set in the IAAS_USER environment variable.
Displays the usage information for this command.
Name of the file containing the password of the cloud user. If a path is not specified for this file, the command line interface looks for the file in the current directory. If this option is not specified, and the value is not set in the IAAS_PASSWORD_FILE environment variable, the cloud user is prompted for a password interactively.
Column separator character, the default separator is TAB.
Name of the file that stores the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore.
Username of a different cloud user to display the access keys created for that cloud user. This option validates that the cloud user using this option has cloud administrator privileges.
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example displays the access keys of a cloud user. This example uses these options and values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| user | <username> |
| password-file | ~/pwd.file |
bash-3.2$ ./akm-describe-access-keys --base-url https://<EnterpriseControllerHostname>/ --user <username> --password-file ~/pwd.file AK_3 ACC-d7td508a-dad3-4866-a41a-bf8850163c3g <username> bash-3.2$
This example displays the access keys of a cloud user adding a header row. This example uses these options and values:
| Option | Environment Variable | Environment Variable Value |
|---|---|---|
| base-url | IAAS_BASE_URL | https://<EnterpriseControllerHostname>/ |
| user | IAAS_USER | <username> |
| password-file | IAAS_PASSWORD_FILE | ~/pwd.file |
bash-3.2$ ./akm-describe-access-keys -HaccessKeyId account user AK_3 ACC-d7td508a-dad3-4866-a41a-bf8850163c3g <username> bash-3.2$
(Success) The command displays a list containing the access key ID, the account ID, and username of the specified cloud user.
(Failure) The command displays a descriptive error message and error code.
Displays accounts information for a cloud user.
akm-describe-accounts|akm-dac [--base-url <base_url>] [--debug] [--header]
[--user <user name>] [--help]
[--password-file <password_file>]
[--sep <separator>]
[--trust-store <truststore_file>]
[--for-user <username>]
[--account <account-id>] [--verbose]
[--xml]
This command lists information about the accounts available for a cloud user. The command displays the username of the specified cloud user along with the account ID, name, and description of each account available for that cloud user.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Username of the cloud user. The command validates the cloud user in the Oracle Enterprise Manager Ops Center instance and verify the cloud user has the correct privileges for the specified account. If this option is not specified, the user name is taken from the value set in the IAAS_USER environment variable.
Displays the usage information for this command.
Name of the file containing the password of the cloud user. If a path is not specified for this file, the command line interface looks for the file in the current directory. If this option is not specified, and the value is not set in the IAAS_PASSWORD_FILE environment variable, the cloud user is prompted for a password interactively.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Username of another cloud user. This option validates that the cloud user using this option has cloud administrator privileges.
Account ID of the account. This option can be used as a filter to limit the information displayed to the specified account.Note. account IDs are displayed in the UI or by using akm-describe-user-accounts command.
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example displays the accounts information for a cloud user. This example uses these options and values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| user | <username> |
| password-file | ~/pwd.file |
bash-3.2$ ./akm-describe-accounts --base-url https://<EnterpriseControllerHostname>/ --user <username> --password-file ~/pwd.file ACC-f7gd508a-dad3-4866-a41a-bf8850163c3g account0 account0 for user <username> <username>ACC-95gdb073-d569-4a45-ac24-f14eba689a8g account1 account1 for user <username> <username>ACC-eag64db9-c0ee-43de-bb17-55cfb9d105fg account2 account2 for user <username> <username> bash-3.2$
This example displays the accounts information for a different cloud user including the header row. This example uses these options and values:
| Option | Environment Variable | Environment Variable Value |
|---|---|---|
| base-url | IAAS_BASE_URL | https://<EnterpriseControllerHostname>/ |
| user | IAAS_USER | <username> |
| password-file | IAAS_PASSWORD_FILE | ~/pwd.file |
| for-user | N/A | <username>0 |
bash-3.2$ ./akm-describe-accounts --for-user <username>0 -H account name description user ACC-f7gd508a-dad3-4866-a41a-bf8850163c3g account0 account0 for user <username>0 <username>ACC-95gdb073-d569-4a45-ac24-f14eba689a8g account1 account1 for user <username>0 <username> bash-3.2$
(Success) The command returns a list containing the account ID, the account name, the account description, and user name of the specified cloud user.
(Failure) The command displays a descriptive error message and error code.
Allocates a number of IP addresses from a virtual network.
iaas-allocate-ip-addresses|iaas-aip [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--vnet] <vnet-id>
[--num <num>]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command allocates a number of IP addresses from a public or private virtual network that could be associated later with a vServer.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
vNet ID from which ip addresses are allocated.
Number of IP addresses to be allocated. The default values is 1.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example allocates an IP address from the specified virtual network. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vNet ID | VNET-9634972a-bcdd-4714-8c7f-b67d8010f13c |
bash-3.2$ ./iaas-allocate-ip-addresses --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vnet VNET-9634972a-bcdd-4714-8c7f-b67d8010f13c 192.168.0.1 bash-3.2$
This example allocates three IP addresses from the specified virtual network. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vNet ID | VNET-9634972a-bcdd-4714-8c7f-b67d8010f13c |
bash-3.2$ ./iaas-allocate-ip-addresses --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vnet VNET-9634972a-bcdd-4714-8c7f-b67d8010f13c --num 3 192.168.0.2 192.168.0.3 192.168.0.4 bash-3.2$
(Success) The command returns a list of the allocated IP addresses. When using the iaas-describe-ip-addresses command, these IP addresses are listed.
(Failure) The command displays a descriptive error message and error code.
Attach one or more volumes to a stopped vServer.
iaas-attach-volumes-to-vserver|iaas-attvol [--base-url <base_url>] [--debug]
[--access-key-file <access-key-file>]
[--debug] [--header][--help]]
--vserver-id <vserver-id>
[--volume-ids] <vol-id>[,<vol-id>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command attaches one or more volumes to a stopped vServer.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Id of the vServer to which the volume will be attached.
IDs of the volumes to be attached.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example attachs a volume to a vServer. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vServer ID | VSRV-8ae29df9-ccfe-4184-acb8-10080665d7f6 |
bash-3.2$./iaas-attach-volumes-to-vserver --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file -vserver-id VSRV-0fb57293-347c-4717-96ef-6dd23154596f --volume-ids VOL-052cb4b4-5e56-4303-8b3a-82d6ba743a15 bash-3.2$
(Success) The command attachs the specified volume to the vServer. This command doesn't return any other response.
(Failure) The command displays a descriptive error message and error code.
Create a new distribution group for an account.
iaas-create-distribution-group|iaas-cdg [--base-url <base_url>] [--debug]
[--desc <descr>][--header] [--help]
[--access-key-file <access-key-file>]
--name <name>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command creates a distribution group for an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
An optional description for the distribution group.
Name of the distribution group.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates a distribution group for an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| name | myDistributionGroup |
bash-3.2$ ./iaas-create-distribution-group --base-url https://<EnterpriseControllerHostname>/ -a ak.file --name myDistributionGroup DG-068ae84c-d0fc-406d-aa37-0be4f88d411c bash-3.2$
(Success) The command returns the distribution group ID. When using the iaas-describe-distribution-groups command, the distribution group is listed.
(Failure) The command displays a descriptive error message and error code.
Creates a key pair for an account.
iaas-create-key-pair|iaas-ckp [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--key-file <key-file-name>
--key-name <key-pair-name>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command creates a key pair for an account. The command stores the private key of the key pair in the specified key file.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Name of the key pair.
Name of the key file that will store the private key of the key pair. If a path is not specified, the command creates the file in the current directory.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates a key pair in an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| key-name | myKeyPair |
| key-file | myKeyFile |
bash-3.2$ ./iaas-create-key-pair --base-url https://<EnterpriseControllerHostname>/ -a ak.file --key-name myKeyPair --key-file myKeyFile dx a9:60:cb:88:4a:42:2d:c5:d4:f1:23:63:64:54:d9:0a:e0:c5:a5:9e bash-3.2$
(Success) The command returns the key pair name and fingerprint. When using the iaas-describe-key-pairs command, the key pair is listed.
(Failure) The command displays a descriptive error message and error code.
Create a set of new server templates based on an assembly.
iaas-create-server-template-from-assembly|iaas-cstfa [--base-url <base_url>]
[--debug] [--header] [--help]
[--access-key-file <access-key-file>]
--name <name> [--desc <descr>]
[--url] <url>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command imports an assembly and creates one or more server templates in an account based on the assembly. Snapshots can be also created as a result of this action.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Add a header row to the output. If this option is not specified, no header row is displayed.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Name of the server template.
Description of the server template.
An assembly URL.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates a server template from the specified assembly. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| name | myAssembly |
| url | http://myServer.com/vm-templates/OVM.tar.gz |
bash-3.2$ ./iaas-create-server-template-from-assembly --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --name myAssembly --url http://myServer.com/myAssembly.ova ASSM-1110da89-64c7-4c11-a239-927b77e14c2 bash-3.2$
(Success) The command returns the assembly ID and loads the server templates for an account. When using the iaas-describe-server-templates command, the server templates are listed.
(Failure) The command displays a descriptive error message and error code.
Creates a server template based on a file accessible through a URL.
iaas-create-server-template-from-url|iaas-cstfu [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--name <name> [--desc <descr>]
[--url] <url>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command downloads the server template from the specified URL and then loads the server template in the associated account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Name of the server template.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Description of the server template.
Note: in demo, default description comes from OVM/third party?
Server template URL from which the server template is downloaded.
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates a server template from the specified URL. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| name | myST |
| url | http://myServer.com/vm-templates/OVM.tar.gz |
bash-3.2$ ./iaas-create-server-template-from-url --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --name myST --url http://myServer.com/vm-templates/OVM.tar.gz TMPL-9330da89-64c7-4c11-a239-927b77e344d1 bash-3.2$
(Success) The command returns the server template ID and loads the server template in an account. When using the iaas-describe-server-templates command, the server template is listed.
(Failure) The command displays a descriptive error message and error code.
Create a new server template based on a stopped vServer.
iaas-create-server-template-from-vserver|iaas-cstfi [--base-url <base_url>]
[--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--desc <descr>]
--name <name>
--vserver-id <vserver-id>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command creates a new server template based on a stopped vServer in the account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Description of the template.
Name of the template.
vServer ID.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates a server template from the specified URL. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| name | myST |
| vServer ID | http://myServer.com/vm-templates/OVM.tar.gz |
bash-3.2$ ./iaas-create-server-template-from-vserver --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --name myST --vserver-id VSRV-a959be32-6237-40c7-b44b-47d392e7a0ac TMPL-00005a39-93fd-44d9-86e5-2755d506f16f bash-3.2$
(Success) The command returns the server template ID and loads the server template in the account. When using the iaas-describe-server-templates command, the server template is listed.
(Failure) The command displays a descriptive error message and error code.
Create a snapshot based on an existing volume for an account.
iaas-create-snapshot|iaas-cs [--base-url <base_url>] [--debug]
[--access-key-file <access-key-file>]
[--header] [--help]
--name <name> [--desc <descr>]
[--volume-id] <volume-id>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command creates a snapshot based on an existing volume.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Description of the snapshot.
Name of the snapshot.
ID of the volume.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates a snapshot of the specified volume ID. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| volumeID | VOL-246b5c62-4072-41cf-885b-99d6c63583bd |
bash-3.2$ ./iaas-create-snapshot --base-url https://<EnterpriseControllerHostname>/ -a ak.file --volume-id VOL-246b5c62-4072-41cf-885b-99d6c63583bd --name mySnapshot SNAP-d7ca2baf-d10b-4ae9-a2c5-5355da9d7004 bash-3.2$
This example creates a snapshot of the specified volume ID. This example uses these option values:
| Option | Environment Variable | Environment Variable Value |
|---|---|---|
| base-url | IAAS_BASE_URL | https://<EnterpriseControllerHostname>/ |
| access-key-file | IAAS_ACCESS_KEY_FILE | ak.file |
| volumeID | N/A | VOL-246b5c62-4072-41cf-885b-99d6c63583bd |
bash-3.2$ ./iaas-create-snapshot --volume-id VOL-246b5c62-4072-41cf-885b-99d6c63583bd --name mySnapshot2 SNAP-d7ca2baf-d10b-4ae9-a2c5-5355da9d7002 bash-3.2$
(Success) The command returns the snapshot ID of the snapshot created. When using the iaas-describe-snapshots command, the snapshot is listed.
(Failure) The command displays a descriptive error message and error code.
Creates tags for a resource in an account.
iaas-create-tags|iaas-ctag [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--id <resource-id>
[--tags] <name>=<val>[,<name>=<val>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command adds or overwrites tags for the specified resource ID that exists in an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
ID of a resource in the account.
List of tag names and values.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example adds a tag to the specified resource. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| resource ID | VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t |
bash-3.2$ ./iaas-create-tags --base-url https://<EnterpriseControllerHostname>/ -a ak.file --id VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t --tags myTag=myTagValue bash-3.2$
This example adds two tags to the specified resource. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vNet ID | VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t |
bash-3.2$../iaas-create-tags --base-url https://<EnterpriseControllerHostname>/ -a ak.file --id VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t --tags myTag=myTagValue myTag2=myTag2Values bash-3.2$
(Success) The command adds or overwrites tags to the specified resource. This command does not return any value, just the command prompt. When using the iaas-describe-tags command, the tag is listed.
(Failure) The command displays a descriptive error message and error code.
Creates a private virtual network for the account.
iaas-create-vnet|iaas-cvn [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--name <name> [--desc <descr>]
[--size <size>]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command creates a private virtual network for an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Name of the virtual network.
Size of the subnet of the virtual network. The default value is.
Description of t he virtual network.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates a virtual network with the default subnet size. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| name | myVNET |
bash-3.2$ ./iaas-create-vnet --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --name myVNET VNET-350c9c3f-0ee5-41be-917e-ebbaed0fa4ad bash-3.2$
This example creates a virtual network with a subnet size of 16. This uses these option values:
| Option | Environment Variable | Environment Variable Value |
|---|---|---|
| base-url | IAAS_BASE_URL | https://<EnterpriseControllerHostname>/ |
| access-key-file | IAAS_ACCESS_KEY_FILE | ak.file |
| name | N/A | myVNET2 |
| size | N/A | 16 |
bash-3.2$ ./iaas-create-vnet --name myVNET2 --size 16 VNET-480c9c3f-0ee5-41be-917e-ebbaed0fa4gt bash-3.2$
(Success) The command returns a the vNet ID of the vNet created. When using the iaas-describe-vnets command, the vNet is listed.
(Failure) The command displays a descriptive error message and error code.
Creates a volume for an account.
iaas-create-volume|iaas-cvol [--base-url <base_url>] [--debug] [--header]
[--access-key-file <access-key-file>] [--help]
[--desc <descr>] [--snapshot-id <snapshot-id>]
--name <name> [--shared] [--size <size>]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command creates an empty volume of the specified size for the account. This command have also the option to create a volume from a snapshot.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Name of the volume.
Specifies if the volume is a shared volume, the default is a non-shared volume.
Size of the volume in GB. This option is required if a snapshot ID is not given.
Snapshot ID. The volume is created based on the specified snapshot.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Description of the volume.
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates a empty volume of 2 GB. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| name | firstVol |
bash-3.2$ ./iaas-create-volume --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --name firstVol --size 2 VOL-f23a8ba1-ec55-4159-bbdf-de220d18a1c4 bash-3.2$
This example creates a volume base on the specified snapshot. This uses these option values:
| Option | Environment Variable | Environment Variable Value |
|---|---|---|
| base-url | IAAS_BASE_URL | https://<EnterpriseControllerHostname>/ |
| access-key-file | IAAS_ACCESS_KEY_FILE | <username> |
| snapshot ID | N/A | SNAP-7a717e39-fe67-4573-a93d-889b3446176b |
bash-3.2$ ./iaas-create-volume --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --name myVol --snapshot-id SNAP-7a717e39-fe67-4573-a93d-889b3446176b VOL-g23a8ba1-ec55-4159-bbdf-de220d18a1b7 bash-3.2$
(Success) The command returns a the volume ID of the volume created. When using the iaas-describe-volumes command, the volume is listed
(Failure) The command displays a descriptive error message and error code.
Delete an existing distribution group.
iaas-delete-distribution-group|iaas-deldg [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--distribution-group-id] <distribution group-id>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command deletes a distribution group from an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Id of the distribution group.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example deletes an existing distribution group from an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| distribution group ID | DG-3206ed4d-44c9-42c4-8df7-511709a49ead |
bash-3.2$ ./iaas-delete-distribution-group --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --distribution-group-id DG-3206ed4d-44c9-42c4-8df7-511709a49ead bash-3.2$
(Success) The command deletes the specified distribution group from the account. The command does not return any value, just the command prompt is returned.
(Failure) The command displays a descriptive error message and error code.
Deletes an existing key pair from an account.
iaas-delete-key-pair|iaas-delkp [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--key-name <key-pair-name>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command deletes a key pair from an account
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Id of the key pair.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example deletes an existing key pair in an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| key pair name | key1 |
bash-3.2$ ./iaas-delete-key-pair --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --key-name key1 bash-3.2$
(Success) The command deletes the key pair. The command does not return any value, just the command prompt is returned.
(Failure) The command displays a descriptive error message and error code.
Deletes an existing server template.
iaas-delete-server-template|iaas-delstem [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
<server-template-id>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command deletes a server template based on the specified server template ID.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
ID of the server template.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example deletes an existing server template from an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| server-template-id | TMPL-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee03 |
bash-3.2$ ./iaas-delete-server-template --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --server-template-id TMPL-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee03 bash-3.2$
(Success) The command deletes the server template. The command does not return any value, just the command prompt is returned.
(Failure) The command displays a descriptive error message and error code.
Deletes a snapshot from an account.
iaas-delete-snapshot|iaas-dels [--base-url <base_url>] [--debug]
[--access-key-file <access-key-file>]
[--header] [--help]
[--snapshot-id] <snapshot-id>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command deletes a snapshot from an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
ID of the snapshot
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example deletes the specified snapshot from an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| snapshot ID | SNAP-d743e90c-53c5-4b01-a297-e2c944755c48 |
| access-key-file | ak.file |
bash-3.2$ ./iaas-delete-snapshot --base-url https://<EnterpriseControllerHostname>/ -a ak.file --snapshot-id SNAP-d743e90c-53c5-4b01-a297-e2c944755c48 bash-3.2$
(Success) The command deletes the specified snapshot. The command does not return any value, just the command prompt is returned.
(Failure) The command displays a descriptive error message and error code.
Delete tags from a resource.
iaas-delete-tags|iaas-deltag [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--id <resource-id>
[--tags] <name|val>[,<name|val>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command deletes tags from a resource in an account using the tag name.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
ID of a resource in an account.
List of tag names or values of the tags to be deleted.
Specify the column separator character(s), the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example deletes a tag from the specified resource. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| resource ID | VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t |
| tag name | myTag |
bash-3.2$ ./iaas-delete-tags --base-url https://<EnterpriseControllerHostname>/ -a ak.file --id VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t --tags myTag bash-3.2$
This example deletes two tags from the specified resource. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| resource ID | VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t |
| tag1 name | myTag |
| tag2 name | myTag2 |
bash-3.2$../iaas-delete-tags --base-url https://<EnterpriseControllerHostname>/ -a ak.file --id VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t --tags myTag,myTag2 bash-3.2$
(Success) The command deletes tags from the specified resource. This command does not return any value as part of the output, just the command prompt.
(Failure) The command displays a descriptive error message and error code.
Deletes a private vNet.
iaas-delete-vnet|iaas-delvn [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--vnet] <vnet-id>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command deletes an private vNet from an account. The vNet must not be associated with a vServer.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
ID of the virtual network.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example deletes the specified virtual network. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vNet ID | VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t |
bash-3.2$./iaas-delete-vnet --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vnet VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t bash-3.2$
(Success) The command deletes the specified vNet. This command does not return any message, the response is simply empty.
(Failure) The command displays a descriptive error message and error code.
Delete a volume from an account.
iaas-delete-volume|iaas-delvol [--base-url <base_url>] [--debug] [--header]
[--access-key-file <access-key-file>] [--help]
[--volume-id] <volume-id>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command deletes a volume. A deletion of a volume does not affect any volume snapshots that have been created prior based on the deleted volume.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
ID of the volume.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example deletes the specified volume. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| volume ID | VOL-82b4661e-de12-4931-b9a4-cce8edd23532 |
bash-3.2$./iaas-delete-volume --base-url https://<EnterpriseControllerHostname>/ -a ak.file --volume-id VOL-82b4661e-de12-4931-b9a4-cce8edd23532 bash-3.2$
(Success) The command deletes the specified volume. This command does not return any message, the response is simply empty.
(Failure) The command displays a descriptive error message and error code.
Displays attributes of a resource in an account.
iaas-describe-attributes|iaas-dat [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--id <resource-id>
[--attr-names] <name>[,<name>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command displays the attributes of a resource in an account. This command requires the input of the ID of the resource and the name of the attribute.
The name of the attribute is displayed as part of the header in the describe command for the related resource. For example, you can use the iaas-describe-volumes command with the --header option to see the attribute names for volumes.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
The ID of the resource. The ID of the resource can be obtained using the corresponding iaas-describe* command, for example iaas-describe-server-template.
List of attribute names. The name of the attribute is any of the names displayed in the header of output of a iaas-describe-* command, for example iaas-describe-server-template -H.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example displays the name attribute of the specified vNet. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| IvNet ID | VNET-7403e87f-1bab-4097-98ae-ea72d8fe4b3f |
bash-3.2$ ./iaas-describe-attributes --base-url https://<EnterpriseControllerHostname>/ -a ak.file --id VNET-7403e87f-1bab-4097-98ae-ea72d8fe4b3f --attr-names namename myVnet2bash-3.2$
This example displays the name and status attribute of the specified server template. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| server template ID | TMPL-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee01 |
bash-3.2$ ./iaas-describe-attributes --base-url https://<EnterpriseControllerHostname>/ -a ak.file --id TMPL-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee01 --attr-names name,status name default-server-template1 status OK bash-3.2$
(Success) The command returns the list of attributes of the specified resource.
(Failure) The command displays a descriptive error message and error code.
Lists distribution groups for an account.
iaas-describe-distribution-groups|iaas-ddg [--base-url <base_url>] [--debug]
[--access-key-file <access-key-file>]
[--help] [--header]
[--filters <name>=<val>[,<name>=<val>]*]
[--ids <dg-id>[,<dg-id>]*]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command lists the distribution groups in an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of filters.
List of distribution group ids.
Specify the column separator character(s), the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example lists the attributes of all distribution groups in an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$././iaas-describe-distribution-groups --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file -H id name description status DG-8e7b0d64-57ca-492d-806d-a2db6b9a00df distribGP OK DG-068ae84c-d0fc-406d-aa37-0be4f88d411c myDistributionGroup OK bash-3.2$
(Success) The command returns the list of distribution groups and their attributes. If no distribution groups are found, the response is simply empty.
(Failure) The command displays a descriptive error message and error code.
Lists of IP addresses allocated in an account.
iaas-describe-ip-addresses|iaas-dip [--base-url <base_url>] [--debug]
[--access-key-file <access-key-file>]
[--help] [--header]
[--filters <name>=<val>[,<name>=<val>]*]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command lists IP addresses allocated in an account. The attributes displayed as part of the list include the IP address, the vNet ID, and the vServer ID in case the IP address is associated with a vServer.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of filters, valid names are ipAddress, vnet, and vserver.
Specify the column separator character(s), the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example lists all allocated IP addresses for an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$./iaas-describe-ip-addresses --base-url https://<EnterpriseControllerHostname>/ -a ak.file 192.168.2.5 VNET-cde375904-9d34-4ec8-86b9-d917712abaaa VSRV-123456789-1234-1234-1234-123456789123 192.168.2.1 VNET-vfr4375904-9d34-4ec8-86b9-d917712abaaa192.168.2.1 VNET-vfr375904-9d34-4ec8-86b9-d917712abaaa bash-3.2$
This example lists the allocated IP addresses from the specified virtual network. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vNet ID | VNET-cde375904-9d34-4ec8-86b9-d917712abaaa |
bash-3.2$./iaas-describe-ip-addresses --base-url https://<EnterpriseControllerHostname>/ -a ak.file --filters vnet=VNET-cbd75904-9d34-4ec8-86b9-d917712abaaa,vnet=VNET-cde375904-9d34-4ec8-86b9-d917712abaaa 192.168.2.5 VNET-cde375904-9d34-4ec8-86b9-d917712abaaa 192.168.2.1 VNET-cde375904-9d34-4ec8-86b9-d917712abaaa bash-3.2$
(Success) The command returns the list of allocated IP addresses and their attributes. If no IP addresses are found, the response is simply empty.
(Failure) The command displays a descriptive error message and error code.
Displays key pairs for an account.
iaas-describe-key-pairs|iaas-dkp [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--filters <name>=<val>[,<name>=<val>]*]
[--key-names <key-pair-names>]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command lists the key pairs for an account. This command also allows filtering of the key pairs displayed.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of filters.
Name of key pairs.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example lists the attributes of all the existing key pairs in an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$ ./iaas-describe-key-pairs --base-url https://<EnterpriseControllerHostname>/ -a ak.file key1 d8:ab:f4:ca:51:ee:40:61:a1:c2:c0:13:49:7c:23:77 bash-3.2$
This example lists the attributes of the specified key pair. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| key pair name | key1 |
bash-3.2$./iaas-describe-key-pairs --base-url https://<EnterpriseControllerHostname>/ -a ak.file --key-names key1 -H name fingerprint key1 d8:ab:f4:ca:51:ee:40:61:a1:c2:c0:13:49:7c:23:77 bash-3.2$
(Success) The command returns the list of existing key pairs and their attributes. If no key pairs are found, the response is simply empty.
(Failure) The command displays a descriptive error message and error code.
Lists server templates for an account and their attributes.
iaas-describe-server-templates|iaas-dstem [--base-url <base_url>] [--debug]
[--access-key-file <access-key-file>]
[--header] [--help]
[--filters <name>=<val>[,<name>=<val>]*]
[--ids <t-id>[,<t-id>]*]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command lists the server templates loaded associated with the account. This command also allows filtering of the server templates displayed.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of filters to limit the server templates listed by this command. Valid names for filters are: description, ID, imageType, memory, name, public, readOnly, size, and status.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
List of server template IDs to filter the server templates listed by this command.
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example displays all existing server templates of an account adding the header row. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$ ./iaas-describe-server-templates --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file -H id name description status size public imageType readOnly TMPL-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee03 default-server-template3 Default Server Template OK 197912092999680 false VDMK false TMPL-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee05 default-server-template5 Default Server Template OK 197912092999680 false VDMK false bash-3.2$
This example displays server templates that are public to other accounts. This uses these option values:
| Option | Environment Variable | Environment Variable Value |
|---|---|---|
| base-url | IAAS_BASE_URL | https://<EnterpriseControllerHostname>/ |
| access-key-file | IAAS_ACCESS_KEY_FILE | <username> |
| filters | N/A | public=true |
bash-3.2$ ./iaas-describe-server-templates --filters public=true TMPL-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee02 default-server-template2 Default Server Template OK 197912092999680 true VDMK false TMPL-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee01 default-server-template1 Default Server Template OK 197912092999680 true VDMK false bash-3.2$
(Success) The command returns a list of the found server templates.
(Failure) The command displays a descriptive error message and error code.
Displays snapshots for an account.
iaas-describe-snapshots|iaas-ds [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--filters <val>[,<name>=<val>]*]
[--ids <vs-id>[,<vs-id>]*]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command lists the available snapshots for an account. This command also allows filtering of the snapshots displayed.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of filters. Valid names are description, id, name, and status.
IDs of the snapshots.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example lists the attributes of all the existing snapshots in an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$ ./iaas-describe-snapshots --base-url https://<EnterpriseControllerHostname>/ -a ak.file -H id name description status SNAP-2f2039cd-943b-4072-9ded-e96b54b7ca79 mySnapshot2 OK SNAP-d743e90c-53c5-4b01-a297-e2c944755c48 mySnapshot OK bash-3.2$
(Success) The command returns a list of the snapshots and their attributes.
(Failure) The command displays a descriptive error message and error code.
Displays existing tags in an account.
iaas-describe-tags|iaas-dtag [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--filters <name>[=<val>][,<name>[=<val>]]*]
[--ids <res-id>[,<res-id>]*]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command lists the resources in an account that have a tag associated with them. The attributes displayed by this command are the resource ID, the name of the tag, and the value of the tag. This command also allows filtering of the tags displayed.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of filters to limit the resources listed by this command.
Allows the filtering of tags by tag name, tag value, entity type (instance, template, key pair, vnet, volume, snapshot or instance snapshot) and entity identifier. The result contains only tags that matches against all elements of the filter list.
IDs of resources in the account to display only the tags associated to these resources.
Specify the column separator character(s), the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example lists the resources that have a tag associated to them in an account along with the tag name and value. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$ ./iaas-describe-tags --base-url https://<EnterpriseControllerHostname>/ -a ak.file VNET-77d2b71b-a5ff-4d76-bdc4-fbd9317bbdc1 vNet1Tag vNet1TagValue VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t vNet2Tag vNet1TagValue bash-3.2$
This example lists the tag names and values of the specified virtual network. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vNet ID | VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t |
bash-3.2$./iaas-describe-tags --base-url https://<EnterpriseControllerHostname>/ -a ak.file --ids VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t vNet2Tag vNet1TagValue bash-3.2$
This example identifies server templates from a particular assembly filtering with the tag name assemblyKey. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| assemblyKey | ASSM-ad6c7baa-0373-41bd-bd5a-051e4ec5f896 |
bash-3.2$./iaas-describe-tags --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file -H --ids TMPL-955e701d-1396-4e9a-b427-45b278870e1b,TMPL-fa591348-bfd1-40a3-b3a2-e030af76b968,TMPL-bc78b1c1-3a78-4f78-a486-6b2849e8040a,TMPL-5179af29-4332-434f-a25f-8002e61e87ee --filters assemblyKey=ASSM-ad6c7baa-0373-41bd-bd5a-051e4ec5f896 resourceId name value TMPL-955e701d-1396-4e9a-b427-45b278870e1b assemblyKey ASSM-ad6c7baa-0373-41bd-bd5a-051e4ec5f896 TMPL-fa591348-bfd1-40a3-b3a2-e030af76b968 assemblyKey ASSM-ad6c7baa-0373-41bd-bd5a-051e4ec5f896 bash-3.2$
(Success) The command returns the list of resources with the name and value of the associated tag.
(Failure) The command displays a descriptive error message and error code.
Displays the vDC capabilities for an account.
iaas-describe-vdc-capabilities|iaas-dvcap [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--filters <name>[=<val>][,<name>[=<val>]]*]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command displays the vDC capabilities for an account. This command also allows filtering of the vDC capabilities displayed.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
List of capability names and optional values to filter.
Displays the usage information for this command.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example lists the capabilities of the vDC associated with the account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$ ./iaas-describe-vdc-capabilities --base-url https://<EnterpriseControllerHostname>/ -a ak.file -H name value VirtualizationType OVM VirtualizationVersion 3.0.2 ProcessorArch Default_Intel_F6_M23 ProcessorVersion Default_Intel_Family:6_Model:23 DynamicVNetCreation disabled DistributionGroupSupport disabled bash-3.2$
This example lists only the virtualization type of the vDC for an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| filters | VirtualizationType |
bash-3.2$./iaas-describe-vdc-capabilities --base-url https://<EnterpriseControllerHostname>/ -a ak.file --filters VirtualizationType VirtualizationType OVM bash-3.2$
(Success) The command returns the list of vDC capabilities of the account.
(Failure) The command displays a descriptive error message and error code.
Lists virtual networks information for an account.
iaas-describe-vnets|iaas-dvn [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--filters <name>=<val>[,<name>=<val>]*]
[--ids <vn-id>[,<vn-id>]*]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command list the available virtual networks in an account. This command also allows filtering of the vNets displayed.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of filters to limit the virtual networks listed by this command. Valid names for filters are id, name, description, status, and ipAddress. The result contains only virtual networks that matches against all elements of the filter list.
IDs of the virtual networks.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example lists the attributes of all the virtual networks in an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$ ./iaas-describe-vnets --base-url https://<EnterpriseControllerHostname>/ -a ak.file VNET-9634972a-bcdd-4714-8c7f-b67d8010f13c vnet1 descvnet1 OK 192.168.0.0/24 VNET-8521f019-b50d-4051-8028-7ed2b0f5d767 vnet2 descvnet2 OK 192.168.3.0/24 VNET-7418613f-efaa-42f4-bc96-9583ec39a481 vnet3 descvnet3 OK 192.168.5.0/24 VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t vnet4 descvnet4 OK 192.168.6.0/24 bash-3.2$
This example lists the attributes of the specified virtual network IDs. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vNet ID | VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t
VNET-7418613f-efaa-42f4-bc96-9583ec39a481 |
bash-3.2$./iaas-describe-vnets --base-url https://<EnterpriseControllerHostname>/ -a ak.file --ids VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t,VNET-7418613f-efaa-42f4-bc96-9583ec39a481 VNET-7418613f-efaa-42f4-bc96-9583ec39a481 vnet3 descvnet3 OK 192.168.5.0/24 VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t vnet4 descvnet4 OK 192.168.6.0/24 bash-3.2$
(Success) The command returns the list of existing virtual networks and their attributes. If no virtual networks are found, the response is simply empty.
(Failure) The command displays a descriptive error message and error code.
Displays volumes information for an account.
iaas-describe-volumes|iaas-dvol [--base-url <base_url>] [--debug]
[--access-key-file <access-key-file>]
[--filters <name>=<val>[,<name>=<val>]*]
[--ids] <vol-id>[,<vol-id>]*
[--sep <separator>] [--header] [--help]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command lists available volumes for an account. This command also allows filtering of volumes displayed.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of filters. Valid names are: id, status,name,description,size, and shared.
List of volume IDs.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example lists the attributes of all the volumes found in an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$ ./iaas-describe-volumes --base-url https://<EnterpriseControllerHostname>/ -a ak.file -H id name description status size shared VOL-7f7b1963-283c-4f2d-9748-30cf87119cef myVol1 DescmyVol1 OK 0 VOL-82b4661e-de12-4931-b9a4-cce8edd23532 myVol2 DescmyVol1 OK 8 bash-3.2$
This example lists the attributes of the specified volume IDs. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| volume IDs | VOL-7f7b1963-283c-4f2d-9748-30cf87119cef
VOL-82b4661e-de12-4931-b9a4-cce8edd23532 |
bash-3.2$./iaas-describe-volumes --base-url https://<EnterpriseControllerHostname>/ -a ak.file --ids VOL-7f7b1963-283c-4f2d-9748-30cf87119cef,VOL-82b4661e-de12-4931-b9a4-cce8edd23532 VOL-7f7b1963-283c-4f2d-9748-30cf87119cef myVol1 DescmyVol1 OK 0 VOL-82b4661e-de12-4931-b9a4-cce8edd23532 myVol2 DescmyVol1 OK 8 bash-3.2$
(Success) The command returns the list of existing volumes and their attributes. If no volumes are found, the response is simply empty.
(Failure) The command displays a descriptive error message and error code.
Displays vServers information for an account.
iaas-describe-vservers|iaas-dvss [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--filters <name>=<val>[,<name>=<val>]*]
[--ids <id>[,<id>]*]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command displays attributes of vServers in an account. The command also allows filtering of vServers displayed.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of filters.
List of vServer IDs.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example lists the attributes of all the vServers found in an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$ ./iaas-describe-vservers --base-url https://<EnterpriseControllerHostname>/ -a ak.file -H id name description status vnets ipAddresses serverTemplateId keyName vserverType VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee05 name modified Default Virtual Server OK VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff01,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff02,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff03,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff04,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff05 small VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee03 default-vserver3 Default Virtual Server OK VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff01,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff02,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff03,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff04,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff05 mockupKey small VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee02 default-vserver2 Default Virtual Server OK VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff01,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff02,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff03,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff04,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff05 mockupKey small VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee04 default-vserver4 Default Virtual Server OK VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff01,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff02,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff03,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff04,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff05 mockupKey small VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee01 default-vserver1 Default Virtual Server OK VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff01,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff02,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff03,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff04,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff05 mockupKey small bash-3.2$
This example lists the attributes of the specified vServer IDs. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vServer IDs | VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee02
VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee03 |
bash-3.2$./iaas-describe-vservers --base-url https://<EnterpriseControllerHostname>/ -a ak.file --ids VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee02,VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee03 -H id name description status vnets ipAddresses serverTemplateId keyName vserverType VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee03 default-vserver3 Default Virtual Server OK VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff01,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff02,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff03,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff04,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff05 mockupKey small VSRV-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee02 default-vserver2 Default Virtual Server OK VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff01,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff02,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff03,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff04,VNET-aaaaaaa8-bbb4-ccc4-ddd4-ffffffffff05 mockupKey small bash-3.2$
(Success) The command returns the list of existing vServers and their attributes. If no volumes are found, the response is simply empty.
(Failure) The command displays a descriptive error message and error code.
Displays available vServers types for an account
iaas-describe-vserver-types|iaas-dvst [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command displays available vServers types for an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example lists all the permitted vserver types for an account. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
bash-3.2$ ./iaas-describe-vserver-types --base-url https://<EnterpriseControllerHostname>/ -a ak.file -H id name description status memorySize storageSize vcpu small small small instance type 1073741824 10737418240 1 medium medium medium instance type 4294967296 107374182400 2 large large large instance type 17179869184 1073741824000 4 bash-3.2$
(Success) The command returns the list of existing vSever types and their attributes. If no vServer types are found, the response is simply empty.
(Failure) The command displays a descriptive error message and error code.
Detach one or more volumes from a stopped vServer.
iaas-detach-volumes-from-vserver|iaas-detvol [--base-url <base_url>] [--debug]
[--access-key-file <access-key-file>]
[--header] [--help]
[--force]
--vserver-id <vserver-id>
[--volume-ids] <vol-id>[,<vol-id>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command detaches one or more volumes from a stopped vServer.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
ID of the vServer.
Volume IDs.
Force the detach.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example detaches a volume from a vServer. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vServer ID | VSRV-8ae29df9-ccfe-4184-acb8-10080665d7f6 |
bash-3.2$./iaas-detach-volumes-from-vserver --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file -vserver-id VSRV-0fb57293-347c-4717-96ef-6dd23154596f --volume-ids VOL-052cb4b4-5e56-4303-8b3a-82d6ba743a15 --force bash-3.2$
(Success) The command detaches the specified volume from the vServer. This command doesn't return any other response.
(Failure) The command displays a descriptive error message and error code.
Imports an existing key pair to an account.
iaas-import-key-pair|iaas-ikp [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--key-file <key-file-name>
--key-name <key-pair-name>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command stores a public RSA key to the application. This public key is created with a third-party tool and it is stored in the key-file used as part of this command.
The supported formats of the public key to be imported are:
OpenSSH
SECSH
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Name of the file containing the public key.
Name of the key pair.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example imports a key pair based on the specified key pair file. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| file containing a public key | myOtherPair.key |
| key name | myOtherPair |
bash-3.2$ ./iaas-import-key-pair --base-url https://<EnterpriseControllerHostname>/ -a ak.file --key-name myOtherPair --key-file myOtherPair.key myOtherPair d9:ab:f4:ca:51:ee:40:61:a1:c2:c0:13:49:7c:23:77 bash-3.2$
(Success) The command returns the name and the fingerprint of the imported key.
(Failure) The command displays a descriptive error message and error code.
Imports a volume.
iaas-import-volume|iaas-ivol [--base-url <base_url>] [--debug]
[--access-key-file <access-key-file>]
[--header] [--help]
--name <name>
[--desc <descr>]
[--url] <url>
[--sep <separator>]
[--shared]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command imports a volume from another location.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Name of the volume.
URL of the volume to import.
Column separator character, the default separator is TAB.
Flag to indicate that the volume is shared.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Description of the volume.
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example imports a volume based on the image file of the specified url. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| url | http://ovm.oracle.com/volume-image/volume.img |
| volume name | myVolume |
bash-3.2$ ./iaas-import-volume --base-url https://<EnterpriseControllerHostname>/ -a ak.file --name myVolume --url http://ovm.oracle.com/volume-image/volume.img VOL-e9afec8c-dbe2-4e03-8561-15716650b81e bash-3.2$
(Success) The command returns the volume ID.
(Failure) The command displays a descriptive error message and error code.
Modifies attributes of a resource in an account.
iaas-modify-attributes|iaas-ma [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--id <resource-id>
[--attributes] <name>=<val>[,<name>=<val>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command modifies attributes of a resource in an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Displays the usage information for this command.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
ID of the resource. The ID of the resource can be obtained using the corresponding iaas-describe* command, for example iaas-describe-server-template.
List of attribute names. The name of the attribute is any of the names displayed in the header of output of a iaas-describe-* command, for example iaas-describe-server-template -H.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example modifies the name attribute of the specified vNet. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| IvNet ID | VNET-7403e87f-1bab-4097-98ae-ea72d8fe4b3f |
bash-3.2$ ./iaas-modify-attributes --base-url https://<EnterpriseControllerHostname>/ -a ak.file --id VNET-7403e87f-1bab-4097-98ae-ea72d8fe4b3f --attributes name=myNewName bash-3.2$
This example modifies the name and public attribute of the specified server template. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| Iserver template ID | TMPL-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee01 |
bash-3.2$ ./iaas-modify-attributes --base-url https://<EnterpriseControllerHostname>/ -a ak.file --id TMPL-aaaaaaa8-bbb4-ccc4-ddd4-eeeeeeeeee01 --attributes name=myNewName,public=true bash-3.2$
(Success) The command modifies the specified attributes. This command does not return any value, just the command prompt.
(Failure) The command displays a descriptive error message and error code.
Reboots vServers for an account.
iaas-reboot-vservers|iaas-rebvss [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--vserver-ids] <id>[,<id>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command reboots one or more vServers for an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Displays the usage information for this command.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
vServer IDs.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example reboots a vServer. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vServer ID | VSRV-8ae29df9-ccfe-4184-acb8-10080665d7f6 |
bash-3.2$./iaas-reboot-vservers --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file --vserver-ids VSRV-0fb57293-347c-4717-96ef-6dd23154596f bash-3.2$
(Success) The command restarts the specified vServers. This command doesn't return any other response.
(Failure) The command displays a descriptive error message and error code.
Receives one message from a vServer.
iaas-receive-message-from-vserver|iaas-rmfvs [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--vserver-id <vserver-id>
[--key] <key>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command receives one message from a vServer. The command reads the message from the common buffer in the virtualization layer by name. This action might return an error if the vServer is not in appropriate state to receive messages.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
vServer ID.
Key of the message to retrieve.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example sends a message to a vServer. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vServer ID | VSRV-8ae29df9-ccfe-4184-acb8-10080665d7f6 |
bash-3.2$../iaas-receive-message-from-server --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file --vserver-id VSRV-8ae29df9-ccfe-4184-acb8-10080665d7f6 --key com.oracle.ovab.test-response MyMessage bash-3.2$
(Success) The command displays the message received from the specified vServer.
(Failure) The command displays a descriptive error message and error code.
Release allocated IP addresses of a virtual network.
iaas-release-ip-addresses|iaas-rip [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--vnet <vnet-id>
[--ip-addresses] <ip>[,<ip>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command release allocated IP addresses of a public or private virtual network. The IP addresses must not be associated with a vServer.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
vNet ID of the IP addresses to be released.
List of IP addresses to be released.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example releases an allocated IP address of the specified virtual network. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vNet ID | VNET-9634972a-bcdd-4714-8c7f-b67d8010f13c |
bash-3.2$ ./iaas-release-ip-addresses --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vnet VNET-9634972a-bcdd-4714-8c7f-b67d8010f13c --ip-addresses 192.168.0.1 bash-3.2$
This example releases 3 allocated IP addresses of the specified virtual network. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vNet ID | VNET-9634972a-bcdd-4714-8c7f-b67d8010f13c |
bash-3.2$ ./iaas-release-ip-addresses --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vnet VNET-9634972a-bcdd-4714-8c7f-b67d8010f13c --ip-addresses 192.168.0.2,192.168.0.3,192.168.0.4 bash-3.2$
(Success) The command releases the allocated IP addresses of the specified virtual network. The command does not returns any messages.
(Failure) The command displays a descriptive error message and error code.
Runs a single vServer.
iaas-run-vserver|iaas-rvs [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--dist-group <dg-id>]
--ip-addresses <ip>[,<ip>]*
--key-name <key-pair-name>
--name <name>
[--desc <descr>]
--server-template-id <server-template-id>
--vnets <vn-id>[,<vn-id>]*
[--volumes <vol-id>[,<vol-id>]*]
--vserver-type <type>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command creates and starts a single vServer.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
A distribution group ID.
List of ip addresses, one for each virtual network.
Name of the key pair.
Name of the vServer.
Description of the vServer.
ID of the server template.
List of virtual network IDs.
List of volumeIDs.
vServer type.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates and starts a vServer. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| key pair name | myKeyPair |
bash-3.2$../iaas-run-vserver --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file --vnets VNET-84ada392-1c13-4f86-8365-1cf7f9c8aadf --key-name myKeyPair --name myVserver --server-template-id TMPL-9e4a9ed3-e675-45f1-9d7c-b21c25a55632 --ip-addresses 192.168.0.2 --vserver-type 457 VSRV-0fb57293-347c-4717-96ef-6dd23154596f bash-3.2$
(Success) The command creates and starts a vServer. This command returns the vServer ID.
(Failure) The command displays a descriptive error message and error code.
Create and starts one or more vServers.
iaas-run-vservers|iaas-rvss [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--key-name <key-pair-name>
--name <name>
[--desc <descr>]
[--dist-group <dg-id>]
[--num <num>]
--server-template-id <server-template-id>
--vnets <vn-id>[,<vn-id>]*
[--volumes <vol-id>[,<vol-id>]*]
--vserver-type <type>
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command create and starts one or more vServers. A suffix is appended a numerical sequence to the name to distinguish among all vServers created.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Name of the key pair.
Name of the vServer.
Description of the vServer.
Distribution group ID.
The number of vServers to run, default is 1.
ID of the server template.
List of virtual network IDs.
List of volume IDs.
vServer type.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example creates two vServers. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| key pair | myKeyPair |
bash-3.2$./iaas-run-vservers --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file --key-name myKeyPair --name myVserver --num 2 --server-template-id TMPL-2f313208-433c-4b92-aae6-6373c38b795e --vnets VNET-6ea466f5-6e6b-4159-adf3-8867473d4cf4 --vserver-type 457 VSRV-d6800889-f59b-4798-a57d-3f9f31b0cf1c VSRV-d6500889-f59b-4567-a65g-3f9f31b0se1d bash-3.2$
(Success) The command creates and starts the number of specified vServers. This command returns the vServer IDs.
(Failure) The command displays a descriptive error message and error code.
Sends messages to a vServer.
iaas-send-messages-to-vserver|iaas-smtvs [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
--vserver-id <vserver-id>
[--messages] <key>=<value>[,<key>=<value>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command sends messages to a vServer. These messages can be read from the guest OS. The message is sent to a common buffer in the virtualization layer that have a limited size. This action might return an error if the size limit is reached or if the vServer is not in appropriate state to send messages.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
vServer ID.
List of messages.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example sends a message to a vServer. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vServer ID | VSRV-8ae29df9-ccfe-4184-acb8-10080665d7f6 |
bash-3.2$../iaas-send-message-to-vserver --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file --vserver-id VSRV-8ae29df9-ccfe-4184-acb8-10080665d7f6 --messages com.oracle.ovab.test=Running bash-3.2$
(Success) The command sends the message to the specified vServer. This command doesn't return any other response.
(Failure) The command displays a descriptive error message and error code.
Starts one or more vServers for an account.
iaas-start-vservers|iaas-stavss [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--vserver-ids] <id>[,<id>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command starts one or more vServers for an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of vServer IDs.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
The following example starts the specified vServer. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| IvServer ID | VSRV-c1e236e6-ef4d-4936-911a-97923dfbc291 |
bash-3.2$ ./iaas-start-vservers --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vserver-ids VSRV-c1e236e6-ef4d-4936-911a-97923dfbc291 bash-3.2$
(Success) The command starts the specified vServer. This command does not return any value, just the command prompt.
(Failure) The command displays a descriptive error message and error code.
Stops one or more vServers for an account.
iaas-stop-vservers|iaas-stovss [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--vserver-ids] <id>[,<id>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command stops one or more vServers for an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
List of vServer IDs.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
The following example stops the specified vServer. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| IvServer ID | VSRV-c1e236e6-ef4d-4936-911a-97923dfbc291 |
bash-3.2$ ./iaas-stop-vservers --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vserver-ids VSRV-c1e236e6-ef4d-4936-911a-97923dfbc291 bash-3.2$
(Success) The command stops the specified vServer. This command does not return any value, just the command prompt.
(Failure) The command displays a descriptive error message and error code.
Stops and deletes one or more vServers for an account.
iaas-terminate-vservers|iaas-tvss [--base-url <base_url>] [--debug]
[--header] [--help]
[--access-key-file <access-key-file>]
[--force]
[--vserver-ids] <id>[,<id>]*
[--sep <separator>]
[--trust-store <truststore_file>]
[--verbose] [--xml]
This command stops and deletes one or more vServers for an account.
Base URL of the Enterprise Controller where the Web service is running. The value for this option must use the following syntax: https://<EnterpriseControllerHostname>. If this option is not specified, the URL information is taken from the value set in the IAAS_BASE_URL environment variable.
Starts the command in debug mode.
Adds a header row to the output. The default output shows no header.
Complete path and name of the file that stores the access key, for example /tmp/ak.file. If a path is not specified, the command looks for the file in the current directory.
Displays the usage information for this command.
Forces the execution of the command.
List of vServer IDs.
Column separator character, the default separator is TAB.
Name of the file containing the trusted SSL certificate. The default is $HOME/.oracle_iaas/truststore).
Starts the command in verbose mode.
Displays the output result in XML format, the default output is in table format.
This example deletes a vServer. This example uses these option values:
| Option | Option value |
|---|---|
| base-url | https://<EnterpriseControllerHostname>/ |
| access-key-file | ak.file |
| vServer ID | VSRV-0fb57293-347c-4717-96ef-6dd23154596f |
bash-3.2$./iaas-terminate-vservers --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file --vserver-ids VSRV-0fb57293-347c-4717-96ef-6dd23154596f --force bash-3.2$
(Success) The command stops and deletes the specified vServers. This command doesn't return any other response.
(Failure) The command displays a descriptive error message and error code.
|
 Copyright © 2007, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|