Definir parâmetros padrão

A CLI do Azure comanda az account set e az config fornece a capacidade de manter valores de parâmetro padrão para comandos do Azure Sphere. Isso remove a necessidade de retipo contínuo de parâmetros comuns. Por exemplo, assinatura, grupo de recursos e catálogo são parâmetros necessários em muitos comandos.

Ao definir os valores de parâmetro padrão, você reduz a redundância e pode reduzir significativamente a sintaxe de comando.

Os parâmetros padrão sempre podem ser substituídos inserindo explicitamente o parâmetro desejado.

Definir a assinatura padrão

Após fazer logon, você verá uma lista de assinaturas associadas à sua conta do Azure. As informações de assinatura com isDefault: true é a assinatura ativada no momento após o logon. Para selecionar outra assinatura, use o az account set comando com a ID da assinatura para a qual deseja alternar. Para obter mais informações sobre a seleção de assinatura, confira Como gerenciar assinaturas do Azure com a CLI do Azure.

Ponta

Use os az account show comandos ou az account list para ver a assinatura que você está usando no momento ou para obter uma lista de assinaturas disponíveis.

Definir o grupo de recursos padrão e o catálogo do Azure Sphere

Além da assinatura, outros padrões para a CLI do Azure são definidos com o az config set comando. Esse comando usa uma lista separada por espaço de pares key=value como um argumento. Os valores fornecidos são usados pelos comandos do Azure Sphere no lugar dos argumentos necessários.

Ponta

Use o az config get comando para ver sua configuração atual.

A tabela a seguir contém uma lista de chaves de configuração disponíveis.

Nome do parâmetro Descrição Exemplo
defaults.group O grupo de recursos padrão a ser usado para todos os comandos.
Substitui o --resource-group parâmetro.
az config set defaults.group=<name>
defaults.sphere.catalog O catálogo padrão a ser usado para todos os comandos do Azure Sphere.
Substitui o --catalog parâmetro.
az config set defaults.sphere.catalog=<name>

Como exemplo, veja como definir o grupo de recursos padrão e o catálogo para todos os comandos. Defina o grupo de recursos padrão como MyResourceGroup e cataloge como MyCatalog.

az config set defaults.group=MyResourceGroup defaults.sphere.catalog=MyCatalog

Uma lista completa de configurações pode ser encontrada na documentação de configuração da CLI do Azure. Observe que algumas configurações não são aplicáveis ao Azure Sphere. Por exemplo, a configuração defaults.location é ignorada, pois o Azure Sphere é um serviço global.

Solucionando problemas

Um catálogo do Azure Sphere pertence a um grupo de recursos, que pertence a uma assinatura. Você pode ver mensagens de erro indicando que um recurso não pode ser encontrado mesmo ao trabalhar com recursos que você sabe que existem, se a combinação de parâmetros padrão e especificados não corresponder. Por exemplo, se o grupo de recursos padrão ou especificado não pertencer à assinatura padrão ou especificada, você poderá ver o erro "O grupo de recursos 'Name' não pôde ser encontrado".