Partilhar via

az redisenterprise

  • Referência

Nota

Essa referência faz parte da extensão redisenterprise para a CLI do Azure (versão 2.45.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az redisenterprise . Saiba mais sobre extensões.

Gerencie o cache da redisenterprise.

Comandos

Name Description Tipo Status
az redisenterprise create

Crie um cluster de cache existente (substituir/recriar, com potencial tempo de inatividade).

 Extensão GA
az redisenterprise database

Gerencie bancos de dados Redis Enterprise.

 Extensão GA
az redisenterprise database create

Crie um banco de dados.

 Extensão GA
az redisenterprise database delete

Exclua um único banco de dados.

 Extensão GA
az redisenterprise database export

Exporta um arquivo de banco de dados do banco de dados de destino.

 Extensão GA
az redisenterprise database flush

Libera todas as chaves neste banco de dados e também de seus bancos de dados vinculados.

 Extensão GA
az redisenterprise database force-unlink

Remove à força o link para o recurso de banco de dados especificado.

 Extensão GA
az redisenterprise database import

Importa arquivos de banco de dados para o banco de dados de destino.

 Extensão GA
az redisenterprise database list

Liste todos os bancos de dados no cluster RedisEnterprise especificado.

 Extensão GA
az redisenterprise database list-keys

Recupera as chaves de acesso para o banco de dados RedisEnterprise.

 Extensão GA
az redisenterprise database regenerate-key

Regenera as chaves de acesso do banco de dados RedisEnterprise.

 Extensão GA
az redisenterprise database show

Obtenha informações sobre um banco de dados em um cluster RedisEnterprise.

 Extensão GA
az redisenterprise database update

Atualizar um banco de dados.

 Extensão GA
az redisenterprise database wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Extensão GA
az redisenterprise delete

Exclua um cluster de cache RedisEnterprise.

 Extensão GA
az redisenterprise list

Liste todos os clusters RedisEnterprise na assinatura especificada.

 Extensão GA
az redisenterprise operation-status

Obtenha o status de uma operação.

 Extensão GA
az redisenterprise operation-status show

Obtenha o status da operação.

 Extensão GA
az redisenterprise show

Obtenha informações sobre um cluster RedisEnterprise.

 Extensão GA
az redisenterprise update

Atualize um cluster de cache existente (substituir/recriar, com potencial tempo de inatividade).

 Extensão GA
az redisenterprise wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Extensão GA

az redisenterprise create

Crie um cluster de cache existente (substituir/recriar, com potencial tempo de inatividade).

az redisenterprise create --cluster-name
                          --resource-group
                          --sku {EnterpriseFlash_F1500, EnterpriseFlash_F300, EnterpriseFlash_F700, Enterprise_E1, Enterprise_E10, Enterprise_E100, Enterprise_E20, Enterprise_E200, Enterprise_E400, Enterprise_E5, Enterprise_E50}
                          [--assigned-identities]
                          [--capacity]
                          [--client-protocol {Encrypted, Plaintext}]
                          [--clustering-policy {EnterpriseCluster, OSSCluster}]
                          [--eviction-policy {AllKeysLFU, AllKeysLRU, AllKeysRandom, NoEviction, VolatileLFU, VolatileLRU, VolatileRandom, VolatileTTL}]
                          [--group-nickname]
                          [--identity-resource-id]
                          [--identity-type {None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned}]
                          [--key-encryption-identity-type {systemAssignedIdentity, userAssignedIdentity}]
                          [--key-encryption-key-url]
                          [--linked-databases]
                          [--location]
                          [--minimum-tls-version {1.0, 1.1, 1.2}]
                          [--module]
                          [--no-database]
                          [--no-wait]
                          [--persistence]
                          [--port]
                          [--tags]
                          [--zones]

Exemplos

Criar cache

az redisenterprise create --cluster-name "cache1" --location "East US" --minimum-tls-version "1.2" --sku "Enterprise_E20" --capacity 4 --tags tag1="value1" --zones "1" "2" "3" --client-protocol "Encrypted" --clustering-policy "EnterpriseCluster" --eviction-policy "NoEviction" --modules name="RedisBloom" args="ERROR_RATE 0.02 INITIAL_SIZE 400" --persistence aof-enabled=true aof-frequency="1s" --port 10000 --resource-group "rg1"

Parâmetros Obrigatórios

--cluster-name --name -n

O nome do cluster RedisEnterprise.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--sku

O tipo de cluster RedisEnterprise a ser implantado. Valores possíveis: (Enterprise_E10, EnterpriseFlash_F300 etc.).

Valores aceites: EnterpriseFlash_F1500, EnterpriseFlash_F300, EnterpriseFlash_F700, Enterprise_E1, Enterprise_E10, Enterprise_E100, Enterprise_E20, Enterprise_E200, Enterprise_E400, Enterprise_E5, Enterprise_E50

Parâmetros Opcionais

--assigned-identities --user-assigned-identities

O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações.

--capacity

O tamanho do cluster RedisEnterprise. O padrão é 2 ou 3, dependendo da SKU. Os valores válidos são (2, 4, 6, ...) para Enterprise SKUs e (3, 9, 15, ...) para Flash SKUs.

--client-protocol

Especifica se os clientes redis podem se conectar usando protocolos redis criptografados por TLS ou texto sem formatação. O padrão é criptografado por TLS.

Valores aceites: Encrypted, Plaintext
--clustering-policy

Política de clustering - o padrão é OSSCluster. Especificado no momento da criação.

Valores aceites: EnterpriseCluster, OSSCluster
--eviction-policy

Política de despejo Redis - o padrão é VolatileLRU.

Valores aceites: AllKeysLFU, AllKeysLRU, AllKeysRandom, NoEviction, VolatileLFU, VolatileLRU, VolatileRandom, VolatileTTL
--group-nickname

Nome para o grupo de recursos de banco de dados vinculados.

--identity-resource-id --user-assigned-identity-resource-id

Identidade atribuída pelo usuário a ser usada para acessar a chave de criptografia de chave Url. Ex: /subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

--identity-type

Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).

Valores aceites: None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned
--key-encryption-identity-type --key-identity-type

Somente userAssignedIdentity é suportado nesta versão da API; Outros tipos podem ser suportados no futuro.

Valores aceites: systemAssignedIdentity, userAssignedIdentity
--key-encryption-key-url

URL da chave de encriptação da chave, apenas versionada. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78.

--linked-databases

Lista de recursos de banco de dados a serem vinculados a esse banco de dados.

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--minimum-tls-version

A versão TLS mínima para o cluster suportar, por exemplo, '1.2'.

Valores aceites: 1.0, 1.1, 1.2
--module --modules

Conjunto opcional de módulos redis para habilitar neste banco de dados - os módulos só podem ser adicionados no momento da criação.

--no-database

Avançado. Não crie automaticamente um banco de dados padrão. Aviso: o cache não será utilizável até que você crie um banco de dados.

Default value: False
--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--persistence

Configurações de persistência.

--port

Porta TCP do ponto de extremidade do banco de dados. Especificado no momento da criação. O padrão é uma porta disponível.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--zones -z

As zonas de disponibilidade onde esse cluster será implantado.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az redisenterprise delete

Exclua um cluster de cache RedisEnterprise.

az redisenterprise delete [--cluster-name]
                          [--ids]
                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                          [--resource-group]
                          [--subscription]
                          [--yes]

Parâmetros Opcionais

--cluster-name --name -n

O nome do cluster RedisEnterprise.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--no-wait

Não espere que a operação de longa duração termine.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az redisenterprise list

Liste todos os clusters RedisEnterprise na assinatura especificada.

az redisenterprise list [--resource-group]

Parâmetros Opcionais

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az redisenterprise show

Obtenha informações sobre um cluster RedisEnterprise.

az redisenterprise show [--cluster-name]
                        [--ids]
                        [--resource-group]
                        [--subscription]

Parâmetros Opcionais

--cluster-name --name -n

O nome do cluster RedisEnterprise.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az redisenterprise update

Atualize um cluster de cache existente (substituir/recriar, com potencial tempo de inatividade).

az redisenterprise update [--add]
                          [--assigned-identities]
                          [--capacity]
                          [--cluster-name]
                          [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                          [--identity-resource-id]
                          [--identity-type {None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned}]
                          [--ids]
                          [--key-encryption-identity-type {systemAssignedIdentity, userAssignedIdentity}]
                          [--key-encryption-key-url]
                          [--minimum-tls-version {1.0, 1.1, 1.2}]
                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                          [--remove]
                          [--resource-group]
                          [--set]
                          [--sku {EnterpriseFlash_F1500, EnterpriseFlash_F300, EnterpriseFlash_F700, Enterprise_E1, Enterprise_E10, Enterprise_E100, Enterprise_E20, Enterprise_E200, Enterprise_E400, Enterprise_E5, Enterprise_E50}]
                          [--subscription]
                          [--tags]
                          [--zones]

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string ou JSON string>.

--assigned-identities --user-assigned-identities

O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--capacity

O tamanho do cluster RedisEnterprise. O padrão é 2 ou 3, dependendo da SKU. Os valores válidos são (2, 4, 6, ...) para Enterprise SKUs e (3, 9, 15, ...) para Flash SKUs.

--cluster-name --name -n

O nome do cluster RedisEnterprise.

--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--identity-resource-id --user-assigned-identity-resource-id

Identidade atribuída pelo usuário a ser usada para acessar a chave de criptografia de chave Url. Ex: /subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

--identity-type

Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).

Valores aceites: None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--key-encryption-identity-type --key-identity-type

Somente userAssignedIdentity é suportado nesta versão da API; Outros tipos podem ser suportados no futuro.

Valores aceites: systemAssignedIdentity, userAssignedIdentity
--key-encryption-key-url

URL da chave de encriptação da chave, apenas versionada. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78.

--minimum-tls-version

A versão TLS mínima para o cluster suportar, por exemplo, '1.2'.

Valores aceites: 1.0, 1.1, 1.2
--no-wait

Não espere que a operação de longa duração termine.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list OR --remove propertyToRemove.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=.

--sku

O tipo de cluster RedisEnterprise a ser implantado. Valores possíveis: (Enterprise_E10, EnterpriseFlash_F300 etc.).

Valores aceites: EnterpriseFlash_F1500, EnterpriseFlash_F300, EnterpriseFlash_F700, Enterprise_E1, Enterprise_E10, Enterprise_E100, Enterprise_E20, Enterprise_E200, Enterprise_E400, Enterprise_E5, Enterprise_E50
--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--tags

Tags de recursos. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--zones

As zonas de disponibilidade onde esse cluster será implantado. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az redisenterprise wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az redisenterprise wait [--cluster-name]
                        [--created]
                        [--custom]
                        [--deleted]
                        [--exists]
                        [--ids]
                        [--interval]
                        [--resource-group]
                        [--subscription]
                        [--timeout]
                        [--updated]

Parâmetros Opcionais

--cluster-name --name -n

O nome do cluster RedisEnterprise.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Default value: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

Default value: 30
--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--timeout

Espera máxima em segundos.

Default value: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.