az acr repository

Azure Container Registries のリポジトリ (イメージ名) を管理します。

コマンド

名前	説明	型	状態
az acr repository delete	Azure Container Registry 内のリポジトリまたはイメージを削除します。	コア	GA
az acr repository list	Azure Container Registry 内のリポジトリを一覧表示します。	コア	GA
az acr repository list-deleted	Azure Container Registry で論理的に削除されたリポジトリを一覧表示します。	コア	プレビュー
az acr repository show	Azure Container Registry 内のリポジトリまたはイメージの属性を取得します。	コア	GA
az acr repository show-tags	Azure Container Registry のリポジトリのタグを表示します。	コア	GA
az acr repository untag	Azure Container Registry でイメージのタグを解除します。	コア	GA
az acr repository update	Azure Container Registry 内のリポジトリまたはイメージの属性を更新します。	コア	GA

az acr repository delete

Azure Container Registry 内のリポジトリまたはイメージを削除します。

このコマンドは、コンテナー レジストリ内の他のマニフェストによって参照されていない、関連付けられているすべてのレイヤー データを削除します。

az acr repository delete --name
                         [--image]
                         [--password]
                         [--repository]
                         [--suffix]
                         [--username]
                         [--yes]

例

タグでイメージ マニフェストを削除します。 これにより、'hello-world:latest' によって参照されるマニフェストと、同じマニフェストを参照する他のすべてのタグが削除されます。

az acr repository delete -n myregistry --image hello-world:latest

sha256 ベースのマニフェスト ダイジェストでイメージ マニフェストを削除します。 これにより、'hello-world@sha256:abc123' によって識別されるマニフェストと、マニフェストを参照するすべてのタグが削除されます。

az acr repository delete -n myregistry --image hello-world@sha256:abc123

Azure Container Registry からリポジトリを削除します。 これにより、"hello-world" のすべてのマニフェストとタグが削除されます。

az acr repository delete -n myregistry --repository hello-world

必須のパラメーター

--name -n

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--image -t

イメージの名前。 'name:tag' 形式のタグまたは 'name@digest' 形式のダイジェストを含めることができます。

--password -p

コンテナー レジストリへのログインに使用するパスワード。

--repository

リポジトリの名前。

--suffix

レジストリ ログイン サーバーのテナント サフィックス。 レジストリ ログイン サーバーの形式が 'registry-tenant.azurecr.io' の場合は、'--suffix tenant' を指定できます。 別のサブスクリプションからレジストリにアクセスしている場合、またはイメージにアクセスするアクセス許可を持っているが、レジストリ リソースを管理するアクセス許可がない場合に適用されます。

--username -u

コンテナー レジストリへのログインに使用するユーザー名。

--yes -y

確認を求めないでください。

規定値: False

グローバル パラメーター

--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 acr repository list

Azure Container Registry 内のリポジトリを一覧表示します。

az acr repository list --name
                       [--password]
                       [--suffix]
                       [--top]
                       [--username]

例

特定の Azure Container Registry 内のリポジトリを一覧表示します。

az acr repository list -n myregistry

必須のパラメーター

--name -n

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--password -p

コンテナー レジストリへのログインに使用するパスワード。

--suffix

レジストリ ログイン サーバーのテナント サフィックス。 レジストリ ログイン サーバーの形式が 'registry-tenant.azurecr.io' の場合は、'--suffix tenant' を指定できます。 別のサブスクリプションからレジストリにアクセスしている場合、またはイメージにアクセスするアクセス許可を持っているが、レジストリ リソースを管理するアクセス許可がない場合に適用されます。

--top

結果の項目数を制限します。

--username -u

コンテナー レジストリへのログインに使用するユーザー名。

グローバル パラメーター

--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 acr repository list-deleted

プレビュー

このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

Azure Container Registry で論理的に削除されたリポジトリを一覧表示します。

az acr repository list-deleted --name
                               [--password]
                               [--suffix]
                               [--username]

例

特定の Azure Container Registry 内の論理的に削除されたリポジトリを一覧表示します。

az acr repository list-deleted -n myregistry

必須のパラメーター

--name -n

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--password -p

コンテナー レジストリへのログインに使用するパスワード。

--suffix

レジストリ ログイン サーバーのテナント サフィックス。 レジストリ ログイン サーバーの形式が 'registry-tenant.azurecr.io' の場合は、'--suffix tenant' を指定できます。 別のサブスクリプションからレジストリにアクセスしている場合、またはイメージにアクセスするアクセス許可を持っているが、レジストリ リソースを管理するアクセス許可がない場合に適用されます。

--username -u

コンテナー レジストリへのログインに使用するユーザー名。

グローバル パラメーター

--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 acr repository show

Azure Container Registry 内のリポジトリまたはイメージの属性を取得します。

az acr repository show --name
                       [--image]
                       [--password]
                       [--repository]
                       [--suffix]
                       [--username]

例

リポジトリ 'hello-world' の属性を取得します。

az acr repository show -n myregistry --repository hello-world

タグ 'hello-world:latest' によって参照されるイメージの属性を取得します。

az acr repository show -n myregistry --image hello-world:latest

ダイジェスト 'hello-world@sha256:abc123' によって参照されるイメージの属性を取得します。

az acr repository show -n myregistry --image hello-world@sha256:abc123

必須のパラメーター

--name -n

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--image -t

イメージの名前。 'name:tag' 形式のタグまたは 'name@digest' 形式のダイジェストを含めることができます。

--password -p

コンテナー レジストリへのログインに使用するパスワード。

--repository

リポジトリの名前。

--suffix

レジストリ ログイン サーバーのテナント サフィックス。 レジストリ ログイン サーバーの形式が 'registry-tenant.azurecr.io' の場合は、'--suffix tenant' を指定できます。 別のサブスクリプションからレジストリにアクセスしている場合、またはイメージにアクセスするアクセス許可を持っているが、レジストリ リソースを管理するアクセス許可がない場合に適用されます。

--username -u

コンテナー レジストリへのログインに使用するユーザー名。

グローバル パラメーター

--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 acr repository show-tags

Azure Container Registry のリポジトリのタグを表示します。

az acr repository show-tags --name
                            --repository
                            [--detail]
                            [--orderby {time_asc, time_desc}]
                            [--password]
                            [--suffix]
                            [--top]
                            [--username]

例

Azure Container Registry 内のリポジトリのタグを表示します。

az acr repository show-tags -n myregistry --repository MyRepository

Azure Container Registry 内のリポジトリのタグの詳細情報を表示します。

az acr repository show-tags -n myregistry --repository MyRepository --detail

Azure Container Registry のリポジトリのタイムスタンプで並べ替えられた最新の 10 個のタグの詳細情報を表示します。

az acr repository show-tags -n myregistry --repository MyRepository --top 10 --orderby time_desc --detail

必須のパラメーター

--name -n

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

--repository

リポジトリの名前。

省略可能のパラメーター

--detail

詳細情報を表示します。

規定値: False

--orderby

結果内の項目を並べ替えます。 既定では、名前のアルファベット順です。

指定可能な値: time_asc, time_desc

--password -p

コンテナー レジストリへのログインに使用するパスワード。

--suffix

レジストリ ログイン サーバーのテナント サフィックス。 レジストリ ログイン サーバーの形式が 'registry-tenant.azurecr.io' の場合は、'--suffix tenant' を指定できます。 別のサブスクリプションからレジストリにアクセスしている場合、またはイメージにアクセスするアクセス許可を持っているが、レジストリ リソースを管理するアクセス許可がない場合に適用されます。

--top

結果の項目数を制限します。

--username -u

コンテナー レジストリへのログインに使用するユーザー名。

グローバル パラメーター

--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 acr repository untag

Azure Container Registry でイメージのタグを解除します。

このコマンドは、タグまたは関連付けられているレイヤー データによって参照されるマニフェストを削除しません。

az acr repository untag --image
                        --name
                        [--password]
                        [--suffix]
                        [--username]

例

リポジトリからイメージのタグを解除します。

az acr repository untag -n myregistry --image hello-world:latest

必須のパラメーター

--image -t

イメージの名前。 'name:tag' という形式のタグを含めることができます。

--name -n

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--password -p

コンテナー レジストリへのログインに使用するパスワード。

--suffix

レジストリ ログイン サーバーのテナント サフィックス。 レジストリ ログイン サーバーの形式が 'registry-tenant.azurecr.io' の場合は、'--suffix tenant' を指定できます。 別のサブスクリプションからレジストリにアクセスしている場合、またはイメージにアクセスするアクセス許可を持っているが、レジストリ リソースを管理するアクセス許可がない場合に適用されます。

--username -u

コンテナー レジストリへのログインに使用するユーザー名。

グローバル パラメーター

--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 acr repository update

Azure Container Registry 内のリポジトリまたはイメージの属性を更新します。

az acr repository update --name
                         [--delete-enabled {false, true}]
                         [--image]
                         [--list-enabled {false, true}]
                         [--password]
                         [--read-enabled {false, true}]
                         [--repository]
                         [--suffix]
                         [--username]
                         [--write-enabled {false, true}]

例

書き込み操作を無効にするために、リポジトリ 'hello-world' の属性を更新します。

az acr repository update -n myregistry --repository hello-world --write-enabled false

タグ 'hello-world:latest' によって参照されるイメージの属性を更新して、書き込み操作を無効にします。

az acr repository update -n myregistry --image hello-world:latest --write-enabled false

ダイジェスト 'hello-world@sha256:abc123' によって参照されるイメージの属性を更新して、書き込み操作を無効にします。

az acr repository update -n myregistry --image hello-world@sha256:abc123 --write-enabled false

必須のパラメーター

--name -n

コンテナー レジストリの名前。 小文字で指定する必要があります。 az configure --defaults acr=<registry name>を使用して、既定のレジストリ名を構成できます。

省略可能のパラメーター

--delete-enabled

削除操作を許可するかどうかを示します。

指定可能な値: false, true

--image -t

イメージの名前。 'name:tag' 形式のタグまたは 'name@digest' 形式のダイジェストを含めることができます。

--list-enabled

この項目がリスト操作の結果に表示されるかどうかを示します。

指定可能な値: false, true

--password -p

コンテナー レジストリへのログインに使用するパスワード。

--read-enabled

読み取り操作が許可されているかどうかを示します。

指定可能な値: false, true

--repository

リポジトリの名前。

--suffix

レジストリ ログイン サーバーのテナント サフィックス。 レジストリ ログイン サーバーの形式が 'registry-tenant.azurecr.io' の場合は、'--suffix tenant' を指定できます。 別のサブスクリプションからレジストリにアクセスしている場合、またはイメージにアクセスするアクセス許可を持っているが、レジストリ リソースを管理するアクセス許可がない場合に適用されます。

--username -u

コンテナー レジストリへのログインに使用するユーザー名。

--write-enabled

書き込み操作または削除操作を許可するかどうかを示します。

指定可能な値: false, true

グローバル パラメーター

--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 を使用します。