다음을 통해 공유


Microsoft.DevCenter 프로젝트/풀

Bicep 리소스 정의

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

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

리소스 형식

Microsoft.DevCenter/projects/pools 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.DevCenter/projects/pools@2024-10-01-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    devBoxDefinition: {
      imageReference: {
        id: 'string'
      }
      sku: {
        capacity: int
        family: 'string'
        name: 'string'
        size: 'string'
        tier: 'string'
      }
    }
    devBoxDefinitionName: 'string'
    devBoxDefinitionType: 'string'
    displayName: 'string'
    licenseType: 'string'
    localAdministrator: 'string'
    managedVirtualNetworkRegions: [
      'string'
    ]
    networkConnectionName: 'string'
    singleSignOnStatus: 'string'
    stopOnDisconnect: {
      gracePeriodMinutes: int
      status: 'string'
    }
    stopOnNoConnect: {
      gracePeriodMinutes: int
      status: 'string'
    }
    virtualNetworkType: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

ImageReference

이름 묘사
아이디 이미지 ID 또는 이미지 버전 ID입니다. 이미지 ID가 제공되면 최신 버전이 사용됩니다. 문자열

Microsoft.DevCenter/projects/pools

이름 묘사
위치 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 3
최대 길이 = 3
패턴 = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$(필수)
부모 Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다.

자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.
형식의 리소스에 대한 기호 이름: 프로젝트
속성 풀 속성 PoolProperties
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

PoolDevBoxDefinition

이름 묘사
imageReference 이미지 참조 정보입니다. imageReference
sku 풀에서 만든 개발 상자용 SKU입니다. Sku

PoolProperties

이름 묘사
devBoxDefinition 이 풀에서 만든 컴퓨터의 정의입니다. devBoxDefinitionType이 참조이거나 제공되지 않은 경우 무시됩니다. PoolDevBoxDefinition
devBoxDefinitionName 이 풀의 부모 프로젝트에 있는 Dev Box 정의의 이름입니다. devBoxDefinitionType이 Value이면 무시됩니다. 문자열
devBoxDefinitionType 풀이 기존 Dev Box 정의에서 만들어졌는지 또는 풀이 직접 제공되는지 여부를 나타냅니다. 'Reference'
'Value'
displayName 풀의 표시 이름입니다. 문자열
licenseType 호출자가 만들 개발자 상자에 대한 라이선스를 이미 획득했음을 나타내는 라이선스 유형을 지정합니다. 'Windows_Client'
localAdministrator 이 풀의 Dev Box 소유자가 Dev Box에 로컬 관리자로 추가되는지 여부를 나타냅니다. '사용 안 함'
'Enabled'
managedVirtualNetworkRegions 관리되는 가상 네트워크의 지역입니다(managedNetworkType이 관리되는 경우 필요). string[]
networkConnectionName 이 풀의 부모 프로젝트에 있는 네트워크 연결의 이름 문자열
singleSignOnStatus Single Sign-On을 사용하도록 설정하여 이 풀의 Dev Box를 만들지 여부를 나타냅니다. 또한 테넌트에서 Single Sign-On을 사용하도록 설정해야 합니다. '사용 안 함'
'Enabled'
stopOnDisconnect 이 풀에서 만든 Dev Box에 대한 연결 끊기 구성 설정을 중지합니다. stopOnDisconnectConfiguration
stopOnNoConnect 이 풀에서 만든 Dev Box에 대한 연결 구성 설정을 중지합니다. stopOnNoConnectConfiguration
virtualNetworkType 풀이 Microsoft에서 관리하는 Virtual Network 또는 고객이 제공한 네트워크를 사용하는지 여부를 나타냅니다. '관리'
'관리되지 않음'

Sku

이름 묘사
용량 SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. int
가족 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. 문자열
이름 SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. string(필수)
크기 SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. 문자열
계층 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. '기본'
'무료'
'프리미엄'
'Standard'

StopOnDisconnectConfiguration

이름 묘사
gracePeriodMinutes 연결이 끊긴 후 Dev Box를 중지하기 전에 대기할 지정된 시간(분)입니다. int
상태 유예 기간이 경과된 후 연결 해제 시 Dev Box를 중지하는 기능을 사용할 수 있는지 여부입니다. '사용 안 함'
'Enabled'

StopOnNoConnectConfiguration

이름 묘사
gracePeriodMinutes 연결이 없으면 Dev Box를 중지하기 전에 대기할 지정된 시간(분)입니다. int
상태 유예 기간이 경과된 후 연결되지 않은 경우 이 기능이 시작된 Dev Box를 중지할 수 있도록 합니다. '사용 안 함'
'Enabled'

TrackedResourceTags

이름 묘사

빠른 시작 샘플

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

Bicep 파일 묘사
Dev Box 서비스 구성 이 템플릿은 Dev Box 빠른 시작 가이드(/azure/dev-box/quickstart-create-dev-box)에 따라 모든 Dev Box 관리 리소스를 만듭니다. 만든 모든 리소스를 보거나 DevPortal.microsoft.com 직접 이동하여 첫 번째 Dev Box를 만들 수 있습니다.
기본 제공 이미지 사용하여 Dev Box Service 배포 이 템플릿은 기본 제공 이미지를 사용하여 Dev Box 서비스를 배포하는 방법을 제공합니다.

ARM 템플릿 리소스 정의

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

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

리소스 형식

Microsoft.DevCenter/projects/pools 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.DevCenter/projects/pools",
  "apiVersion": "2024-10-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "devBoxDefinition": {
      "imageReference": {
        "id": "string"
      },
      "sku": {
        "capacity": "int",
        "family": "string",
        "name": "string",
        "size": "string",
        "tier": "string"
      }
    },
    "devBoxDefinitionName": "string",
    "devBoxDefinitionType": "string",
    "displayName": "string",
    "licenseType": "string",
    "localAdministrator": "string",
    "managedVirtualNetworkRegions": [ "string" ],
    "networkConnectionName": "string",
    "singleSignOnStatus": "string",
    "stopOnDisconnect": {
      "gracePeriodMinutes": "int",
      "status": "string"
    },
    "stopOnNoConnect": {
      "gracePeriodMinutes": "int",
      "status": "string"
    },
    "virtualNetworkType": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

ImageReference

이름 묘사
아이디 이미지 ID 또는 이미지 버전 ID입니다. 이미지 ID가 제공되면 최신 버전이 사용됩니다. 문자열

Microsoft.DevCenter/projects/pools

이름 묘사
apiVersion api 버전 '2024-10-01-preview'
위치 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 3
최대 길이 = 3
패턴 = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$(필수)
속성 풀 속성 PoolProperties
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
리소스 종류 'Microsoft.DevCenter/projects/pools'

PoolDevBoxDefinition

이름 묘사
imageReference 이미지 참조 정보입니다. imageReference
sku 풀에서 만든 개발 상자용 SKU입니다. Sku

PoolProperties

이름 묘사
devBoxDefinition 이 풀에서 만든 컴퓨터의 정의입니다. devBoxDefinitionType이 참조이거나 제공되지 않은 경우 무시됩니다. PoolDevBoxDefinition
devBoxDefinitionName 이 풀의 부모 프로젝트에 있는 Dev Box 정의의 이름입니다. devBoxDefinitionType이 Value이면 무시됩니다. 문자열
devBoxDefinitionType 풀이 기존 Dev Box 정의에서 만들어졌는지 또는 풀이 직접 제공되는지 여부를 나타냅니다. 'Reference'
'Value'
displayName 풀의 표시 이름입니다. 문자열
licenseType 호출자가 만들 개발자 상자에 대한 라이선스를 이미 획득했음을 나타내는 라이선스 유형을 지정합니다. 'Windows_Client'
localAdministrator 이 풀의 Dev Box 소유자가 Dev Box에 로컬 관리자로 추가되는지 여부를 나타냅니다. '사용 안 함'
'Enabled'
managedVirtualNetworkRegions 관리되는 가상 네트워크의 지역입니다(managedNetworkType이 관리되는 경우 필요). string[]
networkConnectionName 이 풀의 부모 프로젝트에 있는 네트워크 연결의 이름 문자열
singleSignOnStatus Single Sign-On을 사용하도록 설정하여 이 풀의 Dev Box를 만들지 여부를 나타냅니다. 또한 테넌트에서 Single Sign-On을 사용하도록 설정해야 합니다. '사용 안 함'
'Enabled'
stopOnDisconnect 이 풀에서 만든 Dev Box에 대한 연결 끊기 구성 설정을 중지합니다. stopOnDisconnectConfiguration
stopOnNoConnect 이 풀에서 만든 Dev Box에 대한 연결 구성 설정을 중지합니다. stopOnNoConnectConfiguration
virtualNetworkType 풀이 Microsoft에서 관리하는 Virtual Network 또는 고객이 제공한 네트워크를 사용하는지 여부를 나타냅니다. '관리'
'관리되지 않음'

Sku

이름 묘사
용량 SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. int
가족 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. 문자열
이름 SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. string(필수)
크기 SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. 문자열
계층 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. '기본'
'무료'
'프리미엄'
'Standard'

StopOnDisconnectConfiguration

이름 묘사
gracePeriodMinutes 연결이 끊긴 후 Dev Box를 중지하기 전에 대기할 지정된 시간(분)입니다. int
상태 유예 기간이 경과된 후 연결 해제 시 Dev Box를 중지하는 기능을 사용할 수 있는지 여부입니다. '사용 안 함'
'Enabled'

StopOnNoConnectConfiguration

이름 묘사
gracePeriodMinutes 연결이 없으면 Dev Box를 중지하기 전에 대기할 지정된 시간(분)입니다. int
상태 유예 기간이 경과된 후 연결되지 않은 경우 이 기능이 시작된 Dev Box를 중지할 수 있도록 합니다. '사용 안 함'
'Enabled'

TrackedResourceTags

이름 묘사

빠른 시작 템플릿

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

템플렛 묘사
Dev Box 서비스 구성

Azure
배포
이 템플릿은 Dev Box 빠른 시작 가이드(/azure/dev-box/quickstart-create-dev-box)에 따라 모든 Dev Box 관리 리소스를 만듭니다. 만든 모든 리소스를 보거나 DevPortal.microsoft.com 직접 이동하여 첫 번째 Dev Box를 만들 수 있습니다.
기본 제공 이미지 사용하여 Dev Box Service 배포

Azure
배포
이 템플릿은 기본 제공 이미지를 사용하여 Dev Box 서비스를 배포하는 방법을 제공합니다.

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

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

  • 리소스 그룹

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

리소스 형식

Microsoft.DevCenter/projects/pools 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects/pools@2024-10-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      devBoxDefinition = {
        imageReference = {
          id = "string"
        }
        sku = {
          capacity = int
          family = "string"
          name = "string"
          size = "string"
          tier = "string"
        }
      }
      devBoxDefinitionName = "string"
      devBoxDefinitionType = "string"
      displayName = "string"
      licenseType = "string"
      localAdministrator = "string"
      managedVirtualNetworkRegions = [
        "string"
      ]
      networkConnectionName = "string"
      singleSignOnStatus = "string"
      stopOnDisconnect = {
        gracePeriodMinutes = int
        status = "string"
      }
      stopOnNoConnect = {
        gracePeriodMinutes = int
        status = "string"
      }
      virtualNetworkType = "string"
    }
  })
}

속성 값

ImageReference

이름 묘사
아이디 이미지 ID 또는 이미지 버전 ID입니다. 이미지 ID가 제공되면 최신 버전이 사용됩니다. 문자열

Microsoft.DevCenter/projects/pools

이름 묘사
위치 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 3
최대 길이 = 3
패턴 = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$(필수)
parent_id 이 리소스의 부모인 리소스의 ID입니다. 형식의 리소스 ID: 프로젝트
속성 풀 속성 PoolProperties
태그 리소스 태그 태그 이름 및 값의 사전입니다.
리소스 종류 "Microsoft.DevCenter/projects/pools@2024-10-01-preview"

PoolDevBoxDefinition

이름 묘사
imageReference 이미지 참조 정보입니다. imageReference
sku 풀에서 만든 개발 상자용 SKU입니다. Sku

PoolProperties

이름 묘사
devBoxDefinition 이 풀에서 만든 컴퓨터의 정의입니다. devBoxDefinitionType이 참조이거나 제공되지 않은 경우 무시됩니다. PoolDevBoxDefinition
devBoxDefinitionName 이 풀의 부모 프로젝트에 있는 Dev Box 정의의 이름입니다. devBoxDefinitionType이 Value이면 무시됩니다. 문자열
devBoxDefinitionType 풀이 기존 Dev Box 정의에서 만들어졌는지 또는 풀이 직접 제공되는지 여부를 나타냅니다. 'Reference'
'Value'
displayName 풀의 표시 이름입니다. 문자열
licenseType 호출자가 만들 개발자 상자에 대한 라이선스를 이미 획득했음을 나타내는 라이선스 유형을 지정합니다. 'Windows_Client'
localAdministrator 이 풀의 Dev Box 소유자가 Dev Box에 로컬 관리자로 추가되는지 여부를 나타냅니다. '사용 안 함'
'Enabled'
managedVirtualNetworkRegions 관리되는 가상 네트워크의 지역입니다(managedNetworkType이 관리되는 경우 필요). string[]
networkConnectionName 이 풀의 부모 프로젝트에 있는 네트워크 연결의 이름 문자열
singleSignOnStatus Single Sign-On을 사용하도록 설정하여 이 풀의 Dev Box를 만들지 여부를 나타냅니다. 또한 테넌트에서 Single Sign-On을 사용하도록 설정해야 합니다. '사용 안 함'
'Enabled'
stopOnDisconnect 이 풀에서 만든 Dev Box에 대한 연결 끊기 구성 설정을 중지합니다. stopOnDisconnectConfiguration
stopOnNoConnect 이 풀에서 만든 Dev Box에 대한 연결 구성 설정을 중지합니다. stopOnNoConnectConfiguration
virtualNetworkType 풀이 Microsoft에서 관리하는 Virtual Network 또는 고객이 제공한 네트워크를 사용하는지 여부를 나타냅니다. '관리'
'관리되지 않음'

Sku

이름 묘사
용량 SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. int
가족 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. 문자열
이름 SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. string(필수)
크기 SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. 문자열
계층 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. '기본'
'무료'
'프리미엄'
'Standard'

StopOnDisconnectConfiguration

이름 묘사
gracePeriodMinutes 연결이 끊긴 후 Dev Box를 중지하기 전에 대기할 지정된 시간(분)입니다. int
상태 유예 기간이 경과된 후 연결 해제 시 Dev Box를 중지하는 기능을 사용할 수 있는지 여부입니다. '사용 안 함'
'Enabled'

StopOnNoConnectConfiguration

이름 묘사
gracePeriodMinutes 연결이 없으면 Dev Box를 중지하기 전에 대기할 지정된 시간(분)입니다. int
상태 유예 기간이 경과된 후 연결되지 않은 경우 이 기능이 시작된 Dev Box를 중지할 수 있도록 합니다. '사용 안 함'
'Enabled'

TrackedResourceTags

이름 묘사