Crear agentIdentityBlueprint

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Crea un nuevo objeto de blueprint de identidad de agente .

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) AgentIdentityBlueprint.Create AgentIdentityBlueprint.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación AgentIdentityBlueprint.Create AgentIdentityBlueprint.ReadWrite.All

Importante

  • Una entidad de seguridad que crea una identidad de agente, un plano técnico o una entidad de seguridad de plano técnico se asigna automáticamente como propietario.
  • Los propietarios pueden crear y modificar identidades de agente asociadas a un plano técnico de su propiedad sin que se les asigne un rol de ID de agente.
  • Para que los usuarios que no son propietarios llamen a esta API en escenarios delegados con cuentas profesionales o educativas, el administrador debe tener asignado uno de los siguientes roles:

Solicitud HTTP

POST /applications/microsoft.graph.agentIdentityBlueprint

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto blueprint de la identidad del agente . Debe especificar la propiedad displayName y la relación de patrocinadores .

Opcionalmente, establezca isSingleInstance para true crear un plano técnico que admita como máximo una identidad de agente activa por inquilino sin una entidad de seguridad del plano técnico de identidad de agente. Si se omite, el falsevalor predeterminado es , conservando la topología de varias instancias. El valor es inmutable después de la creación, ya sea true o false.

Respuesta

Si tiene éxito, este método devuelve un 201 Created código de respuesta y un objeto agentIdentityBlueprint en el cuerpo de la respuesta.

Para obtener información sobre los errores devueltos por las API de identidad de agente, consulte Códigos de error de la plataforma de identidad de agente de Microsoft.

Ejemplos

Ejemplo 1: Creación de un plano técnico de identidad de agente de varias instancias

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/applications/microsoft.graph.agentIdentityBlueprint
Content-type: application/json

{
  "displayName": "Display name",
  "isSingleInstance": false,
  "sponsors@odata.bind": [
    "https://graph.microsoft.com/beta/users/e64405d7-f156-4ce1-b1f5-b0d801c367f3"
   ]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#applications/microsoft.graph.agentIdentityBlueprint/$entity",
    "id": "03ef14b0-ca33-4840-8f4f-d6e91916010e",
    "appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
    "identifierUris": [],
    "createdDateTime": "2019-09-17T19:10:35.2742618Z",
    "displayName": "Display name",
    "publisherDomain": "contoso.com",
    "requiredResourceAccess": [],
    "signInAudience": "AzureADMyOrg"
}

Ejemplo 2: Creación de un plano técnico de identidad de agente de instancia única

Solicitud

POST https://graph.microsoft.com/beta/applications/microsoft.graph.agentIdentityBlueprint
Content-Type: application/json

{
  "displayName": "Contoso Single-Instance Agent Blueprint",
  "isSingleInstance": true,
  "sponsors@odata.bind": [
    "https://graph.microsoft.com/v1.0/users/acc9f0a1-9075-464f-9fe7-049bf1ae6481"
  ],
  "owners@odata.bind": [
    "https://graph.microsoft.com/v1.0/users/acc9f0a1-9075-464f-9fe7-049bf1ae6481"
  ]
}

Respuesta

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.agentIdentityBlueprint",
  "id": "03ef14b0-ca33-4840-8f4f-d6e91916010e",
  "appId": "65415bb1-9267-4313-bbf5-ae259732ee12",
  "displayName": "Contoso Single-Instance Agent Blueprint",
  "isSingleInstance": true,
  "createdDateTime": "2026-11-02T23:00:00Z"
}
  • Se actualizó por última vez el