Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This workflow shows how to create a catalog using the portal or CLI. Catalogs are used to manage products, devices and device groups. For more information, see About catalogs.
Note
When you create a new catalog, a corresponding Azure Sphere (Legacy) tenant is created, and an Administrator user role for the tenant is assigned to you. The Legacy tenant's access is set to Paused by default. If you wish to manage resources using the Azure Sphere (Legacy) interface, see Pause or enable Legacy tenant access.
Use the portal
- Sign in to the Azure Portal. To locate the Azure Sphere service, in the top search bar, enter and select Azure Sphere. The Azure Sphere page is displayed.
- Select + Create from the menu at the top of the page. The Create Azure Sphere Catalog page displays.
- Under Project details, enter the following values:
- Subscription: Select your Azure subscription.
- Resource group: Enter a new resource group name.
- Under Instance details, enter the following values:
- Name: Enter a name for the catalog. Catalog names can contain only alphanumeric characters, underscores, and hyphens, and cannot exceed 30 characters.
- Region: Select an Azure location, such as global.
- Select Review + create.
- Select Create. It takes a few seconds to create a catalog.
- Select Refresh from the top menu to refresh the list, and then select the newly created item to open it. Or select Notification(the bell icon) from the top, and then select Go to resource group to open the resource group where the resource is created.
Use the CLI
To create a catalog, use the az sphere catalog create command.
az sphere catalog create --name MyCatalog --resource-group MyResourceGroup
Tip
We recommend that you configure the default values for the subscription, resource group, and catalog parameters. This helps reduce redundancy and can significantly shorten CLI command syntax.
Unless you have set the active subscription, the --subscription parameter will be required for all commands. You can set the active subscription using the command az account set --subscription <subscription-name>.