Virtual Machine Scale Sets - Get Instance View

Service:

Compute

API Version:

2018-04-01

Gets the status of a VM scale set instance.

HTTP

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/instanceView?api-version=2018-04-01

URI Parameters

Name	In	Required	Type	Description
resourceGroupName	path	True	string	The name of the resource group.
subscriptionId	path	True	string	Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.
vmScaleSetName	path	True	string	The name of the VM scale set.
api-version	query	True	string	Client Api Version.

Responses

Name	Type	Description
200 OK	VirtualMachineScaleSetInstanceView	OK

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Definitions

Name	Description
InstanceViewStatus	Instance view status.
StatusLevelTypes	The level code.
VirtualMachineScaleSetInstanceView	The instance view of a virtual machine scale set.
VirtualMachineScaleSetInstanceViewStatusesSummary	Instance view statuses summary for virtual machines of a virtual machine scale set.
VirtualMachineScaleSetVMExtensionsSummary	Extensions summary for virtual machines of a virtual machine scale set.
VirtualMachineStatusCodeCount	The status code and count of the virtual machine scale set instance view status summary.

InstanceViewStatus

Object

Instance view status.

Name	Type	Description
code	string	The status code.
displayStatus	string	The short localizable label for the status.
level	StatusLevelTypes	The level code.
message	string	The detailed status message, including for alerts and error messages.
time	string	The time of the status.

StatusLevelTypes

Enumeration

The level code.

Value	Description
Error
Info
Warning

VirtualMachineScaleSetInstanceView

Object

The instance view of a virtual machine scale set.

Name	Type	Description
extensions	VirtualMachineScaleSetVMExtensionsSummary[]	The extensions information.
statuses	InstanceViewStatus[]	The resource status information.
virtualMachine	VirtualMachineScaleSetInstanceViewStatusesSummary	The instance view status summary for the virtual machine scale set.

VirtualMachineScaleSetInstanceViewStatusesSummary

Object

Instance view statuses summary for virtual machines of a virtual machine scale set.

Name	Type	Description
statusesSummary	VirtualMachineStatusCodeCount[]	The extensions information.

VirtualMachineScaleSetVMExtensionsSummary

Object

Extensions summary for virtual machines of a virtual machine scale set.

Name	Type	Description
name	string	The extension name.
statusesSummary	VirtualMachineStatusCodeCount[]	The extensions information.

VirtualMachineStatusCodeCount

Object

The status code and count of the virtual machine scale set instance view status summary.

Name	Type	Description
code	string	The instance view status code.
count	integer	The number of instances having a particular status code.