az storage blob lease

  • Ссылка

Управление арендой BLOB-объектов хранилища.

Команды

Имя Описание Тип Состояние
az storage blob lease acquire

Запрос новой аренды.

 Основные сведения Общедоступная версия
az storage blob lease break

Разорвать аренду, если контейнер или большой двоичный объект имеет активную аренду.

 Основные сведения Общедоступная версия
az storage blob lease change

Измените идентификатор аренды активной аренды.

 Основные сведения Общедоступная версия
az storage blob lease release

Отпустите аренду.

 Основные сведения Общедоступная версия
az storage blob lease renew

Продление аренды.

 Основные сведения Общедоступная версия

az storage blob lease acquire

Изменить

Запрос новой аренды.

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]

Примеры

Запрос новой аренды.

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

Обязательные параметры

--blob-name -b

Имя большого двоичного объекта.

--container-name -c

Имя контейнера.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--blob-endpoint

служба хранилища конечную точку службы данных. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Значение ETag или дикий карта символ (*). Укажите этот заголовок для выполнения операции, только если ETag ресурса соответствует указанному значению.

--if-modified-since

Начинается только в том случае, если оно было изменено с момента даты и времени UTC (Y-m-d'T'H:M'Z).

--if-none-match

Значение ETag или дикий карта символ (). Укажите этот заголовок для выполнения операции, только если ETag ресурса не соответствует указанному значению. Укажите дикий карта символ () для выполнения операции только в том случае, если ресурс не существует, и завершится сбоем операции, если она существует.

--if-unmodified-since

Начинается только в том случае, если не изменено с указанной даты в формате UTC (Y-m-d'T'H:M'Z').

--lease-duration

Укажите длительность аренды, в секундах или отрицательное значение (-1) для аренды, которая никогда не истекает. Неконечная аренда может составлять от 15 до 60 секунд. Длительность аренды не может быть изменена с помощью продления или изменения. Значение по умолчанию — -1 (бесконечная аренда).

значение по умолчанию: -1
--proposed-lease-id

Предлагаемый идентификатор аренды в формате строки GUID. Служба BLOB-объектов возвращает значение 400 (недопустимый запрос), если предлагаемый идентификатор аренды не соответствует правильному формату.

--sas-token

Подписанный URL-адрес (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Укажите SQL, где предложение тегов BLOB-объектов работает только в больших двоичных объектах со соответствующим значением.

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az storage blob lease break

Изменить

Разорвать аренду, если контейнер или большой двоичный объект имеет активную аренду.

После разрыва аренды его нельзя продлить. Любой авторизованный запрос может нарушить аренду; Запрос не требуется для указания соответствующего идентификатора аренды. При сломе аренды срок аренды допускается истекать, в течение которого не выполняется операция аренды, за исключением перерыва и освобождения, можно выполнить на контейнере или большом двоичном объекте. При успешном разрыве аренды ответ указывает интервал в секундах до получения новой аренды.

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]

Обязательные параметры

--blob-name -b

Имя большого двоичного объекта.

--container-name -c

Имя контейнера.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--blob-endpoint

служба хранилища конечную точку службы данных. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Значение ETag или дикий карта символ (*). Укажите этот заголовок для выполнения операции, только если ETag ресурса соответствует указанному значению.

--if-modified-since

Начинается только в том случае, если оно было изменено с момента даты и времени UTC (Y-m-d'T'H:M'Z).

--if-none-match

Значение ETag или дикий карта символ (). Укажите этот заголовок для выполнения операции, только если ETag ресурса не соответствует указанному значению. Укажите дикий карта символ () для выполнения операции только в том случае, если ресурс не существует, и завершится сбоем операции, если она существует.

--if-unmodified-since

Начинается только в том случае, если не изменено с указанной даты в формате UTC (Y-m-d'T'H:M'Z').

--lease-break-period

Это предлагаемая длительность секунд, которая должна продолжаться, прежде чем она будет нарушена, от 0 до 60 секунд. Этот период перерыва используется только в том случае, если оно меньше времени, оставшегося на аренде. Если больше времени, оставшееся на аренде, используется. Новая аренда не будет доступна до истечения периода перерыва, но аренда может быть проведена дольше, чем период перерыва. Если этот заголовок не отображается с операцией перерыва, фиксированный срок аренды прерывается после окончания оставшегося периода аренды, и бесконечные перерывы аренды немедленно.

--sas-token

Подписанный URL-адрес (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Укажите SQL, где предложение тегов BLOB-объектов работает только в больших двоичных объектах со соответствующим значением.

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az storage blob lease change

Изменить

Измените идентификатор аренды активной аренды.

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]

Обязательные параметры

--blob-name -b

Имя большого двоичного объекта.

--container-name -c

Имя контейнера.

--lease-id

Требуется, если большой двоичный объект имеет активную аренду.

--proposed-lease-id

Предлагаемый идентификатор аренды в формате строки GUID. Служба BLOB-объектов возвращает значение 400 (недопустимый запрос), если предлагаемый идентификатор аренды не соответствует правильному формату.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--blob-endpoint

служба хранилища конечную точку службы данных. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Значение ETag или дикий карта символ (*). Укажите этот заголовок для выполнения операции, только если ETag ресурса соответствует указанному значению.

--if-modified-since

Начинается только в том случае, если оно было изменено с момента даты и времени UTC (Y-m-d'T'H:M'Z).

--if-none-match

Значение ETag или дикий карта символ (). Укажите этот заголовок для выполнения операции, только если ETag ресурса не соответствует указанному значению. Укажите дикий карта символ () для выполнения операции только в том случае, если ресурс не существует, и завершится сбоем операции, если она существует.

--if-unmodified-since

Начинается только в том случае, если не изменено с указанной даты в формате UTC (Y-m-d'T'H:M'Z').

--sas-token

Подписанный URL-адрес (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Укажите SQL, где предложение тегов BLOB-объектов работает только в больших двоичных объектах со соответствующим значением.

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az storage blob lease release

Изменить

Отпустите аренду.

Аренда может быть освобождена, если указанный идентификатор аренды клиента совпадает с контейнером или большим двоичным объектом. Освобождение аренды позволяет другому клиенту немедленно получить аренду контейнера или большого двоичного объекта сразу после завершения выпуска. :ключевое слово ~datetime.datetime if_modified_since: значение DateTime. Azure ожидает, что значение даты, переданное в формате UTC. Если часовой пояс включен, все даты и времени, отличные от UTC, будут преобразованы в формате UTC. Если дата передается без сведений о часовом поясе, предполагается, что дата в формате UTC. Укажите этот заголовок для выполнения операции, только если ресурс был изменен с указанного времени. :ключевое слово ~datetime.datetime if_unmodified_since: значение DateTime. Azure ожидает, что значение даты, переданное в формате UTC. Если часовой пояс включен, все даты и времени, отличные от UTC, будут преобразованы в формате UTC. Если дата передается без сведений о часовом поясе, предполагается, что дата в формате UTC. Укажите этот заголовок для выполнения операции, только если ресурс не был изменен с указанной даты и времени. :ключевое слово str etag: значение ETag или дикий карта символ (*). Используется для проверка, если ресурс изменился, и действует в соответствии с условием, указанным параметромmatch_condition. :ключевое слово ~azure.core.MatchConditions match_condition: условие соответствия, используемое для etag. :ключевое слово str if_tags_match_condition. Укажите предложение SQL, в котором предложение тегов BLOB-объектов работает только с большим двоичным объектом с соответствующим значением. Например: "\"tagname\"='my tag'" .. versionadded:: 12.4.0 :ключевое слово время ожидания int: задает время ожидания на стороне сервера в секундах. Дополнительные сведения см. в следующей статье: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Это значение не отслеживается или проверяется на клиенте. Сведения о настройке времени ожидания сети на стороне клиента см. в разделе here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob #other-client--per-operation-configuration>_. :return: Нет.

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]

Обязательные параметры

--blob-name -b

Имя большого двоичного объекта.

--container-name -c

Имя контейнера.

--lease-id

Требуется, если большой двоичный объект имеет активную аренду.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--blob-endpoint

служба хранилища конечную точку службы данных. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Значение ETag или дикий карта символ (*). Укажите этот заголовок для выполнения операции, только если ETag ресурса соответствует указанному значению.

--if-modified-since

Начинается только в том случае, если оно было изменено с момента даты и времени UTC (Y-m-d'T'H:M'Z).

--if-none-match

Значение ETag или дикий карта символ (). Укажите этот заголовок для выполнения операции, только если ETag ресурса не соответствует указанному значению. Укажите дикий карта символ () для выполнения операции только в том случае, если ресурс не существует, и завершится сбоем операции, если она существует.

--if-unmodified-since

Начинается только в том случае, если не изменено с указанной даты в формате UTC (Y-m-d'T'H:M'Z').

--sas-token

Подписанный URL-адрес (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Укажите SQL, где предложение тегов BLOB-объектов работает только в больших двоичных объектах со соответствующим значением.

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az storage blob lease renew

Изменить

Продление аренды.

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]

Примеры

Продление аренды.

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

Обязательные параметры

--blob-name -b

Имя большого двоичного объекта.

--container-name -c

Имя контейнера.

--lease-id

Требуется, если большой двоичный объект имеет активную аренду.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--blob-endpoint

служба хранилища конечную точку службы данных. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Значение ETag или дикий карта символ (*). Укажите этот заголовок для выполнения операции, только если ETag ресурса соответствует указанному значению.

--if-modified-since

Начинается только в том случае, если оно было изменено с момента даты и времени UTC (Y-m-d'T'H:M'Z).

--if-none-match

Значение ETag или дикий карта символ (). Укажите этот заголовок для выполнения операции, только если ETag ресурса не соответствует указанному значению. Укажите дикий карта символ () для выполнения операции только в том случае, если ресурс не существует, и завершится сбоем операции, если она существует.

--if-unmodified-since

Начинается только в том случае, если не изменено с указанной даты в формате UTC (Y-m-d'T'H:M'Z').

--sas-token

Подписанный URL-адрес (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Укажите SQL, где предложение тегов BLOB-объектов работает только в больших двоичных объектах со соответствующим значением.

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.