Lab Plans - Create Or Update

랩 계획 리소스를 업데이트 만들거나 만듭니다.
랩 계획 리소스를 만들거나 업데이트하는 작업입니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labPlans/{labPlanName}?api-version=2022-08-01

URI 매개 변수

Name In Required Type Description
labPlanName
path True
  • string

포함된 리소스 그룹 내에서 고유하게 식별하는 랩 계획의 이름입니다. 리소스 URI 및 UI에 사용됩니다.

resourceGroupName
path True
  • string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True
  • string

대상 구독의 ID입니다.

api-version
query True
  • string

이 작업에 사용할 API 버전입니다.

요청 본문

Name Required Type Description
location True
  • string

리소스가 있는 지리적 위치

identity

관리 ID 정보

properties.allowedRegions
  • string[]

랩 작성자가 이 랩 계획을 사용하여 랩을 만들 때 사용할 수 있는 지역입니다.

properties.defaultAutoShutdownProfile

기본 랩 종료 프로필입니다. 랩 리소스에서 변경할 수 있으며 기본 프로필만 제공합니다.

properties.defaultConnectionProfile

기본 랩 연결 프로필입니다. 랩 리소스에서 변경할 수 있으며 기본 프로필만 제공합니다.

properties.defaultNetworkProfile

랩 계획 네트워크 프로필입니다. 랩 네트워크 정책을 적용하려면 여기서 정의해야 하며 이 랩 계획과 연결된 기존 랩이 있을 때 변경할 수 없습니다.

properties.linkedLmsInstance
  • string

이 랩 계획이 랩 명단을 연결할 수 있는 lms 인스턴스의 기본 URL입니다.

properties.sharedGalleryId
  • string

이 랩 계획에 연결된 Shared Image Gallery 리소스 ID입니다. 랩 템플릿 가상 머신 이미지를 저장할 때 이 갤러리에 유지됩니다. 갤러리의 공유 이미지를 새 랩을 만들 때 사용할 수 있습니다.

properties.supportInfo

랩 계획의 사용자에 대한 연락처 정보 및 지침을 지원합니다. 이 정보는 랩 계획의 모든 랩에 대한 랩 소유자 및 가상 머신 사용자에게 표시됩니다.

tags
  • object

리소스 태그.

응답

Name Type Description
200 OK

업데이트에 성공했습니다. 응답에는 랩 계획이 포함됩니다.

201 Created

만들기에 성공했습니다. 응답에는 랩 계획이 포함됩니다.

202 Accepted

업데이트가 성공했으며 장기 실행 작업이 있습니다. 응답에는 랩 계획이 포함됩니다.

Other Status Codes

기본 오류 응답입니다.

예제

putLabPlan

Sample Request

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan?api-version=2022-08-01

{
  "location": "westus",
  "properties": {
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}

Sample Response

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan",
  "name": "testlabplan",
  "type": "Microsoft.LabServices/LabPlan",
  "location": "westus",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}
Location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.LabServices/operationresults/a64149d8-84cb-4566-ab8e-b4ee1a074174
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan",
  "name": "testlabplan",
  "type": "Microsoft.LabServices/LabPlan",
  "location": "westus",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Creating",
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}
Location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.LabServices/operationresults/a64149d8-84cb-4566-ab8e-b4ee1a074174
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan",
  "name": "testlabplan",
  "type": "Microsoft.LabServices/LabPlan",
  "location": "westus",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Updating",
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}

정의

AutoShutdownProfile

가상 머신 종료를 처리하는 방법에 대한 프로필입니다.

ConnectionProfile

사용자가 랩 가상 머신에 연결하는 방법에 대한 연결 프로필입니다.

ConnectionType

SSH를 통해 웹 액세스에 대해 사용하도록 설정된 액세스 수준입니다.

createdByType

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

EnableState

연결 끊기에서 종료가 사용되는지 여부

ErrorAdditionalInfo

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

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

Identity

리소스의 ID입니다.

LabPlan

랩 계획은 labs.azure.com 통해 랩을 만들기 위한 권한 컨테이너 역할을 합니다. 또한 랩을 만들 때 적용되는 기본 구성 집합을 제공할 수 있지만 이러한 기본값은 계속 덮어쓸 수 있습니다.

LabPlanNetworkProfile

랩 계획에 대한 네트워킹을 처리하는 방법에 대한 프로필입니다.

ProvisioningState

랩 계획의 현재 프로비전 상태입니다.

ResourceIdentityType

ID 형식입니다.

shutdownOnIdleMode

유휴 상태일 때 VM을 종료할지 여부와 유휴 검색 기준을 정의합니다.

SupportInfo

연락처 정보 및 지침을 지원합니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

AutoShutdownProfile

가상 머신 종료를 처리하는 방법에 대한 프로필입니다.

Name Type Default Value Description
disconnectDelay
  • string

이 동작을 사용하는 경우 사용자가 연결을 끊은 후 VM이 계속 실행되는 시간입니다.

idleDelay
  • string

이 동작을 사용하는 경우 VM이 종료되기 전에 유휴 상태가 되는 시간입니다.

noConnectDelay
  • string

연결이 설정되지 않고 이 동작이 활성화된 경우 VM이 종료되기 전에 VM이 계속 실행되는 시간입니다.

shutdownOnDisconnect Disabled

연결 끊기에서 종료가 사용되는지 여부

shutdownOnIdle None

일정 기간 동안 유휴 상태일 때 VM이 종료되는지 여부입니다.

shutdownWhenNotConnected Disabled

일정 기간 후에 VM이 연결되지 않은 경우 VM이 종료되는지 여부입니다.

ConnectionProfile

사용자가 랩 가상 머신에 연결하는 방법에 대한 연결 프로필입니다.

Name Type Default Value Description
clientRdpAccess None

RDP를 통해 클라이언트 액세스에 대해 사용하도록 설정된 액세스 수준입니다.

clientSshAccess None

SSH를 통해 클라이언트 액세스에 사용하도록 설정된 액세스 수준입니다.

webRdpAccess None

RDP를 통해 웹 액세스에 대해 사용하도록 설정된 액세스 수준입니다.

webSshAccess None

SSH를 통해 웹 액세스에 대해 사용하도록 설정된 액세스 수준입니다.

ConnectionType

SSH를 통해 웹 액세스에 대해 사용하도록 설정된 액세스 수준입니다.

Name Type Description
None
  • string
Private
  • string
Public
  • string

createdByType

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

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

EnableState

연결 끊기에서 종료가 사용되는지 여부

Name Type Description
Disabled
  • string
Enabled
  • string

ErrorAdditionalInfo

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

Name Type Description
info
  • object

추가 정보입니다.

type
  • string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name Type Description
additionalInfo

오류 추가 정보입니다.

code
  • string

오류 코드입니다.

details

오류 세부 정보입니다.

message
  • string

오류 메시지입니다.

target
  • string

오류 대상입니다.

ErrorResponse

오류 응답

Name Type Description
error

오류 개체입니다.

Identity

리소스의 ID입니다.

Name Type Description
principalId
  • string

리소스 ID의 보안 주체 ID입니다.

tenantId
  • string

리소스의 테넌트 ID입니다.

type

ID 형식입니다.

LabPlan

랩 계획은 labs.azure.com 통해 랩을 만들기 위한 권한 컨테이너 역할을 합니다. 또한 랩을 만들 때 적용되는 기본 구성 집합을 제공할 수 있지만 이러한 기본값은 계속 덮어쓸 수 있습니다.

Name Type Description
id
  • string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

관리 ID 정보

location
  • string

리소스가 있는 지리적 위치

name
  • string

리소스의 이름입니다.

properties.allowedRegions
  • string[]

랩 작성자가 이 랩 계획을 사용하여 랩을 만들 때 사용할 수 있는 지역입니다.

properties.defaultAutoShutdownProfile

기본 랩 종료 프로필입니다. 랩 리소스에서 변경할 수 있으며 기본 프로필만 제공합니다.

properties.defaultConnectionProfile

기본 랩 연결 프로필입니다. 랩 리소스에서 변경할 수 있으며 기본 프로필만 제공합니다.

properties.defaultNetworkProfile

랩 계획 네트워크 프로필입니다. 랩 네트워크 정책을 적용하려면 여기서 정의해야 하며 이 랩 계획과 연결된 기존 랩이 있을 때 변경할 수 없습니다.

properties.linkedLmsInstance
  • string

이 랩 계획이 랩 명단을 연결할 수 있는 lms 인스턴스의 기본 URL입니다.

properties.provisioningState

랩 계획의 현재 프로비전 상태입니다.

properties.sharedGalleryId
  • string

이 랩 계획에 연결된 Shared Image Gallery 리소스 ID입니다. 랩 템플릿 가상 머신 이미지를 저장할 때 이 갤러리에 유지됩니다. 갤러리의 공유 이미지를 새 랩을 만들 때 사용할 수 있습니다.

properties.supportInfo

랩 계획의 사용자에 대한 연락처 정보 및 지침을 지원합니다. 이 정보는 랩 계획의 모든 랩에 대한 랩 소유자 및 가상 머신 사용자에게 표시됩니다.

systemData

랩 계획의 생성 및 마지막 수정과 관련된 메타데이터입니다.

tags
  • object

리소스 태그.

type
  • string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

LabPlanNetworkProfile

랩 계획에 대한 네트워킹을 처리하는 방법에 대한 프로필입니다.

Name Type Description
subnetId
  • string

외부 서브넷 리소스 ID

ProvisioningState

랩 계획의 현재 프로비전 상태입니다.

Name Type Description
Creating
  • string

리소스를 만드는 중입니다.

Deleting
  • string

리소스가 삭제되는 중입니다.

Failed
  • string

리소스에 대한 이전 작업에서 리소스를 비정상 상태로 두지 못했습니다.

Locked
  • string

리소스가 잠겨 있고 변경 내용이 현재 차단됩니다. 이는 유지 관리 또는 예약된 작업 때문일 수 있습니다. 잠금 작업이 완료되면 상태가 다시 성공으로 돌아갑니다.

Succeeded
  • string

리소스는 생성 또는 업데이트 작업 후 정상 상태입니다.

Updating
  • string

새 속성 값이 리소스에 적용되고 있습니다.

ResourceIdentityType

ID 형식입니다.

Name Type Description
SystemAssigned
  • string

shutdownOnIdleMode

유휴 상태일 때 VM을 종료할지 여부와 유휴 검색 기준을 정의합니다.

Name Type Description
LowUsage
  • string

VM은 사용자가 없을 때 유휴 상태로 간주되며 리소스(CPU 및 디스크) 사용량이 낮습니다.

None
  • string

VM은 유휴 상태일 때 종료되지 않습니다.

UserAbsence
  • string

키보드 또는 마우스 입력이 없는 경우 VM은 유휴 상태로 간주됩니다.

SupportInfo

연락처 정보 및 지침을 지원합니다.

Name Type Description
email
  • string

연락처 전자 메일 주소를 지원합니다.

instructions
  • string

지원 지침입니다.

phone
  • string

연락처 전화 번호를 지원합니다.

url
  • string

웹 주소를 지원합니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name Type Description
createdAt
  • string

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy
  • string

리소스를 만든 ID입니다.

createdByType

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

lastModifiedAt
  • string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy
  • string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

리소스를 마지막으로 수정한 ID의 형식입니다.