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 una trustFrameworkPolicy existente o cree una si no existe.

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) Policy.ReadWrite.TrustFramework No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Policy.ReadWrite.TrustFramework No disponible.

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. El administrador de directivas B2C IEF 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 autenticación y 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 trustFrameworkPolicy , una solicitud correcta devuelve un código de 200 OK respuesta.
  • Si no existe trustFrameworkPolicy , una solicitud correcta devuelve un 201 Created código de respuesta.
  • Si falla, se devolverá un error 4xx con detalles específicos.

Ejemplo

El siguiente ejemplo actualiza una 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>