trustFrameworkPolicy を更新または作成する
名前空間: microsoft.graph
重要: Microsoft Graph のベータ版 (/beta) の API はプレビュー中であるため、変更されることがあります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。
既存の trustFrameworkPolicy を 更新するか、存在しない場合は作成します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この 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>