Gerenciar produtos
Importante
Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (Integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).
Um produto identifica uma MCU do Azure Sphere que é incorporada em um dispositivo conectado para executar uma função específica. Como fabricante, você cria um produto para cada modelo de um dispositivo conectado, como uma máquina de lavar louça ou cafeteira. Por exemplo, a Contoso cria um produto para suas máquinas de lavar louça DW100 e atribui esse produto a cada máquina de lavar louça DW100 durante a fabricação. Cada produto tem um GUID que é exclusivo dentro do locatário e não pode ser alterado.
Cada dispositivo conectado tem um único produto, mas um único produto pode ser associado a muitos dispositivos. Cada produto tem um nome que deve ser exclusivo dentro do seu inquilino, juntamente com uma descrição. O nome e a descrição do produto fornecem uma forma legível por pessoas de distinguir um produto de outro. O nome e a descrição do produto podem ser modificados quantas vezes desejar.
Listar produtos
Liste todos os produtos em seu locatário do Azure Sphere usando o comando azsphere product list ou usando a API Pública do Azure Sphere.
Para listar todos os produtos:
azsphere product list
Uma mensagem pode ser exibida se o locatário padrão não estiver selecionado. Selecione o locatário necessário na lista e tente novamente o comando.
Para listar todos os produtos em um locatário do Azure Sphere:
Selecione o ícone do Azure Sphere Explorer na Barra de Atividades do Visual Studio Code para abrir o Azure Sphere Explorer. Se o painel Inquilino mostrar Iniciar sessão para ver inquilinos, inicie sessão no Azure Sphere e selecione Atualizar para ver os inquilinos disponíveis.
Expanda o inquilino em que está interessado.
Expanda o nó do produto.
Selecione Exibir>Outro Windows>Azure Sphere Explorer para abrir o Azure Sphere Explorer. Se o painel Inquilino mostrar Iniciar sessão para ver inquilinos, inicie sessão no Azure Sphere e selecione Atualizar para ver os inquilinos disponíveis.
Expanda o inquilino em que está interessado.
Expanda o nó do produto.
Criar um produto
Crie um produto em seu locatário do Azure Sphere usando o comando azsphere product create ou usando a API Pública do Azure Sphere.
Para criar um produto:
azsphere product create --name <product-name>
Substitua <o nome> do produto por um nome legível por pessoas para o seu produto, como DW100. Os nomes dos produtos podem conter apenas caracteres alfanuméricos e espaços. Não podem exceder 50 caracteres. Se o nome ou a descrição incluir espaços, coloque-o entre aspas.
Por padrão, quando você cria um novo produto, o Azure Sphere cria automaticamente cinco grupos de dispositivos para uso na criação de implantações. Os cinco grupos de dispositivos padrão são Desenvolvimento, Teste de campo, Produção, Avaliação do sistema operacional de teste de campo e Avaliação do sistema operacional de produção. Para criar o produto sem os grupos de dispositivos padrão, use o comando:
azsphere product create --name <product-name> --no-default-device-groups
Um inquilino pode conter muitos produtos, pode ser útil fornecer uma descrição de cada um. Você pode adicionar uma descrição a um produto da seguinte maneira:
azsphere product create --name <product-name> --description <product-description>
Para criar um produto:
Para o locatário em que você está interessado, clique com o botão direito do mouse no nó Produto e selecione Novo Produto.
Especifique um nome para o produto e pressione Enter. Os nomes dos produtos podem conter apenas caracteres alfanuméricos e espaços. Não podem exceder 50 caracteres. Se você especificar um nome inválido, um erro será relatado na janela Saída .
Quando você cria um produto no Azure Sphere Explorer, os cinco grupos de dispositivos padrão são criados automaticamente. Se você quiser criar um produto sem grupos de dispositivos, use o comando azsphere product create ou a API Pública do Azure Sphere e especifique --no-default-device-groups.
Você pode criar um produto no Azure Sphere Explorer, mas não excluí-lo. Para excluir produtos, use o comando azsphere product delete ou a API Pública do Azure Sphere.
Para criar um produto:
Para o locatário em que você está interessado, clique com o botão direito do mouse no nó Produto e selecione Novo Produto.
Especifique um nome para o produto e pressione Enter ou clique em Aplicar. Os nomes dos produtos podem conter apenas caracteres alfanuméricos e espaços. Não podem exceder 50 caracteres. Se você especificar um nome inválido, um erro será relatado na janela Saída .
Quando você cria um produto no Azure Sphere Explorer, os cinco grupos de dispositivos padrão são criados automaticamente. Se você quiser criar um produto sem grupos de dispositivos, use o comando azsphere product create ou a API Pública do Azure Sphere e especifique --no-default-device-groups.
Você pode criar um produto no Azure Sphere Explorer, mas não excluí-lo. Para excluir produtos, use o comando azsphere product delete ou a API Pública do Azure Sphere.
Atualizar um produto
Modifique o nome ou a descrição de um produto a qualquer momento usando o comando azsphere product update ou usando a API Pública do Azure Sphere. Para atualizar o nome e a descrição de um produto:
azsphere product update --product <product-name> --new-name <new-product-name> --new-description <new-product-description>
Eliminar um produto
Exclua um produto a qualquer momento usando o comando azsphere product delete ou usando a API Pública do Azure Sphere.
Um produto só pode ser eliminado quando:
- O usuário tem permissões de administrador para o locatário.
- O produto está vazio e os grupos de dispositivos não têm dispositivos. O comando azsphere product device list lista todos os dispositivos em um produto. Execute azsphere device update --device-group para mover o dispositivo para um device-group diferente ou azsphere device-group delete para excluir um grupo de dispositivos.
Para excluir um produto:
azsphere product delete --product <product-name>
Para o locatário em que você está interessado, expanda o nó Produto.
Para renomear o produto, clique com o botão direito do mouse no nome do produto e selecione Renomear, especifique um novo nome de produto e pressione Enter.
Para atualizar a descrição, clique com o botão direito do mouse no nome do produto e selecione Atualizar Descrição, especifique uma nova descrição e pressione Enter.
Para o locatário em que você está interessado, expanda o nó Produto.
Para renomear o produto, selecione o nome do produto e pressione F2 ou clique com o botão direito do mouse no nome do produto e selecione Renomear, especifique um novo nome de produto e pressione Enter ou clique em Aplicar.
Para atualizar a descrição, expanda o produto, selecione Descrição e pressione F2 ou clique com o botão direito do mouse em Descrição e selecione Modificar, especifique uma nova descrição e pressione Enter ou clique em Aplicar.
Mostrar detalhes do produto
Exiba os detalhes de um produto em seu locatário usando o comando azsphere product show ou usando a API Pública do Azure Sphere.
azsphere product show --product <product-name>
Para ver os detalhes de um produto no seu inquilino:
Selecione o ícone do Azure Sphere Explorer na Barra de Atividades do Visual Studio Code para abrir o Azure Sphere Explorer. Se o painel Inquilino mostrar Iniciar sessão para ver inquilinos, inicie sessão no Azure Sphere e selecione Atualizar para ver os inquilinos disponíveis.
Para o locatário em que você está interessado, expanda o nó Produto.
Expanda o produto em que está interessado.
Selecione Exibir>Outro Windows>Azure Sphere Explorer para abrir o Azure Sphere Explorer. Se o painel Inquilino mostrar Iniciar sessão para ver inquilinos, inicie sessão no Azure Sphere e selecione Atualizar para ver os inquilinos disponíveis.
Para o locatário em que você está interessado, expanda o nó Produto.
Expanda o produto em que está interessado.