system node virtual-machine instance show
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 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 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 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.
[-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.
[-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
[-storage-ontap-instance-id <text>]
- Storage ontap instance ID for the deployment-
Storage ONTAP instance ID for the deployment
[-vpc-partner-api-endpoint <text>]
- VPC partner api endpoint for the deployment-
VPC partner api endpoint for the deployment
[-self-setup {true|false}]
- Deployed and configured without BlueXP-
Deployed and configured without BlueXP
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: 3000 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 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 Storage Ontap Instance ID: b27115df-1f54-4ee6-85a6-1ae04a7fe42f