Databases - Create

Referencia

Szolgáltatás:: Redis Cache

API-verzió:: 2024-10-01

Adatbázis létrehozása

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
clusterName	path	True	string pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$	A Redis Enterprise-fürt neve. A névnek 1–60 karakter hosszúságúnak kell lennie. Engedélyezett karakterek (A-Z, a-z, 0-9) és kötőjel(-). Nem lehet vezető, záró vagy egymást követő kötőjel
databaseName	path	True	string pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$	A Redis Enterprise-adatbázis neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string minLength: 1	A cél-előfizetés azonosítója.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Kérelem törzse

Name	Típus	Description
properties.clientProtocol	Protocol	Megadja, hogy a Redis-ügyfelek TLS-titkosított vagy egyszerű szöveges redis protokollokkal tudnak-e csatlakozni. Az alapértelmezett érték a TLS-titkosítás.
properties.clusteringPolicy	ClusteringPolicy	Fürtkezelési szabályzat – alapértelmezés szerint AZ OSSCluster. Létrehozáskor van megadva.
properties.evictionPolicy	EvictionPolicy	Redis kilakoltatási szabályzat – az alapértelmezett a VolatileLRU
properties.geoReplication	GeoReplication	Nem kötelező tulajdonságok készlete az adatbázis georeplikációs konfigurálásához.
properties.modules	Module[]	Az adatbázisban engedélyezhető Redis-modulok választható készlete – a modulok csak létrehozáskor vehetők fel.
properties.persistence	Persistence	Adatmegőrzési beállítások Adatmegőrzési beállítások
properties.port	integer (int32)	Az adatbázisvégpont TCP-portja. Létrehozáskor van megadva. Alapértelmezett érték egy elérhető porton.

Válaszok

Name	Típus	Description
200 OK	Database	Az adatbázis frissítése folyamatban van/folyamatban van. A részletes állapotért tekintse meg a provisioningState és a resourceState állapotot.
201 Created	Database	Az adatbázis létrehozása/létrehozása folyamatban van. A részletes állapotért tekintse meg a provisioningState és a resourceState állapotot.
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

RedisEnterpriseDatabasesCreate

RedisEnterpriseDatabasesCreate With Active Geo Replication

RedisEnterpriseDatabasesCreate

Mintakérelem

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

Mintaválasz

Állapotkód:: 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"
      }
    ]
  }
}

Állapotkód:: 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

Mintakérelem

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

Mintaválasz

Állapotkód:: 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"
        }
      ]
    }
  }
}

Állapotkód:: 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"
        }
      ]
    }
  }
}

Definíciók

Name	Description
AofFrequency	Beállítja az adatok lemezre írásának gyakoriságát.
ClusteringPolicy	Fürtkezelési szabályzat – alapértelmezés szerint AZ OSSCluster. Létrehozáskor van megadva.
Database	A RedisEnterprise fürt adatbázisának leírása
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
EvictionPolicy	Redis kilakoltatási szabályzat – az alapértelmezett a VolatileLRU
GeoReplication	Nem kötelező tulajdonságok készlete az adatbázis georeplikációs konfigurálásához.
LinkedDatabase	Csatolt adatbázis
LinkState	Az adatbázis-erőforrások közötti kapcsolat állapota.
Module	Modulbeállítások
Persistence	Adatmegőrzési beállítások
Protocol	Megadja, hogy a Redis-ügyfelek TLS-titkosított vagy egyszerű szöveges redis protokollokkal tudnak-e csatlakozni. Az alapértelmezett érték a TLS-titkosítás.
ProvisioningState	Jelenlegi kiépítési állapot
RdbFrequency	Beállítja az adatbázis pillanatképének létrehozásának gyakoriságát.
ResourceState	Aktuális erőforrásállapot

AofFrequency

Enumerálás

Beállítja az adatok lemezre írásának gyakoriságát.

Érték	Description
1s
always

ClusteringPolicy

Enumerálás

Fürtkezelési szabályzat – alapértelmezés szerint AZ OSSCluster. Létrehozáskor van megadva.

Érték	Description
EnterpriseCluster
OSSCluster

Database

Objektum

A RedisEnterprise fürt adatbázisának leírása

Name	Típus	Description
id	string	Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Az erőforrás neve
properties.clientProtocol	Protocol	Megadja, hogy a Redis-ügyfelek TLS-titkosított vagy egyszerű szöveges redis protokollokkal tudnak-e csatlakozni. Az alapértelmezett érték a TLS-titkosítás.
properties.clusteringPolicy	ClusteringPolicy	Fürtkezelési szabályzat – alapértelmezés szerint AZ OSSCluster. Létrehozáskor van megadva.
properties.evictionPolicy	EvictionPolicy	Redis kilakoltatási szabályzat – az alapértelmezett a VolatileLRU
properties.geoReplication	GeoReplication	Nem kötelező tulajdonságok készlete az adatbázis georeplikációs konfigurálásához.
properties.modules	Module[]	Az adatbázisban engedélyezhető Redis-modulok választható készlete – a modulok csak létrehozáskor vehetők fel.
properties.persistence	Persistence	Adatmegőrzési beállítások Adatmegőrzési beállítások
properties.port	integer (int32)	Az adatbázisvégpont TCP-portja. Létrehozáskor van megadva. Alapértelmezett érték egy elérhető porton.
properties.provisioningState	ProvisioningState	Az adatbázis aktuális kiépítési állapota
properties.resourceState	ResourceState	Az adatbázis aktuális erőforrás-állapota
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

EvictionPolicy

Enumerálás

Redis kilakoltatási szabályzat – az alapértelmezett a VolatileLRU

Érték	Description
AllKeysLFU
AllKeysLRU
AllKeysRandom
NoEviction
VolatileLFU
VolatileLRU
VolatileRandom
VolatileTTL

GeoReplication

Objektum

Nem kötelező tulajdonságok készlete az adatbázis georeplikációs konfigurálásához.

Name	Típus	Description
groupNickname	string	Csatolt adatbázis-erőforrások csoportjának neve
linkedDatabases	LinkedDatabase[]	Az adatbázishoz csatolandó adatbázis-erőforrások listája

LinkedDatabase

Objektum

Csatolt adatbázis

Name	Típus	Description
id	string (arm-id)	Az adatbázis-erőforrás erőforrás-azonosítója az adatbázishoz való csatoláshoz.
state	LinkState	Az adatbázis-erőforrások közötti kapcsolat állapota.

LinkState

Enumerálás

Az adatbázis-erőforrások közötti kapcsolat állapota.

Érték	Description
LinkFailed
Linked
Linking
UnlinkFailed
Unlinking

Module

Objektum

Modulbeállítások

Name	Típus	Description
args	string	A modul konfigurációs beállításai, például "ERROR_RATE 0.01 INITIAL_SIZE 400".
name	string	A modul neve, pl. "RedisBloom", "RediSearch", "RedisTimeSeries"
version	string	A modul verziója, pl. "1.0".

Persistence

Objektum

Adatmegőrzési beállítások

Name	Típus	Description
aofEnabled	boolean	Beállítja, hogy az AOF engedélyezve van-e.
aofFrequency	AofFrequency	Beállítja az adatok lemezre írásának gyakoriságát.
rdbEnabled	boolean	Beállítja, hogy az RDB engedélyezve van-e.
rdbFrequency	RdbFrequency	Beállítja az adatbázis pillanatképének létrehozásának gyakoriságát.

Protocol

Enumerálás

Megadja, hogy a Redis-ügyfelek TLS-titkosított vagy egyszerű szöveges redis protokollokkal tudnak-e csatlakozni. Az alapértelmezett érték a TLS-titkosítás.

Érték	Description
Encrypted
Plaintext

ProvisioningState

Enumerálás

Jelenlegi kiépítési állapot

Érték	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

RdbFrequency

Enumerálás

Beállítja az adatbázis pillanatképének létrehozásának gyakoriságát.

Érték	Description
12h
1h
6h

ResourceState

Enumerálás

Aktuális erőforrásállapot

Érték	Description
CreateFailed
Creating
DeleteFailed
Deleting
DisableFailed
Disabled
Disabling
EnableFailed
Enabling
Running
Scaling
ScalingFailed
UpdateFailed
Updating

Megosztás a következőn keresztül:

Databases - Create

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

RedisEnterpriseDatabasesCreate

Mintakérelem

Mintaválasz

RedisEnterpriseDatabasesCreate With Active Geo Replication

Mintakérelem

Mintaválasz

Definíciók

AofFrequency

ClusteringPolicy

Database

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

EvictionPolicy

GeoReplication

LinkedDatabase

LinkState

Module

Persistence

Protocol

ProvisioningState

RdbFrequency

ResourceState

További források