Databases - Create
데이터베이스를 만듭니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}?api-version=2025-07-01
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
cluster
|
path | True |
string pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ |
Redis Enterprise 클러스터의 이름입니다. 이름은 1~60자여야 합니다. 허용되는 문자(A-Z, a-z, 0-9) 및 하이픈(-)입니다. 선행 또는 후행 또는 연속 하이픈이 있을 수 없습니다. |
|
database
|
path | True |
string pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ |
Redis Enterprise 데이터베이스의 이름입니다. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다. |
|
subscription
|
path | True |
string minLength: 1 |
대상 구독의 ID입니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
요청 본문
| Name | 형식 | Description |
|---|---|---|
| properties.accessKeysAuthentication |
현재 액세스 키를 사용하여 액세스를 허용하거나 거부하려면 이 속성을 사용/사용 안 함으로 설정할 수 있습니다. 데이터베이스를 만든 후에도 업데이트할 수 있습니다. 기본값은 사용 안 함입니다. |
|
| properties.clientProtocol |
redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 TLS 암호화입니다. |
|
| properties.clusteringPolicy |
클러스터링 정책 - 기본값은 OSSCluster입니다. 현재 값이 NoCluster인 경우에만 이 속성을 업데이트할 수 있습니다. 값이 OSSCluster 또는 EnterpriseCluster인 경우 데이터베이스를 삭제하지 않고 업데이트할 수 없습니다. |
|
| properties.deferUpgrade |
최신 버전이 릴리스될 때 업그레이드를 연기하는 옵션 - 기본값은 NotDeferred입니다. 더 알아보세요: https://aka.ms/redisversionupgrade |
|
| properties.evictionPolicy |
Redis 제거 정책 - 기본값은 VolatileLRU입니다. |
|
| properties.geoReplication |
이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다. |
|
| properties.modules |
Module[] |
이 데이터베이스에서 사용하도록 설정하는 선택적 redis 모듈 집합 - 모듈은 생성 시에만 추가할 수 있습니다. |
| properties.persistence |
지속성 설정 |
|
| properties.port |
integer (int32) |
데이터베이스 엔드포인트의 TCP 포트입니다. 생성 시 지정됩니다. 기본값은 사용 가능한 포트입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
데이터베이스가 업데이트되었습니다. 자세한 상태는 provisioningState 및 resourceState를 확인합니다. |
|
| 201 Created |
데이터베이스가 생성되었거나 생성되고 있습니다. 자세한 상태는 provisioningState 및 resourceState를 확인합니다. |
|
| Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | Description |
|---|---|
| user_impersonation | 사용자 계정 가장 |
예제
|
Redis |
|
Redis |
|
Redis |
RedisEnterpriseDatabasesCreate
샘플 요청
PUT https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default?api-version=2025-07-01
{
"properties": {
"clientProtocol": "Encrypted",
"clusteringPolicy": "EnterpriseCluster",
"evictionPolicy": "AllKeysLRU",
"persistence": {
"aofEnabled": true,
"aofFrequency": "1s"
},
"port": 10000,
"modules": [
{
"name": "RedisBloom",
"args": "ERROR_RATE 0.00 INITIAL_SIZE 400"
},
{
"name": "RedisTimeSeries",
"args": "RETENTION_POLICY 20"
},
{
"name": "RediSearch"
}
],
"deferUpgrade": "NotDeferred",
"accessKeysAuthentication": "Enabled"
}
}
샘플 응답
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
"name": "cache1/default",
"type": "Microsoft.Cache/redisEnterprise/databases",
"properties": {
"provisioningState": "Updating",
"resourceState": "Updating",
"clientProtocol": "Encrypted",
"clusteringPolicy": "EnterpriseCluster",
"evictionPolicy": "AllKeysLRU",
"persistence": {
"aofEnabled": true,
"aofFrequency": "1s"
},
"port": 10000,
"modules": [
{
"name": "RedisBloom",
"args": "ERROR_RATE 0.00 INITIAL_SIZE 400",
"version": "1.0.0"
},
{
"name": "RedisTimeSeries",
"args": "RETENTION_POLICY 20",
"version": "1.0.0"
},
{
"name": "RediSearch",
"args": "",
"version": "1.0.0"
}
],
"deferUpgrade": "NotDeferred",
"accessKeysAuthentication": "Enabled",
"redisVersion": "6.0"
}
}
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/db1",
"name": "cache1/db1",
"type": "Microsoft.Cache/redisEnterprise/databases",
"properties": {
"provisioningState": "Creating",
"resourceState": "Creating",
"clientProtocol": "Encrypted",
"clusteringPolicy": "EnterpriseCluster",
"evictionPolicy": "AllKeysLRU",
"persistence": {
"aofEnabled": true,
"aofFrequency": "1s"
},
"port": 10000,
"modules": [
{
"name": "RedisBloom",
"args": "ERROR_RATE 0.00 INITIAL_SIZE 400",
"version": "1.0.0"
},
{
"name": "RedisTimeSeries",
"args": "RETENTION_POLICY 20",
"version": "1.0.0"
},
{
"name": "RediSearch",
"args": "",
"version": "1.0.0"
}
],
"accessKeysAuthentication": "Enabled"
}
}
RedisEnterpriseDatabasesCreate No Cluster Cache
샘플 요청
PUT https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default?api-version=2025-07-01
{
"properties": {
"clientProtocol": "Encrypted",
"clusteringPolicy": "NoCluster",
"evictionPolicy": "NoEviction",
"port": 10000
}
}
샘플 응답
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
"name": "cache1/default",
"type": "Microsoft.Cache/redisEnterprise/databases",
"properties": {
"clientProtocol": "Encrypted",
"port": 10000,
"provisioningState": "Creating",
"resourceState": "Creating",
"clusteringPolicy": "NoCluster",
"evictionPolicy": "NoEviction",
"deferUpgrade": "NotDeferred",
"redisVersion": "7.2",
"accessKeysAuthentication": "Enabled"
}
}
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
"name": "cache1/default",
"type": "Microsoft.Cache/redisEnterprise/databases",
"properties": {
"clientProtocol": "Encrypted",
"port": 10000,
"provisioningState": "Updating",
"resourceState": "Updating",
"clusteringPolicy": "NoCluster",
"evictionPolicy": "NoEviction",
"deferUpgrade": "NotDeferred",
"redisVersion": "7.2",
"accessKeysAuthentication": "Enabled"
}
}
RedisEnterpriseDatabasesCreate With Active Geo Replication
샘플 요청
PUT https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default?api-version=2025-07-01
{
"properties": {
"clientProtocol": "Encrypted",
"clusteringPolicy": "EnterpriseCluster",
"evictionPolicy": "NoEviction",
"port": 10000,
"accessKeysAuthentication": "Enabled",
"geoReplication": {
"groupNickname": "groupName",
"linkedDatabases": [
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default"
},
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8e/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default"
}
]
}
}
}
샘플 응답
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
"name": "cache1/default",
"type": "Microsoft.Cache/redisEnterprise/databases",
"properties": {
"provisioningState": "Updating",
"resourceState": "Updating",
"clientProtocol": "Encrypted",
"clusteringPolicy": "EnterpriseCluster",
"evictionPolicy": "NoEviction",
"port": 10000,
"geoReplication": {
"groupNickname": "groupName",
"linkedDatabases": [
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8e/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
"state": "Linking"
},
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f2/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default",
"state": "Linking"
}
]
},
"deferUpgrade": "NotDeferred",
"accessKeysAuthentication": "Enabled",
"redisVersion": "6.0"
}
}
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/db1",
"name": "cache1/db1",
"type": "Microsoft.Cache/redisEnterprise/databases",
"properties": {
"provisioningState": "Creating",
"resourceState": "Creating",
"clientProtocol": "Plaintext",
"clusteringPolicy": "EnterpriseCluster",
"evictionPolicy": "NoEviction",
"port": 10000,
"geoReplication": {
"groupNickname": "groupName",
"linkedDatabases": [
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8e/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
"state": "Linking"
},
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f2/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default",
"state": "Linking"
}
]
},
"deferUpgrade": "NotDeferred",
"accessKeysAuthentication": "Enabled",
"redisVersion": "6.0"
}
}
정의
| Name | Description |
|---|---|
|
access |
현재 액세스 키를 사용하여 액세스를 허용하거나 거부하려면 이 속성을 사용/사용 안 함으로 설정할 수 있습니다. 데이터베이스를 만든 후에도 업데이트할 수 있습니다. 기본값은 사용 안 함입니다. |
|
Aof |
데이터가 디스크에 기록되는 빈도를 설정합니다. 기본값은 '1s'로, '매초'를 의미합니다. 성능에 영향을 주므로 'always' 설정은 더 이상 사용되지 않습니다. |
|
Clustering |
클러스터링 정책 - 기본값은 OSSCluster입니다. 현재 값이 NoCluster인 경우에만 이 속성을 업데이트할 수 있습니다. 값이 OSSCluster 또는 EnterpriseCluster인 경우 데이터베이스를 삭제하지 않고 업데이트할 수 없습니다. |
| Database |
Redis Enterprise 클러스터의 데이터베이스에 대해 설명합니다. |
|
Defer |
최신 버전이 릴리스될 때 업그레이드를 연기하는 옵션 - 기본값은 NotDeferred입니다. 더 알아보세요: https://aka.ms/redisversionupgrade |
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
Eviction |
Redis 제거 정책 - 기본값은 VolatileLRU입니다. |
|
Geo |
이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다. |
|
Linked |
링크된 데이터베이스 |
|
Link |
데이터베이스 리소스 간의 링크 상태입니다. |
| Module |
모듈 설정 |
| Persistence |
지속성 설정 |
| Protocol |
redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 TLS 암호화입니다. |
|
Provisioning |
현재 프로비저닝 상태 |
|
Rdb |
데이터베이스의 스냅샷이 만들어지는 빈도를 설정합니다. |
|
Resource |
현재 자원 상태 |
accessKeysAuthentication
현재 액세스 키를 사용하여 액세스를 허용하거나 거부하려면 이 속성을 사용/사용 안 함으로 설정할 수 있습니다. 데이터베이스를 만든 후에도 업데이트할 수 있습니다. 기본값은 사용 안 함입니다.
| 값 | Description |
|---|---|
| Disabled | |
| Enabled |
AofFrequency
데이터가 디스크에 기록되는 빈도를 설정합니다. 기본값은 '1s'로, '매초'를 의미합니다. 성능에 영향을 주므로 'always' 설정은 더 이상 사용되지 않습니다.
| 값 | Description |
|---|---|
| 1s | |
| always |
ClusteringPolicy
클러스터링 정책 - 기본값은 OSSCluster입니다. 현재 값이 NoCluster인 경우에만 이 속성을 업데이트할 수 있습니다. 값이 OSSCluster 또는 EnterpriseCluster인 경우 데이터베이스를 삭제하지 않고 업데이트할 수 없습니다.
| 값 | Description |
|---|---|
| EnterpriseCluster |
엔터프라이즈 클러스터링 정책은 redis 클러스터 명령을 지원하지 않는 클래식 redis 프로토콜만 사용합니다. |
| OSSCluster |
OSS 클러스터링 정책은 redis 클러스터 사양을 따르며 모든 클라이언트가 redis 클러스터링을 지원해야 합니다. |
| NoCluster |
NoCluster 정책은 클러스터링 기능이 필요하지 않은 클러스터링되지 않은 Redis 인스턴스에 사용됩니다. |
Database
Redis Enterprise 클러스터의 데이터베이스에 대해 설명합니다.
| Name | 형식 | Default value | Description |
|---|---|---|---|
| id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
| name |
string |
리소스의 이름 |
|
| properties.accessKeysAuthentication | Disabled |
현재 액세스 키를 사용하여 액세스를 허용하거나 거부하려면 이 속성을 사용/사용 안 함으로 설정할 수 있습니다. 데이터베이스를 만든 후에도 업데이트할 수 있습니다. 기본값은 사용 안 함입니다. |
|
| properties.clientProtocol |
redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 TLS 암호화입니다. |
||
| properties.clusteringPolicy |
클러스터링 정책 - 기본값은 OSSCluster입니다. 현재 값이 NoCluster인 경우에만 이 속성을 업데이트할 수 있습니다. 값이 OSSCluster 또는 EnterpriseCluster인 경우 데이터베이스를 삭제하지 않고 업데이트할 수 없습니다. |
||
| properties.deferUpgrade |
최신 버전이 릴리스될 때 업그레이드를 연기하는 옵션 - 기본값은 NotDeferred입니다. 더 알아보세요: https://aka.ms/redisversionupgrade |
||
| properties.evictionPolicy |
Redis 제거 정책 - 기본값은 VolatileLRU입니다. |
||
| properties.geoReplication |
이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다. |
||
| properties.modules |
Module[] |
이 데이터베이스에서 사용하도록 설정하는 선택적 redis 모듈 집합 - 모듈은 생성 시에만 추가할 수 있습니다. |
|
| properties.persistence |
지속성 설정 |
||
| properties.port |
integer (int32) |
데이터베이스 엔드포인트의 TCP 포트입니다. 생성 시 지정됩니다. 기본값은 사용 가능한 포트입니다. |
|
| properties.provisioningState |
데이터베이스의 현재 프로비저닝 상태 |
||
| properties.redisVersion |
string |
데이터베이스가 실행 중인 Redis 버전(예: '6.0') |
|
| properties.resourceState |
데이터베이스의 현재 자원 상태 |
||
| type |
string |
리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
DeferUpgradeSetting
최신 버전이 릴리스될 때 업그레이드를 연기하는 옵션 - 기본값은 NotDeferred입니다. 더 알아보세요: https://aka.ms/redisversionupgrade
| 값 | Description |
|---|---|
| Deferred | |
| NotDeferred |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
object |
추가 정보입니다. |
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
EvictionPolicy
Redis 제거 정책 - 기본값은 VolatileLRU입니다.
| 값 | Description |
|---|---|
| AllKeysLFU | |
| AllKeysLRU | |
| AllKeysRandom | |
| VolatileLRU | |
| VolatileLFU | |
| VolatileTTL | |
| VolatileRandom | |
| NoEviction |
GeoReplication
이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다.
| Name | 형식 | Description |
|---|---|---|
| groupNickname |
string |
연결된 데이터베이스 리소스 그룹의 이름 |
| linkedDatabases |
이 데이터베이스와 연결할 데이터베이스 리소스 목록 |
LinkedDatabase
링크된 데이터베이스
| Name | 형식 | Description |
|---|---|---|
| id |
string (arm-id) |
이 데이터베이스와 연결할 데이터베이스 리소스의 리소스 ID입니다. |
| state |
데이터베이스 리소스 간의 링크 상태입니다. |
LinkState
데이터베이스 리소스 간의 링크 상태입니다.
| 값 | Description |
|---|---|
| Linked | |
| Linking | |
| Unlinking | |
| LinkFailed | |
| UnlinkFailed |
Module
모듈 설정
| Name | 형식 | Description |
|---|---|---|
| args |
string |
모듈에 대한 구성 옵션(예: 'ERROR_RATE 0.01 INITIAL_SIZE 400'). |
| name |
string |
모듈의 이름(예: 'RedisBloom', 'RediSearch', 'RedisTimeSeries' |
| version |
string |
모듈의 버전(예: '1.0'). |
Persistence
지속성 설정
| Name | 형식 | Description |
|---|---|---|
| aofEnabled |
boolean |
AOF를 사용할 수 있는지 여부를 설정합니다. AOF 또는 RDB 지속성 중 하나 이상이 사용하도록 설정될 수 있습니다. |
| aofFrequency |
데이터가 디스크에 기록되는 빈도를 설정합니다. 기본값은 '1s'로, '매초'를 의미합니다. 성능에 영향을 주므로 'always' 설정은 더 이상 사용되지 않습니다. |
|
| rdbEnabled |
boolean |
RDB를 사용할 수 있는지 여부를 설정합니다. AOF 또는 RDB 지속성 중 하나 이상이 사용하도록 설정될 수 있습니다. |
| rdbFrequency |
데이터베이스의 스냅샷이 만들어지는 빈도를 설정합니다. |
Protocol
redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 TLS 암호화입니다.
| 값 | Description |
|---|---|
| Encrypted | |
| Plaintext |
ProvisioningState
현재 프로비저닝 상태
| 값 | Description |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Creating | |
| Updating | |
| Deleting |
RdbFrequency
데이터베이스의 스냅샷이 만들어지는 빈도를 설정합니다.
| 값 | Description |
|---|---|
| 1h | |
| 6h | |
| 12h |
ResourceState
현재 자원 상태
| 값 | Description |
|---|---|
| Running | |
| Creating | |
| CreateFailed | |
| Updating | |
| UpdateFailed | |
| Deleting | |
| DeleteFailed | |
| Enabling | |
| EnableFailed | |
| Disabling | |
| DisableFailed | |
| Disabled | |
| Scaling | |
| ScalingFailed | |
| Moving |