REST API - get

vapi metadata cli command: get

Retrieves information about a command including information about how to execute that command.

Request:

HTTP request

POST https://{server}/rest/com/vmware/vapi/metadata/cli/command?~action=get

Request Body Structure:

{
    "identity" : {
        "path" : "string",
        "name" : "string"
    }
}

Request Body Parameters:

Name	Type	Description
bold = required
identity	identity	Identifier of the command for which to retreive information.
identity.path	string	The dot-separated path of the namespace containing the command in the CLI command tree.
identity.name	string	Name of the command.

Response:

HTTP Status Code: 200

Representation:

{
    "value" : {
        "formatter" : "SIMPLE",
        "output_field_list" : [
            {
                "output_fields" : [
                    {
                        "display_name" : "string",
                        "field_name" : "string"
                    },
                    {
                        "display_name" : "string",
                        "field_name" : "string"
                    }
                ],
                "structure_id" : "obj-103"
            },
            {
                "output_fields" : [
                    {
                        "display_name" : "string",
                        "field_name" : "string"
                    },
                    {
                        "display_name" : "string",
                        "field_name" : "string"
                    }
                ],
                "structure_id" : "obj-103"
            }
        ],
        "identity" : {
            "path" : "string",
            "name" : "string"
        },
        "service_id" : "obj-103",
        "options" : [
            {
                "short_option" : "string",
                "long_option" : "string",
                "description" : "string",
                "type" : "string",
                "generic" : "NONE",
                "field_name" : "string"
            },
            {
                "short_option" : "string",
                "long_option" : "string",
                "description" : "string",
                "type" : "string",
                "generic" : "NONE",
                "field_name" : "string"
            }
        ],
        "description" : "string",
        "operation_id" : "obj-103"
    }
}

Response Type:

Name	Type	Description
bold = required
value	info	Information about the command including information about how to execute that command.
value.identity	identity	Basic command identity.
value.identity.path	string	The dot-separated path of the namespace containing the command in the CLI command tree.
value.identity.name	string	Name of the command.
value.description	string	The text description displayed to the user in help output.
value.service_id	string	The service identifier that contains the operations for this CLI command. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: `com.vmware.vapi.service`. When operations return a value of this structure as a result, the field will be an identifier for the resource type: `com.vmware.vapi.service`.
value.operation_id	string	The operation identifier corresponding to this CLI command. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: `com.vmware.vapi.operation`. When operations return a value of this structure as a result, the field will be an identifier for the resource type: `com.vmware.vapi.operation`.
value.options	option_info[]	The input for this command.
value.options[].long_option	string	The long option name of the parameter as used by the user.
value.options[].short_option	string	The single character value option name. Optional. If not present, there's no single character option for the parameter.
value.formatter	string	The formatter to use when displaying the output of this command. Optional. If not present, client can choose a default output formatter.
value.output_field_list	output_info[]	List of output structure name and output field info.

Errors:

HTTP Status Code	Type	Description
404	not_found	if a command corresponding to `identity` doesn't exist.