az acr manifest

Manage artifact manifests in Azure Container Registries.

Commands

az acr manifest delete	Delete a manifest in an Azure Container Registry.
az acr manifest list	List the manifests in a repository in an Azure Container Registry.
az acr manifest list-metadata	List the metadata of the manifests in a repository in an Azure Container Registry.
az acr manifest list-referrers	List the ORAS referrers to a manifest in an Azure Container Registry.
az acr manifest metadata	Manage artifact manifest metadata in Azure Container Registries.
az acr manifest metadata list	List the metadata of the manifests in a repository in an Azure Container Registry.
az acr manifest metadata show	Get the metadata of an artifact in an Azure Container Registry.
az acr manifest metadata update	Update the manifest metadata of an artifact in an Azure Container Registry.
az acr manifest show	Get a manifest in an Azure Container Registry.
az acr manifest show-metadata	Get the metadata of an artifact in an Azure Container Registry.
az acr manifest update-metadata	Update the manifest metadata of an artifact in an Azure Container Registry.

az acr manifest delete

Delete a manifest in an Azure Container Registry.

az acr manifest delete [--name]
                       [--password]
                       [--registry]
                       [--suffix]
                       [--username]
                       [--yes]
                       [<MANIFEST_ID>]

Examples

Delete the manifest of the artifact 'hello-world:latest'.

az acr manifest delete -r MyRegistry -n hello-world:latest

Delete the manifest of the artifact 'hello-world:latest'.

az acr manifest delete MyRegistry.azurecr.io/hello-world:latest

Delete the manifest of the artifact referenced by digest 'hello-world@sha256:abc123'.

az acr manifest delete -r MyRegistry -n hello-world@sha256:abc123

Optional Parameters

--name -n

The name of the artifact. May include a tag in the format 'name:tag' or digest in the format 'name@digest'.

--password -p

The password used to log into a container registry.

--registry -r

The name of the container registry. You can configure the default registry name using az configure --defaults acr=<registry name>.

--suffix

The tenant suffix in registry login server. You may specify '--suffix tenant' if your registry login server is in the format 'registry-tenant.azurecr.io'. Applicable if you're accessing the registry from a different subscription or you have permission to access images but not the permission to manage the registry resource.

--username -u

The username used to log into a container registry.

--yes -y

Do not prompt for confirmation.

<MANIFEST_ID>

A fully qualified manifest specifier such as 'MyRegistry.azurecr.io/hello-world:latest'.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acr manifest list

List the manifests in a repository in an Azure Container Registry.

az acr manifest list [--name]
                     [--orderby {time_asc, time_desc}]
                     [--password]
                     [--registry]
                     [--suffix]
                     [--top]
                     [--username]
                     [<REPO_ID>]

Examples

List the manifests of the repository 'hello-world'.

az acr manifest list -r MyRegistry -n hello-world

List the manifests of the repository 'hello-world'.

az acr manifest list MyRegistry.azurecr.io/hello-world

Optional Parameters

--name -n

The name of the repository.

--orderby

Order the items in the results. Default to alphabetical order of names.

accepted values: time_asc, time_desc

--password -p

The password used to log into a container registry.

--registry -r

The name of the container registry. You can configure the default registry name using az configure --defaults acr=<registry name>.

--suffix

The tenant suffix in registry login server. You may specify '--suffix tenant' if your registry login server is in the format 'registry-tenant.azurecr.io'. Applicable if you're accessing the registry from a different subscription or you have permission to access images but not the permission to manage the registry resource.

--top

Limit the number of items in the results.

--username -u

The username used to log into a container registry.

<REPO_ID>

A fully qualified repository specifier such as 'MyRegistry.azurecr.io/hello-world'.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acr manifest list-metadata

List the metadata of the manifests in a repository in an Azure Container Registry.

az acr manifest list-metadata [--name]
                              [--orderby {time_asc, time_desc}]
                              [--password]
                              [--registry]
                              [--suffix]
                              [--top]
                              [--username]
                              [<REPO_ID>]

Examples

List the metadata of the manifests in the repository 'hello-world'.

az acr manifest list-metadata -r MyRegistry -n hello-world

List the metadata of the manifests in the repository 'hello-world'.

az acr manifest list-metadata MyRegistry.azurecr.io/hello-world

Optional Parameters

--name -n

The name of the repository.

--orderby

Order the items in the results. Default to alphabetical order of names.

accepted values: time_asc, time_desc

--password -p

The password used to log into a container registry.

--registry -r

The name of the container registry. You can configure the default registry name using az configure --defaults acr=<registry name>.

--suffix

The tenant suffix in registry login server. You may specify '--suffix tenant' if your registry login server is in the format 'registry-tenant.azurecr.io'. Applicable if you're accessing the registry from a different subscription or you have permission to access images but not the permission to manage the registry resource.

--top

Limit the number of items in the results.

--username -u

The username used to log into a container registry.

<REPO_ID>

A fully qualified repository specifier such as 'MyRegistry.azurecr.io/hello-world'.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acr manifest list-referrers

List the ORAS referrers to a manifest in an Azure Container Registry.

az acr manifest list-referrers [--artifact-type]
                               [--name]
                               [--password]
                               [--recursive]
                               [--registry]
                               [--suffix]
                               [--username]
                               [<MANIFEST_ID>]

Examples

List the referrers to the manifest of the artifact 'hello-world:latest'.

az acr manifest list-referrers -r MyRegistry -n hello-world:latest

List the referrers to the manifest of the artifact 'hello-world:latest'.

az acr manifest list-referrers MyRegistry.azurecr.io/hello-world:latest

List the referrers to the manifest of the artifact referenced by digest 'hello-world@sha256:abc123'.

az acr manifest list-referrers -r MyRegistry -n hello-world@sha256:abc123

Optional Parameters

--artifact-type

Filter referrers based on artifact type.

--name -n

The name of the artifact. May include a tag in the format 'name:tag' or digest in the format 'name@digest'.

--password -p

The password used to log into a container registry.

--recursive

Recursively include referrer artifacts.

--registry -r

The name of the container registry. You can configure the default registry name using az configure --defaults acr=<registry name>.

--suffix

The tenant suffix in registry login server. You may specify '--suffix tenant' if your registry login server is in the format 'registry-tenant.azurecr.io'. Applicable if you're accessing the registry from a different subscription or you have permission to access images but not the permission to manage the registry resource.

--username -u

The username used to log into a container registry.

<MANIFEST_ID>

A fully qualified manifest specifier such as 'MyRegistry.azurecr.io/hello-world:latest'.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acr manifest show

Get a manifest in an Azure Container Registry.

az acr manifest show [--name]
                     [--password]
                     [--raw]
                     [--registry]
                     [--suffix]
                     [--username]
                     [<MANIFEST_ID>]

Examples

Get the manifest of the artifact 'hello-world:latest'.

az acr manifest show -r MyRegistry -n hello-world:latest

Get the manifest of the artifact 'hello-world:latest'.

az acr manifest show MyRegistry.azurecr.io/hello-world:latest

Get the manifest of the artifact referenced by digest 'hello-world@sha256:abc123'.

az acr manifest show -r MyRegistry -n hello-world@sha256:abc123

Get the raw, unformatted manifest of the artifact 'hello-world:latest'.

az acr manifest show -r MyRegistry -n hello-world:latest --raw

Optional Parameters

--name -n

The name of the artifact. May include a tag in the format 'name:tag' or digest in the format 'name@digest'.

--password -p

The password used to log into a container registry.

--raw

Output the raw manifest text with no formatting.

--registry -r

The name of the container registry. You can configure the default registry name using az configure --defaults acr=<registry name>.

--suffix

The tenant suffix in registry login server. You may specify '--suffix tenant' if your registry login server is in the format 'registry-tenant.azurecr.io'. Applicable if you're accessing the registry from a different subscription or you have permission to access images but not the permission to manage the registry resource.

--username -u

The username used to log into a container registry.

<MANIFEST_ID>

A fully qualified manifest specifier such as 'MyRegistry.azurecr.io/hello-world:latest'.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acr manifest show-metadata

Get the metadata of an artifact in an Azure Container Registry.

az acr manifest show-metadata [--name]
                              [--password]
                              [--registry]
                              [--suffix]
                              [--username]
                              [<MANIFEST_ID>]

Examples

Get the metadata of the tag 'hello-world:latest'.

az acr manifest show-metadata -r MyRegistry -n hello-world:latest

Get the metadata of the tag 'hello-world:latest'.

az acr manifest show-metadata MyRegistry.azurecr.io/hello-world:latest

Get the metadata of the manifest referenced by digest 'hello-world@sha256:abc123'.

az acr manifest show-metadata -r MyRegistry -n hello-world@sha256:abc123

Optional Parameters

--name -n

The name of the artifact. May include a tag in the format 'name:tag' or digest in the format 'name@digest'.

--password -p

The password used to log into a container registry.

--registry -r

The name of the container registry. You can configure the default registry name using az configure --defaults acr=<registry name>.

--suffix

The tenant suffix in registry login server. You may specify '--suffix tenant' if your registry login server is in the format 'registry-tenant.azurecr.io'. Applicable if you're accessing the registry from a different subscription or you have permission to access images but not the permission to manage the registry resource.

--username -u

The username used to log into a container registry.

<MANIFEST_ID>

A fully qualified manifest specifier such as 'MyRegistry.azurecr.io/hello-world:latest'.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az acr manifest update-metadata

Update the manifest metadata of an artifact in an Azure Container Registry.

az acr manifest update-metadata [--delete-enabled {false, true}]
                                [--list-enabled {false, true}]
                                [--name]
                                [--password]
                                [--read-enabled {false, true}]
                                [--registry]
                                [--suffix]
                                [--username]
                                [--write-enabled {false, true}]
                                [<MANIFEST_ID>]

Examples

Update the metadata of the tag 'hello-world:latest'.

az acr manifest update-metadata -r MyRegistry -n hello-world:latest --write-enabled false

Update the metadata of the tag 'hello-world:latest'.

az acr manifest update-metadata MyRegistry.azurecr.io/hello-world:latest --write-enabled false

Update the metadata of the artifact referenced by digest 'hello-world@sha256:abc123'.

az acr manifest update-metadata -r MyRegistry -n hello-world@sha256:abc123 --write-enabled false

Optional Parameters

--delete-enabled

Indicate whether delete operation is allowed.

accepted values: false, true

--list-enabled

Indicate whether this item shows in list operation results.

accepted values: false, true

--name -n

The name of the artifact. May include a tag in the format 'name:tag' or digest in the format 'name@digest'.

--password -p

The password used to log into a container registry.

--read-enabled

Indicate whether read operation is allowed.

accepted values: false, true

--registry -r

The name of the container registry. You can configure the default registry name using az configure --defaults acr=<registry name>.

--suffix

The tenant suffix in registry login server. You may specify '--suffix tenant' if your registry login server is in the format 'registry-tenant.azurecr.io'. Applicable if you're accessing the registry from a different subscription or you have permission to access images but not the permission to manage the registry resource.

--username -u

The username used to log into a container registry.

--write-enabled

Indicate whether write or delete operation is allowed.

accepted values: false, true

<MANIFEST_ID>

A fully qualified manifest specifier such as 'MyRegistry.azurecr.io/hello-world:latest'.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.