다음을 통해 공유

Microsoft.DevTestLab labs/virtualmachines 2018-09-15

  • 아티클

Bicep 리소스 정의

랩/virtualmachines 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.DevTestLab/labs/virtualmachines 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2018-09-15' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    allowClaim: bool
    artifacts: [
      {
        artifactId: 'string'
        artifactTitle: 'string'
        deploymentStatusMessage: 'string'
        installTime: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
        status: 'string'
        vmExtensionStatusMessage: 'string'
      }
    ]
    createdDate: 'string'
    customImageId: 'string'
    dataDiskParameters: [
      {
        attachNewDataDiskOptions: {
          diskName: 'string'
          diskSizeGiB: int
          diskType: 'string'
        }
        existingLabDiskId: 'string'
        hostCaching: 'string'
      }
    ]
    disallowPublicIpAddress: bool
    environmentId: 'string'
    expirationDate: 'string'
    galleryImageReference: {
      offer: 'string'
      osType: 'string'
      publisher: 'string'
      sku: 'string'
      version: 'string'
    }
    isAuthenticationWithSshKey: bool
    labSubnetName: 'string'
    labVirtualNetworkId: 'string'
    networkInterface: {
      dnsName: 'string'
      privateIpAddress: 'string'
      publicIpAddress: 'string'
      publicIpAddressId: 'string'
      rdpAuthority: 'string'
      sharedPublicIpAddressConfiguration: {
        inboundNatRules: [
          {
            backendPort: int
            frontendPort: int
            transportProtocol: 'string'
          }
        ]
      }
      sshAuthority: 'string'
      subnetId: 'string'
      virtualNetworkId: 'string'
    }
    notes: 'string'
    ownerObjectId: 'string'
    ownerUserPrincipalName: 'string'
    password: 'string'
    planId: 'string'
    scheduleParameters: [
      {
        name: 'string'
        properties: {
          dailyRecurrence: {
            time: 'string'
          }
          hourlyRecurrence: {
            minute: int
          }
          notificationSettings: {
            emailRecipient: 'string'
            notificationLocale: 'string'
            status: 'string'
            timeInMinutes: int
            webhookUrl: 'string'
          }
          status: 'string'
          targetResourceId: 'string'
          taskType: 'string'
          timeZoneId: 'string'
          weeklyRecurrence: {
            time: 'string'
            weekdays: [
              'string'
            ]
          }
        }
        tags: {
          {customized property}: 'string'
        }
      }
    ]
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    userName: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

ArtifactInstallProperties

이름 묘사 값
artifactId 아티팩트의 식별자입니다. 문자열
artifactTitle 아티팩트의 제목입니다. 문자열
deploymentStatusMessage 배포의 상태 메시지입니다. 문자열
installTime 아티팩트가 가상 머신에 설치하기 시작하는 시간입니다. 문자열
매개 변수 아티팩트 매개 변수입니다. ArtifactParameterProperties[]
상태 아티팩트 상태입니다. 문자열
vmExtensionStatusMessage 가상 머신 확장의 상태 메시지입니다. 문자열

ArtifactParameterProperties

이름 묘사 값
이름 아티팩트 매개 변수의 이름입니다. 문자열
값 아티팩트 매개 변수의 값입니다. 문자열

AttachNewDataDiskOptions

이름 묘사 값
diskName 연결할 디스크의 이름입니다. 문자열
diskSizeGiB Gibibytes에 연결할 디스크의 크기입니다. int
diskType 디스크의 스토리지 유형(예: 표준, 프리미엄)입니다. '프리미엄'
'Standard'
'StandardSSD'

DataDiskProperties

이름 묘사 값
attachNewDataDiskOptions 가상 머신에 새 디스크를 연결하는 옵션을 지정합니다. attachNewDataDiskOptions
existingLabDiskId 가상 머신에 연결할 기존 랩 디스크 ID를 지정합니다. 문자열
hostCaching 데이터 디스크에 대한 캐싱 옵션(예: None, ReadOnly, ReadWrite). 'None'
'ReadOnly'
'ReadWrite'

DayDetails

이름 묘사 값
시간 일정이 수행되는 시간입니다. 문자열

GalleryImageReference

이름 묘사 값
제공 갤러리 이미지의 제안입니다. 문자열
osType 갤러리 이미지의 OS 유형입니다. 문자열
게시자 갤러리 이미지의 게시자입니다. 문자열
sku 갤러리 이미지의 SKU입니다. 문자열
버전 갤러리 이미지의 버전입니다. 문자열

HourDetails

이름 묘사 값
분 일정이 실행되는 시간(분)입니다. int

InboundNatRule

이름 묘사 값
backendPort 외부 트래픽을 리디렉션할 포트입니다. int
frontendPort 인바운드 연결의 외부 엔드포인트 포트입니다. 가능한 값 범위는 1에서 65535 사이입니다( 포함). 지정하지 않으면 값이 자동으로 할당됩니다. int
transportProtocol 엔드포인트에 대한 전송 프로토콜입니다. 'Tcp'
'Udp'

LabVirtualMachineProperties

이름 묘사 값
allowClaim 다른 사용자가 가상 머신의 소유권을 가져올 수 있는지 여부를 나타냅니다. bool
아티팩트 가상 머신에 설치할 아티팩트입니다. ArtifactInstallProperties[]
createdDate 가상 머신의 생성 날짜입니다. 문자열
customImageId 가상 머신의 사용자 지정 이미지 식별자입니다. 문자열
dataDiskParameters 만든 후 가상 머신에 연결할 새 데이터 디스크 또는 기존 데이터 디스크 DataDiskProperties[]
disallowPublicIpAddress 공용 IP 주소 없이 가상 머신을 만들 것인지 여부를 나타냅니다. bool
environmentId 이 가상 머신이 포함된 환경의 리소스 ID(있는 경우)입니다. 문자열
expirationDate VM의 만료 날짜입니다. 문자열
galleryImageReference 가상 머신의 Microsoft Azure Marketplace 이미지 참조입니다. GalleryImageReference
isAuthenticationWithSshKey 이 가상 머신이 인증에 SSH 키를 사용하는지 여부를 나타냅니다. bool
labSubnetName 가상 머신의 랩 서브넷 이름입니다. 문자열
labVirtualNetworkId 가상 머신의 랩 가상 네트워크 식별자입니다. 문자열
networkInterface 네트워크 인터페이스 속성입니다. networkInterfaceProperties
노트 가상 머신의 메모입니다. 문자열
ownerObjectId 가상 머신 소유자의 개체 식별자입니다. 문자열
ownerUserPrincipalName 가상 머신 소유자의 사용자 계정 이름입니다. 문자열
암호 가상 머신 관리자의 암호입니다. 문자열

제약 조건:
중요한 값입니다. 보안 매개 변수로 전달합니다.
planId 가상 머신 이미지와 연결된 계획의 ID입니다. 문자열
scheduleParameters 만들 가상 머신 일정 ScheduleCreationParameter[]
크기 가상 머신의 크기입니다. 문자열
sshKey 가상 머신 관리자의 SSH 키입니다. 문자열

제약 조건:
중요한 값입니다. 보안 매개 변수로 전달합니다.
storageType 가상 머신(즉, 표준, 프리미엄)에 사용할 스토리지 유형입니다. 문자열
userName 가상 머신의 사용자 이름입니다. 문자열

Microsoft.DevTestLab/labs/virtualmachines

이름 묘사 값
위치 리소스의 위치입니다. 문자열
이름 리소스 이름 string(필수)
부모 Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다.

자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.		 형식 리소스의 기호 이름: 랩
속성 리소스의 속성입니다. LabVirtualMachineProperties(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

NetworkInterfaceProperties

이름 묘사 값
dnsName DNS 이름입니다. 문자열
privateIpAddress 개인 IP 주소입니다. 문자열
publicIpAddress 공용 IP 주소입니다. 문자열
publicIpAddressId 공용 IP 주소의 리소스 ID입니다. 문자열
rdpAuthority RdpAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 RDP(원격 데스크톱 프로토콜)에 대한 서비스 포트 번호입니다. 문자열
sharedPublicIpAddressConfiguration 여러 가상 머신에서 공용 IP 주소를 공유하기 위한 구성입니다. sharedPublicIpAddressConfiguration
sshAuthority SshAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 SSH에 대한 서비스 포트 번호입니다. 문자열
subnetId 서브넷의 리소스 ID입니다. 문자열
virtualNetworkId 가상 네트워크의 리소스 ID입니다. 문자열

NotificationSettings

이름 묘사 값
emailRecipient 알림을 보낼 전자 메일 받는 사람(세미콜론으로 구분된 전자 메일 주소 목록일 수 있음). 문자열
notificationLocale 알림을 보낼 때 사용할 로캘입니다(지원되지 않는 언어에 대한 대체는 EN). 문자열
상태 이 일정에 대한 알림이 활성화된 경우(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
timeInMinutes 알림이 전송되는 이벤트 전 시간(분)입니다. int
webhookUrl 알림을 보낼 웹후크 URL입니다. 문자열

ResourceTags

이름 묘사 값

ScheduleCreationParameter

이름 묘사 값
이름 가상 머신 또는 환경의 이름 문자열
속성 일정의 속성입니다. ScheduleCreationParameterProperties
태그 리소스의 태그입니다. ScheduleCreationParameterTags

ScheduleCreationParameterProperties

이름 묘사 값
dailyRecurrence 일정이 요일마다 한 번씩 발생하는 경우 일별 되풀이를 지정합니다. DayDetails
hourlyRecurrence 일정이 하루에 여러 번 발생하는 경우 시간별 되풀이를 지정합니다. HourDetails
notificationSettings 알림 설정입니다. notificationSettings
상태 일정의 상태(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
targetResourceId 일정이 속한 리소스 ID 문자열
taskType 일정의 작업 유형(예: LabVmsShutdownTask, LabVmAutoStart)입니다. 문자열
timeZoneId 표준 시간대 ID(예: 중국 표준시, 그린란드 표준시, 태평양 표준시 등)입니다. 이 속성의 가능한 값은 IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds(https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)에서 찾을 수 있습니다. 문자열
weeklyRecurrence 일정이 요일 중 일부만 발생하는 경우 매주 되풀이를 지정합니다. WeekDetails

ScheduleCreationParameterTags

이름 묘사 값

SharedPublicIpAddressConfiguration

이름 묘사 값
inboundNatRules 들어오는 NAT 규칙 InboundNatRule[]

WeekDetails

이름 묘사 값
시간 일정이 수행되는 날짜의 시간입니다. 문자열
평일 일정이 설정된 요일(예: 일요일, 월요일, 화요일 등)입니다. string[]

빠른 시작 샘플

다음 빠른 시작 샘플은 이 리소스 유형을 배포합니다.

Bicep 파일 묘사
클레임된 VM 사용하여 Azure DevTest Labs에 랩을 만듭니다. 이 템플릿은 클레임된 Windows Server 2019 Datacenter VM을 사용하여 새 DevTest Lab/DTL 인스턴스를 만듭니다. Azure DevTest Labs용 Azure Resource Manager 빠른 시작 템플릿은 https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

ARM 템플릿 리소스 정의

랩/virtualmachines 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.DevTestLab/labs/virtualmachines 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.DevTestLab/labs/virtualmachines",
  "apiVersion": "2018-09-15",
  "name": "string",
  "location": "string",
  "properties": {
    "allowClaim": "bool",
    "artifacts": [
      {
        "artifactId": "string",
        "artifactTitle": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "createdDate": "string",
    "customImageId": "string",
    "dataDiskParameters": [
      {
        "attachNewDataDiskOptions": {
          "diskName": "string",
          "diskSizeGiB": "int",
          "diskType": "string"
        },
        "existingLabDiskId": "string",
        "hostCaching": "string"
      }
    ],
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "string",
    "galleryImageReference": {
      "offer": "string",
      "osType": "string",
      "publisher": "string",
      "sku": "string",
      "version": "string"
    },
    "isAuthenticationWithSshKey": "bool",
    "labSubnetName": "string",
    "labVirtualNetworkId": "string",
    "networkInterface": {
      "dnsName": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "publicIpAddressId": "string",
      "rdpAuthority": "string",
      "sharedPublicIpAddressConfiguration": {
        "inboundNatRules": [
          {
            "backendPort": "int",
            "frontendPort": "int",
            "transportProtocol": "string"
          }
        ]
      },
      "sshAuthority": "string",
      "subnetId": "string",
      "virtualNetworkId": "string"
    },
    "notes": "string",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "planId": "string",
    "scheduleParameters": [
      {
        "name": "string",
        "properties": {
          "dailyRecurrence": {
            "time": "string"
          },
          "hourlyRecurrence": {
            "minute": "int"
          },
          "notificationSettings": {
            "emailRecipient": "string",
            "notificationLocale": "string",
            "status": "string",
            "timeInMinutes": "int",
            "webhookUrl": "string"
          },
          "status": "string",
          "targetResourceId": "string",
          "taskType": "string",
          "timeZoneId": "string",
          "weeklyRecurrence": {
            "time": "string",
            "weekdays": [ "string" ]
          }
        },
        "tags": {
          "{customized property}": "string"
        }
      }
    ],
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "userName": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

ArtifactInstallProperties

이름 묘사 값
artifactId 아티팩트의 식별자입니다. 문자열
artifactTitle 아티팩트의 제목입니다. 문자열
deploymentStatusMessage 배포의 상태 메시지입니다. 문자열
installTime 아티팩트가 가상 머신에 설치하기 시작하는 시간입니다. 문자열
매개 변수 아티팩트 매개 변수입니다. ArtifactParameterProperties[]
상태 아티팩트 상태입니다. 문자열
vmExtensionStatusMessage 가상 머신 확장의 상태 메시지입니다. 문자열

ArtifactParameterProperties

이름 묘사 값
이름 아티팩트 매개 변수의 이름입니다. 문자열
값 아티팩트 매개 변수의 값입니다. 문자열

AttachNewDataDiskOptions

이름 묘사 값
diskName 연결할 디스크의 이름입니다. 문자열
diskSizeGiB Gibibytes에 연결할 디스크의 크기입니다. int
diskType 디스크의 스토리지 유형(예: 표준, 프리미엄)입니다. '프리미엄'
'Standard'
'StandardSSD'

DataDiskProperties

이름 묘사 값
attachNewDataDiskOptions 가상 머신에 새 디스크를 연결하는 옵션을 지정합니다. attachNewDataDiskOptions
existingLabDiskId 가상 머신에 연결할 기존 랩 디스크 ID를 지정합니다. 문자열
hostCaching 데이터 디스크에 대한 캐싱 옵션(예: None, ReadOnly, ReadWrite). 'None'
'ReadOnly'
'ReadWrite'

DayDetails

이름 묘사 값
시간 일정이 수행되는 시간입니다. 문자열

GalleryImageReference

이름 묘사 값
제공 갤러리 이미지의 제안입니다. 문자열
osType 갤러리 이미지의 OS 유형입니다. 문자열
게시자 갤러리 이미지의 게시자입니다. 문자열
sku 갤러리 이미지의 SKU입니다. 문자열
버전 갤러리 이미지의 버전입니다. 문자열

HourDetails

이름 묘사 값
분 일정이 실행되는 시간(분)입니다. int

InboundNatRule

이름 묘사 값
backendPort 외부 트래픽을 리디렉션할 포트입니다. int
frontendPort 인바운드 연결의 외부 엔드포인트 포트입니다. 가능한 값 범위는 1에서 65535 사이입니다( 포함). 지정하지 않으면 값이 자동으로 할당됩니다. int
transportProtocol 엔드포인트에 대한 전송 프로토콜입니다. 'Tcp'
'Udp'

LabVirtualMachineProperties

이름 묘사 값
allowClaim 다른 사용자가 가상 머신의 소유권을 가져올 수 있는지 여부를 나타냅니다. bool
아티팩트 가상 머신에 설치할 아티팩트입니다. ArtifactInstallProperties[]
createdDate 가상 머신의 생성 날짜입니다. 문자열
customImageId 가상 머신의 사용자 지정 이미지 식별자입니다. 문자열
dataDiskParameters 만든 후 가상 머신에 연결할 새 데이터 디스크 또는 기존 데이터 디스크 DataDiskProperties[]
disallowPublicIpAddress 공용 IP 주소 없이 가상 머신을 만들 것인지 여부를 나타냅니다. bool
environmentId 이 가상 머신이 포함된 환경의 리소스 ID(있는 경우)입니다. 문자열
expirationDate VM의 만료 날짜입니다. 문자열
galleryImageReference 가상 머신의 Microsoft Azure Marketplace 이미지 참조입니다. GalleryImageReference
isAuthenticationWithSshKey 이 가상 머신이 인증에 SSH 키를 사용하는지 여부를 나타냅니다. bool
labSubnetName 가상 머신의 랩 서브넷 이름입니다. 문자열
labVirtualNetworkId 가상 머신의 랩 가상 네트워크 식별자입니다. 문자열
networkInterface 네트워크 인터페이스 속성입니다. networkInterfaceProperties
노트 가상 머신의 메모입니다. 문자열
ownerObjectId 가상 머신 소유자의 개체 식별자입니다. 문자열
ownerUserPrincipalName 가상 머신 소유자의 사용자 계정 이름입니다. 문자열
암호 가상 머신 관리자의 암호입니다. 문자열

제약 조건:
중요한 값입니다. 보안 매개 변수로 전달합니다.
planId 가상 머신 이미지와 연결된 계획의 ID입니다. 문자열
scheduleParameters 만들 가상 머신 일정 ScheduleCreationParameter[]
크기 가상 머신의 크기입니다. 문자열
sshKey 가상 머신 관리자의 SSH 키입니다. 문자열

제약 조건:
중요한 값입니다. 보안 매개 변수로 전달합니다.
storageType 가상 머신(즉, 표준, 프리미엄)에 사용할 스토리지 유형입니다. 문자열
userName 가상 머신의 사용자 이름입니다. 문자열

Microsoft.DevTestLab/labs/virtualmachines

이름 묘사 값
apiVersion api 버전 '2018-09-15'
위치 리소스의 위치입니다. 문자열
이름 리소스 이름 string(필수)
속성 리소스의 속성입니다. LabVirtualMachineProperties(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형 리소스 종류 'Microsoft.DevTestLab/labs/virtualmachines'

NetworkInterfaceProperties

이름 묘사 값
dnsName DNS 이름입니다. 문자열
privateIpAddress 개인 IP 주소입니다. 문자열
publicIpAddress 공용 IP 주소입니다. 문자열
publicIpAddressId 공용 IP 주소의 리소스 ID입니다. 문자열
rdpAuthority RdpAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 RDP(원격 데스크톱 프로토콜)에 대한 서비스 포트 번호입니다. 문자열
sharedPublicIpAddressConfiguration 여러 가상 머신에서 공용 IP 주소를 공유하기 위한 구성입니다. sharedPublicIpAddressConfiguration
sshAuthority SshAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 SSH에 대한 서비스 포트 번호입니다. 문자열
subnetId 서브넷의 리소스 ID입니다. 문자열
virtualNetworkId 가상 네트워크의 리소스 ID입니다. 문자열

NotificationSettings

이름 묘사 값
emailRecipient 알림을 보낼 전자 메일 받는 사람(세미콜론으로 구분된 전자 메일 주소 목록일 수 있음). 문자열
notificationLocale 알림을 보낼 때 사용할 로캘입니다(지원되지 않는 언어에 대한 대체는 EN). 문자열
상태 이 일정에 대한 알림이 활성화된 경우(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
timeInMinutes 알림이 전송되는 이벤트 전 시간(분)입니다. int
webhookUrl 알림을 보낼 웹후크 URL입니다. 문자열

ResourceTags

이름 묘사 값

ScheduleCreationParameter

이름 묘사 값
이름 가상 머신 또는 환경의 이름 문자열
속성 일정의 속성입니다. ScheduleCreationParameterProperties
태그 리소스의 태그입니다. ScheduleCreationParameterTags

ScheduleCreationParameterProperties

이름 묘사 값
dailyRecurrence 일정이 요일마다 한 번씩 발생하는 경우 일별 되풀이를 지정합니다. DayDetails
hourlyRecurrence 일정이 하루에 여러 번 발생하는 경우 시간별 되풀이를 지정합니다. HourDetails
notificationSettings 알림 설정입니다. notificationSettings
상태 일정의 상태(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
targetResourceId 일정이 속한 리소스 ID 문자열
taskType 일정의 작업 유형(예: LabVmsShutdownTask, LabVmAutoStart)입니다. 문자열
timeZoneId 표준 시간대 ID(예: 중국 표준시, 그린란드 표준시, 태평양 표준시 등)입니다. 이 속성의 가능한 값은 IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds(https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)에서 찾을 수 있습니다. 문자열
weeklyRecurrence 일정이 요일 중 일부만 발생하는 경우 매주 되풀이를 지정합니다. WeekDetails

ScheduleCreationParameterTags

이름 묘사 값

SharedPublicIpAddressConfiguration

이름 묘사 값
inboundNatRules 들어오는 NAT 규칙 InboundNatRule[]

WeekDetails

이름 묘사 값
시간 일정이 수행되는 날짜의 시간입니다. 문자열
평일 일정이 설정된 요일(예: 일요일, 월요일, 화요일 등)입니다. string[]

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플렛 묘사
클레임된 VM 사용하여 Azure DevTest Labs에 랩을 만듭니다.

Azure 배포 		이 템플릿은 클레임된 Windows Server 2019 Datacenter VM을 사용하여 새 DevTest Lab/DTL 인스턴스를 만듭니다. Azure DevTest Labs용 Azure Resource Manager 빠른 시작 템플릿은 https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Terraform(AzAPI 공급자) 리소스 정의

랩/virtualmachines 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.DevTestLab/labs/virtualmachines 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      allowClaim = bool
      artifacts = [
        {
          artifactId = "string"
          artifactTitle = "string"
          deploymentStatusMessage = "string"
          installTime = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
          status = "string"
          vmExtensionStatusMessage = "string"
        }
      ]
      createdDate = "string"
      customImageId = "string"
      dataDiskParameters = [
        {
          attachNewDataDiskOptions = {
            diskName = "string"
            diskSizeGiB = int
            diskType = "string"
          }
          existingLabDiskId = "string"
          hostCaching = "string"
        }
      ]
      disallowPublicIpAddress = bool
      environmentId = "string"
      expirationDate = "string"
      galleryImageReference = {
        offer = "string"
        osType = "string"
        publisher = "string"
        sku = "string"
        version = "string"
      }
      isAuthenticationWithSshKey = bool
      labSubnetName = "string"
      labVirtualNetworkId = "string"
      networkInterface = {
        dnsName = "string"
        privateIpAddress = "string"
        publicIpAddress = "string"
        publicIpAddressId = "string"
        rdpAuthority = "string"
        sharedPublicIpAddressConfiguration = {
          inboundNatRules = [
            {
              backendPort = int
              frontendPort = int
              transportProtocol = "string"
            }
          ]
        }
        sshAuthority = "string"
        subnetId = "string"
        virtualNetworkId = "string"
      }
      notes = "string"
      ownerObjectId = "string"
      ownerUserPrincipalName = "string"
      password = "string"
      planId = "string"
      scheduleParameters = [
        {
          name = "string"
          properties = {
            dailyRecurrence = {
              time = "string"
            }
            hourlyRecurrence = {
              minute = int
            }
            notificationSettings = {
              emailRecipient = "string"
              notificationLocale = "string"
              status = "string"
              timeInMinutes = int
              webhookUrl = "string"
            }
            status = "string"
            targetResourceId = "string"
            taskType = "string"
            timeZoneId = "string"
            weeklyRecurrence = {
              time = "string"
              weekdays = [
                "string"
              ]
            }
          }
          tags = {
            {customized property} = "string"
          }
        }
      ]
      size = "string"
      sshKey = "string"
      storageType = "string"
      userName = "string"
    }
  })
}

속성 값

ArtifactInstallProperties

이름 묘사 값
artifactId 아티팩트의 식별자입니다. 문자열
artifactTitle 아티팩트의 제목입니다. 문자열
deploymentStatusMessage 배포의 상태 메시지입니다. 문자열
installTime 아티팩트가 가상 머신에 설치하기 시작하는 시간입니다. 문자열
매개 변수 아티팩트 매개 변수입니다. ArtifactParameterProperties[]
상태 아티팩트 상태입니다. 문자열
vmExtensionStatusMessage 가상 머신 확장의 상태 메시지입니다. 문자열

ArtifactParameterProperties

이름 묘사 값
이름 아티팩트 매개 변수의 이름입니다. 문자열
값 아티팩트 매개 변수의 값입니다. 문자열

AttachNewDataDiskOptions

이름 묘사 값
diskName 연결할 디스크의 이름입니다. 문자열
diskSizeGiB Gibibytes에 연결할 디스크의 크기입니다. int
diskType 디스크의 스토리지 유형(예: 표준, 프리미엄)입니다. '프리미엄'
'Standard'
'StandardSSD'

DataDiskProperties

이름 묘사 값
attachNewDataDiskOptions 가상 머신에 새 디스크를 연결하는 옵션을 지정합니다. attachNewDataDiskOptions
existingLabDiskId 가상 머신에 연결할 기존 랩 디스크 ID를 지정합니다. 문자열
hostCaching 데이터 디스크에 대한 캐싱 옵션(예: None, ReadOnly, ReadWrite). 'None'
'ReadOnly'
'ReadWrite'

DayDetails

이름 묘사 값
시간 일정이 수행되는 시간입니다. 문자열

GalleryImageReference

이름 묘사 값
제공 갤러리 이미지의 제안입니다. 문자열
osType 갤러리 이미지의 OS 유형입니다. 문자열
게시자 갤러리 이미지의 게시자입니다. 문자열
sku 갤러리 이미지의 SKU입니다. 문자열
버전 갤러리 이미지의 버전입니다. 문자열

HourDetails

이름 묘사 값
분 일정이 실행되는 시간(분)입니다. int

InboundNatRule

이름 묘사 값
backendPort 외부 트래픽을 리디렉션할 포트입니다. int
frontendPort 인바운드 연결의 외부 엔드포인트 포트입니다. 가능한 값 범위는 1에서 65535 사이입니다( 포함). 지정하지 않으면 값이 자동으로 할당됩니다. int
transportProtocol 엔드포인트에 대한 전송 프로토콜입니다. 'Tcp'
'Udp'

LabVirtualMachineProperties

이름 묘사 값
allowClaim 다른 사용자가 가상 머신의 소유권을 가져올 수 있는지 여부를 나타냅니다. bool
아티팩트 가상 머신에 설치할 아티팩트입니다. ArtifactInstallProperties[]
createdDate 가상 머신의 생성 날짜입니다. 문자열
customImageId 가상 머신의 사용자 지정 이미지 식별자입니다. 문자열
dataDiskParameters 만든 후 가상 머신에 연결할 새 데이터 디스크 또는 기존 데이터 디스크 DataDiskProperties[]
disallowPublicIpAddress 공용 IP 주소 없이 가상 머신을 만들 것인지 여부를 나타냅니다. bool
environmentId 이 가상 머신이 포함된 환경의 리소스 ID(있는 경우)입니다. 문자열
expirationDate VM의 만료 날짜입니다. 문자열
galleryImageReference 가상 머신의 Microsoft Azure Marketplace 이미지 참조입니다. GalleryImageReference
isAuthenticationWithSshKey 이 가상 머신이 인증에 SSH 키를 사용하는지 여부를 나타냅니다. bool
labSubnetName 가상 머신의 랩 서브넷 이름입니다. 문자열
labVirtualNetworkId 가상 머신의 랩 가상 네트워크 식별자입니다. 문자열
networkInterface 네트워크 인터페이스 속성입니다. networkInterfaceProperties
노트 가상 머신의 메모입니다. 문자열
ownerObjectId 가상 머신 소유자의 개체 식별자입니다. 문자열
ownerUserPrincipalName 가상 머신 소유자의 사용자 계정 이름입니다. 문자열
암호 가상 머신 관리자의 암호입니다. 문자열

제약 조건:
중요한 값입니다. 보안 매개 변수로 전달합니다.
planId 가상 머신 이미지와 연결된 계획의 ID입니다. 문자열
scheduleParameters 만들 가상 머신 일정 ScheduleCreationParameter[]
크기 가상 머신의 크기입니다. 문자열
sshKey 가상 머신 관리자의 SSH 키입니다. 문자열

제약 조건:
중요한 값입니다. 보안 매개 변수로 전달합니다.
storageType 가상 머신(즉, 표준, 프리미엄)에 사용할 스토리지 유형입니다. 문자열
userName 가상 머신의 사용자 이름입니다. 문자열

Microsoft.DevTestLab/labs/virtualmachines

이름 묘사 값
위치 리소스의 위치입니다. 문자열
이름 리소스 이름 string(필수)
parent_id 이 리소스의 부모인 리소스의 ID입니다. 형식 리소스에 대한 ID: 랩
속성 리소스의 속성입니다. LabVirtualMachineProperties(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다.
형 리소스 종류 "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"

NetworkInterfaceProperties

이름 묘사 값
dnsName DNS 이름입니다. 문자열
privateIpAddress 개인 IP 주소입니다. 문자열
publicIpAddress 공용 IP 주소입니다. 문자열
publicIpAddressId 공용 IP 주소의 리소스 ID입니다. 문자열
rdpAuthority RdpAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 RDP(원격 데스크톱 프로토콜)에 대한 서비스 포트 번호입니다. 문자열
sharedPublicIpAddressConfiguration 여러 가상 머신에서 공용 IP 주소를 공유하기 위한 구성입니다. sharedPublicIpAddressConfiguration
sshAuthority SshAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 SSH에 대한 서비스 포트 번호입니다. 문자열
subnetId 서브넷의 리소스 ID입니다. 문자열
virtualNetworkId 가상 네트워크의 리소스 ID입니다. 문자열

NotificationSettings

이름 묘사 값
emailRecipient 알림을 보낼 전자 메일 받는 사람(세미콜론으로 구분된 전자 메일 주소 목록일 수 있음). 문자열
notificationLocale 알림을 보낼 때 사용할 로캘입니다(지원되지 않는 언어에 대한 대체는 EN). 문자열
상태 이 일정에 대한 알림이 활성화된 경우(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
timeInMinutes 알림이 전송되는 이벤트 전 시간(분)입니다. int
webhookUrl 알림을 보낼 웹후크 URL입니다. 문자열

ResourceTags

이름 묘사 값

ScheduleCreationParameter

이름 묘사 값
이름 가상 머신 또는 환경의 이름 문자열
속성 일정의 속성입니다. ScheduleCreationParameterProperties
태그 리소스의 태그입니다. ScheduleCreationParameterTags

ScheduleCreationParameterProperties

이름 묘사 값
dailyRecurrence 일정이 요일마다 한 번씩 발생하는 경우 일별 되풀이를 지정합니다. DayDetails
hourlyRecurrence 일정이 하루에 여러 번 발생하는 경우 시간별 되풀이를 지정합니다. HourDetails
notificationSettings 알림 설정입니다. notificationSettings
상태 일정의 상태(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
targetResourceId 일정이 속한 리소스 ID 문자열
taskType 일정의 작업 유형(예: LabVmsShutdownTask, LabVmAutoStart)입니다. 문자열
timeZoneId 표준 시간대 ID(예: 중국 표준시, 그린란드 표준시, 태평양 표준시 등)입니다. 이 속성의 가능한 값은 IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds(https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md)에서 찾을 수 있습니다. 문자열
weeklyRecurrence 일정이 요일 중 일부만 발생하는 경우 매주 되풀이를 지정합니다. WeekDetails

ScheduleCreationParameterTags

이름 묘사 값

SharedPublicIpAddressConfiguration

이름 묘사 값
inboundNatRules 들어오는 NAT 규칙 InboundNatRule[]

WeekDetails

이름 묘사 값
시간 일정이 수행되는 날짜의 시간입니다. 문자열
평일 일정이 설정된 요일(예: 일요일, 월요일, 화요일 등)입니다. string[]