Bicep 리소스 정의
databaseAccounts/sqlDatabases 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
Microsoft.DocumentDB/databaseAccounts/sqlDatabases 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2025-04-15' = {
parent: resourceSymbolicName
___location: 'string'
name: 'string'
properties: {
options: {
autoscaleSettings: {
maxThroughput: int
}
throughput: int
}
resource: {
createMode: 'string'
id: 'string'
restoreParameters: {
restoreSource: 'string'
restoreTimestampInUtc: 'string'
restoreWithTtlDisabled: bool
}
}
}
tags: {
{customized property}: 'string'
}
}
속성 값
Microsoft.DocumentDB/databaseAccounts/sqlDatabases
이름 |
설명 |
가치 |
위치 |
리소스가 속한 리소스 그룹의 위치입니다. |
문자열 |
이름 |
리소스 이름 |
string(필수) |
부모 |
Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다.
자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요. |
형식 리소스의 기호 이름: databaseAccounts |
속성 |
Azure Cosmos DB SQL 데이터베이스를 만들고 업데이트하는 속성입니다. |
sqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (필수) |
태그 |
리소스 태그 |
태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요. |
자동 크기 조정 설정
이름 |
설명 |
가치 |
최대 처리량 |
최대 처리량을 나타내며 리소스를 확장할 수 있습니다. |
정수 (int) |
CreateUpdateOptions또는SqlDatabaseGetPropertiesOptions
이름 |
설명 |
가치 |
자동 크기 조정 설정 |
자동 크기 조정 설정을 지정합니다. 참고: 처리량 또는 autoscaleSettings가 필요하지만 둘 다 필요하지는 않습니다. |
AutoscaleSettings |
처리량 |
초당 요청 단위입니다. 예를 들어 "처리량": 10000입니다. |
정수 (int) |
ResourceRestore매개 변수
이름 |
설명 |
가치 |
복원 소스 |
복원을 시작해야 하는 복원 가능한 데이터베이스 계정의 ID입니다. 예: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{___location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
문자열 |
restoreTimestampInUtc |
계정을 복원해야 하는 시간(ISO-8601 형식)입니다. |
문자열 |
restoreWithTtlDisabled |
복원이 성공하면 복원된 계정에 Time-To-Live 사용하지 않도록 설정할지 여부를 지정합니다. |
bool |
SqlDatabaseCreateUpdateProperties또는SqlDatabaseGetProperties
SqlDatabaseResource또는SqlDatabaseGetPropertiesResource
이름 |
설명 |
가치 |
크리에이션모드 |
리소스 생성 모드를 나타내는 열거형입니다. |
기본값 '복원' |
아이디 |
Cosmos DB SQL 데이터베이스의 이름 |
string(필수) |
restoreParameters |
복원에 대한 정보를 나타내는 매개 변수 |
resourceRestoreParameters |
사용 예제
Azure 빠른 시작 샘플
다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.
Bicep 파일 |
설명 |
분석 저장소 사용하여 Azure Cosmos DB 계정 SQL API |
이 템플릿은 분석 저장소로 구성된 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API에 대한 Azure Cosmos 계정을 만듭니다. |
무료 계층 Azure Cosmos DB 계정 만들기 |
이 템플릿은 공유 처리량 및 컨테이너가 있는 데이터베이스를 사용하여 SQL API에 대한 무료 계층 Azure Cosmos DB 계정을 만듭니다. |
Core(SQL) API 대한 Azure Cosmos DB 계정 만들기 |
이 템플릿은 다른 여러 옵션이 있는 처리량이 있는 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API에 대한 Azure Cosmos 계정을 만듭니다. |
자동 크기 조정 사용하여 Azure Cosmos DB 계정 SQL API 만들기 |
이 템플릿은 다른 여러 옵션을 사용하여 자동 크기 조정 처리량이 있는 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API용 Azure Cosmos 계정을 만듭니다. |
Azure Cosmos DB Core(SQL) API 저장 프로시저 만들기 |
이 템플릿은 Core(SQL) API용 Azure Cosmos DB 계정과 저장 프로시저, 트리거 및 사용자 정의 함수가 있는 컨테이너를 만듭니다. |
Container Apps 사용하여 Dapr 마이크로 서비스 앱을 만듭니다. |
Container Apps를 사용하여 Dapr 마이크로 서비스 앱을 만듭니다. |
Container Apps 사용하여 Dapr pub-sub servicebus 앱을 만듭니다. |
Container Apps를 사용하여 Dapr pub-sub servicebus 앱을 만듭니다. |
Cosmos DB 연결 사용하여 Azure Data Explorer DB 배포 |
Cosmos DB 연결을 사용하여 Azure Data Explorer DB를 배포합니다. |
ARM 템플릿 리소스 정의
databaseAccounts/sqlDatabases 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
Microsoft.DocumentDB/databaseAccounts/sqlDatabases 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
"apiVersion": "2025-04-15",
"name": "string",
"___location": "string",
"properties": {
"options": {
"autoscaleSettings": {
"maxThroughput": "int"
},
"throughput": "int"
},
"resource": {
"createMode": "string",
"id": "string",
"restoreParameters": {
"restoreSource": "string",
"restoreTimestampInUtc": "string",
"restoreWithTtlDisabled": "bool"
}
}
},
"tags": {
"{customized property}": "string"
}
}
속성 값
Microsoft.DocumentDB/databaseAccounts/sqlDatabases
이름 |
설명 |
가치 |
API버전 |
api 버전 |
'2025-04-15' |
위치 |
리소스가 속한 리소스 그룹의 위치입니다. |
문자열 |
이름 |
리소스 이름 |
string(필수) |
속성 |
Azure Cosmos DB SQL 데이터베이스를 만들고 업데이트하는 속성입니다. |
sqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (필수) |
태그 |
리소스 태그 |
태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요. |
유형 |
리소스 종류 |
'Microsoft.DocumentDB/databaseAccounts/sqlDatabases' |
자동 크기 조정 설정
이름 |
설명 |
가치 |
최대 처리량 |
최대 처리량을 나타내며 리소스를 확장할 수 있습니다. |
정수 (int) |
CreateUpdateOptions또는SqlDatabaseGetPropertiesOptions
이름 |
설명 |
가치 |
자동 크기 조정 설정 |
자동 크기 조정 설정을 지정합니다. 참고: 처리량 또는 autoscaleSettings가 필요하지만 둘 다 필요하지는 않습니다. |
AutoscaleSettings |
처리량 |
초당 요청 단위입니다. 예를 들어 "처리량": 10000입니다. |
정수 (int) |
ResourceRestore매개 변수
이름 |
설명 |
가치 |
복원 소스 |
복원을 시작해야 하는 복원 가능한 데이터베이스 계정의 ID입니다. 예: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{___location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
문자열 |
restoreTimestampInUtc |
계정을 복원해야 하는 시간(ISO-8601 형식)입니다. |
문자열 |
restoreWithTtlDisabled |
복원이 성공하면 복원된 계정에 Time-To-Live 사용하지 않도록 설정할지 여부를 지정합니다. |
bool |
SqlDatabaseCreateUpdateProperties또는SqlDatabaseGetProperties
SqlDatabaseResource또는SqlDatabaseGetPropertiesResource
이름 |
설명 |
가치 |
크리에이션모드 |
리소스 생성 모드를 나타내는 열거형입니다. |
기본값 '복원' |
아이디 |
Cosmos DB SQL 데이터베이스의 이름 |
string(필수) |
restoreParameters |
복원에 대한 정보를 나타내는 매개 변수 |
resourceRestoreParameters |
사용 예제
Azure 빠른 시작 템플릿
다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.
템플릿 |
설명 |
분석 저장소 사용하여 Azure Cosmos DB 계정 SQL API
|
이 템플릿은 분석 저장소로 구성된 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API에 대한 Azure Cosmos 계정을 만듭니다. |
무료 계층 Azure Cosmos DB 계정 만들기
|
이 템플릿은 공유 처리량 및 컨테이너가 있는 데이터베이스를 사용하여 SQL API에 대한 무료 계층 Azure Cosmos DB 계정을 만듭니다. |
Core(SQL) API 대한 Azure Cosmos DB 계정 만들기
|
이 템플릿은 다른 여러 옵션이 있는 처리량이 있는 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API에 대한 Azure Cosmos 계정을 만듭니다. |
자동 크기 조정 사용하여 Azure Cosmos DB 계정 SQL API 만들기
|
이 템플릿은 다른 여러 옵션을 사용하여 자동 크기 조정 처리량이 있는 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API용 Azure Cosmos 계정을 만듭니다. |
Azure Cosmos DB Core(SQL) API 저장 프로시저 만들기
|
이 템플릿은 Core(SQL) API용 Azure Cosmos DB 계정과 저장 프로시저, 트리거 및 사용자 정의 함수가 있는 컨테이너를 만듭니다. |
Container Apps 사용하여 Dapr 마이크로 서비스 앱을 만듭니다.
|
Container Apps를 사용하여 Dapr 마이크로 서비스 앱을 만듭니다. |
Container Apps 사용하여 Dapr pub-sub servicebus 앱을 만듭니다.
|
Container Apps를 사용하여 Dapr pub-sub servicebus 앱을 만듭니다. |
Cosmos DB 연결 사용하여 Azure Data Explorer DB 배포
|
Cosmos DB 연결을 사용하여 Azure Data Explorer DB를 배포합니다. |
databaseAccounts/sqlDatabases 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
Microsoft.DocumentDB/databaseAccounts/sqlDatabases 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2025-04-15"
name = "string"
parent_id = "string"
___location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
options = {
autoscaleSettings = {
maxThroughput = int
}
throughput = int
}
resource = {
createMode = "string"
id = "string"
restoreParameters = {
restoreSource = "string"
restoreTimestampInUtc = "string"
restoreWithTtlDisabled = bool
}
}
}
}
}
속성 값
Microsoft.DocumentDB/databaseAccounts/sqlDatabases
이름 |
설명 |
가치 |
위치 |
리소스가 속한 리소스 그룹의 위치입니다. |
문자열 |
이름 |
리소스 이름 |
string(필수) |
부모 ID |
이 리소스의 부모인 리소스의 ID입니다. |
형식의 리소스 ID: databaseAccounts |
속성 |
Azure Cosmos DB SQL 데이터베이스를 만들고 업데이트하는 속성입니다. |
sqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (필수) |
태그 |
리소스 태그 |
태그 이름 및 값의 사전입니다. |
유형 |
리소스 종류 |
"Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2025-04-15" |
자동 크기 조정 설정
이름 |
설명 |
가치 |
최대 처리량 |
최대 처리량을 나타내며 리소스를 확장할 수 있습니다. |
정수 (int) |
CreateUpdateOptions또는SqlDatabaseGetPropertiesOptions
이름 |
설명 |
가치 |
자동 크기 조정 설정 |
자동 크기 조정 설정을 지정합니다. 참고: 처리량 또는 autoscaleSettings가 필요하지만 둘 다 필요하지는 않습니다. |
AutoscaleSettings |
처리량 |
초당 요청 단위입니다. 예를 들어 "처리량": 10000입니다. |
정수 (int) |
ResourceRestore매개 변수
이름 |
설명 |
가치 |
복원 소스 |
복원을 시작해야 하는 복원 가능한 데이터베이스 계정의 ID입니다. 예: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{___location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
문자열 |
restoreTimestampInUtc |
계정을 복원해야 하는 시간(ISO-8601 형식)입니다. |
문자열 |
restoreWithTtlDisabled |
복원이 성공하면 복원된 계정에 Time-To-Live 사용하지 않도록 설정할지 여부를 지정합니다. |
bool |
SqlDatabaseCreateUpdateProperties또는SqlDatabaseGetProperties
SqlDatabaseResource또는SqlDatabaseGetPropertiesResource
이름 |
설명 |
가치 |
크리에이션모드 |
리소스 생성 모드를 나타내는 열거형입니다. |
기본값 '복원' |
아이디 |
Cosmos DB SQL 데이터베이스의 이름 |
string(필수) |
restoreParameters |
복원에 대한 정보를 나타내는 매개 변수 |
resourceRestoreParameters |