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	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. Vzor regulárního výrazu: `^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$`
databaseName	path	True	string	Název databáze Redis Enterprise. Vzor regulárního výrazu: `^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$`
resourceGroupName	path	True	string	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string	ID cílového předplatného.
api-version	query	True	string	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	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

Nastaví frekvenci zápisu dat na disk.

Name	Typ	Description
1s	string
always	string

ClusteringPolicy

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

Name	Typ	Description
EnterpriseCluster	string
OSSCluster	string

Database

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

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

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

ErrorDetail

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

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

EvictionPolicy

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

Name	Typ	Description
AllKeysLFU	string
AllKeysLRU	string
AllKeysRandom	string
NoEviction	string
VolatileLFU	string
VolatileLRU	string
VolatileRandom	string
VolatileTTL	string

GeoReplication

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

Propojená databáze

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

LinkState

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

Name	Typ	Description
LinkFailed	string
Linked	string
Linking	string
UnlinkFailed	string
Unlinking	string

Module

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

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

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.

Name	Typ	Description
Encrypted	string
Plaintext	string

ProvisioningState

Aktuální stav zřizování

Name	Typ	Description
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

RdbFrequency

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

Name	Typ	Description
12h	string
1h	string
6h	string

ResourceState

Aktuální stav zdroje

Name	Typ	Description
CreateFailed	string
Creating	string
DeleteFailed	string
Deleting	string
DisableFailed	string
Disabled	string
Disabling	string
EnableFailed	string
Enabling	string
Running	string
Scaling	string
ScalingFailed	string
UpdateFailed	string
Updating	string

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