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	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 Reguljärt uttrycksmönster: `^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$`
databaseName	path	True	string	Namnet på Redis Enterprise-databasen. Reguljärt uttrycksmönster: `^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$`
resourceGroupName	path	True	string	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string	ID för målprenumerationen.
api-version	query	True	string	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	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

Anger hur ofta data skrivs till disk.

Name	Typ	Description
1s	string
always	string

ClusteringPolicy

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

Name	Typ	Description
EnterpriseCluster	string
OSSCluster	string

Database

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

Ytterligare information om resurshanteringsfelet.

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

ErrorDetail

Felinformationen.

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

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

EvictionPolicy

Redis-borttagningsprincip – standardvärdet är VolatileLRU

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

GeoReplication

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

Länkad databas

Name	Typ	Description
id	string	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

Status för länken mellan databasresurserna.

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

Module

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

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

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

Name	Typ	Description
Encrypted	string
Plaintext	string

ProvisioningState

Aktuell etableringsstatus

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

RdbFrequency

Anger hur ofta en ögonblicksbild av databasen skapas.

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

ResourceState

Aktuell resursstatus

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

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