Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Actualizar las propiedades de un objeto de aplicación . Esta API también puede actualizar un objeto agentIdentityBlueprint cuando la propiedad @odata.type se establece en #microsoft.graph.agentIdentityBlueprint.
Importante
No es compatible con el uso de PATCH para establecer passwordCredential. Use los métodos addPassword y removePassword para actualizar la contraseña o el secreto de una aplicación.
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global | Administración pública de EE. UU. | Gobierno de EE. UU. L5 (DOD) | China operado por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
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) | Application.ReadWrite.All | HardDeletionSetting.ReadWrite.Enable |
| Delegado (cuenta personal de Microsoft) | Application.ReadWrite.All | No disponible. |
| Aplicación | Application.ReadWrite.OwnedBy | Application.ReadWrite.All, HardDeletionSetting.ReadWrite.Enable |
Importante
Para el acceso delegado con cuentas profesionales o educativas, el administrador debe tener asignado un rol compatible de Microsoft Entra o un rol personalizado que conceda los permisos necesarios para esta operación. Esta operación admite los siguientes roles integrados, que proporcionan solo el privilegio mínimo necesario:
- Un miembro o invitado no administrador que tiene permisos de usuario predeterminados, a menos que el administrador del espacio empresarial restrinja el acceso.
- Desarrollador de aplicaciones. Este rol puede crear aplicaciones incluso cuando el administrador restringió el acceso a miembros e invitados. A la entidad de seguridad con este rol se le asigna la propiedad de la aplicación que crea.
- Escritores de directorios. Este rol puede actualizar las propiedades de extensión.
- Administrador de identidades híbridas. Este rol solo puede actualizar propiedades básicas.
- Administrador de seguridad
- Administrador de aplicaciones en la nube
- Administrador de la aplicación
En escenarios delegados con cuentas profesionales o educativas, se admiten los siguientes privilegios para administrar planos técnicos de identidad de agente:
- El usuario que ha iniciado sesión es el propietario, o bien
- Al usuario que ha iniciado sesión se le asigna el rol de administrador de ID de agente .
Solicitud HTTP
Puede dirigirse a la aplicación mediante su id o appId.
id y appId se conocen como Id. de objeto e Id. de aplicación (cliente), respectivamente, en los registros de aplicaciones en el Centro de administración de Microsoft Entra. Reemplácelo {applicationObjectId} por el identificador del objeto de aplicación.
PATCH /applications/{applicationObjectId}
PATCH /applications(appId='{appId}')
Para actualizar el logotipo, utilice el método PUT de la siguiente manera.
PUT /applications/{applicationObjectId}/logo
PUT /applications(appId='{appId}')/logo
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 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 incluya valores existentes que no hayan cambiado.
| Propiedad | Tipo | Descripción |
|---|---|---|
| api | apiApplication | Especifica la configuración de una aplicación que implementa una API web. |
| appRoles | Colección appRole | Colección de roles definidos para la aplicación. Estos roles pueden asignarse a usuarios, grupos o entidades de servicio. No admite valores NULL. |
| displayName | Cadena | Nombre para mostrar de la aplicación. |
| groupMembershipClaims | Cadena | Configura la notificación de grupos emitida en un usuario o token de acceso de OAuth 2.0 que espera la aplicación. Para establecer este atributo, use uno de los siguientes valores de cadena válidos:
|
| identifierUris | Colección string | Los URI que identifican la aplicación dentro de su inquilino de Microsoft Entra o dentro de un dominio personalizado comprobado si la aplicación es multiinquilino. Para más información, vea Objetos de aplicación y de entidad de servicio. No admite valores NULL. |
| info | informationalUrl | Información de perfil básica de la aplicación, como el marketing de la aplicación, el soporte técnico, los términos del servicio y las direcciones URL de la declaración de privacidad. Las condiciones del servicio y la declaración de privacidad se exponen a los usuarios mediante la experiencia de consentimiento del usuario. Para obtener más información, consulte Agregar términos de servicio y declaración de privacidad para las aplicaciones de Microsoft Entra registradas. |
| isFallbackPublicClient | Boolean | Especifica el tipo de aplicación de reserva como un cliente público, por ejemplo, una aplicación instalada que se ejecuta en un dispositivo móvil. El valor predeterminado es false, lo que significa que el tipo de aplicación de reserva es cliente confidencial, como aplicación web. Hay determinados escenarios en los que Microsoft Entra ID no puede determinar el tipo de aplicación cliente (por ejemplo, flujo ROPC donde se configura sin especificar un URI de redireccionamiento). En esos casos, Microsoft Entra ID interpretará el tipo de aplicación en función del valor de esta propiedad. |
| keyCredentials | Colección keyCredential | La colección de credenciales de clave asociada a la aplicación. No admite valores NULL. |
| logo | Stream | Logotipo principal de la aplicación. No admite valores NULL. Use el método PUT para actualizar el logotipo. |
| de administradorAplicaciones | Colección Guid | Una colección de identificadores de aplicación para aplicaciones propias de Microsoft designadas como administradores. Esta propiedad solo se admite en objetos agentIdentityBlueprint y no se actualiza mediante esta API de aplicación de actualización . Para actualizar managerApplications, utilice la API dedicada Update agentIdentityBlueprint . La actualización de managerApplications en aplicaciones que no son de agente devuelve un 400 Bad Request error. Solo se pueden agregar como administradores id. de aplicaciones propias de Microsoft; Al agregar una aplicación de terceros se devuelve un 400 Bad Request error. El máximo permitido es de 10 aplicaciones de administrador; Si se supera este límite, se produce un 400 Bad Request error. |
| nativeAuthenticationApisEnabled | nativeAuthenticationApisEnabled | Especifica si las API de autenticación nativa están habilitadas para que la aplicación pueda usarlas para proporcionar autenticación nativa. Los valores posibles son none, all, y unknownFutureValue. Para obtener más información, consulte Autenticación nativa. |
| optionalClaims | optionalClaims | Los desarrolladores de aplicaciones pueden configurar notificaciones opcionales en sus aplicaciones de Microsoft Entra para especificar qué notificaciones desean en los tokens enviados a su aplicación por el servicio de tokens de seguridad de Microsoft. Consulte las reclamaciones opcionales para obtener más información. |
| parentalControlSettings | parentalControlSettings | Especifica opciones de configuración de control parental para una aplicación. |
| publicClient | publicClientApplication | Especifica opciones de configuración para clientes instalados, como dispositivos móviles o de escritorio. |
| requiredResourceAccess | Colección requiredResourceAccess | Especifica los recursos a los que necesita obtener acceso la aplicación. Esta propiedad también especifica el conjunto de permisos delegados y roles de aplicación que necesita para cada uno de esos recursos. Esta configuración de acceso a los recursos necesarios controla la experiencia del consentimiento. No se pueden configurar más de 50 servicios de recursos (API). A partir de mediados de octubre de 2021, el número total de permisos necesarios no debe superar los 400. No admite valores NULL. |
| samlMetadataUrl | Cadena | La dirección URL donde el servicio muestra los metadatos de SAML para la federación. Esta propiedad solo es válida para aplicaciones de un solo inquilino. |
| signInAudience | Cadena | Especifica las cuentas Microsoft compatibles con la aplicación actual. Los valores admitidos son los siguientes:
El valor de esta propiedad tiene implicaciones en otras propiedades del objeto de la aplicación. Como resultado, si cambia esta propiedad, es posible que primero tenga que cambiar otras propiedades. Para obtener más información, consulte Diferencias de validación para signInAudience. |
| spa | spaApplication | Especifica la configuración de aplicación de una sola página, incluidas las direcciones URL de cierre de sesión y los URI de redirección para los códigos de autorización y los tokens de acceso. |
| tags | Colección string | Cadenas personalizadas que pueden usarse para clasificar por categorías e identificar aplicaciones. No admite valores NULL. |
| tokenEncryptionKeyId | Cadena | Especifica el valor keyId de una clave pública de la colección keyCredentials. Cuando se configura, Microsoft Entra ID cifra todos los tokens que emite mediante la clave a la que apunta esta propiedad. El código de aplicación que recibe el token cifrado debe usar la clave privada coincidente para descifrar el token a fin de poder usarlo para el usuario que ha iniciado sesión. |
| uniqueName | Cadena | Identificador único que se puede asignar a una aplicación y usar como clave alternativa. Solo se puede actualizar si null y es inmutable una vez que se establece. |
| web | webApplication | Especifica opciones de configuración para una aplicación web. |
Respuesta
Si tiene éxito, este método devuelve un 204 No Content código de respuesta y no devuelve nada en el cuerpo de la respuesta.
Ejemplos
Ejemplo 1: Actualizar el nombre para mostrar de una aplicación
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PATCH https://graph.microsoft.com/v1.0/applications/{id}
Content-type: application/json
{
"displayName": "New display name"
}
Respuesta
HTTP/1.1 204 No Content
Ejemplo 2: Actualizar los appRoles de una aplicación
En el ejemplo siguiente se actualiza la colección appRoles para una aplicación. Para mantener los roles de aplicación existentes, inclúyalos en la solicitud. Los objetos existentes en la colección que no se incluyen en la solicitud se reemplazan por los nuevos objetos. Este objeto se sincroniza con la propiedad correspondiente de la entidad de servicio en el inquilino.
Solicitud
PATCH https://graph.microsoft.com/v1.0/applications/fda284b5-f0ad-4763-8289-31a273fca865
Content-type: application/json
{
"appRoles": [
{
"allowedMemberTypes": [
"User",
"Application"
],
"description": "Survey.Read",
"displayName": "Survey.Read",
"id": "ebb7c86c-fb47-4e3f-8191-420ff1b9de4a",
"isEnabled": false,
"origin": "Application",
"value": "Survey.Read"
}
]
}
Respuesta
HTTP/1.1 204 No Content