Merge pull request #205218 from TimShererWithAquent/us1970076e

Updates to Azure CLI: az acr manifest list-metadata

Author: Stacyrch140

articles/container-registry/container-registry-concepts.md

@@ -86,16 +86,16 @@ A basic manifest for a Linux `hello-world` image looks similar to the following:
   }
   ```
 
-You can list the manifests for a repository with the Azure CLI command [az acr repository show-manifests][az-acr-repository-show-manifests]:
+You can list the manifests for a repository with the Azure CLI command [az acr manifest list-metadata][az-acr-manifest-list-metadata]:
 
 ```azurecli
-az acr repository show-manifests --name <acrName> --repository <repositoryName>
+az acr manifest list-metadata --name <repositoryName> --registry <acrName>
 ```
 
 For example, list the manifests for the "acr-helloworld" repository:
 
 ```azurecli
-az acr repository show-manifests --name myregistry --repository acr-helloworld
+az acr manifest list-metadata --name acr-helloworld --registry myregistry
 ```
 
 ```output
@@ -179,4 +179,4 @@ Learn more about [registry storage](container-registry-storage.md) and [supporte
 Learn how to [push and pull images](container-registry-get-started-docker-cli.md) from Azure Container Registry.
 
 <!-- LINKS - Internal -->
-[az-acr-repository-show-manifests]: /cli/azure/acr/repository#az_acr_repository_show_manifests
+[az-acr-manifest-list-metadata]: /cli/azure/acr/manifest#az-acr-manifest-list-metadata

articles/container-registry/container-registry-delete.md

@@ -57,7 +57,7 @@ A [manifest digest](container-registry-concepts.md#manifest-digest) can be assoc
 To delete by digest, first list the manifest digests for the repository containing the images you wish to delete. For example:
 
 ```azurecli
-az acr repository show-manifests --name myregistry --repository acr-helloworld
+az acr manifest list-metadata --name acr-helloworld --registry myregistry
 ```
 
 ```output
@@ -106,8 +106,8 @@ To maintain the size of a repository or registry, you might need to periodically
 The following Azure CLI command lists all manifest digests in a repository older than a specified timestamp, in ascending order. Replace `<acrName>` and `<repositoryName>` with values appropriate for your environment. The timestamp could be a full date-time expression or a date, as in this example.
 
 ```azurecli
-az acr repository show-manifests --name <acrName> --repository <repositoryName> \
---orderby time_asc -o tsv --query "[?timestamp < '2019-04-05'].[digest, timestamp]"
+az acr manifest list-metadata --name <repositoryName> --registry <acrName> <repositoryName> \
+    --orderby time_asc -o tsv --query "[?timestamp < '2019-04-05'].[digest, timestamp]"
 ```
 
 After identifying stale manifest digests, you can run the following Bash script to delete manifest digests older than a specified timestamp. It requires the Azure CLI and **xargs**. By default, the script performs no deletion. Change the `ENABLE_DELETE` value to `true` to enable image deletion.
@@ -135,13 +135,13 @@ TIMESTAMP=2019-04-05
 
 if [ "$ENABLE_DELETE" = true ]
 then
-    az acr repository show-manifests --name $REGISTRY --repository $REPOSITORY \
+    az acr manifest list-metadata --name $REPOSITORY --registry $REGISTRY \
     --orderby time_asc --query "[?timestamp < '$TIMESTAMP'].digest" -o tsv \
     | xargs -I% az acr repository delete --name $REGISTRY --image $REPOSITORY@% --yes
 else
     echo "No data deleted."
     echo "Set ENABLE_DELETE=true to enable deletion of these images in $REPOSITORY:"
-    az acr repository show-manifests --name $REGISTRY --repository $REPOSITORY \
+    az acr manifest list-metadata --name $REPOSITORY --repository $REGISTRY \
    --orderby time_asc --query "[?timestamp < '$TIMESTAMP'].[digest, timestamp]" -o tsv
 fi
 ```
@@ -154,7 +154,7 @@ As mentioned in the [Manifest digest](container-registry-concepts.md#manifest-di
 1. Check manifests for repository *acr-helloworld*:
 
    ```azurecli
-   az acr repository show-manifests --name myregistry --repository acr-helloworld
+   az acr manifest list-metadata --name acr-helloworld --registry myregistry
    
    ```
 
@@ -175,7 +175,7 @@ As mentioned in the [Manifest digest](container-registry-concepts.md#manifest-di
 1. Check manifests for repository *acr-helloworld*:
 
    ```azurecli
-   az acr repository show-manifests --name myregistry --repository acr-helloworld
+   az acr manifest list-metadata --name myregistry --repository acr-helloworld
    ```
 
    ```output

articles/container-registry/container-registry-faq.yml

@@ -108,13 +108,13 @@ sections:
           If you are on bash:
           
           ```azurecli
-          az acr repository show-manifests -n myRegistry --repository myRepository --query "[?tags[0]==null].digest" -o tsv  | xargs -I% az acr repository delete -n myRegistry -t myRepository@%
+          az acr manifest list-metadata --name myRepository --registry myRegistry --query "[?tags[0]==null].digest" --output tsv  | xargs -I% az acr repository delete --name myRegistry ---image myRepository@%
           ```
           
           For PowerShell:
           
           ```azurecli
-          az acr repository show-manifests -n myRegistry --repository myRepository --query "[?tags[0]==null].digest" -o tsv | %{ az acr repository delete -n myRegistry -t myRepository@$_ }
+          az acr manifest list-metadata --name myRepository --repository myRegistry --query "[?tags[0]==null].digest" --output tsv | %{ az acr repository delete --name myRegistry --image myRepository@$_ }
           ```
           
           > [!NOTE] 

articles/container-registry/container-registry-helm-repos.md

@@ -213,7 +213,7 @@ Output is similar to:
 }
 ```
 
-Run the [az acr repository show-manifests][az-acr-repository-show-manifests] command to see details of the chart stored in the repository. For example:
+Run the [az acr manifest list-metadata][az-acr-manifest-list-metadata] command to see details of the chart stored in the repository. For example:
 
 ```azurecli
 az acr manifest list-metadata \
@@ -383,5 +383,5 @@ helm repo remove $ACR_NAME
 [az-acr-repository]: /cli/azure/acr/repository
 [az-acr-repository-show]: /cli/azure/acr/repository#az_acr_repository_show
 [az-acr-repository-delete]: /cli/azure/acr/repository#az_acr_repository_delete
-[az-acr-repository-show-manifests]: /cli/azure/acr/repository#az_acr_repository_show_manifests
+[az-acr-manifest-list-metadata]: /cli/azure/acr/manifest#az-acr-manifest-list-metadata
 [acr-tasks]: container-registry-tasks-overview.md

articles/container-registry/container-registry-image-lock.md

@@ -64,7 +64,7 @@ az acr repository update \
 
 ### Lock an image by manifest digest
 
-To lock a *myimage* image identified by manifest digest (SHA-256 hash, represented as `sha256:...`), run the following command. (To find the manifest digest associated with one or more image tags, run the [az acr repository show-manifests][az-acr-repository-show-manifests] command.)
+To lock a *myimage* image identified by manifest digest (SHA-256 hash, represented as `sha256:...`), run the following command. (To find the manifest digest associated with one or more image tags, run the [az acr manifest list-metadata][az-acr-manifest-list-metadata] command.)
 
 ```azurecli
 az acr repository update \
@@ -149,8 +149,8 @@ To see the attributes set for an image version or repository, use the [az acr re
 For details about delete operations, see [Delete container images in Azure Container Registry][container-registry-delete].
 
 <!-- LINKS - Internal -->
+[az-acr-manifest-list-metadata]: /cli/azure/acr/manifest#az-acr-manifest-list-metadata
 [az-acr-repository-update]: /cli/azure/acr/repository#az_acr_repository_update
 [az-acr-repository-show]: /cli/azure/acr/repository#az_acr_repository_show
-[az-acr-repository-show-manifests]: /cli/azure/acr/repository#az_acr_repository_show_manifests
 [azure-cli]: /cli/azure/install-azure-cli
 [container-registry-delete]: container-registry-delete.md

articles/container-registry/container-registry-import-images.md

@@ -80,12 +80,12 @@ az acr import \
   --image hello-world:latest
 ```
 
-You can verify that multiple manifests are associated with this image by running the `az acr repository show-manifests` command:
+You can verify that multiple manifests are associated with this image by running the [az acr manifest list-metadata](/cli/azure/acr/manifest#az-acr-manifest-list-metadata) command:
 
 ```azurecli
-az acr repository show-manifests \
-  --name myregistry \
-  --repository hello-world
+az acr manifest list-metadata \
+  --name hello-world \
+  --registry myregistry
 ```
 
 To import an artifact by digest without adding a tag:

articles/container-registry/container-registry-oras-artifacts.md

@@ -313,10 +313,10 @@ az acr repository show-tags \
 A repository can have a list of manifests that are both tagged and untagged
 
 ```azurecli
-az acr repository show-manifests \
-  -n $ACR_NAME \
-  --repository $REPO \
-  --detail -o jsonc
+az acr manifest list-metadata \
+  --name $REPO \
+  --repository $ACR_NAME \
+  --output jsonc
 ```
 
 Note the container image manifests have `"tags":`
@@ -373,9 +373,9 @@ az acr repository delete \
 ### View the remaining manifests
 
 ```azurecli
-az acr repository show-manifests \
-  -n $ACR_NAME \
-  --repository $REPO \
+az acr manifest list-metadata \
+  --name $REPO \
+  --registry $ACR_NAME \
   --detail -o jsonc
 ```
 

articles/container-registry/container-registry-repository-scoped-permissions.md

@@ -187,7 +187,7 @@ The authentication method depends on the configured action or actions associated
   |`content/delete`    | `az acr repository delete` in Azure CLI<br/><br/>Example: `az acr repository delete --name myregistry --repository myrepo --username MyToken --password xxxxxxxxxx`|
   |`content/read`     |  `docker login`<br/><br/>`az acr login` in Azure CLI<br/><br/>Example: `az acr login --name myregistry --username MyToken --password xxxxxxxxxx`  |
   |`content/write`     |  `docker login`<br/><br/>`az acr login` in Azure CLI     |
-  |`metadata/read`    | `az acr repository show`<br/><br/>`az acr repository show-tags`<br/><br/>`az acr repository show-manifests` in Azure CLI   |
+  |`metadata/read`    | `az acr repository show`<br/><br/>`az acr repository show-tags`<br/><br/>`az acr manifest list-metadata` in Azure CLI   |
   |`metadata/write`     |  `az acr repository untag`<br/><br/>`az acr repository update` in Azure CLI |
 
 ## Examples: Use token
@@ -317,7 +317,7 @@ az acr scope-map update \
 
 To update the scope map using the portal, see the [previous section](#update-token-permissions).
 
-To read metadata in the `samples/hello-world` repository, run the [az acr repository show-manifests][az-acr-repository-show-manifests] or [az acr repository show-tags][az-acr-repository-show-tags] command. 
+To read metadata in the `samples/hello-world` repository, run the [az acr manifest list-metadata][az-acr-manifest-list-metadata] or [az acr repository show-tags][az-acr-repository-show-tags] command. 
 
 To read metadata, pass the token's name and password to either command. The following example uses the environment variables created earlier in the article:
 
@@ -432,9 +432,9 @@ In the portal, select the token in the **Tokens (Preview)** screen, and select *
 
 <!-- LINKS - Internal -->
 [az-acr-login]: /cli/azure/acr#az_acr_login
+[az-acr-manifest-list-metadata]: /cli/azure/acr/manifest#az-acr-manifest-list-metadata
 [az-acr-repository]: /cli/azure/acr/repository/
 [az-acr-repository-show-tags]: /cli/azure/acr/repository/#az_acr_repository_show_tags
-[az-acr-repository-show-manifests]: /cli/azure/acr/repository/#az_acr_repository_show_manifests
 [az-acr-repository-delete]: /cli/azure/acr/repository/#az_acr_repository_delete
 [az-acr-scope-map]: /cli/azure/acr/scope-map/
 [az-acr-scope-map-create]: /cli/azure/acr/scope-map/#az_acr_scope_map_create

articles/container-registry/container-registry-retention-policy.md

@@ -59,7 +59,7 @@ If you enable the preceding policy with a retention period of 0 days, you can qu
     az acr repository untag \
       --name myregistry --image hello-world:latest
     ```
-1. Within a few seconds, the untagged manifest is deleted. You can verify the deletion by listing manifests in the repository, for example, using the [az acr repository show-manifests][az-acr-repository-show-manifests] command. If the test image was the only one in the repository, the repository itself is deleted.
+1. Within a few seconds, the untagged manifest is deleted. You can verify the deletion by listing manifests in the repository, for example, using the [az acr manifest list-metadata][az-acr-manifest-list-metadata] command. If the test image was the only one in the repository, the repository itself is deleted.
 
 ### Manage a retention policy
 
@@ -110,5 +110,5 @@ You can also set a registry's retention policy in the [Azure portal](https://por
 [azure-cli]: /cli/azure/install-azure-cli
 [az-acr-config-retention-update]: /cli/azure/acr/config/retention#az_acr_config_retention_update
 [az-acr-config-retention-show]: /cli/azure/acr/config/retention#az_acr_config_retention_show
+[az-acr-manifest-list-metadata]: /cli/azure/acr/manifest#az-acr-manifest-list-metadata
 [az-acr-repository-untag]: /cli/azure/acr/repository#az_acr_repository_untag
-[az-acr-repository-show-manifests]: /cli/azure/acr/repository#az_acr_repository_show_manifests

articles/container-registry/push-multi-architecture-images.md

@@ -41,7 +41,7 @@ A basic manifest for a Linux `hello-world` image looks similar to the following:
   }
   ```
 
-You can view a manifest in Azure Container Registry using the Azure portal or tools such as the [az acr repository show-manifests](/cli/azure/acr/repository#az-acr-repository-show-manifests) command in the Azure CLI.
+You can view a manifest in Azure Container Registry using the Azure portal or tools such as the [az acr manifest list-metadata](/cli/azure/acr/manifest#az-acr-manifest-list-metadata) command in the Azure CLI.
 
 ### Manifest list
 
@@ -90,7 +90,7 @@ You can view a manifest list using the `docker manifest inspect` command. The fo
 }
 ```
 
-When a multi-arch manifest list is stored in Azure Container Registry, you can also view the manifest list using the Azure portal or with tools such as the [az acr repository show-manifests](/cli/azure/acr/repository#az-acr-repository-how-manifests) command.
+When a multi-arch manifest list is stored in Azure Container Registry, you can also view the manifest list using the Azure portal or with tools such as the [az acr manifest list-metadata](/cli/azure/acr/manifest#az-acr-manifest-list-metadata) command.
 
 ## Import a multi-arch image