az acr repository

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

コマンド

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

az acr repository delete

Azure コンテナー レジストリ内のリポジトリまたはイメージを削除します。

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

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 コンテナー レジストリ内のリポジトリを一覧表示します。

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 コンテナー レジストリ内のリポジトリまたはイメージの属性を取得します。

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-manifests

非推奨

このコマンドは非推奨となり、今後のリリースで削除される予定です。 代わりに 'acr manifest list-metadata' を使用してください。

Azure コンテナー レジストリ内のリポジトリのマニフェストを表示します。

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

例

Azure コンテナー レジストリ内のリポジトリのマニフェストを表示します。

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

Azure Container Registry のリポジトリのタイムスタンプで並べ替えられた最新の 10 個のマニフェストを表示します。

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

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

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

Azure コンテナー レジストリ内のリポジトリ用のタグを表示します。

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 コンテナー レジストリ内のイメージのタグを解除します。

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

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 コンテナー レジストリ内のリポジトリまたはイメージの属性を更新します。

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