Update agentIdentityBlueprint

Espacio de nombres: microsoft.graph

Actualice las propiedades de un objeto agentIdentityBlueprint .

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.

Permisos para escenarios específicos

• El permiso con privilegios mínimos para actualizar las propiedades relacionadas con las credenciales, como keyCredentials y passwordCredentials, es AgentIdentityBlueprint.AddRemoveCreds.All.
• El permiso con privilegios mínimos para actualizar las propiedades de personalización de marca, como displayName y description , es AgentIdentityBlueprint.UpdateBranding.All.
• Para actualizar las propiedades cubiertas por ambos ámbitos de permisos, use el permiso AgentIdentityBlueprint.ReadWrite.All con privilegios superiores.

Solicitud HTTP

PATCH /applications/{id}/microsoft.graph.agentIdentityBlueprint

Encabezados de solicitud

Cuerpo de solicitud

En el cuerpo de la solicitud, proporcione los valores de los campos relevantes que deben actualizarse. Las propiedades existentes que no están incluidas en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad. Para obtener el mejor rendimiento no debe incluir valores existentes que no hayan cambiado.

Respuesta

La propiedad isSingleInstance es inmutable después de la creación. Un intento de cambiarlo, en cualquier dirección, devuelve 400 Bad Request el código Request_BadRequestde error .

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.

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

Ejemplos

Ejemplo 1: Actualizar el nombre para mostrar de un plano técnico de identidad de agente

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/applications/{id}/microsoft.graph.agentIdentityBlueprint
Content-Type: application/json

{
  "displayName": "My New Name"
}

const options = {
	authProvider,
};

const client = Client.init(options);

const agentIdentityBlueprint = {
  displayName: 'My New Name'
};

await client.api('/applications/{id}/microsoft.graph.agentIdentityBlueprint')
	.version('beta')
	.update(agentIdentityBlueprint);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 2: Actualizar ManagerApplications en un plano técnico de identidad de agente

La managerApplications propiedad es totalmente grabable tanto por autores de llamadas propias (1P) como de terceros (3P) en planos de identidad de agentes.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11
Content-Type: application/json

{
  "managerApplications": [
    "77504268-3426-435e-99c0-9bc8656bc20e"
  ]
}

const options = {
	authProvider,
};

const client = Client.init(options);

const agentIdentityBlueprint = {
  managerApplications: [
    '77504268-3426-435e-99c0-9bc8656bc20e'
  ]
};

await client.api('/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11')
	.version('beta')
	.update(agentIdentityBlueprint);

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 3: Intentar agregar una aplicación no propia como administrador

Actualmente, solo los identificadores de aplicaciones propias de Microsoft se pueden establecer como valores en la managerApplications colección.

Solicitud

En el ejemplo siguiente se muestra una solicitud que intenta agregar una aplicación que no es propia.

PATCH https://graph.microsoft.com/beta/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11
Content-Type: application/json

{
  "managerApplications": [
    "b43716e4-8cd1-4e88-b4ef-94611f4c6c46"
  ]
}

const options = {
	authProvider,
};

const client = Client.init(options);

const agentIdentityBlueprint = {
  managerApplications: [
    'b43716e4-8cd1-4e88-b4ef-94611f4c6c46'
  ]
};

await client.api('/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11')
	.version('beta')
	.update(agentIdentityBlueprint);

Respuesta

En el ejemplo siguiente se muestra la respuesta del error.

HTTP/1.1 400 Bad Request
Content-type: application/json

{
  "error": {
    "code": "BadRequest",
    "message": "Application b43716e4-8cd1-4e88-b4ef-94611f4c6c46 is not a Microsoft first-party application. Managers must be Microsoft first-party applications.",
    "innerError": {
      "date": "2026-01-09T18:19:01",
      "request-id": "b67ef789-eb9c-4639-8847-4425f27c3c13",
      "client-request-id": "7b3c375e-a647-4e57-9452-6a8539b2256f"
    }
  }
}

Ejemplo 4: Intentar superar el límite de 10 aplicaciones de administrador

Las solicitudes están limitadas a un máximo de 10 aplicaciones de administrador.

Solicitud

En el ejemplo siguiente se muestra una solicitud que intenta establecer 11 aplicaciones de administrador.

PATCH https://graph.microsoft.com/beta/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11
Content-Type: application/json

{
  "managerApplications": [
    "030bd5f7-db55-4925-959e-5cd332851a0d",
    "1bcc0f3a-18c2-44cb-851a-26e344c2b1bd",
    "6ed7705a-21de-4de9-9e98-95d1a2b5caa5",
    "1925068d-8f9f-4fe8-8d4f-af7d70dce238",
    "383b3cea-2ad2-4ca9-8c86-7f66e507ee77",
    "00f03cc4-3d1f-4b44-8bfa-fca7b181cbb9",
    "9d089274-e6dc-4640-bae2-0c88b4dc89a3",
    "8ea5293f-5d07-45dd-8333-64edfd907423",
    "2a0c3ca6-102f-4f22-a19e-4e5d1d99337d",
    "d40473a1-1d8c-4db9-bc87-1296c90e516b",
    "d902c7bd-7fe6-486a-86e8-00da01936fba"
  ]
}

const options = {
	authProvider,
};

const client = Client.init(options);

const agentIdentityBlueprint = {
  managerApplications: [
    '030bd5f7-db55-4925-959e-5cd332851a0d',
    '1bcc0f3a-18c2-44cb-851a-26e344c2b1bd',
    '6ed7705a-21de-4de9-9e98-95d1a2b5caa5',
    '1925068d-8f9f-4fe8-8d4f-af7d70dce238',
    '383b3cea-2ad2-4ca9-8c86-7f66e507ee77',
    '00f03cc4-3d1f-4b44-8bfa-fca7b181cbb9',
    '9d089274-e6dc-4640-bae2-0c88b4dc89a3',
    '8ea5293f-5d07-45dd-8333-64edfd907423',
    '2a0c3ca6-102f-4f22-a19e-4e5d1d99337d',
    'd40473a1-1d8c-4db9-bc87-1296c90e516b',
    'd902c7bd-7fe6-486a-86e8-00da01936fba'
  ]
};

await client.api('/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11')
	.version('beta')
	.update(agentIdentityBlueprint);

Respuesta

En el ejemplo siguiente se muestra la respuesta del error.

HTTP/1.1 400 Bad Request
Content-type: application/json

{
  "error": {
    "code": "BadRequest",
    "message": "The number of ManagerApplications exceeds the limit. A blueprint can have only 10 ManagerApplications values.",
    "innerError": {
      "date": "2026-01-09T18:19:01",
      "request-id": "b67ef789-eb9c-4639-8847-4425f27c3c13",
      "client-request-id": "7b3c375e-a647-4e57-9452-6a8539b2256f"
    }
  }
}