Adicionar patrocinadores agentIdentityBlueprint

Namespace: microsoft.graph

Adicione um patrocinador a um objeto agentIdentityBlueprint . Os patrocinadores podem incluir utilizadores ou grupos. Os patrocinadores podem não incluir principais de serviço ou utilizadores de agente.

Um único esquema pode ter até 100 patrocinadores. Não mais do que 5 patrocinadores podem ser grupos. Apenas os grupos com associação dinâmica ou grupos do Microsoft 365 são suportados como patrocinadores. Os grupos atribuíveis a funções não podem ser definidos como patrocinadores.

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)	Application.ReadWrite.All.	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	Application.ReadWrite.All.	Indisponível.

Importante

• Um principal que cria um esquema de identidade do agente ou principal de esquema é atribuído automaticamente como proprietário.
• Os proprietários podem criar e modificar identidades de agente associadas a um esquema que possuem sem que lhe seja atribuída uma função de ID de Agente.
• Para que os não conhecidos chamem esta API em cenários delegados através de contas escolares ou profissionais, tem de ser atribuída ao administrador uma função de Microsoft Entra suportada. Esta operação suporta a seguinte função incorporada com menos privilégios:
  • Administrador de ID do Agente

Solicitação HTTP

POST /applications/{id}/microsoft.graph.agentIdentityBlueprint/sponsors/$ref

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type	application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça uma referência ao objeto directoryObject a ser adicionado como patrocinador.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

HTTP

POST https://graph.microsoft.com/v1.0/applications/{id}/microsoft.graph.agentIdentityBlueprint/sponsors/$ref
Content-Type: application/json

{
  "@odata.id": "https://graph.microsoft.com/v1.0/directoryObjects/{sponsor-object-id}"
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const directoryObject = {
  '@odata.id': 'https://graph.microsoft.com/v1.0/directoryObjects/{sponsor-object-id}'
};

await client.api('/applications/{id}/microsoft.graph.agentIdentityBlueprint/sponsors/$ref')
	.post(directoryObject);

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