Freigeben über


Databases - Regenerate Key

Generiert die Zugriffsschlüssel der Redis Enterprise-Datenbank neu.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}/regenerateKey?api-version=2025-07-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
clusterName
path True

string

pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$

Der Name des Redis Enterprise-Clusters. Der Name muss 1 bis 60 Zeichen lang sein. Zulässige Zeichen (A-Z, a-z, 0-9) und Bindestrich(-). Es kann weder führende noch nachfolgende Bindestriche oder aufeinander folgende Bindestriche geben.

databaseName
path True

string

pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$

Der Name der Redis Enterprise-Datenbank.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

minLength: 1

Die ID des Zielabonnements.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
keyType True

AccessKeyType

Welche Zugriffstaste neu generiert werden soll.

Antworten

Name Typ Beschreibung
200 OK

AccessKeys

Gibt die neuen Zugriffsschlüssel für die Datenbank zurück

202 Accepted

Der Clusteraktualisierungsvorgang wurde gestartet. GET die URL in den Headern Azure-AsyncOperation oder Location, um den aktualisierten Status abzurufen.

Header

  • Location: string
  • Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

RedisEnterpriseDatabasesRegenerateKey

Beispielanforderung

POST https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1/databases/default/regenerateKey?api-version=2025-07-01

{
  "keyType": "Primary"
}

Beispiel für eine Antwort

{
  "primaryKey": "<primaryKey>",
  "secondaryKey": "<secondaryKey>"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/providers/Microsoft.Cache/...pathToOperationStatus...
Location: https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/providers/Microsoft.Cache/...pathToOperationResult...

Definitionen

Name Beschreibung
AccessKeys

Zugriffstasten

AccessKeyType

Welche Zugriffstaste neu generiert werden soll.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

RegenerateKeyParameters

Anforderung von Zugriffsschlüsseln neu generieren

AccessKeys

Zugriffstasten

Name Typ Beschreibung
primaryKey

string

Der aktuelle Primärschlüssel, den Clients zur Authentifizierung verwenden können

secondaryKey

string

Der aktuelle Sekundärschlüssel, den Clients zur Authentifizierung verwenden können

AccessKeyType

Welche Zugriffstaste neu generiert werden soll.

Wert Beschreibung
Primary
Secondary

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

RegenerateKeyParameters

Anforderung von Zugriffsschlüsseln neu generieren

Name Typ Beschreibung
keyType

AccessKeyType

Welche Zugriffstaste neu generiert werden soll.