View a managed namespace and its associated member clusters (preview)

Applies to: ✔️ Fleet Manager with hub cluster

This article shows you how to view the managed namespaces you have access to and monitor resource usage across member clusters.

Before you begin

• You need an Azure account with an active subscription. Create an account for free.

• You need an existing multi-cluster managed namespace. If you don't have one, see Create a multi-cluster managed namespace.

• Read the overview of multi-cluster managed namespaces to understand the concept of a managed namespace.

• You need Azure CLI version 2.58.0 or later installed to complete this article. To install or upgrade, see Install Azure CLI.

• You need the fleet Azure CLI extension. You can install it and update to the latest version using the az extension add and az extension update commands.

  # Install the extension
  az extension add --name fleet
  
  # Update the extension
  az extension update --name fleet
  

• Confirm the fleet extension version is at least 1.7.0 using the az extension show command.

  az extension show --name fleet
  

• Set the following environment variables for your subscription ID, resource group, and Fleet:

  export SUBSCRIPTION_ID=<subscription-id>
  export GROUP=<resource-group-name>
  export FLEET=<fleet-name>
  export FLEET_NAMESPACE_NAME=<fleet-namespace-name>
  

• Set the default Azure subscription using the az account set command.

  az account set --subscription ${SUBSCRIPTION_ID}
  

View the multi-cluster managed namespaces I have access to

• View the multi-cluster managed namespaces you have access to using the az fleet namespace list command.

  az fleet namespace list  
      --resource-group {GROUP} \ 
      --fleet-name ${FLEET} \ 
      -o table 
  

  Your output should resemble the following example output:

  AdoptionPolicy  DeletePolicy   ETag                                    Location   Name                  ProvisioningState   ResourceGroup
  --------------  ------------   -------------------------------------   --------   --------------------  -----------------   -------------
  Always          Delete         "aaaaaaaa-0b0b-1c1c-2d2d-333333333333   westus2    my-managed-namespace  Succeeded           test-rg
  

View a managed namespace

• View a specific managed namespace using the az fleet namespace show command.

  az fleet namespace show \ 
      --resource-group ${GROUP} \ 
      --fleet-name ${FLEET} \ 
      --name ${FLEET_NAMESPACE_NAME}$ \ 
      -o table 
  

  Your output should resemble the following example output:

  AdoptionPolicy  DeletePolicy   ETag                                    Location   Name                  ProvisioningState   ResourceGroup
  --------------  ------------   -------------------------------------   --------   --------------------  -----------------   -------------
  Always          Delete         "aaaaaaaa-0b0b-1c1c-2d2d-333333333333   westus2    my-managed-namespace  Succeeded           test-rg
  

Next steps

• Read the overview of multi-cluster managed namespaces to understand the concept of a managed namespace.
• Learn how to create and use a multi-cluster managed namespace.