Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
Leia as propriedades e os relacionamentos do objeto agentIdentityBlueprint .
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissão com privilégios mínimos | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | AgentIdentityBlueprint.Read.All | Application.Read.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | AgentIdentityBlueprint.Read.All | Application.Read.All |
Importante
- Uma entidade de segurança que cria um blueprint de identidade de agente ou uma entidade de segurança de plano é automaticamente atribuída como proprietária.
- Os proprietários podem criar e modificar identidades de agente associadas a um blueprint que possuem sem receber uma função de ID de agente.
- Para que os não proprietários chamem essa API em cenários delegados usando contas corporativas ou de estudante, o administrador deve receber uma função do Microsoft Entra com suporte. Esta operação dá suporte à seguinte função interna com privilégios mínimos:
Solicitação HTTP
GET /applications/{id}/microsoft.graph.agentIdentityBlueprint
Parâmetros de consulta opcionais
Esse método dá suporte aos $select parâmetros de consulta OData e $expand para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
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 for bem-sucedido, esse método retornará um código de 200 OK resposta e um objeto agentIdentityBlueprint no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/applications/{id}/microsoft.graph.agentIdentityBlueprint
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": {
"@odata.type": "#microsoft.graph.agentIdentityBlueprint",
"id": "08be1f79-37a1-49c0-b444-3075e74d1e8c",
"appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
"identifierUris": [
"api://00001111-aaaa-2222-bbbb-3333cccc4444"
],
"createdByAppId": "14d82eec-204b-4c2f-b7e8-296a70dab67e",
"createdDateTime": "2025-09-10T17:04:20Z",
"description": null,
"disabledByMicrosoftStatus": null,
"displayName": "My Agent Blueprint",
"groupMembershipClaims": null,
"managerApplications": ["77504268-3426-435e-99c0-9bc8656bc20e"],
"publisherDomain": "contoso.onmicrosoft.com",
"signInAudience": "AzureADMyOrg",
"tags": [],
"tokenEncryptionKeyId": null,
"uniqueName": null,
"serviceManagementReference": null,
"optionalClaims": null,
"api": {
"requestedAccessTokenVersion": 2,
"acceptMappedClaims": null,
"knownClientApplications": [],
"oauth2PermissionScopes": [],
"preAuthorizedApplications": [],
"tokenEncryptionSetting": {
"scheme": null,
"audience": null,
"automatedTokenVersion": {
"current": null,
"available": []
}
}
},
"appRoles": [],
"info": {
"termsOfServiceUrl": null,
"supportUrl": null,
"privacyStatementUrl": null,
"marketingUrl": null,
"logoUrl": null
},
"keyCredentials": [],
"passwordCredentials": [],
"requiredResourceAccess": [],
"verifiedPublisher": {
"displayName": null,
"verifiedPublisherId": null,
"addedDateTime": null
},
"web": {
"redirectUris": [],
"homePageUrl": null,
"logoutUrl": null,
"redirectUriSettings": [],
"implicitGrantSettings": {
"enableIdTokenIssuance": false,
"enableAccessTokenIssuance": false
}
}
}
}