Edit storage targets

You can modify storage targets with the Azure portal or by using the Azure CLI. For example, you can change access policies, usage models, and namespace paths for an existing storage target.

Depending on the type of storage, you can modify these storage target values:

• For Blob storage targets, you can change the namespace path and access policy.

• For NFS storage targets, you can change these values:

  • Namespace paths
  • Access policy
  • The storage export or export subdirectory associated with a namespace path
  • Usage model

• For ADLS-NFS storage targets, you can change the namespace path, access policy, and the usage model.

You can't edit a storage target's name, type, or back-end storage system. If you need to change these properties, delete the storage target and create a replacement with the new value.

Change a blob storage target's namespace path or access policy

Namespace paths are the paths that clients use to mount this storage target. (To learn more, read Plan the aggregated namespace and Set up the aggregated namespace).

Use the Azure portal or the Azure CLI to change the namespace path or access policy.

az hpc-cache blob-storage-target update --cache-name cache-name --name target-name \
  --resource-group rg --virtual-namespace-path "/new-path"

Update an NFS storage target

For NFS storage targets, you can change or add virtual namespace paths, change the NFS export or subdirectory values that a namespace path points to, and change the usage model.

Details are below:

• Change aggregated namespace values (virtual namespace path, access policy, export, and export subdirectory)
• Change the usage model

Change aggregated namespace values

You can use the Azure portal or the Azure CLI to change the client-facing namespace path, the storage export, and the export subdirectory (if used). If you need to change the access policy, use the Azure portal.

Read the guidelines in Add NFS namespace paths if you need a reminder about how to create multiple valid paths on one storage target.

az hpc-cache nfs-storage-target update --cache-name mycache \
  --name st-name --resource-group doc-rg0619 \
  --junction namespace-path="/new-path" nfs-export="/my-export" target-path="my-subdirectory"

Change the usage model

The usage model influences how the cache retains data. Read Understand cache usage models to learn more.

To change the usage model for an NFS storage target, use one of these methods.

Update an ADLS-NFS storage target

Similar to NFS targets, you can change the namespace path and the usage model for ADLS-NFS storage targets.

Change an ADLS-NFS namespace path

Use the Namespace page for your Azure HPC Cache to update namespace values. This page is described in more detail in the article Set up the aggregated namespace.

1. Click the name of the path that you want to change.
2. Use the edit window to type in new virtual path, or update the access policy.
3. After making changes, click OK to update the storage target or Cancel to discard changes.

Change ADLS-NFS usage models

The configuration for ADLS-NFS usage models is identical to the NFS usage model selection. Read the portal instructions in Change the usage model in the NFS section above. Additional tools for updating ADLS-NFS storage targets are in development.

Next steps

• Read View and manage storage targets for information about stopping, deleting, and flushing individual storage targets.
• Read Add storage targets to learn more about storage target options.
• Read Plan the aggregated namespace for more tips about using virtual paths.