Databases - Create

Referensi

Layanan:: Redis Cache

Versi API:: 2024-10-01

Membuat database

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}?api-version=2024-10-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 ini tidak peka huruf besar/kecil.
subscriptionId	path	True	string minLength: 1	ID langganan target.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
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. Ditentukan pada waktu pembuatan.
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	Database sedang diperbarui. Periksa provisioningState dan resourceState untuk status terperinci.
201 Created	Database	Database 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 With Active Geo Replication

RedisEnterpriseDatabasesCreate

Permintaan sampel

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

Respon sampel

Kode status:: 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"
      }
    ]
  }
}

Kode status:: 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

Permintaan sampel

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

Respon sampel

Kode status:: 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"
        }
      ]
    }
  }
}

Kode status:: 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"
        }
      ]
    }
  }
}

Definisi

Nama	Deskripsi
AofFrequency	Mengatur frekuensi di mana data ditulis ke disk.
ClusteringPolicy	Kebijakan pengklusteran - defaultnya adalah OSSCluster. Ditentukan pada waktu pembuatan.
Database	Menjelaskan database pada kluster RedisEnterprise
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons 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

AofFrequency

Enumeration

Mengatur frekuensi di mana data ditulis ke disk.

Nilai	Deskripsi
1s
always

ClusteringPolicy

Enumeration

Kebijakan pengklusteran - defaultnya adalah OSSCluster. Ditentukan pada waktu pembuatan.

Nilai	Deskripsi
EnterpriseCluster
OSSCluster

Database

Objek

Menjelaskan database pada kluster RedisEnterprise

Nama	Jenis	Deskripsi
id	string	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nama sumber daya
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. Ditentukan pada waktu pembuatan.
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.resourceState	ResourceState	Status sumber daya database saat ini
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

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

Objek

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

EvictionPolicy

Enumeration

Kebijakan pengeluaran Redis - defaultnya adalah VolatileLRU

Nilai	Deskripsi
AllKeysLFU
AllKeysLRU
AllKeysRandom
NoEviction
VolatileLFU
VolatileLRU
VolatileRandom
VolatileTTL

GeoReplication

Objek

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

Objek

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

Enumeration

Status tautan antara sumber daya database.

Nilai	Deskripsi
LinkFailed
Linked
Linking
UnlinkFailed
Unlinking

Module

Objek

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

Objek

Pengaturan persistensi

Nama	Jenis	Deskripsi
aofEnabled	boolean	Mengatur apakah AOF diaktifkan.
aofFrequency	AofFrequency	Mengatur frekuensi di mana data ditulis ke disk.
rdbEnabled	boolean	Mengatur apakah RDB diaktifkan.
rdbFrequency	RdbFrequency	Mengatur frekuensi pembuatan rekam jepret database.

Protocol

Enumeration

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

Nilai	Deskripsi
Encrypted
Plaintext

ProvisioningState

Enumeration

Status provisi saat ini

Nilai	Deskripsi
Canceled
Creating
Deleting
Failed
Succeeded
Updating

RdbFrequency

Enumeration

Mengatur frekuensi pembuatan rekam jepret database.

Nilai	Deskripsi
12h
1h
6h

ResourceState

Enumeration

Status sumber daya saat ini

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

Bagikan melalui

Databases - Create

Parameter URI

Isi Permintaan

Respons

Keamanan

azure_auth

Cakupan

Contoh

RedisEnterpriseDatabasesCreate

Permintaan sampel

Respon sampel

RedisEnterpriseDatabasesCreate With Active Geo Replication

Permintaan sampel

Respon sampel

Definisi

AofFrequency

ClusteringPolicy

Database

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

EvictionPolicy

GeoReplication

LinkedDatabase

LinkState

Module

Persistence

Protocol

ProvisioningState

RdbFrequency

ResourceState

Sumber Daya Tambahan: