Remover o proprietário do deviceTemplate

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Remova um proprietário de um objeto deviceTemplate . Os proprietários podem remover-se automaticamente. Enquanto proprietário, não são necessárias outras funções de administrador para criar, atualizar, eliminar os dispositivos deste modelo, bem como para adicionar ou remover proprietários de modelos.

Todos os dispositivos ligados ao modelo de dispositivo têm de ser eliminados primeiro antes de eliminar o próprio modelo. Apenas os proprietários registados do modelo podem efetuar esta operação.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão	Permissão com menos privilégios	Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante)	DeviceTemplate.ReadWrite.All	Directory.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	DeviceTemplate.ReadWrite.All	Directory.ReadWrite.All

Importante

Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função de Microsoft Entra suportada ou uma função personalizada com uma permissão de função suportada. As seguintes funções com menos privilégios são suportadas para esta operação:

• Administrador de Dispositivos na Cloud
• Administrador de Dispositivos IoT
• Utilizadores – proprietários do objeto de modelo de dispositivo

Solicitação HTTP

DELETE /directory/templates/deviceTemplates/{deviceTemplateId}/owners/{id}/$ref

Nota: O {deviceTemplateId} no URL do pedido é o valor da propriedade ID do modelo de dispositivo e {id} representa o oid do principal de serviço proprietário.

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content. Não devolve nada no corpo da resposta. Os modelos de dispositivo não podem ser eliminados até que todos os dispositivos ligados sejam removidos; caso contrário, este método devolve um código de 400 Bad Request resposta. Se o autor da chamada não for o proprietário do modelo de dispositivo, este método devolve um 403 Forbidden código de resposta.

Para obter mais informações, veja Respostas de erro e tipos de recursos do Microsoft Graph.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

HTTP

DELETE https://graph.microsoft.com/beta/directory/templates/deviceTemplates/2d62b12a-0163-457d-9796-9602e9807e1/owners/00001111-aaaa-2222-bbbb-3333cccc4444/$ref

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/directory/templates/deviceTemplates/2d62b12a-0163-457d-9796-9602e9807e1/owners/00001111-aaaa-2222-bbbb-3333cccc4444/$ref')
	.version('beta')
	.delete();

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content