Databases - Create

Membuat database

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}?api-version=2025-07-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
clusterName
path True

string

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

Nama kluster Redis Enterprise. Panjang nama harus 1-60 karakter. Karakter yang diizinkan(A-Z, a-z, 0-9) dan tanda hubung(-). Tidak boleh ada tanda hubung atau tanda hubung berikutnya atau berturut-turut

databaseName
path True

string

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

Nama database Redis Enterprise.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

subscriptionId
path True

string

minLength: 1

ID langganan target.

api-version
query True

string

minLength: 1

Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama Jenis Deskripsi
properties.accessKeysAuthentication

accessKeysAuthentication

Properti ini dapat Diaktifkan/Dinonaktifkan untuk mengizinkan atau menolak akses dengan kunci akses saat ini. Dapat diperbarui bahkan setelah database dibuat. Defaultnya adalah Dinonaktifkan.

properties.clientProtocol

Protocol

Menentukan apakah klien redis dapat terhubung menggunakan protokol redis yang dienkripsi TLS atau teks biasa. Defaultnya adalah terenkripsi TLS.

properties.clusteringPolicy

ClusteringPolicy

Kebijakan pengklusteran - defaultnya adalah OSSCluster. Properti ini hanya dapat diperbarui jika nilai saat ini adalah NoCluster. Jika nilainya adalah OSSCluster atau EnterpriseCluster, nilai tersebut tidak dapat diperbarui tanpa menghapus database.

properties.deferUpgrade

DeferUpgradeSetting

Opsi untuk menunggak peningkatan saat versi terbaru dirilis - defaultnya adalah NotDeferred. Pelajari lebih lanjut: https://aka.ms/redisversionupgrade

properties.evictionPolicy

EvictionPolicy

Kebijakan pengeluaran Redis - defaultnya adalah VolatileLRU

properties.geoReplication

GeoReplication

Sekumpulan properti opsional untuk mengonfigurasi replikasi geografis untuk database ini.

properties.modules

Module[]

Set modul redis opsional untuk diaktifkan dalam database ini - modul hanya dapat ditambahkan pada waktu pembuatan.

properties.persistence

Persistence

Pengaturan persistensi
Pengaturan persistensi

properties.port

integer (int32)

Port TCP dari titik akhir database. Ditentukan pada waktu pembuatan. Default ke port yang tersedia.

Respons

Nama Jenis Deskripsi
200 OK

Database

Basis data sedang diperbarui. Periksa provisioningState dan resourceState untuk status terperinci.

201 Created

Database

Basis data sedang dibuat. Periksa provisioningState dan resourceState untuk status terperinci.

Other Status Codes

ErrorResponse

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

RedisEnterpriseDatabasesCreate
RedisEnterpriseDatabasesCreate No Cluster Cache
RedisEnterpriseDatabasesCreate With Active Geo Replication

RedisEnterpriseDatabasesCreate

Permintaan sampel

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"
  }
}

Respon sampel

{
  "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

Permintaan sampel

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
  }
}

Respon sampel

{
  "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

Permintaan sampel

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"
        }
      ]
    }
  }
}

Respon sampel

{
  "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"
  }
}

Definisi

Nama Deskripsi
accessKeysAuthentication

Properti ini dapat Diaktifkan/Dinonaktifkan untuk mengizinkan atau menolak akses dengan kunci akses saat ini. Dapat diperbarui bahkan setelah database dibuat. Defaultnya adalah Dinonaktifkan.

AofFrequency

Mengatur frekuensi di mana data ditulis ke disk. Default ke '1s', yang berarti 'setiap detik'. Perhatikan bahwa pengaturan 'selalu' tidak digunakan lagi, karena dampak performanya.

ClusteringPolicy

Kebijakan pengklusteran - defaultnya adalah OSSCluster. Properti ini hanya dapat diperbarui jika nilai saat ini adalah NoCluster. Jika nilainya adalah OSSCluster atau EnterpriseCluster, nilai tersebut tidak dapat diperbarui tanpa menghapus database.

Database

Menjelaskan database pada kluster Redis Enterprise

DeferUpgradeSetting

Opsi untuk menunggak peningkatan saat versi terbaru dirilis - defaultnya adalah NotDeferred. Pelajari lebih lanjut: https://aka.ms/redisversionupgrade

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Tanggapan kesalahan

EvictionPolicy

Kebijakan pengeluaran Redis - defaultnya adalah VolatileLRU

GeoReplication

Sekumpulan properti opsional untuk mengonfigurasi replikasi geografis untuk database ini.

LinkedDatabase

Database Tertaut

LinkState

Status tautan antara sumber daya database.

Module

Pengaturan modul

Persistence

Pengaturan persistensi

Protocol

Menentukan apakah klien redis dapat terhubung menggunakan protokol redis yang dienkripsi TLS atau teks biasa. Defaultnya adalah terenkripsi TLS.

ProvisioningState

Status provisi saat ini

RdbFrequency

Mengatur frekuensi pembuatan rekam jepret database.

ResourceState

Status sumber daya saat ini

accessKeysAuthentication

Properti ini dapat Diaktifkan/Dinonaktifkan untuk mengizinkan atau menolak akses dengan kunci akses saat ini. Dapat diperbarui bahkan setelah database dibuat. Defaultnya adalah Dinonaktifkan.

Nilai Deskripsi
Disabled
Enabled

AofFrequency

Mengatur frekuensi di mana data ditulis ke disk. Default ke '1s', yang berarti 'setiap detik'. Perhatikan bahwa pengaturan 'selalu' tidak digunakan lagi, karena dampak performanya.

Nilai Deskripsi
1s
always

ClusteringPolicy

Kebijakan pengklusteran - defaultnya adalah OSSCluster. Properti ini hanya dapat diperbarui jika nilai saat ini adalah NoCluster. Jika nilainya adalah OSSCluster atau EnterpriseCluster, nilai tersebut tidak dapat diperbarui tanpa menghapus database.

Nilai Deskripsi
EnterpriseCluster

Kebijakan pengelompokan perusahaan hanya menggunakan protokol redis klasik, yang tidak mendukung perintah kluster redis.

OSSCluster

Kebijakan pengelompokan OSS mengikuti spesifikasi kluster redis, dan mengharuskan semua klien untuk mendukung pengelompokan redis.

NoCluster

Kebijakan NoCluster digunakan untuk instans Redis non-kluster yang tidak memerlukan fitur pengklusteran.

Database

Menjelaskan database pada kluster Redis Enterprise

Nama Jenis Nilai default Deskripsi
id

string

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nama sumber daya

properties.accessKeysAuthentication

accessKeysAuthentication

Disabled

Properti ini dapat Diaktifkan/Dinonaktifkan untuk mengizinkan atau menolak akses dengan kunci akses saat ini. Dapat diperbarui bahkan setelah database dibuat. Defaultnya adalah Dinonaktifkan.

properties.clientProtocol

Protocol

Menentukan apakah klien redis dapat terhubung menggunakan protokol redis yang dienkripsi TLS atau teks biasa. Defaultnya adalah terenkripsi TLS.

properties.clusteringPolicy

ClusteringPolicy

Kebijakan pengklusteran - defaultnya adalah OSSCluster. Properti ini hanya dapat diperbarui jika nilai saat ini adalah NoCluster. Jika nilainya adalah OSSCluster atau EnterpriseCluster, nilai tersebut tidak dapat diperbarui tanpa menghapus database.

properties.deferUpgrade

DeferUpgradeSetting

Opsi untuk menunggak peningkatan saat versi terbaru dirilis - defaultnya adalah NotDeferred. Pelajari lebih lanjut: https://aka.ms/redisversionupgrade

properties.evictionPolicy

EvictionPolicy

Kebijakan pengeluaran Redis - defaultnya adalah VolatileLRU

properties.geoReplication

GeoReplication

Sekumpulan properti opsional untuk mengonfigurasi replikasi geografis untuk database ini.

properties.modules

Module[]

Set modul redis opsional untuk diaktifkan dalam database ini - modul hanya dapat ditambahkan pada waktu pembuatan.

properties.persistence

Persistence

Pengaturan persistensi
Pengaturan persistensi

properties.port

integer (int32)

Port TCP dari titik akhir database. Ditentukan pada waktu pembuatan. Default ke port yang tersedia.

properties.provisioningState

ProvisioningState

Status provisi database saat ini

properties.redisVersion

string

Versi Redis database berjalan, misalnya '6.0'

properties.resourceState

ResourceState

Status sumber daya database saat ini

type

string

Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

DeferUpgradeSetting

Opsi untuk menunggak peningkatan saat versi terbaru dirilis - defaultnya adalah NotDeferred. Pelajari lebih lanjut: https://aka.ms/redisversionupgrade

Nilai Deskripsi
Deferred
NotDeferred

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Tanggapan kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

EvictionPolicy

Kebijakan pengeluaran Redis - defaultnya adalah VolatileLRU

Nilai Deskripsi
AllKeysLFU
AllKeysLRU
AllKeysRandom
VolatileLRU
VolatileLFU
VolatileTTL
VolatileRandom
NoEviction

GeoReplication

Sekumpulan properti opsional untuk mengonfigurasi replikasi geografis untuk database ini.

Nama Jenis Deskripsi
groupNickname

string

Nama untuk grup sumber daya database tertaut

linkedDatabases

LinkedDatabase[]

Daftar sumber daya database untuk ditautkan dengan database ini

LinkedDatabase

Database Tertaut

Nama Jenis Deskripsi
id

string (arm-id)

ID sumber daya sumber daya database untuk ditautkan dengan database ini.

state

LinkState

Status tautan antara sumber daya database.

LinkState

Status tautan antara sumber daya database.

Nilai Deskripsi
Linked
Linking
Unlinking
LinkFailed
UnlinkFailed

Module

Pengaturan modul

Nama Jenis Deskripsi
args

string

Opsi konfigurasi untuk modul, misalnya 'ERROR_RATE 0,01 INITIAL_SIZE 400'.

name

string

Nama modul, misalnya 'RedisBloom', 'RediSearch', 'RedisTimeSeries'

version

string

Versi modul, misalnya '1.0'.

Persistence

Pengaturan persistensi

Nama Jenis Deskripsi
aofEnabled

boolean

Mengatur apakah AOF diaktifkan. Perhatikan bahwa sebagian besar persistensi AOF atau RDB dapat diaktifkan.

aofFrequency

AofFrequency

Mengatur frekuensi di mana data ditulis ke disk. Default ke '1s', yang berarti 'setiap detik'. Perhatikan bahwa pengaturan 'selalu' tidak digunakan lagi, karena dampak performanya.

rdbEnabled

boolean

Mengatur apakah RDB diaktifkan. Perhatikan bahwa sebagian besar persistensi AOF atau RDB dapat diaktifkan.

rdbFrequency

RdbFrequency

Mengatur frekuensi pembuatan rekam jepret database.

Protocol

Menentukan apakah klien redis dapat terhubung menggunakan protokol redis yang dienkripsi TLS atau teks biasa. Defaultnya adalah terenkripsi TLS.

Nilai Deskripsi
Encrypted
Plaintext

ProvisioningState

Status provisi saat ini

Nilai Deskripsi
Succeeded
Failed
Canceled
Creating
Updating
Deleting

RdbFrequency

Mengatur frekuensi pembuatan rekam jepret database.

Nilai Deskripsi
1h
6h
12h

ResourceState

Status sumber daya saat ini

Nilai Deskripsi
Running
Creating
CreateFailed
Updating
UpdateFailed
Deleting
DeleteFailed
Enabling
EnableFailed
Disabling
DisableFailed
Disabled
Scaling
ScalingFailed
Moving