Virtual Machines - List By Lab

참조

Service:: Lab Services

API Version:: 2023-06-07

랩에 대한 모든 가상 머신을 가져옵니다.
랩의 모든 가상 머신 목록을 반환합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labs/{labName}/virtualMachines?api-version=2023-06-07

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labs/{labName}/virtualMachines?api-version=2023-06-07&$filter={$filter}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
labName	path	True	string	랩 계획을 포함하는 내에서 고유하게 식별하는 랩의 이름입니다. 리소스 URI에 사용됩니다.
resourceGroupName	path	True	string	리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string	대상 구독의 ID입니다.
api-version	query	True	string	이 작업에 사용할 API 버전입니다.
$filter	query		string	작업에 적용할 필터입니다.

응답

Name	형식	Description
200 OK	PagedVirtualMachines	요청이 성공했습니다. 응답에는 지정된 랩에 대한 모든 가상 머신이 포함됩니다.
Other Status Codes	ErrorResponse	기본 오류 응답입니다.

예제

listVirtualMachine

Sample Request

HTTP

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/virtualMachines?api-version=2023-06-07

Sample Response

Status code:: 200

{
  "nextLink": null,
  "value": [
    {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/virtualMachines/template",
      "name": "default",
      "type": "Microsoft.LabServices/VirtualMachine",
      "systemData": {
        "createdBy": "identity123",
        "createdByType": "User",
        "createdAt": "2020-05-01T10:00:00Z",
        "lastModifiedBy": "identity123",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-06-01T09:12:28Z"
      },
      "properties": {
        "provisioningState": "Succeeded",
        "state": "Running",
        "connectionProfile": {
          "privateIpAddress": "192.168.2.1",
          "sshAuthority": "vm-42.contoso.com:22",
          "sshInBrowserUrl": "vm-42.contoso.com",
          "rdpAuthority": "vm-42.contoso.com:3389",
          "rdpInBrowserUrl": "vm-42.contoso.com",
          "adminUsername": "user123"
        },
        "claimedByUserId": "testuser567",
        "vmType": "Template"
      }
    }
  ]
}

정의

Name	Description
createdByType	리소스를 만든 ID의 형식입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
PagedVirtualMachines	랩 서비스 가상 머신의 페이징된 목록입니다.
ProvisioningState	가상 머신의 현재 프로비전 상태입니다.
ResourceOperationError	이 리소스의 최신 작업 실패에 대한 오류 세부 정보
systemData	리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
VirtualMachine	랩 가상 머신 리소스입니다.
VirtualMachineConnectionProfile	가상 머신에 대한 연결 정보
VirtualMachineState	가상 머신의 상태입니다.
VirtualMachineType	랩 가상 머신의 유형입니다.

createdByType

리소스를 만든 ID의 형식입니다.

Name	형식	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	Error 개체.

PagedVirtualMachines

랩 서비스 가상 머신의 페이징된 목록입니다.

Name	형식	Description
nextLink	string	가상 머신 결과의 다음 페이지를 가져오는 링크입니다.
value	VirtualMachine[]	가상 머신 결과의 배열 페이지입니다.

ProvisioningState

가상 머신의 현재 프로비전 상태입니다.

Name	형식	Description
Creating	string	리소스를 만드는 중입니다.
Deleting	string	리소스가 삭제되는 중입니다.
Failed	string	리소스에 대한 이전 작업이 리소스를 비정상 상태로 만들지 못했습니다.
Locked	string	리소스가 잠겨 있고 변경 내용이 현재 차단되어 있습니다. 이는 유지 관리 또는 예약된 작업 때문일 수 있습니다. 잠금 작업이 완료되면 상태가 성공으로 돌아갑니다.
Succeeded	string	만들기 또는 업데이트 작업 후 리소스가 정상 상태입니다.
Updating	string	리소스에 새 속성 값이 적용되고 있습니다.

ResourceOperationError

이 리소스의 최신 작업 실패에 대한 오류 세부 정보

Name	형식	Description
action	string	실패한 작업 작업
code	string	작업 오류 유형에 해당하는 코드
message	string	작업 실패 메시지
timestamp	string	오류가 발생한 날짜/시간입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string	UTC(리소스 만들기)의 타임스탬프입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID 유형입니다.

VirtualMachine

랩 가상 머신 리소스입니다.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	리소스의 이름입니다.
properties.claimedByUserId	string	가상 머신을 요청한 사용자의 랩 사용자 ID(PUID 아님)입니다.
properties.connectionProfile	VirtualMachineConnectionProfile	가상 머신에 연결하는 방법에 대한 자세한 내용은 프로필입니다.
properties.provisioningState	ProvisioningState	가상 머신의 현재 프로비전 상태입니다.
properties.resourceOperationError	ResourceOperationError	랩 계획에서 마지막으로 수행된 작업의 오류 세부 정보입니다.
properties.state	VirtualMachineState	가상 머신의 현재 상태
properties.vmType	VirtualMachineType	이 VM 리소스의 유형
systemData	systemData	랩 가상 머신의 시스템 데이터입니다.
type	string	리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

VirtualMachineConnectionProfile

가상 머신에 대한 연결 정보

Name	형식	Description
adminUsername	string	가상 머신에 관리자 권한으로 로그온하는 데 사용되는 사용자 이름입니다.
nonAdminUsername	string	가상 머신에 관리자가 아닌 사용자(있는 경우)로 로그온하는 데 사용되는 사용자 이름입니다.
privateIpAddress	string	가상 머신의 개인 IP 주소입니다.
rdpAuthority	string	RDP 프로토콜을 통해 가상 머신에 연결하기 위해 세미콜론으로 구분된 포트 및 호스트 이름입니다.
rdpInBrowserUrl	string	브라우저에서 RDP 프로토콜을 통해 가상 머신에 연결하기 위한 URL입니다.
sshAuthority	string	SSH 프로토콜을 통해 가상 머신에 연결하기 위해 세미콜론으로 구분된 포트 및 호스트 이름입니다.
sshInBrowserUrl	string	브라우저에서 SSH 프로토콜을 통해 가상 머신에 연결하기 위한 URL입니다.

VirtualMachineState

가상 머신의 상태입니다.

Name	형식	Description
Redeploying	string	VM이 다시 배포되고 있습니다.
Reimaging	string	VM이 이미지로 다시 설치되고 있습니다.
ResettingPassword	string	VM 암호가 다시 설정되고 있습니다.
Running	string	VM이 실행 중입니다.
Starting	string	VM이 시작됩니다.
Stopped	string	VM이 현재 중지되었습니다.
Stopping	string	VM이 중지됩니다.

VirtualMachineType

랩 가상 머신의 유형입니다.

Name	형식	Description
Template	string	템플릿 VM
User	string	사용자 VM