az storage queue

Versão Prévia
Referência

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerencia filas de armazenamento.

Comandos

Nome	Description	Tipo	Status
az storage queue create	Crie uma fila na conta fornecida.	Núcleo	Versão Prévia
az storage queue delete	Exclua a fila especificada e todas as mensagens que ela contém.	Núcleo	Versão Prévia
az storage queue exists	Retornar um booleano indicando se a fila existe.	Núcleo	Versão Prévia
az storage queue generate-sas	Gere uma assinatura de acesso compartilhado para a fila. Use a assinatura retornada com o parâmetro sas_token de QueueService.	Núcleo	Versão Prévia
az storage queue list	Listar filas em uma conta de armazenamento.	Núcleo	Versão Prévia
az storage queue metadata	Gerencia os metadados de uma fila de armazenamento.	Núcleo	Versão Prévia
az storage queue metadata show	Retornar todos os metadados definidos pelo usuário para a fila especificada.	Núcleo	Versão Prévia
az storage queue metadata update	Defina metadados definidos pelo usuário na fila especificada.	Núcleo	Versão Prévia
az storage queue policy	Gerencia as políticas de acesso compartilhado para uma fila de armazenamento.	Núcleo	Versão Prévia
az storage queue policy create	Crie uma política de acesso armazenado no objeto que contém.	Núcleo	Versão Prévia
az storage queue policy delete	Exclua uma política de acesso armazenado em um objeto que contém.	Núcleo	Versão Prévia
az storage queue policy list	Listar políticas de acesso armazenadas em um objeto que contém.	Núcleo	Versão Prévia
az storage queue policy show	Mostrar uma política de acesso armazenado em um objeto que contém.	Núcleo	Versão Prévia
az storage queue policy update	Defina uma política de acesso armazenado em um objeto que contém.	Núcleo	Versão Prévia
az storage queue stats	Recuperar estatísticas relacionadas à replicação para o serviço de fila. Ele só está disponível quando a replicação com redundância geográfica de acesso de leitura está habilitada para a conta de armazenamento.	Núcleo	Versão Prévia

az storage queue create

Editar

Versão Prévia

O grupo de comandos 'fila de armazenamento' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie uma fila na conta fornecida.

az storage queue create --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--fail-on-exist]
                        [--metadata]
                        [--queue-endpoint]
                        [--sas-token]
                        [--timeout]

Exemplos

Crie uma fila na conta fornecida com metadados.

az storage queue create -n myqueue --metadata key1=value1 key2=value2 --account-name mystorageaccount

Parâmetros Exigidos

--name -n

O nome da fila.

Parâmetros Opcionais

--account-key

Chave de conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

Nome da conta de armazenamento. Variável de ambiente relacionado: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com a chave da conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota de API poderá ser atingida.

--auth-mode

O modo no qual executar o comando. O modo "login" usará diretamente suas credenciais de login para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Valores aceitos: key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

--fail-on-exist

Especifique se deseja lançar uma exceção se a fila já existir.

Valor padrão: False

--metadata

Metadados em pares key=value separados por espaço. Isso substitui quaisquer metadados existentes.

--queue-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com a chave da conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário de serviço com az storage account showo . Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az storage queue delete

Editar

Versão Prévia

O grupo de comandos 'fila de armazenamento' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Exclua a fila especificada e todas as mensagens que ela contém.

az storage queue delete --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--fail-not-exist]
                        [--queue-endpoint]
                        [--sas-token]
                        [--timeout]

Exemplos

Exclua a fila especificada, lance uma exceção se a fila não existir.

az storage queue delete -n myqueue --fail-not-exist --account-name mystorageaccount

Parâmetros Exigidos

--name -n

O nome da fila.

Parâmetros Opcionais

--account-key

Chave de conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceitos: key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

--fail-not-exist

Especifique se deseja lançar uma exceção se a fila não existir.

Valor padrão: False

--queue-endpoint

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az storage queue exists

Editar

Versão Prévia

O grupo de comandos 'fila de armazenamento' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Retornar um booleano indicando se a fila existe.

az storage queue exists --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--queue-endpoint]
                        [--sas-token]
                        [--timeout]

Exemplos

Verifique se a fila existe.

az storage queue exists -n myqueue --account-name mystorageaccount

Parâmetros Exigidos

--name -n

O nome da fila.

Parâmetros Opcionais

--account-key

Chave de conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceitos: key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az storage queue generate-sas

Editar

Versão Prévia

O grupo de comandos 'fila de armazenamento' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gere uma assinatura de acesso compartilhado para a fila. Use a assinatura retornada com o parâmetro sas_token de QueueService.

az storage queue generate-sas --name
                              [--account-key]
                              [--account-name]
                              [--connection-string]
                              [--expiry]
                              [--https-only]
                              [--ip]
                              [--permissions]
                              [--policy-name]
                              [--queue-endpoint]
                              [--start]

Exemplos

Gere um token sas para a fila com permissões somente leitura.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage queue generate-sas -n myqueue --account-name mystorageaccount --permissions r --expiry $end --https-only

Gere um token sas para a fila com o intervalo de ip especificado.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage queue generate-sas -n myqueue --account-name mystorageaccount --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

Parâmetros Exigidos

--name -n

O nome da fila.

Parâmetros Opcionais

--account-key

Chave de conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

--expiry

Especifica a data/hora UTC (Y-m-d'T'H:M'Z') na qual a SAS se torna inválida. Não use se uma política de acesso armazenado for referenciada com --policy-name que especifica esse valor.

--https-only

Permita apenas solicitações feitas com o protocolo HTTPS. Se omitidas, as solicitações do protocolo HTTP e HTTPS serão permitidas.

--ip

Especifica o endereço IP ou o intervalo de endereços IP a partir do qual aceitar solicitações. Suporta apenas endereços de estilo IPv4.

--permissions

As permissões que o SAS concede. Valores permitidos: (a)dd (p)rocess (r)ead (u)pdate. Não use se uma política de acesso armazenado for referenciada com --id que especifica esse valor. Pode ser combinado.

--policy-name

O nome de uma política de acesso armazenado na ACL do compartilhamento.

--queue-endpoint

--start

Especifica a data/hora UTC (Y-m-d'T'H:M'Z') na qual a SAS se torna válida. Não use se uma política de acesso armazenado for referenciada com --policy-name que especifica esse valor. Padrão para a hora da solicitação.

Parâmetros Globais

--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az storage queue list

Editar

Versão Prévia

O grupo de comandos 'fila de armazenamento' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar filas em uma conta de armazenamento.

az storage queue list [--account-key]
                      [--account-name]
                      [--auth-mode {key, login}]
                      [--connection-string]
                      [--include-metadata]
                      [--marker]
                      [--num-results]
                      [--prefix]
                      [--queue-endpoint]
                      [--sas-token]
                      [--show-next-marker]
                      [--timeout]

Exemplos

Listar filas cujos nomes começam com 'myprefix' na conta de armazenamento 'mystorageaccount' (nome da conta)

az storage queue list --prefix myprefix --account-name mystorageaccount

Parâmetros Opcionais

--account-key

Chave de conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceitos: key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

--include-metadata

Especifique que os metadados da fila sejam retornados na resposta.

Valor padrão: False

--marker

Um valor de cadeia de caracteres que identifica a parte da lista de contêineres a serem retornados com a próxima operação de listagem. A operação retorna o valor NextMarker dentro do corpo da resposta se a operação de listagem não retornar todos os contêineres restantes a serem listados com a página atual. Se especificado, este gerador começará a retornar resultados do ponto onde o gerador anterior parou.

--num-results

Especifique o número máximo a ser retornado. Se a solicitação não especificar num_results ou especificar um valor maior que 5000, o servidor retornará até 5000 itens. Observe que, se a operação de listagem cruzar um limite de partição, o serviço retornará um token de continuação para recuperar o restante dos resultados. Forneça "*" para devolver tudo.

Valor padrão: 5000

--prefix

Filtre os resultados para retornar apenas filas cujos nomes comecem com o prefixo especificado.

--queue-endpoint

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--show-next-marker

Mostrar nextMarker no resultado quando especificado.

--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az storage queue stats

Editar

Versão Prévia

O grupo de comandos 'fila de armazenamento' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Recuperar estatísticas relacionadas à replicação para o serviço de fila. Ele só está disponível quando a replicação com redundância geográfica de acesso de leitura está habilitada para a conta de armazenamento.

az storage queue stats [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--queue-endpoint]
                       [--sas-token]
                       [--timeout]

Exemplos

Mostrar estatísticas relacionadas à replicação para o serviço de fila.

az storage queue stats --account-name mystorageaccount

Parâmetros Opcionais

--account-key

Chave de conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valores aceitos: key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade de serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tempo limite da solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros Globais

--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

Compartilhar via

az storage queue

Comandos

az storage queue create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage queue delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage queue exists

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage queue generate-sas

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az storage queue list

Exemplos

Parâmetros Opcionais

az storage queue stats

Exemplos

Parâmetros Opcionais

Recursos adicionais