Databases - Create

Reference

Služba:: Redis Cache

Verze rozhraní API:: 2024-10-01

Vytvoří databázi.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
clusterName	path	True	string pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$	Název clusteru Redis Enterprise. Název musí mít délku 1 až 60 znaků. Povolené znaky(A-Z, a-z, 0-9) a spojovník(-). Nesmí existovat žádné úvodní ani koncové ani po sobě jdoucí pomlčky.
databaseName	path	True	string pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$	Název databáze Redis Enterprise.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
properties.clientProtocol	Protocol	Určuje, jestli se klienti Redis mohou připojit pomocí protokolů REDIS šifrovaných pomocí protokolu TLS nebo prostého textu. Výchozí hodnota je zašifrovaná protokolem TLS.
properties.clusteringPolicy	ClusteringPolicy	Zásady clusteringu – výchozí hodnota je OSSCluster. Zadané při vytvoření.
properties.evictionPolicy	EvictionPolicy	Zásada vyřazení Redis – výchozí hodnota je VolatileLRU
properties.geoReplication	GeoReplication	Volitelná sada vlastností pro konfiguraci geografické replikace pro tuto databázi
properties.modules	Module[]	Volitelná sada modulů Redis pro povolení v této databázi – moduly je možné přidat pouze při vytváření.
properties.persistence	Persistence	Nastavení trvalosti Nastavení trvalosti
properties.port	integer (int32)	Port TCP koncového bodu databáze. Zadané při vytvoření. Výchozí hodnota je dostupný port.

Odpovědi

Name	Typ	Description
200 OK	Database	Databáze byla/právě aktualizována. Podrobný stav zkontrolujte provisioningState a resourceState.
201 Created	Database	Databáze se vytvořila nebo se vytváří. Podrobný stav zkontrolujte provisioningState a resourceState.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

RedisEnterpriseDatabasesCreate

RedisEnterpriseDatabasesCreate With Active Geo Replication

RedisEnterpriseDatabasesCreate

Ukázkový požadavek

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

Ukázková odpověď

Stavový kó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"
      }
    ]
  }
}

Stavový kó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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kó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"
        }
      ]
    }
  }
}

Stavový kó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"
        }
      ]
    }
  }
}

Definice

Name	Description
AofFrequency	Nastaví frekvenci zápisu dat na disk.
ClusteringPolicy	Zásady clusteringu – výchozí hodnota je OSSCluster. Zadané při vytvoření.
Database	Popisuje databázi v clusteru RedisEnterprise.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
EvictionPolicy	Zásada vyřazení Redis – výchozí hodnota je VolatileLRU
GeoReplication	Volitelná sada vlastností pro konfiguraci geografické replikace pro tuto databázi
LinkedDatabase	Propojená databáze
LinkState	Stav propojení mezi databázovými prostředky
Module	Nastavení modulu
Persistence	Nastavení trvalosti
Protocol	Určuje, jestli se klienti Redis mohou připojit pomocí protokolů REDIS šifrovaných pomocí protokolu TLS nebo prostého textu. Výchozí hodnota je zašifrovaná protokolem TLS.
ProvisioningState	Aktuální stav zřizování
RdbFrequency	Nastaví frekvenci vytvoření snímku databáze.
ResourceState	Aktuální stav zdroje

AofFrequency

Výčet

Nastaví frekvenci zápisu dat na disk.

Hodnota	Description
1s
always

ClusteringPolicy

Výčet

Zásady clusteringu – výchozí hodnota je OSSCluster. Zadané při vytvoření.

Hodnota	Description
EnterpriseCluster
OSSCluster

Database

Objekt

Popisuje databázi v clusteru RedisEnterprise.

Name	Typ	Description
id	string	Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Název prostředku
properties.clientProtocol	Protocol	Určuje, jestli se klienti Redis mohou připojit pomocí protokolů REDIS šifrovaných pomocí protokolu TLS nebo prostého textu. Výchozí hodnota je zašifrovaná protokolem TLS.
properties.clusteringPolicy	ClusteringPolicy	Zásady clusteringu – výchozí hodnota je OSSCluster. Zadané při vytvoření.
properties.evictionPolicy	EvictionPolicy	Zásada vyřazení Redis – výchozí hodnota je VolatileLRU
properties.geoReplication	GeoReplication	Volitelná sada vlastností pro konfiguraci geografické replikace pro tuto databázi
properties.modules	Module[]	Volitelná sada modulů Redis pro povolení v této databázi – moduly je možné přidat pouze při vytváření.
properties.persistence	Persistence	Nastavení trvalosti Nastavení trvalosti
properties.port	integer (int32)	Port TCP koncového bodu databáze. Zadané při vytvoření. Výchozí hodnota je dostupný port.
properties.provisioningState	ProvisioningState	Aktuální stav zřizování databáze
properties.resourceState	ResourceState	Aktuální stav prostředku databáze
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

EvictionPolicy

Výčet

Zásada vyřazení Redis – výchozí hodnota je VolatileLRU

Hodnota	Description
AllKeysLFU
AllKeysLRU
AllKeysRandom
NoEviction
VolatileLFU
VolatileLRU
VolatileRandom
VolatileTTL

GeoReplication

Objekt

Volitelná sada vlastností pro konfiguraci geografické replikace pro tuto databázi

Name	Typ	Description
groupNickname	string	Název skupiny propojených databázových prostředků
linkedDatabases	LinkedDatabase[]	Seznam databázových prostředků pro propojení s touto databází

LinkedDatabase

Objekt

Propojená databáze

Name	Typ	Description
id	string (arm-id)	ID prostředku databáze pro propojení s touto databází
state	LinkState	Stav propojení mezi databázovými prostředky

LinkState

Výčet

Stav propojení mezi databázovými prostředky

Hodnota	Description
LinkFailed
Linked
Linking
UnlinkFailed
Unlinking

Module

Objekt

Nastavení modulu

Name	Typ	Description
args	string	Možnosti konfigurace pro modul, například "ERROR_RATE 0.01 INITIAL_SIZE 400".
name	string	Název modulu, například RedisBloom, RediSearch, RedisTimeSeries
version	string	Verze modulu, například 1.0.

Persistence

Objekt

Nastavení trvalosti

Name	Typ	Description
aofEnabled	boolean	Nastaví, jestli je povolená funkce AOF.
aofFrequency	AofFrequency	Nastaví frekvenci zápisu dat na disk.
rdbEnabled	boolean	Nastaví, jestli je povolená sada RDB.
rdbFrequency	RdbFrequency	Nastaví frekvenci vytvoření snímku databáze.

Protocol

Výčet

Určuje, jestli se klienti Redis mohou připojit pomocí protokolů REDIS šifrovaných pomocí protokolu TLS nebo prostého textu. Výchozí hodnota je zašifrovaná protokolem TLS.

Hodnota	Description
Encrypted
Plaintext

ProvisioningState

Výčet

Aktuální stav zřizování

Hodnota	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

RdbFrequency

Výčet

Nastaví frekvenci vytvoření snímku databáze.

Hodnota	Description
12h
1h
6h

ResourceState

Výčet

Aktuální stav zdroje

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

Sdílet prostřednictvím

Databases - Create

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

RedisEnterpriseDatabasesCreate

Ukázkový požadavek

Ukázková odpověď

RedisEnterpriseDatabasesCreate With Active Geo Replication

Ukázkový požadavek

Ukázková odpověď

Definice

AofFrequency

ClusteringPolicy

Database

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

EvictionPolicy

GeoReplication

LinkedDatabase

LinkState

Module

Persistence

Protocol

ProvisioningState

RdbFrequency

ResourceState

Další materiály