Create an Azure Spatial Anchors account

Portal

Go to the Azure portal.

On the left pane, select Create a resource.

Use the search box to search for Spatial Anchors.

Select Spatial Anchors, and then select Create.

On the Spatial Anchors Account pane, do the following:

• Enter a unique resource name by using regular alphanumeric characters.

• Select the subscription that you want to attach the resource to.

• Create a resource group by selecting Create new. Name it myResourceGroup, and then select OK.

  A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. For example, you can choose to delete the entire resource group in one simple step later.

• Select a location (region) in which to place the resource.

• Select Create to begin creating the resource.

After the resource is created, the Azure portal shows that your deployment is complete.

Select Go to resource. You can now view the resource properties.

Copy the resource's Account ID value into a text editor for later use.

Also copy the resource's Account Domain value into a text editor for later use.

Under Settings, select Access Key. Copy the Primary key value, Account Key, into a text editor for later use.

Azure CLI

Start by preparing your environment for the Azure CLI:

• Use the Bash environment in Azure Cloud Shell. For more information, see Quickstart for Bash in Azure Cloud Shell.

  

• If you prefer to run CLI reference commands locally, install the Azure CLI. If you're running on Windows or macOS, consider running Azure CLI in a Docker container. For more information, see How to run the Azure CLI in a Docker container.

  • If you're using a local installation, sign in to the Azure CLI by using the az login command. To finish the authentication process, follow the steps displayed in your terminal. For other sign-in options, see Sign in with the Azure CLI.

  • When you're prompted, install the Azure CLI extension on first use. For more information about extensions, see Use extensions with the Azure CLI.

  • Run az version to find the version and dependent libraries that are installed. To upgrade to the latest version, run az upgrade.

1. After you sign in, use the az account set command to select the subscription in which to set up the spatial anchors account:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Run the az group create command to create a resource group, or use an existing resource group:

   az group create --name myResourceGroup --location eastus2
   

   A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. For example, you can choose to delete the entire resource group in one simple step later.

   You can view your current spatial anchors accounts for a resource group by using the az spatial-anchors-account list command:

   az spatial-anchors-account list --resource-group myResourceGroup
   

   You can also view the spatial anchors accounts for your subscription:

   az spatial-anchors-account list
   

3. Run the az spatial-anchors-account create command to create your spatial anchors account:

   az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2
   

4. View the resource properties by using the az spatial-anchors-account show command:

   az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Copy the resource Account ID value and the resource Account Domain value into a text editor for later use.

5. Run the az spatial-anchors-account key show command to get your primary and secondary keys:

   az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Copy the key values into a text editor for later use.

   If you need to regenerate keys, use the az spatial-anchors-account key renew command:

   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
   

You can delete an account by using the az spatial-anchors-account delete command:

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Azure PowerShell

Start by preparing your environment for Azure PowerShell:

• If you choose to use Azure PowerShell locally:
  • Install the latest version of the Az PowerShell module.
  • Connect to your Azure account using the Connect-AzAccount cmdlet.
• If you choose to use Azure Cloud Shell:
  • See Overview of Azure Cloud Shell for more information.

Important

While the Az.MixedReality PowerShell module is in preview, you must install it separately using the Install-Module cmdlet. After this PowerShell module becomes generally available, it will be part of future Az PowerShell module releases and available by default from within Azure Cloud Shell.

Install-Module -Name Az.MixedReality

1. After you sign in, use the Set-AzContext cmdlet to select the subscription in which to set up the spatial anchors account:

   Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
   

2. Run the New-AzResourceGroup cmdlet to create a resource group, or use an existing resource group:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. For example, you can choose to delete the entire resource group in one simple step later.

   You can view your current spatial anchors accounts for a resource group by using the Get-AzSpatialAnchorsAccount cmdlet:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   You can also view the spatial anchors accounts for your subscription:

   Get-AzSpatialAnchorsAccount
   

3. Run the New-AzSpatialAnchorsAccount cmdlet to create your spatial anchors account:

   New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2
   

4. View the resource properties by using the Get-AzSpatialAnchorsAccount cmdlet:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Copy the property accountId value and the property accountDomain value into a text editor for later use.

5. Run the Get-AzSpatialAnchorsAccountKey cmdlet to get your primary and secondary keys:

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Copy the key values into a text editor for later use.

   If you need to regenerate keys, use the New-AzSpatialAnchorsAccountKey cmdlet:

   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary
   

You can delete an account by using the Remove-AzSpatialAnchorsAccount cmdlet:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart