az storage blob lease

Verwalten von Speicherblob-Leases

Befehle

az storage blob lease acquire

Fordern Sie eine neue Lease an.

az storage blob lease break

Unterbrechen Sie die Lease, wenn der Container oder blob über eine aktive Lease verfügt.

az storage blob lease change

Ändern Sie die Lease-ID eines aktiven Leases.

az storage blob lease release

Geben Sie die Lease frei.

az storage blob lease renew

Erneuern Sie die Lease.

az storage blob lease acquire

Fordern Sie eine neue Lease an.

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]

Beispiele

Fordern Sie eine neue Lease an.

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

Erforderliche Parameter

--blob-name -b

Der Blobname.

--container-name -c

Der Containername

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Name des Speicherkontos Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent getroffen werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacymodus "Schlüssel" versucht, einen Kontoschlüssel abzufragen, wenn keine Authentifizierungsparameter für das Konto bereitgestellt werden. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login
--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit dem angegebenen UTC-Datum (Y-m-d'T'H:M'Z' geändert wurde).

--if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Mit dem Platzhalterzeichen (*) legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource nicht vorhanden ist, und fehlschlägt, wenn die Ressource vorhanden ist.

--if-unmodified-since

Beginnen Sie nur, wenn seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z) nicht geändert wurde.

--lease-duration

Geben Sie die Dauer des Leasings in Sekunden oder negativer (-1) für ein Leasing an, das nie abläuft. Die Dauer einer nicht unendlichen Lease kann zwischen 15 und 60 Sekunden liegen. Eine Leasingdauer kann nicht mithilfe von Verlängerung oder Änderung geändert werden. Der Standardwert ist -1 (unendliches Leasing).

Standardwert: -1
--proposed-lease-id

Vorgeschlagene Lease-ID in einem GUID-Zeichenfolgenformat. Der Blobdienst gibt 400 (Ungültige Anforderung) zurück, wenn sich die vorgeschlagene Lease-ID nicht im richtigen Format befindet.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

az storage blob lease break

Unterbrechen Sie die Lease, wenn der Container oder blob über einen aktiven Lease verfügt.

Nachdem eine Lease unterbrochen wurde, kann sie nicht verlängert werden. Die Lease kann von jeder autorisierten Anforderung unterbrochen werden. In der Anforderung muss keine übereinstimmende Lease-ID angegeben werden. Wenn ein Lease unterbrochen wird, kann der Zeitraum der Mietunterbrechung verstrichen werden, während der keine Lease-Operation mit Ausnahme von Unterbrechungen und Freigaben im Container oder Blob ausgeführt werden kann. Wenn eine Lease erfolgreich unterbrochen wurde, gibt die Antwort das Intervall in Sekunden an, bis eine neue Lease abgerufen werden kann.

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]

Erforderliche Parameter

--blob-name -b

Der Blobname.

--container-name -c

Der Containername

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Name des Speicherkontos Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent getroffen werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet ihre Anmeldeinformationen direkt für die Authentifizierung. Der ältere "Schlüssel"-Modus versucht, einen Kontoschlüssel zu abfragen, wenn keine Authentifizierungsparameter für das Konto bereitgestellt werden. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login
--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie können jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit der angegebenen UTC-Datumszeit geändert wurden (Y-m-d'T'H:M'Z').

--if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Mit dem Platzhalterzeichen (*) legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource nicht vorhanden ist, und fehlschlägt, wenn die Ressource vorhanden ist.

--if-unmodified-since

Beginnen Sie nur, wenn nicht geändert wurde, seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z').

--lease-break-period

Dies ist die vorgeschlagene Dauer von Sekunden, die die Lease fortsetzen sollte, bevor sie unterbrochen wird, zwischen 0 und 60 Sekunden. Dieser Unterbrechungszeitraum wird nur verwendet, wenn er kürzer als die verbleibende Zeit für die Lease ist. Ist er länger, wird die verbleibende Zeit für die Lease verwendet. Eine neue Lease ist erst verfügbar, wenn der Unterbrechungszeitraum abgelaufen ist. Allerdings ist es möglich, dass die Lease länger als der Unterbrechungszeitraum beibehalten wird. Wenn diese Kopfzeile nicht mit einem Unterbrechungsvorgang angezeigt wird, wird nach Ablauf der verbleibenden Mietzeit ein Fixzeit-Lease-Unterbrechungen und sofort eine unendliche Lease-Unterbrechung angezeigt.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob lease change

Ändern Sie die Lease-ID eines aktiven Leases.

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]

Erforderliche Parameter

--blob-name -b

Der Blobname.

--container-name -c

Der Containername

--lease-id

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

--proposed-lease-id

Vorgeschlagene Lease-ID in einem GUID-Zeichenfolgenformat. Der Blob-Dienst gibt 400 (Ungültige Anforderung) zurück, wenn sich die vorgeschlagene Lease-ID nicht im richtigen Format befindet.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Name des Speicherkontos Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent getroffen werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet ihre Anmeldeinformationen direkt für die Authentifizierung. Der ältere "Schlüssel"-Modus versucht, einen Kontoschlüssel zu abfragen, wenn keine Authentifizierungsparameter für das Konto bereitgestellt werden. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login
--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie können jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit der angegebenen UTC-Datumszeit geändert wurden (Y-m-d'T'H:M'Z').

--if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Mit dem Platzhalterzeichen (*) legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource nicht vorhanden ist, und fehlschlägt, wenn die Ressource vorhanden ist.

--if-unmodified-since

Beginnen Sie nur, wenn nicht geändert wurde, seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z').

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob lease release

Geben Sie die Lease frei.

Die Lease kann freigegeben werden, wenn die angegebene Client-Lease-ID mit dem Container oder Blob übereinstimmt. Durch das Freigeben des Leases kann ein anderer Client sofort den Leasingvertrag für den Container oder blob erwerben, sobald die Version abgeschlossen ist. :keyword ~datetime.datetime if_modified_since: Ein DateTime-Wert. Azure erwartet, dass der datumswert, der in UTC übergeben wird. Wenn Zeitzone enthalten ist, werden alle nicht UTC-Datumszeiten in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass utc. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit der angegebenen Zeit geändert wurde. :keyword ~datetime.datetime if_unmodified_since: Ein DateTime-Wert. Azure erwartet, dass der datumswert, der in UTC übergeben wird. Wenn Zeitzone enthalten ist, werden alle nicht UTC-Datumszeiten in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass utc. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde. :Schlüsselwort str etag: Ein ETag-Wert oder das Platzhalterzeichen (*). Wird verwendet, um zu überprüfen, ob sich die Ressource geändert hat und entsprechend der match_condition vom Parameter angegebenen Bedingung handeln. :keyword ~azure.core.MatchConditions match_condition: Die Übereinstimmungsbedingung, die auf dem Etag verwendet werden soll. :Schlüsselwort str if_tags_match_condition: Geben Sie eine SQL-Klausel an, in der nur blob-Tags mit einem übereinstimmenden Wert ausgeführt werden sollen. Beispiel: ""tagname"='my tag'" .. versionadded:: 12.4.0 :schlüsselwort int timeout: Der Timeoutparameter wird in Sekunden ausgedrückt. :return: None.

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]

Erforderliche Parameter

--blob-name -b

Der Blobname.

--container-name -c

Der Containername

--lease-id

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Name des Speicherkontos Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent getroffen werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet ihre Anmeldeinformationen direkt für die Authentifizierung. Der ältere "Schlüssel"-Modus versucht, einen Kontoschlüssel zu abfragen, wenn keine Authentifizierungsparameter für das Konto bereitgestellt werden. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login
--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie können jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit der angegebenen UTC-Datumszeit geändert wurden (Y-m-d'T'H:M'Z').

--if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Mit dem Platzhalterzeichen (*) legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource nicht vorhanden ist, und fehlschlägt, wenn die Ressource vorhanden ist.

--if-unmodified-since

Beginnen Sie nur, wenn nicht geändert wurde, seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z').

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob lease renew

Erneuern Sie die Lease.

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]

Beispiele

Erneuern Sie die Lease.

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

Erforderliche Parameter

--blob-name -b

Der Blobname.

--container-name -c

Der Containername

--lease-id

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Name des Speicherkontos Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent getroffen werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet ihre Anmeldeinformationen direkt für die Authentifizierung. Der ältere "Schlüssel"-Modus versucht, einen Kontoschlüssel zu abfragen, wenn keine Authentifizierungsparameter für das Konto bereitgestellt werden. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login
--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie können jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit der angegebenen UTC-Datumszeit geändert wurden (Y-m-d'T'H:M'Z').

--if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Mit dem Platzhalterzeichen (*) legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource nicht vorhanden ist, und fehlschlägt, wenn die Ressource vorhanden ist.

--if-unmodified-since

Beginnen Sie nur, wenn nicht geändert wurde, seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z').

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.