다음을 통해 공유


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
clusterName
path True

string

pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$

Redis Enterprise 클러스터의 이름입니다. 이름은 1~60자여야 합니다. 허용되는 문자(A-Z, a-z, 0-9) 및 하이픈(-)입니다. 선행 또는 후행 또는 연속 하이픈이 있을 수 없습니다.

databaseName
path True

string

pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$

Redis Enterprise 데이터베이스의 이름입니다.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

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

subscriptionId
path True

string

minLength: 1

대상 구독의 ID입니다.

api-version
query True

string

minLength: 1

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

요청 본문

Name 형식 Description
properties.accessKeysAuthentication

accessKeysAuthentication

현재 액세스 키를 사용하여 액세스를 허용하거나 거부하려면 이 속성을 사용/사용 안 함으로 설정할 수 있습니다. 데이터베이스를 만든 후에도 업데이트할 수 있습니다. 기본값은 사용 안 함입니다.

properties.clientProtocol

Protocol

redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 TLS 암호화입니다.

properties.clusteringPolicy

ClusteringPolicy

클러스터링 정책 - 기본값은 OSSCluster입니다. 현재 값이 NoCluster인 경우에만 이 속성을 업데이트할 수 있습니다. 값이 OSSCluster 또는 EnterpriseCluster인 경우 데이터베이스를 삭제하지 않고 업데이트할 수 없습니다.

properties.deferUpgrade

DeferUpgradeSetting

최신 버전이 릴리스될 때 업그레이드를 연기하는 옵션 - 기본값은 NotDeferred입니다. 더 알아보세요: https://aka.ms/redisversionupgrade

properties.evictionPolicy

EvictionPolicy

Redis 제거 정책 - 기본값은 VolatileLRU입니다.

properties.geoReplication

GeoReplication

이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다.

properties.modules

Module[]

이 데이터베이스에서 사용하도록 설정하는 선택적 redis 모듈 집합 - 모듈은 생성 시에만 추가할 수 있습니다.

properties.persistence

Persistence

지속성 설정
지속성 설정

properties.port

integer (int32)

데이터베이스 엔드포인트의 TCP 포트입니다. 생성 시 지정됩니다. 기본값은 사용 가능한 포트입니다.

응답

Name 형식 Description
200 OK

Database

데이터베이스가 업데이트되었습니다. 자세한 상태는 provisioningState 및 resourceState를 확인합니다.

201 Created

Database

데이터베이스가 생성되었거나 생성되고 있습니다. 자세한 상태는 provisioningState 및 resourceState를 확인합니다.

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

RedisEnterpriseDatabasesCreate
RedisEnterpriseDatabasesCreate No Cluster Cache
RedisEnterpriseDatabasesCreate With Active Geo Replication

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
accessKeysAuthentication

현재 액세스 키를 사용하여 액세스를 허용하거나 거부하려면 이 속성을 사용/사용 안 함으로 설정할 수 있습니다. 데이터베이스를 만든 후에도 업데이트할 수 있습니다. 기본값은 사용 안 함입니다.

AofFrequency

데이터가 디스크에 기록되는 빈도를 설정합니다. 기본값은 '1s'로, '매초'를 의미합니다. 성능에 영향을 주므로 'always' 설정은 더 이상 사용되지 않습니다.

ClusteringPolicy

클러스터링 정책 - 기본값은 OSSCluster입니다. 현재 값이 NoCluster인 경우에만 이 속성을 업데이트할 수 있습니다. 값이 OSSCluster 또는 EnterpriseCluster인 경우 데이터베이스를 삭제하지 않고 업데이트할 수 없습니다.

Database

Redis Enterprise 클러스터의 데이터베이스에 대해 설명합니다.

DeferUpgradeSetting

최신 버전이 릴리스될 때 업그레이드를 연기하는 옵션 - 기본값은 NotDeferred입니다. 더 알아보세요: https://aka.ms/redisversionupgrade

ErrorAdditionalInfo

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

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

EvictionPolicy

Redis 제거 정책 - 기본값은 VolatileLRU입니다.

GeoReplication

이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다.

LinkedDatabase

링크된 데이터베이스

LinkState

데이터베이스 리소스 간의 링크 상태입니다.

Module

모듈 설정

Persistence

지속성 설정

Protocol

redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 TLS 암호화입니다.

ProvisioningState

현재 프로비저닝 상태

RdbFrequency

데이터베이스의 스냅샷이 만들어지는 빈도를 설정합니다.

ResourceState

현재 자원 상태

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

accessKeysAuthentication

Disabled

현재 액세스 키를 사용하여 액세스를 허용하거나 거부하려면 이 속성을 사용/사용 안 함으로 설정할 수 있습니다. 데이터베이스를 만든 후에도 업데이트할 수 있습니다. 기본값은 사용 안 함입니다.

properties.clientProtocol

Protocol

redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 TLS 암호화입니다.

properties.clusteringPolicy

ClusteringPolicy

클러스터링 정책 - 기본값은 OSSCluster입니다. 현재 값이 NoCluster인 경우에만 이 속성을 업데이트할 수 있습니다. 값이 OSSCluster 또는 EnterpriseCluster인 경우 데이터베이스를 삭제하지 않고 업데이트할 수 없습니다.

properties.deferUpgrade

DeferUpgradeSetting

최신 버전이 릴리스될 때 업그레이드를 연기하는 옵션 - 기본값은 NotDeferred입니다. 더 알아보세요: https://aka.ms/redisversionupgrade

properties.evictionPolicy

EvictionPolicy

Redis 제거 정책 - 기본값은 VolatileLRU입니다.

properties.geoReplication

GeoReplication

이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다.

properties.modules

Module[]

이 데이터베이스에서 사용하도록 설정하는 선택적 redis 모듈 집합 - 모듈은 생성 시에만 추가할 수 있습니다.

properties.persistence

Persistence

지속성 설정
지속성 설정

properties.port

integer (int32)

데이터베이스 엔드포인트의 TCP 포트입니다. 생성 시 지정됩니다. 기본값은 사용 가능한 포트입니다.

properties.provisioningState

ProvisioningState

데이터베이스의 현재 프로비저닝 상태

properties.redisVersion

string

데이터베이스가 실행 중인 Redis 버전(예: '6.0')

properties.resourceState

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

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

EvictionPolicy

Redis 제거 정책 - 기본값은 VolatileLRU입니다.

Description
AllKeysLFU
AllKeysLRU
AllKeysRandom
VolatileLRU
VolatileLFU
VolatileTTL
VolatileRandom
NoEviction

GeoReplication

이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다.

Name 형식 Description
groupNickname

string

연결된 데이터베이스 리소스 그룹의 이름

linkedDatabases

LinkedDatabase[]

이 데이터베이스와 연결할 데이터베이스 리소스 목록

LinkedDatabase

링크된 데이터베이스

Name 형식 Description
id

string (arm-id)

이 데이터베이스와 연결할 데이터베이스 리소스의 리소스 ID입니다.

state

LinkState

데이터베이스 리소스 간의 링크 상태입니다.

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

AofFrequency

데이터가 디스크에 기록되는 빈도를 설정합니다. 기본값은 '1s'로, '매초'를 의미합니다. 성능에 영향을 주므로 'always' 설정은 더 이상 사용되지 않습니다.

rdbEnabled

boolean

RDB를 사용할 수 있는지 여부를 설정합니다. AOF 또는 RDB 지속성 중 하나 이상이 사용하도록 설정될 수 있습니다.

rdbFrequency

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