Virtual Machine Scale Set VMs - Get Instance View

VM 확장 집합에서 가상 머신의 상태를 가져옵니다.

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

URI 매개 변수

Name In Required Type Description
instanceId
path True
  • string

가상 머신의 인스턴스 ID입니다.

resourceGroupName
path True
  • string

리소스 그룹의 이름.

subscriptionId
path True
  • string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.

vmScaleSetName
path True
  • string

VM 확장 집합의 이름입니다.

api-version
query True
  • string

클라이언트 API 버전입니다.

응답

Name Type Description
200 OK

확인

Other Status Codes

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

OAuth2 Flow Azure Active Directory

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

Get instance view of a virtual machine from a VM scale set placed on a dedicated host group through automatic placement.

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet/virtualMachines/0/instanceView?api-version=2022-08-01

Sample Response

{
  "platformUpdateDomain": 0,
  "platformFaultDomain": 0,
  "rdpThumbPrint": null,
  "vmAgent": {
    "vmAgentVersion": "Unknown",
    "statuses": [
      {
        "code": "ProvisioningState/Unavailable",
        "level": "Warning",
        "displayStatus": "Not Ready",
        "message": "VM status blob is found but not yet populated.",
        "time": "2022-08-01T05:00:32+00:00"
      }
    ],
    "extensionHandlers": null
  },
  "disks": [
    {
      "name": "myOSDisk",
      "encryptionSettings": null,
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "message": null,
          "time": "2022-08-01T04:58:58.0882815+00:00"
        }
      ]
    }
  ],
  "extensions": null,
  "assignedHost": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup/hosts/myHost",
  "bootDiagnostics": null,
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "message": null,
      "time": "2020-06-05T04:59:58.1852966+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running",
      "message": null,
      "time": null
    }
  ]
}

정의

ApiError

API 오류입니다.

ApiErrorBase

API 오류 기준입니다.

BootDiagnosticsInstanceView

가상 머신 부팅 진단의 인스턴스 보기입니다.

CloudError

Compute 서비스의 오류 응답입니다.

DiskEncryptionSettings

디스크에 대한 암호화 설정 설명합니다.

DiskInstanceView

디스크의 인스턴스 뷰입니다.

InnerError

내부 오류 세부 정보입니다.

InstanceViewStatus

인스턴스 보기 상태입니다.

KeyVaultKeyReference

Key Vault 키에 대한 참조를 설명합니다.

KeyVaultSecretReference

Key Vault 비밀에 대한 참조를 설명합니다.

MaintenanceOperationResultCodeTypes

마지막 유지 관리 작업 결과 코드입니다.

MaintenanceRedeployStatus

유지 관리 작업 상태입니다.

StatusLevelTypes

수준 코드입니다.

SubResource
VirtualMachineAgentInstanceView

가상 머신에서 실행되는 VM 에이전트의 인스턴스 보기입니다.

VirtualMachineExtensionHandlerInstanceView

가상 머신 확장 처리기의 인스턴스 뷰입니다.

VirtualMachineExtensionInstanceView

가상 머신 확장의 인스턴스 뷰입니다.

VirtualMachineHealthStatus

VM의 상태입니다.

VirtualMachineScaleSetVMInstanceView

가상 머신 확장 집합 VM의 인스턴스 보기입니다.

ApiError

API 오류입니다.

Name Type Description
code
  • string

오류 코드입니다.

details

API 오류 세부 정보

innererror

API 내부 오류

message
  • string

오류 메시지입니다.

target
  • string

특정 오류의 대상입니다.

ApiErrorBase

API 오류 기준입니다.

Name Type Description
code
  • string

오류 코드입니다.

message
  • string

오류 메시지입니다.

target
  • string

특정 오류의 대상입니다.

BootDiagnosticsInstanceView

가상 머신 부팅 진단의 인스턴스 보기입니다.

Name Type Description
consoleScreenshotBlobUri
  • string

콘솔 스크린샷 Blob URI입니다.

참고: 부팅 진단이 현재 관리되는 스토리지에서 사용하도록 설정된 경우에는 설정 되지 않습니다 .

serialConsoleLogBlobUri
  • string

직렬 콘솔 로그 Blob Uri입니다.

참고: 부팅 진단이 현재 관리되는 스토리지에서 사용하도록 설정된 경우에는 설정 되지 않습니다 .

status

VM에 대한 부팅 진단 상태 정보입니다.

참고: 부팅 진단을 사용하도록 설정하는 데 오류가 발생한 경우에만 설정됩니다.

CloudError

Compute 서비스의 오류 응답입니다.

Name Type Description
error

API 오류입니다.

DiskEncryptionSettings

디스크에 대한 암호화 설정 설명합니다.

Name Type Description
diskEncryptionKey

Key Vault 비밀인 디스크 암호화 키의 위치를 지정합니다.

enabled
  • boolean

가상 머신에서 디스크 암호화를 사용하도록 설정할지 여부를 지정합니다.

keyEncryptionKey

Key Vault 키 암호화 키의 위치를 지정합니다.

DiskInstanceView

디스크의 인스턴스 뷰입니다.

Name Type Description
encryptionSettings

OS 디스크에 대한 암호화 설정을 지정합니다.

최소 api-version: 2015-06-15

name
  • string

디스크 이름.

statuses

리소스 상태 정보입니다.

InnerError

내부 오류 세부 정보입니다.

Name Type Description
errordetail
  • string

내부 오류 메시지 또는 예외 덤프입니다.

exceptiontype
  • string

예외 형식입니다.

InstanceViewStatus

인스턴스 보기 상태입니다.

Name Type Description
code
  • string

상태 코드입니다.

displayStatus
  • string

상태에 대한 짧은 지역화 가능 레이블입니다.

level

수준 코드입니다.

message
  • string

경고 및 오류 메시지를 포함한 자세한 상태 메시지입니다.

time
  • string

상태의 시간입니다.

KeyVaultKeyReference

Key Vault 키에 대한 참조를 설명합니다.

Name Type Description
keyUrl
  • string

Key Vault 키 암호화 키를 참조하는 URL입니다.

sourceVault

키가 포함된 Key Vault 상대 URL입니다.

KeyVaultSecretReference

Key Vault 비밀에 대한 참조를 설명합니다.

Name Type Description
secretUrl
  • string

Key Vault 비밀을 참조하는 URL입니다.

sourceVault

비밀을 포함하는 Key Vault 상대 URL입니다.

MaintenanceOperationResultCodeTypes

마지막 유지 관리 작업 결과 코드입니다.

Name Type Description
MaintenanceAborted
  • string
MaintenanceCompleted
  • string
None
  • string
RetryLater
  • string

MaintenanceRedeployStatus

유지 관리 작업 상태입니다.

Name Type Description
isCustomerInitiatedMaintenanceAllowed
  • boolean

True입니다. 고객이 유지 관리를 수행할 수 있는 경우입니다.

lastOperationMessage
  • string

마지막 유지 관리 작업에 대해 반환된 메시지입니다.

lastOperationResultCode

마지막 유지 관리 작업 결과 코드입니다.

maintenanceWindowEndTime
  • string

유지 관리 기간의 종료 시간입니다.

maintenanceWindowStartTime
  • string

유지 관리 기간의 시작 시간입니다.

preMaintenanceWindowEndTime
  • string

유지 관리 전 기간의 종료 시간입니다.

preMaintenanceWindowStartTime
  • string

유지 관리 전 기간의 시작 시간입니다.

StatusLevelTypes

수준 코드입니다.

Name Type Description
Error
  • string
Info
  • string
Warning
  • string

SubResource

Name Type Description
id
  • string

리소스 ID

VirtualMachineAgentInstanceView

가상 머신에서 실행되는 VM 에이전트의 인스턴스 보기입니다.

Name Type Description
extensionHandlers

가상 머신 확장 처리기 인스턴스 보기입니다.

statuses

리소스 상태 정보입니다.

vmAgentVersion
  • string

VM 에이전트 전체 버전입니다.

VirtualMachineExtensionHandlerInstanceView

가상 머신 확장 처리기의 인스턴스 뷰입니다.

Name Type Description
status

확장 처리기 상태입니다.

type
  • string

확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.

typeHandlerVersion
  • string

스크립트 처리기의 버전을 지정합니다.

VirtualMachineExtensionInstanceView

가상 머신 확장의 인스턴스 뷰입니다.

Name Type Description
name
  • string

가상 머신 확장 이름입니다.

statuses

리소스 상태 정보입니다.

substatuses

리소스 상태 정보입니다.

type
  • string

확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.

typeHandlerVersion
  • string

스크립트 처리기의 버전을 지정합니다.

VirtualMachineHealthStatus

VM의 상태입니다.

Name Type Description
status

VM의 상태 정보입니다.

VirtualMachineScaleSetVMInstanceView

가상 머신 확장 집합 VM의 인스턴스 보기입니다.

Name Type Description
assignedHost
  • string

가상 머신이 자동 배치를 사용하도록 설정된 전용 호스트 그룹과 연결된 경우 가상 머신이 자동 배치를 통해 할당되는 전용 호스트의 리소스 ID입니다.

최소 api-version: 2020-06-01.

bootDiagnostics

부팅 진단은 콘솔 출력 및 스크린샷을 보고 VM 상태를 진단할 수 있는 디버깅 기능입니다.

콘솔 로그의 출력을 쉽게 볼 수 있습니다.

또한 Azure를 사용하면 하이퍼바이저에서 VM의 스크린샷을 볼 수 있습니다.

disks

디스크 정보입니다.

extensions

확장 정보입니다.

maintenanceRedeployStatus

가상 머신의 유지 관리 작업 상태입니다.

placementGroupId
  • string

VM이 실행되고 있는 배치 그룹입니다. VM의 할당이 취소된 경우 placementGroupId가 없습니다.

platformFaultDomain
  • integer

장애 도메인 수입니다.

platformUpdateDomain
  • integer

업데이트 도메인 수입니다.

rdpThumbPrint
  • string

원격 데스크톱 인증서 지문입니다.

statuses

리소스 상태 정보입니다.

vmAgent

가상 머신에서 실행되는 VM 에이전트입니다.

vmHealth

VM의 상태입니다.