az storage blob lease
Správa zapůjčení objektů blob úložiště
Příkazy
Name | Description | Typ | Stav |
---|---|---|---|
az storage blob lease acquire |
Požádejte o nové zapůjčení. |
Základ | GA |
az storage blob lease break |
Přerušení zapůjčení, pokud má kontejner nebo objekt blob aktivní zapůjčení. |
Základ | GA |
az storage blob lease change |
Změňte ID zapůjčení aktivního zapůjčení. |
Základ | GA |
az storage blob lease release |
Uvolněte zapůjčení. |
Základ | GA |
az storage blob lease renew |
Prodlužte zapůjčení. |
Základ | GA |
az storage blob lease acquire
Požádejte o nové zapůjčení.
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]
Příklady
Požádejte o nové zapůjčení.
az storage blob lease acquire -b myblob -c mycontainer --account-name mystorageaccount --account-key 0000-0000
Povinné parametry
Název objektu blob.
Název kontejneru.
Volitelné parametry
Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.
Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.
Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.
Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account show
služby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.
připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.
Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku odpovídají zadané hodnotě.
Zahájí se pouze v případě, že byl od zadaného času UTC datum a čas (Y-m-d'T'H:M'Z').
Hodnota značky ETag nebo zástupný znak (). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. Zadejte zástupný znak () k provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operace selže.
Zahájí se pouze v případě, že od zadaného data utc datum a čas (Y-m-d'T'H:M'Z').
Zadejte dobu trvání zapůjčení, v sekundách nebo zápornou hodnotu (-1) pro zapůjčení, které nikdy nevyprší platnost. Nenekonečná zapůjčení může být 15 až 60 sekund. Dobu trvání zapůjčení nelze změnit pomocí prodloužení nebo změny. Výchozí hodnota je -1 (nekonečné zapůjčení).
Navrhované ID zapůjčení ve formátu řetězce GUID Služba Blob Service vrátí hodnotu 400 (neplatný požadavek), pokud navrhované ID zapůjčení není ve správném formátu.
Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.
Zadejte klauzuli SQL where pro značky objektů blob, která bude fungovat pouze s objekty blob s odpovídající hodnotou.
Časový limit požadavku v sekundách Platí pro každé volání služby.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az storage blob lease break
Přerušení zapůjčení, pokud má kontejner nebo objekt blob aktivní zapůjčení.
Jakmile se zapůjčení přeruší, nedá se obnovit. Jakákoli autorizovaná žádost může přerušit zapůjčení; Požadavek není nutný k zadání odpovídajícího ID zapůjčení. Pokud je zapůjčení přerušeno, je povoleno uplynulo období přerušení zapůjčení, během kterého se v kontejneru nebo objektu blob nesmí provádět žádná operace zapůjčení s výjimkou přerušení a uvolnění. Když se zapůjčení úspěšně přeruší, odpověď indikuje interval v sekundách, dokud nebude možné získat nové zapůjčení.
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]
Povinné parametry
Název objektu blob.
Název kontejneru.
Volitelné parametry
Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.
Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.
Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.
Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account show
služby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.
připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.
Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku odpovídají zadané hodnotě.
Zahájí se pouze v případě, že byl od zadaného času UTC datum a čas (Y-m-d'T'H:M'Z').
Hodnota značky ETag nebo zástupný znak (). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. Zadejte zástupný znak () k provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operace selže.
Zahájí se pouze v případě, že od zadaného data utc datum a čas (Y-m-d'T'H:M'Z').
Jedná se o navrženou dobu trvání sekund, po kterou by mělo zapůjčení pokračovat, než se přeruší, mezi 0 a 60 sekund. Toto období přerušení se používá pouze v případě, že je kratší než doba zbývající v zapůjčení. Pokud je delší, použije se zbývající čas zapůjčení. Nové zapůjčení nebude k dispozici před vypršením platnosti období přerušení, ale zapůjčení se může uchovávat déle než období přerušení. Pokud se tato hlavička nezobrazí s operací přerušení, přeruší se zapůjčení po zbývající době zapůjčení po uplynutí zbývající doby zapůjčení a okamžitě se přeruší nekonečné zapůjčení.
Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.
Zadejte klauzuli SQL where pro značky objektů blob, která bude fungovat pouze s objekty blob s odpovídající hodnotou.
Časový limit požadavku v sekundách Platí pro každé volání služby.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az storage blob lease change
Změňte ID zapůjčení aktivního zapůjčení.
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]
Povinné parametry
Název objektu blob.
Název kontejneru.
Vyžaduje se, pokud má objekt blob aktivní zapůjčení.
Navrhované ID zapůjčení ve formátu řetězce GUID Služba Blob Service vrátí hodnotu 400 (neplatný požadavek), pokud navrhované ID zapůjčení není ve správném formátu.
Volitelné parametry
Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.
Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.
Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.
Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account show
služby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.
připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.
Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku odpovídají zadané hodnotě.
Zahájí se pouze v případě, že byl od zadaného času UTC datum a čas (Y-m-d'T'H:M'Z').
Hodnota značky ETag nebo zástupný znak (). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. Zadejte zástupný znak () k provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operace selže.
Zahájí se pouze v případě, že od zadaného data utc datum a čas (Y-m-d'T'H:M'Z').
Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.
Zadejte klauzuli SQL where pro značky objektů blob, která bude fungovat pouze s objekty blob s odpovídající hodnotou.
Časový limit požadavku v sekundách Platí pro každé volání služby.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az storage blob lease release
Uvolněte zapůjčení.
Zapůjčení může být vydáno, pokud zadané ID zapůjčení klienta odpovídá kontejneru nebo objektu blob. Uvolnění zapůjčení umožňuje jinému klientovi okamžitě získat zapůjčení kontejneru nebo objektu blob po dokončení vydání. :keyword ~datetime.datetime if_modified_since: Hodnota DateTime Azure očekává, že hodnota data předaná do standardu UTC. Pokud je časové pásmo zahrnuto, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že se jedná o utc. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek změněn od zadaného času. :keyword ~datetime.datetime if_unmodified_since: Hodnota DateTime Azure očekává, že hodnota data předaná do standardu UTC. Pokud je časové pásmo zahrnuto, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že se jedná o utc. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že se prostředek od zadaného data a času nezměnil. :keyword str etag: Hodnota značky ETag nebo zástupný znak (*). Slouží ke kontrole, jestli se prostředek změnil, a funguje podle podmínky zadané parametrem match_condition
. :keyword ~azure.core.MatchConditions match_condition: Podmínka shody, která se má použít při označení etag. :keyword str if_tags_match_condition: Zadejte klauzuli SQL where u značek objektů blob, která se má pracovat pouze s objektem blob s odpovídající hodnotou. např. "\"tagname\"='my tag'"
.. versionadded:: 12.4.0 :keyword int timeout: Nastaví časový limit na straně serveru pro operaci v sekundách. Další podrobnosti najdete tady: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Tato hodnota není sledována ani ověřena v klientovi. Informace o konfiguraci časových limitů sítě na straně klienta najdete v tématu here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob #other-client--per-operation-configuration>
_. :return: Žádné.
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]
Povinné parametry
Název objektu blob.
Název kontejneru.
Vyžaduje se, pokud má objekt blob aktivní zapůjčení.
Volitelné parametry
Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.
Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.
Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.
Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account show
služby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.
připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.
Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku odpovídají zadané hodnotě.
Zahájí se pouze v případě, že byl od zadaného času UTC datum a čas (Y-m-d'T'H:M'Z').
Hodnota značky ETag nebo zástupný znak (). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. Zadejte zástupný znak () k provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operace selže.
Zahájí se pouze v případě, že od zadaného data utc datum a čas (Y-m-d'T'H:M'Z').
Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.
Zadejte klauzuli SQL where pro značky objektů blob, která bude fungovat pouze s objekty blob s odpovídající hodnotou.
Časový limit požadavku v sekundách Platí pro každé volání služby.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az storage blob lease renew
Prodlužte zapůjčení.
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]
Příklady
Prodlužte zapůjčení.
az storage blob lease renew -b myblob -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000
Povinné parametry
Název objektu blob.
Název kontejneru.
Vyžaduje se, pokud má objekt blob aktivní zapůjčení.
Volitelné parametry
Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.
Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.
Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.
Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account show
služby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.
připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.
Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku odpovídají zadané hodnotě.
Zahájí se pouze v případě, že byl od zadaného času UTC datum a čas (Y-m-d'T'H:M'Z').
Hodnota značky ETag nebo zástupný znak (). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. Zadejte zástupný znak () k provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operace selže.
Zahájí se pouze v případě, že od zadaného data utc datum a čas (Y-m-d'T'H:M'Z').
Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.
Zadejte klauzuli SQL where pro značky objektů blob, která bude fungovat pouze s objekty blob s odpovídající hodnotou.
Časový limit požadavku v sekundách Platí pro každé volání služby.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.