Actualizar o crear trustFrameworkPolicy
Espacio de nombres: microsoft.graph
Importante: Las API de la versión /beta de Microsoft Graph se encuentran en versión preliminar y están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción.
Actualice un trustFrameworkPolicy existente o cree uno si no existe.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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) | Policy.ReadWrite.TrustFramework | No disponible. |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | Policy.ReadWrite.TrustFramework | No disponible. |
Importante
En escenarios delegados con cuentas profesionales o educativas, al administrador se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido. El administrador de directivas de IEF B2C es el rol con privilegios mínimos admitido para esta operación.
Solicitud HTTP
PUT /trustFramework/policies/{id}/$value
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Content-Type | application/xml. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación XML del objeto trustFrameworkPolicy .
Nota: el tipo de contenido debe ser
application/xml
.
Respuesta
La respuesta será una de las siguientes:
- Si existe un trustFrameworkPolicy , una solicitud correcta devuelve un código de
200 OK
respuesta. - Si un trustFrameworkPolicy no existe, una solicitud correcta devuelve un código de
201 Created
respuesta. - Si falla, se devolverá un error
4xx
con detalles específicos.
Ejemplo
En el ejemplo siguiente se actualiza trustFrameworkPolicy.
Solicitud
PUT https://graph.microsoft.com/beta/trustFramework/policies/B2C_1A_SocialAndLocalAccounts_Base/$value
Content-Type: application/xml
<TrustFrameworkPolicy xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06" PolicySchemaVersion="0.3.0.0" TenantId="contoso.com" PolicyId="B2C_1A_SocialAndLocalAccounts_Base">
<!---PolicyContent-->
</TrustFrameworkPolicy>
Respuesta
HTTP/1.1 200 OK
Content-Type: application/xml
<TrustFrameworkPolicy xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06" PolicySchemaVersion="0.3.0.0" TenantId="contoso.com" PolicyId="B2C_1A_Test" PublicPolicyUri="http://contoso.com/B2C_1A_Test">
.....
....
<!---PolicyContent-->
....
....
</TrustFrameworkPolicy>