az storage blob lease

  • リファレンス

ストレージの BLOB のリースを管理します。

コマンド

名前 説明 型 状態
az storage blob lease acquire

新しいリースを要求します。

 コア GA
az storage blob lease break

コンテナーまたは BLOB にアクティブなリースがある場合は、リースを解除します。

 コア GA
az storage blob lease change

アクティブなリースのリース ID を変更します。

 コア GA
az storage blob lease release

リースを解放します。

 コア GA
az storage blob lease renew

リースを更新します。

 コア GA

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

BLOB 名。

--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_Standard EditionRVICE_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

提案されたリース ID (GUID 文字列形式)。 提案されたリース ID が正しい形式でない場合、BLOB サービスは 400 (無効な要求) を返します。

--sas-token

Shared Access Signature (SAS)。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

--tags-condition

一致する値を持つ BLOB でのみ動作するように、BLOB タグに対して SQL where 句を指定します。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az storage blob lease break

編集

コンテナーまたは BLOB にアクティブなリースがある場合は、リースを解除します。

リースが中断されると、更新することはできません。 承認された要求はリースを中断する可能性があります。要求は、一致するリース ID を指定する必要はありません。 リースが中断されると、リースの中断期間が経過し、その間、コンテナーまたは BLOB に対して中断と解放を除くリース操作を実行できません。 リースが正常に切断されると、応答は、新しいリースを取得できるようになるまでの間隔を秒単位で示します。

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

BLOB 名。

--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_Standard EditionRVICE_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

Shared Access Signature (SAS)。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

--tags-condition

一致する値を持つ BLOB でのみ動作するように、BLOB タグに対して SQL where 句を指定します。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az storage blob lease change

編集

アクティブなリースのリース ID を変更します。

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

BLOB 名。

--container-name -c

コンテナーの名前。

--lease-id

BLOB にアクティブなリースがある場合に必要です。

--proposed-lease-id

提案されたリース ID (GUID 文字列形式)。 提案されたリース ID が正しい形式でない場合、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_Standard EditionRVICE_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

Shared Access Signature (SAS)。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

--tags-condition

一致する値を持つ BLOB でのみ動作するように、BLOB タグに対して SQL where 句を指定します。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az storage blob lease release

編集

リースを解放します。

指定されたクライアント リース ID が、コンテナーまたは BLOB に関連付けられているリース ID と一致する場合は、リースが解放される可能性があります。 リースを解放すると、リリースが完了するとすぐに、別のクライアントがコンテナーまたは BLOB のリースをすぐに取得できます。 :キーワード (keyword) ~datetime.datetime if_modified_since: DateTime 値。 Azure では、渡された日付値が UTC であると想定しています。 タイムゾーンが含まれている場合、UTC 以外の日時は UTC に変換されます。 タイムゾーン情報なしで日付が渡された場合、UTC と見なされます。 指定した時刻以降にリソースが変更された場合にのみ、このヘッダーを指定して操作を実行します。 :キーワード (keyword) ~datetime.datetime if_unmodified_since: DateTime 値。 Azure では、渡された日付値が UTC であると想定しています。 タイムゾーンが含まれている場合、UTC 以外の日時は UTC に変換されます。 タイムゾーン情報なしで日付が渡された場合、UTC と見なされます。 指定した日付/時刻以降にリソースが変更されていない場合にのみ、このヘッダーを指定して操作を実行します。 :キーワード (keyword) str etag: ETag 値、またはワイルドカード文字 (*)。 リソースが変更された場合にチェックし、パラメーターでmatch_condition指定された条件に従って動作するために使用されます。 :キーワード (keyword) ~azure.core.MatchConditions match_condition: etag で使用する一致条件。 :キーワード (keyword) str if_tags_match_condition: BLOB タグに対して SQL where 句を指定し、一致する値を持つ BLOB でのみ動作します。 例: "\"tagname\"='my tag'" .. versionadded:: 12.4.0 :キーワード (keyword) int timeout: 操作のサーバー側タイムアウトを秒単位で設定します。 詳細については、 https://video2.skills-academy.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

BLOB 名。

--container-name -c

コンテナーの名前。

--lease-id

BLOB にアクティブなリースがある場合に必要です。

省略可能のパラメーター

--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_Standard EditionRVICE_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

Shared Access Signature (SAS)。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

--tags-condition

一致する値を持つ BLOB でのみ動作するように、BLOB タグに対して SQL where 句を指定します。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 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

BLOB 名。

--container-name -c

コンテナーの名前。

--lease-id

BLOB にアクティブなリースがある場合に必要です。

省略可能のパラメーター

--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_Standard EditionRVICE_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

Shared Access Signature (SAS)。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

--tags-condition

一致する値を持つ BLOB でのみ動作するように、BLOB タグに対して SQL where 句を指定します。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。