更新或创建 trustFrameworkPolicy
命名空间:microsoft.graph
重要说明:Microsoft Graph 中 /beta 版本下的 API 是预览版,可能会发生变化。 不支持在生产应用程序中使用这些 API。
更新现有的 trustFrameworkPolicy 或创建一个(如果不存在)。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | Policy.ReadWrite.TrustFramework | 不可用。 |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | Policy.ReadWrite.TrustFramework | 不可用。 |
重要
在具有工作或学校帐户的委派方案中,必须为管理员分配受支持的Microsoft Entra角色或具有受支持角色权限的自定义角色。 B2C IEF 策略管理员 是此操作支持的最低特权角色。
HTTP 请求
PUT /trustFramework/policies/{id}/$value
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
Content-Type | application/xml。 必填。 |
请求正文
在请求正文中,提供 trustFrameworkPolicy 对象的 XML 表示形式。
注意: 内容类型必须为
application/xml
。
响应
响应将是以下项之一:
- 如果存在 trustFrameworkPolicy ,则成功的请求将
200 OK
返回响应代码。 - 如果 trustFrameworkPolicy 不存在,则成功的请求将
201 Created
返回响应代码。 - 如果失败,将返回
4xx
错误并显示具体详细信息。
示例
以下示例更新 trustFrameworkPolicy。
请求
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>
响应
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>