Databases - Create

Referens

Tjänst:: Redis Cache

API-version:: 2024-10-01

Skapar en databas

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
clusterName	path	True	string pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$	Namnet på Redis Enterprise-klustret. Namnet måste vara 1–60 tecken långt. Tillåtna tecken(A-Z, a-z, 0-9) och bindestreck(-). Det får inte finnas några inledande eller avslutande eller efterföljande bindestreck
databaseName	path	True	string pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$	Namnet på Redis Enterprise-databasen.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string minLength: 1	ID för målprenumerationen.
api-version	query	True	string minLength: 1	DEN API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
properties.clientProtocol	Protocol	Anger om Redis-klienter kan ansluta med TLS-krypterade eller redis-protokoll i klartext. Standardvärdet är TLS-krypterat.
properties.clusteringPolicy	ClusteringPolicy	Klustringsprincip – standardvärdet är OSSCluster. Anges vid skapandetillfället.
properties.evictionPolicy	EvictionPolicy	Redis-borttagningsprincip – standardvärdet är VolatileLRU
properties.geoReplication	GeoReplication	Valfri uppsättning egenskaper för att konfigurera geo-replikering för den här databasen.
properties.modules	Module[]	Valfri uppsättning redis-moduler som ska aktiveras i den här databasen – moduler kan bara läggas till när de skapas.
properties.persistence	Persistence	Inställningar för beständighet Inställningar för beständighet
properties.port	integer (int32)	TCP-port för databasslutpunkten. Anges vid skapandetillfället. Standardvärdet är en tillgänglig port.

Svar

Name	Typ	Description
200 OK	Database	Databasen uppdaterades/uppdateras. Kontrollera provisioningState och resourceState för detaljerad status.
201 Created	Database	Databasen skapades/skapas. Kontrollera provisioningState och resourceState för detaljerad status.
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

RedisEnterpriseDatabasesCreate

RedisEnterpriseDatabasesCreate With Active Geo Replication

RedisEnterpriseDatabasesCreate

Exempelbegäran

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

Exempelsvar

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

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

Exempelbegäran

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

Exempelsvar

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

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

Definitioner

Name	Description
AofFrequency	Anger hur ofta data skrivs till disk.
ClusteringPolicy	Klustringsprincip – standardvärdet är OSSCluster. Anges vid skapandetillfället.
Database	Beskriver en databas i RedisEnterprise-klustret
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
EvictionPolicy	Redis-borttagningsprincip – standardvärdet är VolatileLRU
GeoReplication	Valfri uppsättning egenskaper för att konfigurera geo-replikering för den här databasen.
LinkedDatabase	Länkad databas
LinkState	Status för länken mellan databasresurserna.
Module	Modulinställningar
Persistence	Inställningar för beständighet
Protocol	Anger om Redis-klienter kan ansluta med TLS-krypterade eller redis-protokoll i klartext. Standardvärdet är TLS-krypterat.
ProvisioningState	Aktuell etableringsstatus
RdbFrequency	Anger hur ofta en ögonblicksbild av databasen skapas.
ResourceState	Aktuell resursstatus

AofFrequency

Uppräkning

Anger hur ofta data skrivs till disk.

Värde	Description
1s
always

ClusteringPolicy

Uppräkning

Klustringsprincip – standardvärdet är OSSCluster. Anges vid skapandetillfället.

Värde	Description
EnterpriseCluster
OSSCluster

Database

Objekt

Beskriver en databas i RedisEnterprise-klustret

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Namnet på resursen
properties.clientProtocol	Protocol	Anger om Redis-klienter kan ansluta med TLS-krypterade eller redis-protokoll i klartext. Standardvärdet är TLS-krypterat.
properties.clusteringPolicy	ClusteringPolicy	Klustringsprincip – standardvärdet är OSSCluster. Anges vid skapandetillfället.
properties.evictionPolicy	EvictionPolicy	Redis-borttagningsprincip – standardvärdet är VolatileLRU
properties.geoReplication	GeoReplication	Valfri uppsättning egenskaper för att konfigurera geo-replikering för den här databasen.
properties.modules	Module[]	Valfri uppsättning redis-moduler som ska aktiveras i den här databasen – moduler kan bara läggas till när de skapas.
properties.persistence	Persistence	Inställningar för beständighet Inställningar för beständighet
properties.port	integer (int32)	TCP-port för databasslutpunkten. Anges vid skapandetillfället. Standardvärdet är en tillgänglig port.
properties.provisioningState	ProvisioningState	Aktuell etableringsstatus för databasen
properties.resourceState	ResourceState	Aktuell resursstatus för databasen
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

EvictionPolicy

Uppräkning

Redis-borttagningsprincip – standardvärdet är VolatileLRU

Värde	Description
AllKeysLFU
AllKeysLRU
AllKeysRandom
NoEviction
VolatileLFU
VolatileLRU
VolatileRandom
VolatileTTL

GeoReplication

Objekt

Valfri uppsättning egenskaper för att konfigurera geo-replikering för den här databasen.

Name	Typ	Description
groupNickname	string	Namn på gruppen med länkade databasresurser
linkedDatabases	LinkedDatabase[]	Lista över databasresurser som ska länkas till den här databasen

LinkedDatabase

Objekt

Länkad databas

Name	Typ	Description
id	string (arm-id)	Resurs-ID för en databasresurs som ska länkas till den här databasen.
state	LinkState	Status för länken mellan databasresurserna.

LinkState

Uppräkning

Status för länken mellan databasresurserna.

Värde	Description
LinkFailed
Linked
Linking
UnlinkFailed
Unlinking

Module

Objekt

Modulinställningar

Name	Typ	Description
args	string	Konfigurationsalternativ för modulen, t.ex. "ERROR_RATE 0.01 INITIAL_SIZE 400".
name	string	Namnet på modulen, t.ex. "RedisBloom", "RediSearch", "RedisTimeSeries"
version	string	Versionen av modulen, t.ex. "1.0".

Persistence

Objekt

Inställningar för beständighet

Name	Typ	Description
aofEnabled	boolean	Anger om AOF är aktiverat.
aofFrequency	AofFrequency	Anger hur ofta data skrivs till disk.
rdbEnabled	boolean	Anger om RDB är aktiverat.
rdbFrequency	RdbFrequency	Anger hur ofta en ögonblicksbild av databasen skapas.

Protocol

Uppräkning

Anger om Redis-klienter kan ansluta med TLS-krypterade eller redis-protokoll i klartext. Standardvärdet är TLS-krypterat.

Värde	Description
Encrypted
Plaintext

ProvisioningState

Uppräkning

Aktuell etableringsstatus

Värde	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

RdbFrequency

Uppräkning

Anger hur ofta en ögonblicksbild av databasen skapas.

Värde	Description
12h
1h
6h

ResourceState

Uppräkning

Aktuell resursstatus

Värde	Description
CreateFailed
Creating
DeleteFailed
Deleting
DisableFailed
Disabled
Disabling
EnableFailed
Enabling
Running
Scaling
ScalingFailed
UpdateFailed
Updating

Dela via

Databases - Create

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

RedisEnterpriseDatabasesCreate

Exempelbegäran

Exempelsvar

RedisEnterpriseDatabasesCreate With Active Geo Replication

Exempelbegäran

Exempelsvar

Definitioner

AofFrequency

ClusteringPolicy

Database

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

EvictionPolicy

GeoReplication

LinkedDatabase

LinkState

Module

Persistence

Protocol

ProvisioningState

RdbFrequency

ResourceState

Ytterligare resurser