az storage container lease

BLOB ストレージ コンテナーのリースを管理します。

コマンド

名前	説明	型	状態
az storage container lease acquire	新しいリースを要求します。	コア	GA
az storage container lease break	コンテナーにアクティブなリースがある場合は、リースを解除します。	コア	GA
az storage container lease change	アクティブなリースのリース ID を変更します。	コア	GA
az storage container lease release	リースを解放します。	コア	GA
az storage container lease renew	リースを更新します。	コア	GA

az storage container lease acquire

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

コンテナーにアクティブなリースがない場合、BLOB サービスはコンテナーにリースを作成し、新しいリース ID を返します。

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]

例

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

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

必須のパラメーター

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

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

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

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]

例

リースを解除します。

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

必須のパラメーター

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

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

変更には、現在のリース ID と新しいリース ID を含める必要があります。

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]

例

リースを変更します。

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

必須のパラメーター

--container-name -c

コンテナーの名前。

--lease-id

アクティブなリースのリース ID。

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

リースを解放します。

指定されたlease_idがコンテナーに関連付けられているリースと一致する場合、リースが解放される可能性があります。 リースを解放すると、リリースが完了するとすぐに、別のクライアントがコンテナーのリースをすぐに取得できます。

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]

例

リースを解放します。

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

必須のパラメーター

--container-name -c

コンテナーの名前。

--lease-id

アクティブなリースのリース 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_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 container lease renew

リースを更新します。

指定されたリース ID がコンテナーに関連付けられているリース ID と一致する場合は、リースを更新できます。 リースの有効期限が切れてからコンテナーが再びリースされていない限り、リースの有効期限が切れた場合でも、リースが更新される可能性があることに注意してください。 リースを更新すると、リース期間クロックがリセットされます。

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]

例

リースを更新します。

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

必須のパラメーター

--container-name -c

コンテナーの名前。

--lease-id

アクティブなリースのリース 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_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 を使います。