Partilhar via


az storage container lease

Gerencie locações de contêineres de armazenamento de blobs.

Comandos

Name Description Tipo Status
az storage container lease acquire

Solicite um novo arrendamento.

Principal GA
az storage container lease break

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

Principal GA
az storage container lease change

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

Principal GA
az storage container lease release

Libere o contrato de locação.

Principal GA
az storage container lease renew

Renovar o contrato de arrendamento.

Principal GA

az storage container lease acquire

Solicite um novo arrendamento.

Se o contêiner não tiver uma concessão ativa, o serviço de Blob criará uma concessão no contêiner e retornará uma nova ID de concessão.

az storage container lease acquire --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 um novo arrendamento.

az storage container lease acquire --container-name mycontainer --account-name mystorageaccount --account-key 0000-0000

Parâmetros Obrigatórios

--container-name -c

O nome do contêiner.

Parâmetros Opcionais

--account-key

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

--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: 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 da 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 aceites: 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 do 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 a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar somente se modificado desde o fornecimento UTC datetime (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 a operação se ela existir.

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (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 renovar ou alterar. O padrão é -1 (locação infinita).

Default value: -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 do 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

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 storage container lease break

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

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

az storage container lease break --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]

Exemplos

Quebre o contrato de arrendamento.

az storage container lease break -c mycontainer --lease-break-period 10 --account-name mystorageaccount --account-key 0000-0000

Parâmetros Obrigatórios

--container-name -c

O nome do contêiner.

Parâmetros Opcionais

--account-key

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

--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: 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 da 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 aceites: 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 do 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 a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar somente se modificado desde o fornecimento UTC datetime (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 a operação se ela existir.

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (Y-m-d'T'H:M'Z').

--lease-break-period

Esta é a duração proposta de segundos que o contrato de arrendamento deve continuar antes de ser quebrado, entre 0 e 60 segundos. Este período de pausa só é utilizado se for inferior ao tempo restante no contrato de arrendamento. Se for mais longo, o tempo restante na locação é usado. Um novo contrato de arrendamento não estará disponível antes de o período de interrupção ter expirado, mas o contrato de arrendamento pode ser mantido por mais tempo do que o período de interrupção. Se esse cabeçalho não aparecer com uma operação de interrupção, uma locaçã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 do 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

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 storage container lease change

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

Uma alteração deve incluir o ID de concessão atual e um novo ID de concessão.

az storage container lease change --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]

Exemplos

Altere a locação.

az storage container lease change -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --proposed-lease-id "sef2ef2d-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

Parâmetros Obrigatórios

--container-name -c

O nome do contêiner.

--lease-id

ID de concessão para locaçã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 da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: 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 da 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 aceites: 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 do 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 a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar somente se modificado desde o fornecimento UTC datetime (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 a operação se ela existir.

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (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 do 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

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 storage container lease release

Libere o contrato de locação.

A concessão pode ser liberada se o lease_id especificado corresponder ao associado ao contêiner. A liberação da locação permite que outro cliente adquira imediatamente a locação para o contêiner assim que a liberação for concluída.

az storage container lease release --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

Libere o contrato de locação.

az storage container lease release -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

Parâmetros Obrigatórios

--container-name -c

O nome do contêiner.

--lease-id

ID de concessão para locação ativa.

Parâmetros Opcionais

--account-key

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

--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: 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 da 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 aceites: 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 do 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 a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar somente se modificado desde o fornecimento UTC datetime (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 a operação se ela existir.

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (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 do 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

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 storage container lease renew

Renovar o contrato de arrendamento.

A concessão pode ser renovada se o ID de concessão especificado corresponder ao associado ao contêiner. Tenha em atenção que o contrato de arrendamento pode ser renovado mesmo que tenha expirado, desde que o contentor não tenha sido alugado novamente desde a expiração desse contrato. Quando você renova uma locação, o relógio de duração da concessão é redefinido.

az storage container lease renew --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 arrendamento.

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

Parâmetros Obrigatórios

--container-name -c

O nome do contêiner.

--lease-id

ID de concessão para locação ativa.

Parâmetros Opcionais

--account-key

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

--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: 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 da 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 aceites: 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 do 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 a ETag do recurso corresponder ao valor especificado.

--if-modified-since

Iniciar somente se modificado desde o fornecimento UTC datetime (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 a operação se ela existir.

--if-unmodified-since

Comece apenas se não for modificado desde que forneceu data/hora UTC (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 do 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 de solicitação em segundos. Aplica-se a cada chamada para o serviço.

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.