Skip to main content

system node virtual-machine instance show

Contributors
Suggest changes

Display virtual machine instance information per node

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The system node virtual-machine instance show command displays virtual machine information. With this information you can determine the relationship between a Data ONTAP node and its associated virtual machine instance running within a cloud provider. Several other details about the virtual machine can be extracted as well, such as the cloud provider account ID to which it belongs. To filter command output, specify any number of optional fields listed below.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-node {<nodename>|local}] - Node

This optional parameter represents the name of the Data ONTAP node running in a virtual machine for which information is to be displayed. If this parameter is not specified, the command displays information about all nodes in the cluster.

[-instance-id <text>] - ID of This Instance

Selects the nodes that match this parameter value. A cloud provider-supplied unique instance ID for this virtual machine, for example "i-a9d42f89" or "db00a7755a5e4e8a8fe4b19bc3b330c3.1".

[-account-id <text>] - ID of This Account

Selects the nodes that match this parameter value. The cloud provider-associated account ID for this virtual machine. This parameter is usually associated with a cloud provider login ID and password.

[-image-id <text>] - ID Of the Image in Use on This Instance

Selects the nodes that match this parameter value. The image ID installed on this virtual machine instance. It identifies a pre-defined template of a computing device's software environment. It contains the operating system and can also include application software, such as database servers, middleware, and web servers. In this case, the ID refers to an image that contains everything required to run Data ONTAP in the cloud.

[-instance-type <text>] - Specifies System Attributes and Use Cost

Selects the nodes that match this parameter value. A specification (as defined by the cloud provider) that defines the memory, CPU, storage capacity and usage cost for a virtual machine instance. Some instance types are designed for standard applications, whereas others are designed for CPU-intensive or memory-intensive applications and so on.

[-region <text>] - Set of Resources in the Same Geographic Area

Selects the nodes that match this parameter value. A named set of resources in the same geographical area. For example "us-east-1" might be the name for a collection of compute and storage resources on the eastern coast of the United States. Typically, a region contains multiple availability zones.

[-version <text>] - Instance Metadata Version of This VM

Selects the nodes that match this parameter value. The instance metadata version of this virtual machine instance.

[-availability-zone <text>] - Distinct Location within a Region

Selects the nodes that match this parameter value. A distinct location within a region that is insulated from failures in other availability zones. It provides low-latency network connectivity to other availability zones in the same region.

[-primary-ip <text>] - Primary IP Address Assigned to this Instance

Selects the nodes that match this parameter value. The primary IP address assigned to this virtual machine instance.

[-fault-domain <integer>] - Fault Domain of This Instance

Selects the nodes that match this parameter value. A cloud provider-assigned numerical fault domain ID for this virtual machine within an Availability Set.

[-update-domain <integer>] - Update Domain of This Instance

Selects the nodes that match this parameter value. A cloud provider-assigned numerical update domain ID for this virtual machine within an Availability Set.

[-provider <text>] - Provider on which this instance is running.

Selects the nodes that match this parameter value. The provider on which this instance is running.

[-offer <text>] - Marketplace Offer for This Image

Selects the nodes that match this parameter value. A Marketplace is an online store that offers applications and services either built on or designed to integrate with a particular cloud provider. A virtual machine offer corresponds to a class of product offering from a publisher. An offer is a collection of SKUs. Every offer appears as its own entity in the provider Marketplace.

[-sku <text>] - Marketplace SKU for This Image

Selects the nodes that match this parameter value. A SKU is the smallest purchasable unit of an offer. While within the same product class (offer), SKUs allow you to differentiate between different features supported, VM image types and billing models supported.

[-sku-version <text>] - Marketplace Version of a SKU

Selects the nodes that match this parameter value. The version for this virtual machine SKU.

[-resource-group-name <text>] - Resource Group Name of This Instance

Selects the nodes that match this parameter value. Resource group for the instance.

[-cpu-platform <text>] - CPU Platform of the Instance

Selects the nodes that match this parameter value. GCP only. CPU platform of the hypervisor host. Example: Intel Broadwell .

[-consumer <text>] - Consumer of this Instance

Selects the nodes that match this parameter value. Consumer is based on the platform/infrastructure on which ONTAP is launched. Example: Marketplace .

[-total-network-bandwidth-limit <integer>] - Total Network Bandwidth Limit in MB/s

Selects the nodes that match this parameter value. Represents the total network bandwidth limit for the given VM in MBps. For IBM Cloud, the limit is calculated separately for ingress and egress. Example: 1024 .

[-total-volume-bandwidth-limit <integer>] - Total Volume Bandwidth Limit in MB/s

Selects the nodes that match this parameter value. Represents the total volume bandwidth limit for the given VM in MBps. For IBM Cloud, the limit is calculated separately for ingress and egress. Example: 1024 .

[-az-id <text>] - Id of Availability Zone in which the instance is running

Id of Availability Zone in which the instance is running

Examples

The following examples illustrate typical output from the system node virtual-machine instance show command for a virtual machine running in a cloud provider environment.

cluster1::> system node virtual-machine instance show
                                Node:  node1
                         Instance ID:  i-b9c42e97
                          Account ID:  751083215869
                            Image ID:  ami-7fb4a1c6
                       Instance Type:  m3.xlarge
                              Region:  us-east-1
                    Metadata Version:  2010-08-31
                   Availability Zone:  us-east-1d
                          Primary IP:  192.168.0.1
                            Provider:  AWS
                            Consumer:  Marketplace
                        Storage Type:  SSD
                             IOPS/GB:  5
               Storage Capacity (GB):  1024
          Throughput Capacity (MBps):  1000

cluster1::> system node virtual-machine instance show
               Node:  node1
        Instance ID:  090556da-d4fa-764f-a9f1-63614eda019a
   Metadata Version:  2012-11-30
   Availability Set:  Fault Domain:  0
                      Update Doamin: 0
         Primary IP:  192.168.0.1
           Provider:  Azure
              Offer:  netapp-ontap-cloud
                SKU:  ontap_cloud_pgo_sn
        SKU Version:  9.4.20180510
Resource Group Name:  resourcegroup1
         Account ID:  228e471c-3b42-4ae7-9b59-df5bb5e6228d

cluster1::> system node virtual-machine instance show
               Node:  node1
        Instance ID:  1234567890123456789
         Account ID:  customer-project-id
           Image ID:  projects/project-id/global/images/image-id
      Instance Type:  n1-standard-8
       CPU Platform:  Intel Broadwell
             Region:  us-east4
   Metadata Version:  v1
  Availability Zone:  us-east4-b
         Primary IP:  192.168.0.1
           Provider:  GCP

cluster1::> system node virtual-machine instance show
                                Node: node1
                         Instance ID: 0757_c00488fc-1de9-45e2-b895-4b05119cece2
                            Image ID: r014-31d63c06-b5da-4147-8751-c2502dfad35a
                       Instance Type: bx2-8x32
                        CPU Platform: Intel Xeon Processor (Cascadelake)
                    Metadata Version: 2022-05-31
                   Availability Zone: us-east-1
                          Primary IP: 10.160.96.82
                            Provider: IBM Cloud
                            Consumer: -
                 Resource Group Name: unknown
Total Network Bandwidth limit (MBps): 500
 Total Volume Bandwidth limit (MBps): 1500