Compartilhar via


az storage blob lease

Gerencia as concessões do blob de armazenamento.

Comandos

Nome Description Tipo Status
az storage blob lease acquire

Solicite uma nova concessão.

Núcleo GA
az storage blob lease break

Quebre a locação, se o contêiner ou blob tiver uma locação ativa.

Núcleo GA
az storage blob lease change

Altere a ID de concessão de uma concessão ativa.

Núcleo GA
az storage blob lease release

Libere a locação.

Núcleo GA
az storage blob lease renew

Renovar o contrato de locação.

Núcleo GA

az storage blob lease acquire

Solicite uma nova concessão.

az storage blob lease acquire --blob-name
                              --container-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--blob-endpoint]
                              [--connection-string]
                              [--if-match]
                              [--if-modified-since]
                              [--if-none-match]
                              [--if-unmodified-since]
                              [--lease-duration]
                              [--proposed-lease-id]
                              [--sas-token]
                              [--tags-condition]
                              [--timeout]

Exemplos

Solicite uma nova concessão.

az storage blob lease acquire -b myblob -c mycontainer --account-name mystorageaccount --account-key 0000-0000

Parâmetros Exigidos

--blob-name -b

O nome do blob.

--container-name -c

O nome do contêiner.

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

--connection-string

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

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se o ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

Um valor ETag ou o caractere curinga (). Especifique esse cabeçalho para executar a operação somente se o ETag do recurso não corresponder ao valor especificado. Especifique o caractere curinga () para executar a operação somente se o recurso não existir e falhe na operação se ela existir.

--if-unmodified-since

Iniciar somente se não for modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-duration

Especifique a duração da concessão, em segundos, ou negativa (-1) para uma concessão que nunca expira. Uma locação não infinita pode ser entre 15 e 60 segundos. A duração de uma concessão não pode ser alterada usando renovação ou alteração. O padrão é -1 (concessão infinita).

Valor padrão: -1
--proposed-lease-id

ID de concessão proposta, em um formato de cadeia de caracteres GUID. O serviço Blob retornará 400 (solicitação inválida) se a ID de concessão proposta não estiver no formato correto.

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

--tags-condition

Especifique uma cláusula SQL where em tags de blob para operar somente em blobs com um valor correspondente.

--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 blob lease break

Quebre a locação, se o contêiner ou blob tiver uma locação ativa.

Uma vez que um contrato de locação é rompido, ele não pode ser renovado. Qualquer solicitação autorizada pode quebrar o contrato de locação; a solicitação não é necessária para especificar uma ID de concessão correspondente. Quando uma locação é quebrada, o período de interrupção da locação é permitido expirar, durante o qual nenhuma operação de locação, exceto quebra e liberação, pode ser executada no contêiner ou blob. Quando uma concessão é interrompida com êxito, a resposta indica o intervalo em segundos até que uma nova concessão possa ser adquirida.

az storage blob lease break --blob-name
                            --container-name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--if-match]
                            [--if-modified-since]
                            [--if-none-match]
                            [--if-unmodified-since]
                            [--lease-break-period]
                            [--sas-token]
                            [--tags-condition]
                            [--timeout]

Parâmetros Exigidos

--blob-name -b

O nome do blob.

--container-name -c

O nome do contêiner.

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

--connection-string

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

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se o ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

Um valor ETag ou o caractere curinga (). Especifique esse cabeçalho para executar a operação somente se o ETag do recurso não corresponder ao valor especificado. Especifique o caractere curinga () para executar a operação somente se o recurso não existir e falhe na operação se ela existir.

--if-unmodified-since

Iniciar somente se não for modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--lease-break-period

Esta é a duração proposta de segundos que a locação deve continuar antes de ser quebrada, entre 0 e 60 segundos. Este período de pausa só é utilizado se for inferior ao tempo restante na locação. Se for maior, o tempo restante na locação é usado. Uma nova locação não estará disponível antes que o período de pausa tenha expirado, mas a locação pode ser mantida por mais tempo do que o período de pausa. Se esse cabeçalho não aparecer com uma operação de interrupção, uma concessão de duração fixa será interrompida após o período de concessão restante expirar e uma concessão infinita será interrompida imediatamente.

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

--tags-condition

Especifique uma cláusula SQL where em tags de blob para operar somente em blobs com um valor correspondente.

--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 blob lease change

Altere a ID de concessão de uma concessão ativa.

az storage blob lease change --blob-name
                             --container-name
                             --lease-id
                             --proposed-lease-id
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--sas-token]
                             [--tags-condition]
                             [--timeout]

Parâmetros Exigidos

--blob-name -b

O nome do blob.

--container-name -c

O nome do contêiner.

--lease-id

Obrigatório se o blob tiver uma concessão ativa.

--proposed-lease-id

ID de concessão proposta, em um formato de cadeia de caracteres GUID. O serviço Blob retornará 400 (solicitação inválida) se a ID de concessão proposta não estiver no formato correto.

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

--connection-string

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

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se o ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

Um valor ETag ou o caractere curinga (). Especifique esse cabeçalho para executar a operação somente se o ETag do recurso não corresponder ao valor especificado. Especifique o caractere curinga () para executar a operação somente se o recurso não existir e falhe na operação se ela existir.

--if-unmodified-since

Iniciar somente se não for modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

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

--tags-condition

Especifique uma cláusula SQL where em tags de blob para operar somente em blobs com um valor correspondente.

--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 blob lease release

Libere a locação.

A concessão pode ser liberada se o ID de concessão do cliente especificado corresponder ao associado ao contêiner ou blob. A liberação da locação permite que outro cliente adquira imediatamente a locação para o contêiner ou blob assim que a liberação for concluída. :keyword ~datetime.datetime if_modified_since: Um valor DateTime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todas as datas que não sejam UTC serão convertidas em UTC. Se uma data for passada sem informações de fuso horário, presume-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde o tempo especificado. :keyword ~datetime.datetime if_unmodified_since: Um valor DateTime. O Azure espera que o valor de data passado seja UTC. Se o fuso horário estiver incluído, todas as datas que não sejam UTC serão convertidas em UTC. Se uma data for passada sem informações de fuso horário, presume-se que seja UTC. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data/hora especificada. :keyword str etag: Um valor ETag ou o caractere curinga (*). Usado para verificar se o recurso foi alterado e agir de acordo com a condição especificada pelo match_condition parâmetro. :keyword ~azure.core.MatchConditions match_condition: A condição de correspondência a ser usada na etag. :keyword str if_tags_match_condition: especifique uma cláusula SQL where em tags de blob para operar somente em blob com um valor correspondente. ex. "\"tagname\"='my tag'" .. versionadded:: 12.4.0 :keyword int timeout: Define o tempo limite do lado do servidor para a operação em segundos. Para obter mais informações, confira https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Esse valor não é rastreado ou validado no cliente. Para configurar tempos limite de rede do lado do cliente, consulte here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob #other-client--per-operation-configuration>_. :return: Nenhum.

az storage blob lease release --blob-name
                              --container-name
                              --lease-id
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--blob-endpoint]
                              [--connection-string]
                              [--if-match]
                              [--if-modified-since]
                              [--if-none-match]
                              [--if-unmodified-since]
                              [--sas-token]
                              [--tags-condition]
                              [--timeout]

Parâmetros Exigidos

--blob-name -b

O nome do blob.

--container-name -c

O nome do contêiner.

--lease-id

Obrigatório se o blob tiver uma concessão ativa.

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

--connection-string

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

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se o ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

Um valor ETag ou o caractere curinga (). Especifique esse cabeçalho para executar a operação somente se o ETag do recurso não corresponder ao valor especificado. Especifique o caractere curinga () para executar a operação somente se o recurso não existir e falhe na operação se ela existir.

--if-unmodified-since

Iniciar somente se não for modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

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

--tags-condition

Especifique uma cláusula SQL where em tags de blob para operar somente em blobs com um valor correspondente.

--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 blob lease renew

Renovar o contrato de locação.

az storage blob lease renew --blob-name
                            --container-name
                            --lease-id
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--if-match]
                            [--if-modified-since]
                            [--if-none-match]
                            [--if-unmodified-since]
                            [--sas-token]
                            [--tags-condition]
                            [--timeout]

Exemplos

Renovar o contrato de locação.

az storage blob lease renew -b myblob -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

Parâmetros Exigidos

--blob-name -b

O nome do blob.

--container-name -c

O nome do contêiner.

--lease-id

Obrigatório se o blob tiver uma concessão ativa.

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

--connection-string

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

--if-match

Um valor ETag ou o caractere curinga (*). Especifique esse cabeçalho para executar a operação somente se o ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar somente se modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

--if-none-match

Um valor ETag ou o caractere curinga (). Especifique esse cabeçalho para executar a operação somente se o ETag do recurso não corresponder ao valor especificado. Especifique o caractere curinga () para executar a operação somente se o recurso não existir e falhe na operação se ela existir.

--if-unmodified-since

Iniciar somente se não for modificado desde a data e hora UTC fornecida (Y-m-d'T'H:M'Z').

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

--tags-condition

Especifique uma cláusula SQL where em tags de blob para operar somente em blobs com um valor correspondente.

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