Databases - Create

참조

서비스:: Redis Cache

API 버전:: 2024-10-01

데이터베이스 만들기

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}?api-version=2024-10-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.clientProtocol	Protocol	redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 TLS 암호화입니다.
properties.clusteringPolicy	ClusteringPolicy	클러스터링 정책 - 기본값은 OSSCluster입니다. 생성 시 지정됩니다.
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 Flow.

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

RedisEnterpriseDatabasesCreate

RedisEnterpriseDatabasesCreate With Active Geo Replication

RedisEnterpriseDatabasesCreate

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default?api-version=2024-10-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"
      }
    ]
  }
}

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/subid/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"
      }
    ]
  }
}

상태 코드:: 201

{
  "id": "/subscriptions/subid/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"
      }
    ]
  }
}

RedisEnterpriseDatabasesCreate With Active Geo Replication

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid1/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default?api-version=2024-10-01

{
  "properties": {
    "clientProtocol": "Encrypted",
    "clusteringPolicy": "EnterpriseCluster",
    "evictionPolicy": "NoEviction",
    "port": 10000,
    "geoReplication": {
      "groupNickname": "groupName",
      "linkedDatabases": [
        {
          "id": "/subscriptions/subid1/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default"
        },
        {
          "id": "/subscriptions/subid2/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default"
        }
      ]
    }
  }
}

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/subid1/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/subid1/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
          "state": "Linking"
        },
        {
          "id": "/subscriptions/subid2/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default",
          "state": "Linking"
        }
      ]
    }
  }
}

상태 코드:: 201

{
  "id": "/subscriptions/subid1/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/subid1/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default",
          "state": "Linking"
        },
        {
          "id": "/subscriptions/subid2/resourceGroups/rg2/providers/Microsoft.Cache/redisEnterprise/cache2/databases/default",
          "state": "Linking"
        }
      ]
    }
  }
}

정의

Name	Description
AofFrequency	데이터가 디스크에 기록되는 빈도를 설정합니다.
ClusteringPolicy	클러스터링 정책 - 기본값은 OSSCluster입니다. 생성 시 지정됩니다.
Database	RedisEnterprise 클러스터의 데이터베이스에 대해 설명합니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
EvictionPolicy	Redis 제거 정책 - 기본값은 VolatileLRU입니다.
GeoReplication	이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다.
LinkedDatabase	연결된 데이터베이스
LinkState	데이터베이스 리소스 간의 링크 상태입니다.
Module	모듈 설정
Persistence	지속성 설정
Protocol	redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 TLS 암호화입니다.
ProvisioningState	현재 프로비전 상태
RdbFrequency	데이터베이스의 스냅샷이 만들어지는 빈도를 설정합니다.
ResourceState	현재 리소스 상태

AofFrequency

열거형

데이터가 디스크에 기록되는 빈도를 설정합니다.

값	Description
1s
always

ClusteringPolicy

열거형

클러스터링 정책 - 기본값은 OSSCluster입니다. 생성 시 지정됩니다.

값	Description
EnterpriseCluster
OSSCluster

Database

Object

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

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	리소스의 이름
properties.clientProtocol	Protocol	redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 TLS 암호화입니다.
properties.clusteringPolicy	ClusteringPolicy	클러스터링 정책 - 기본값은 OSSCluster입니다. 생성 시 지정됩니다.
properties.evictionPolicy	EvictionPolicy	Redis 제거 정책 - 기본값은 VolatileLRU입니다.
properties.geoReplication	GeoReplication	이 데이터베이스에 대한 지역 복제를 구성하는 선택적 속성 집합입니다.
properties.modules	Module[]	이 데이터베이스에서 사용하도록 설정하는 선택적 redis 모듈 집합 - 모듈은 생성 시에만 추가할 수 있습니다.
properties.persistence	Persistence	지속성 설정 지속성 설정
properties.port	integer (int32)	데이터베이스 엔드포인트의 TCP 포트입니다. 생성 시 지정됩니다. 기본값은 사용 가능한 포트입니다.
properties.provisioningState	ProvisioningState	데이터베이스의 현재 프로비전 상태
properties.resourceState	ResourceState	데이터베이스의 현재 리소스 상태
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ErrorAdditionalInfo

Object

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

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

EvictionPolicy

열거형

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

값	Description
AllKeysLFU
AllKeysLRU
AllKeysRandom
NoEviction
VolatileLFU
VolatileLRU
VolatileRandom
VolatileTTL

GeoReplication

Object

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

Name	형식	Description
groupNickname	string	연결된 데이터베이스 리소스 그룹의 이름
linkedDatabases	LinkedDatabase[]	이 데이터베이스와 연결할 데이터베이스 리소스 목록

LinkedDatabase

Object

연결된 데이터베이스

Name	형식	Description
id	string (arm-id)	이 데이터베이스와 연결할 데이터베이스 리소스의 리소스 ID입니다.
state	LinkState	데이터베이스 리소스 간의 링크 상태입니다.

LinkState

열거형

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

값	Description
LinkFailed
Linked
Linking
UnlinkFailed
Unlinking

Module

Object

모듈 설정

Name	형식	Description
args	string	모듈에 대한 구성 옵션(예: 'ERROR_RATE 0.01 INITIAL_SIZE 400').
name	string	모듈의 이름(예: 'RedisBloom', 'RediSearch', 'RedisTimeSeries'
version	string	모듈의 버전(예: '1.0')입니다.

Persistence

Object

지속성 설정

Name	형식	Description
aofEnabled	boolean	AOF를 사용할 수 있는지 여부를 설정합니다.
aofFrequency	AofFrequency	데이터가 디스크에 기록되는 빈도를 설정합니다.
rdbEnabled	boolean	RDB를 사용할 수 있는지 여부를 설정합니다.
rdbFrequency	RdbFrequency	데이터베이스의 스냅샷이 만들어지는 빈도를 설정합니다.

Protocol

열거형

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

값	Description
Encrypted
Plaintext

ProvisioningState

열거형

현재 프로비전 상태

값	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

RdbFrequency

열거형

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

값	Description
12h
1h
6h

ResourceState

열거형

현재 리소스 상태

값	Description
CreateFailed
Creating
DeleteFailed
Deleting
DisableFailed
Disabled
Disabling
EnableFailed
Enabling
Running
Scaling
ScalingFailed
UpdateFailed
Updating

다음을 통해 공유

Databases - Create

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

RedisEnterpriseDatabasesCreate

샘플 요청

샘플 응답

RedisEnterpriseDatabasesCreate With Active Geo Replication

샘플 요청

샘플 응답

정의

AofFrequency

ClusteringPolicy

Database

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

EvictionPolicy

GeoReplication

LinkedDatabase

LinkState

Module

Persistence

Protocol

ProvisioningState

RdbFrequency

ResourceState

추가 리소스