Documentation Index

Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

getRootPasswordServerInstanceList

Prev Next

Available in VPC

Use the authentication key for a server instance (VM) to get the list of admin passwords.

Syntax

The getRootPasswordServerInstanceList syntax is as follows:

./ncloud vserver getRootPasswordServerInstanceList \
    --rootPasswordServerInstanceList <root-password-server-instance-config> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running getRootPasswordServerInstanceList.

Required options

The following options are required for getRootPasswordServerInstanceList.

Options Type Required Description
--rootPasswordServerInstanceList List Required List of server instance and authentication key mappings
  • For each entry, enter {field=‘value’} pairs within quotation marks, separated by commas.
    • serverInstanceNo (required): Server instance number. See getServerInstanceList.
    • privateKey (required): Authentication key (private key). Enter the contents of a PEM file you created or imported from an external source. Line breaks are represented by \n. file:// or http(s):// path formats are also supported.

Common options

For information about the options common to all vserver subcommands, see Server (VPC) options.

Examples

If the request to retrieve the list of admin passwords is successful, the identification information for each server instance and the decrypted admin passwords are returned.

Command

The command example is as follows:

./ncloud vserver getRootPasswordServerInstanceList \
    --rootPasswordServerInstanceList \
        "serverInstanceNo='34567890', privateKey='file://path/to/key.pem'" \
        "serverInstanceNo='34567891', privateKey='file://path/to/key.pem'" \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "getRootPasswordServerInstanceListResponse": {
    "totalRows": 1,
    "rootPasswordServerInstanceList": [
      {
        "serverInstanceNo": "34567890",
        "rootPassword": "<root-password-redacted>"
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}