Feedback

az redis

  • Referenz

Verwalten sie dedizierte Redis-Caches für Ihre Azure-Anwendungen.

Befehle

az redis create

Erstellt eine neue Redis-Cache-Instanz.
az redis delete

Löscht einen Redis-Cache.
az redis export

Daten exportieren, die in einem Redis-Cache gespeichert sind.
az redis firewall-rules

Verwalten von Redis-Firewallregeln.
az redis firewall-rules create

Erstellen Sie eine Redis-Cache-Firewallregel.
az redis firewall-rules delete

Löscht eine einzelne Firewallregel in einem angegebenen Redis-Cache.
az redis firewall-rules list

Ruft alle Firewallregeln im angegebenen Redis-Cache ab.
az redis firewall-rules show

Ruft eine einzelne Firewallregel in einem angegebenen Redis-Cache ab.
az redis firewall-rules update

Aktualisieren einer Redis-Cache-Firewallregel.
az redis force-reboot

Neustart angegebene Redis-Knoten(n).
az redis identity

Verwalten der Identität, die dem Azure-Cache für Redis zugewiesen ist.
az redis identity assign

Identität für Azure-Cache für Redis zuweisen.
az redis identity remove

Entfernen Sie die Identität, die bereits für Azure-Cache für Redis zugewiesen wurde.
az redis identity show

Zeigen Sie die für Azure-Cache zugewiesene Identität für Redis an.
az redis import

Importieren von Daten in einen Redis-Cache.
az redis import-method

Importieren von Daten in Redis-Cache.
az redis list

Redis-Caches auflisten.
az redis list-keys

Rufen Sie die Zugriffstasten eines Redis-Caches ab.
az redis patch-schedule

Verwalten von Redis-Patchzeitplänen.
az redis patch-schedule create

Erstellen Sie patching schedule for Redis cache.
az redis patch-schedule delete

Löscht den Patchzeitplan eines Redis-Caches.
az redis patch-schedule show

Ruft den Patchzeitplan eines Redis-Caches ab.
az redis patch-schedule update

Aktualisieren Sie den Patchzeitplan für Redis-Cache.
az redis regenerate-keys

Neu erstellen Sie die Zugriffstasten des Redis-Caches.
az redis server-link

Verwalten von Redis-Serverlinks.
az redis server-link create

Fügt einen Serverlink zum Redis-Cache hinzu (erfordert Premium-SKU).
az redis server-link delete

Löscht den verknüpften Server aus einem Redis-Cache (erfordert Premium-SKU).
az redis server-link list

Ruft die Liste der verknüpften Server ab, die diesem Redis-Cache zugeordnet sind (erfordert Premium-SKU).
az redis server-link show

Ruft die detaillierten Informationen zu einem verknüpften Server eines Redis-Caches ab (erfordert Premium-SKU).
az redis show

Ruft einen Redis-Cache (Ressourcenbeschreibung) ab.
az redis update

Aktualisieren eines Redis-Caches.

az redis create

Bearbeiten

Erstellt eine neue Redis-Cache-Instanz.

az redis create --location
                --name
                --resource-group
                --sku {Basic, Premium, Standard}
                --vm-size {c0, c1, c2, c3, c4, c5, c6, p1, p2, p3, p4, p5}
                [--enable-non-ssl-port]
                [--mi-system-assigned]
                [--mi-user-assigned]
                [--minimum-tls-version {1.0, 1.1, 1.2}]
                [--redis-configuration]
                [--redis-version]
                [--replicas-per-master]
                [--shard-count]
                [--static-ip]
                [--subnet-id]
                [--tags]
                [--tenant-settings]
                [--zones {1, 2, 3}]

Beispiele

Erstellt eine neue Redis-Cache-Instanz. (automatisch generiert)

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Basic --vm-size c0

Konfigurieren der mehreren Zonen für neue Premium-Azure Cache for Redis

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --zones 1 2

Konfigurieren Sie die Speicherrichtlinien für den Cache.

az redis create --resource-group resourceGroupName --name cacheName --location westus2 --sku Standard --vm-size c0 --redis-configuration @"config_max-memory.json"

Konfigurieren und aktivieren Sie die RDB-Sicherung der Datenpersistenz für neue Premium-Azure Cache for Redis.

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --redis-configuration @"config_rdb.json"

Konfigurieren und Aktivieren der AOF-Sicherungsdatenpersistenz für neue Premium-Azure Cache for Redis

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --redis-configuration @"config_aof.json"

Erstellen einer Premium-Azure Cache for Redis mit aktivierter Clustering

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --shard-count 2

Bereitstellen einer Premium-Azure Cache for Redis innerhalb einer vorhandenen Azure-Virtual Network

az redis create --location westus2 --name MyRedisCache --resource-group MyResourceGroup --sku Premium --vm-size p1 --subnet-id "/subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.{Network|ClassicNetwork}/virtualNetworks/vnet1/subnets/subnet1"

Erforderliche Parameter

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--name -n

Name des Redis-Caches.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--sku

Typ des Redis-Caches.

Zulässige Werte: Basic, Premium, Standard
--vm-size

Größe des Redis-Caches, der bereitgestellt werden soll. Grundlegende und Standardcachegrößen beginnen mit C. Premium-Cachegrößen beginnen mit P.

Zulässige Werte: c0, c1, c2, c3, c4, c5, c6, p1, p2, p3, p4, p5

Optionale Parameter

--enable-non-ssl-port

Wenn angegeben, wird der nicht ssl-redis-Serverport (6379) aktiviert.

--mi-system-assigned

Kennzeichnen, um die zugewiesene Systemidentität anzugeben.

--mi-user-assigned

Mindestens ein Leerzeichen getrennte Ressourcen-IDs von benutzer zugewiesenen Identitäten.

--minimum-tls-version

Gibt die tls-Version an, die von Clients zum Herstellen einer Verbindung mit dem Cache erforderlich ist.

Zulässige Werte: 1.0, 1.1, 1.2
--redis-configuration

Eine JSON-Datei, die zum Festlegen von Redis-Konfigurationseinstellungen verwendet wird. Möglicherweise treten Analysefehler auf, wenn die JSON-Datei ungültig ist.

--redis-version

Redis Version. Nur Hauptversion wird in der Erstellungs-/Updateanforderung mit aktuellen gültigen Werten verwendet: (4, 6).

--replicas-per-master

Die Anzahl der Replikate, die pro Master erstellt werden sollen.

--shard-count

Die Anzahl der auf einem Premium-Clustercache zu erstellendenHards.

--static-ip

Geben Sie bei Bedarf für das VNET eine statische IP an. Wenn Sie keine statische IP angeben, wird automatisch eine IP-Adresse ausgewählt.

--subnet-id

Die vollständige Ressourcen-ID eines Subnetzs in einem virtuellen Netzwerk, um den Redis-Cache bereitzustellen. Beispielformat /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft. {Network| ClassicNetwork}/virtualNetworks/vnet1/subnet1.

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--tenant-settings

Leertrennte Mandanteneinstellungen im Schlüsselformat [=Wert].

--zones -z

Leertrennte Liste der Verfügbarkeitszonen, in denen die Ressource bereitgestellt werden soll.

Zulässige Werte: 1, 2, 3

az redis delete

Bearbeiten

Löscht einen Redis-Cache.

az redis delete [--ids]
                [--name]
                [--resource-group]
                [--yes]

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Name des Redis-Caches.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--yes -y

Nicht zur Bestätigung auffordern

az redis export

Bearbeiten

Exportieren von Daten, die in einem Redis-Cache gespeichert sind.

az redis export --container
                --prefix
                [--file-format]
                [--ids]
                [--name]
                [--resource-group]

Erforderliche Parameter

--container

SAS-URL für Container, in dem Daten exportiert werden müssen.

--prefix

Präfix, das für exportierte Dateien verwendet werden soll.

Optionale Parameter

--file-format

Format des Blobs (Derzeit rdb ist das einzige unterstützte Format, mit anderen Formaten, die in Zukunft erwartet werden).

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Name des Redis-Caches.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az redis force-reboot

Bearbeiten

Starten Sie angegebene Redis-Knoten(n) neu.

Verwendungsbeispiel : az redis force-reboot --name testCacheName --resource-group testResourceGroup --reboot-type {AllNodes, PrimaryNode, SecondaryNode} [-shard-id].

az redis force-reboot --reboot-type {AllNodes, PrimaryNode, SecondaryNode}
                      [--ids]
                      [--name]
                      [--resource-group]
                      [--shard-id]

Erforderliche Parameter

--reboot-type

Welche Redis-Knoten(n) neu gestartet werden sollen. Je nach Wertverlust ist ein Datenverlust möglich.

Zulässige Werte: AllNodes, PrimaryNode, SecondaryNode

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Name des Redis-Caches.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--shard-id

Wenn das Clustering aktiviert ist, wird die ID des Shards neu gestartet.

az redis import

Bearbeiten

Importieren von Daten in einen Redis-Cache.

az redis import --files
                [--file-format]
                [--ids]
                [--name]
                [--resource-group]

Erforderliche Parameter

--files

SAS-URL für Blobs, die importiert werden müssen.

Optionale Parameter

--file-format

Format des Blobs (Derzeit rdb ist das einzige unterstützte Format, mit anderen Formaten, die in Zukunft erwartet werden).

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Name des Redis-Caches.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az redis import-method

Bearbeiten

Importieren sie Daten im Redis-Cache.

Verwendungsbeispiel – az redis import-method --name testCacheName --resource-group testResourceGroup --files [-file-format].

az redis import-method --files
                       [--file-format]
                       [--ids]
                       [--name]
                       [--resource-group]

Erforderliche Parameter

--files

SAS-URL für Blobs, die importiert werden müssen.

Optionale Parameter

--file-format

Format des Blobs (Derzeit rdb ist das einzige unterstützte Format, mit anderen Formaten, die in Zukunft erwartet werden).

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Name des Redis-Caches.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az redis list

Bearbeiten

Redis-Caches auflisten.

Enthält Details zu allen Caches innerhalb des aktuellen Abonnements oder bereitgestellten Ressourcengruppen.

az redis list [--resource-group]

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az redis list-keys

Bearbeiten

Rufen Sie die Zugriffstasten eines Redis-Caches ab.

Dieser Vorgang erfordert schreibberechtigungen für die Cacheressource.

az redis list-keys [--ids]
                   [--name]
                   [--resource-group]

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Name des Redis-Caches.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az redis regenerate-keys

Bearbeiten

Regenerieren Sie die Zugriffstasten des Redis-Caches.

Verwendungsbeispiel – az redis regenerate-keys --name testCacheName --resource-group testResourceGroup --key-type {Primary, Secondary}.

az redis regenerate-keys --key-type {Primary, Secondary}
                         [--ids]
                         [--name]
                         [--resource-group]

Erforderliche Parameter

--key-type

Der Redis-Zugriffsschlüssel, um zu regenerieren.

Zulässige Werte: Primary, Secondary

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Name des Redis-Caches.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az redis show

Bearbeiten

Ruft einen Redis-Cache (Ressourcenbeschreibung) ab.

az redis show [--ids]
              [--name]
              [--resource-group]

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Name des Redis-Caches.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az redis update

Bearbeiten

Aktualisieren eines Redis-Caches.

Skalieren oder Aktualisieren von Einstellungen eines Redis-Caches.

az redis update [--add]
                [--force-string]
                [--ids]
                [--name]
                [--remove]
                [--resource-group]
                [--set]
                [--sku {Basic, Premium, Standard}]
                [--vm-size {c0, c1, c2, c3, c4, c5, c6, p1, p2, p3, p4, p5}]

Beispiele

Aktualisieren der maxmemory-Richtlinie für Ihre Azure Cache for Redis namens MyRedisCache

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "redisConfiguration.maxmemory-policy"="allkeys-lru"

Deaktivieren der RDB-Sicherung der Datenpersistenz für Premium Azure Cache for Redis

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "redisConfiguration.rdb-backup-enabled"="false"

Konfigurieren der RDB-Sicherung aktivierter Datenpersistenz für bereits erstellte Premium-Azure Cache for Redis

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "redisConfiguration.rdb-storage-connection-string"="DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=myAccountKey;EndpointSuffix=core.windows.net" "redisConfiguration.rdb-backup-enabled"="true" "redisConfiguration.rdb-backup-frequency"="15" "redisConfiguration.rdb-backup-max-snapshot-count"="1"

Skalieren einer Azure Cache for Redis Instanz – Aktualisieren auf unterschiedliche Größe (Beispiel zum Skalieren von c0 bis c1).

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "sku.capacity"="2"

Skalieren Sie eine Azure Cache for Redis Instanz – Aktualisieren sie auf verschiedene Ebenen (Von Basic bis Standard oder Standard nach Premium).

az redis update --name MyRedisCache --resource-group MyResourceGroup --set "sku.name"="Premium" "sku.capacity"="1" "sku.family"="P"

Skalieren sie eine Azure Cache for Redis Instanz – Clustering aktivieren.

az redis update --name MyRedisCache --resource-group MyResourceGroup --set shardCount=1

Skalieren Sie eine Azure Cache for Redis Instanz in/out mithilfe des Redis-Clusters.

az redis update --name MyRedisCache --resource-group MyResourceGroup --set shardCount=2

Optionale Parameter

--add

Fügen Sie einem Objekt eine Liste von Objekten hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgen literale beibehalten, anstatt zu versuchen, in JSON zu konvertieren.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Name des Redis-Caches.

--remove

Entfernen Sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftenpfad und einen wert angeben, der festgelegt werden soll. Beispiel: --set-property1.property2=.

--sku

Typ des Redis-Caches.

Zulässige Werte: Basic, Premium, Standard
--vm-size

Größe des Redis-Caches, der bereitgestellt werden soll. Grundlegende und Standardcachegrößen beginnen mit C. Premium-Cachegrößen beginnen mit P.

Zulässige Werte: c0, c1, c2, c3, c4, c5, c6, p1, p2, p3, p4, p5