テナントの更新AppManagementPolicy

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

tenantAppManagementPolicy オブジェクトのプロパティを更新します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) Policy.ReadWrite.ApplicationConfiguration
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション Policy.ReadWrite.ApplicationConfiguration

HTTP 要求

PATCH /policies/defaultAppManagementPolicy

要求ヘッダー

名前 説明
Authorization ベアラー {token}。必須。
Content-Type application/json. Required.

要求本文

要求本文で、更新する必要がある tenantAppManagementPolicy から関連フィールドの値を指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持します。 最適なパフォーマンスを得る場合は、要求ペイロードに変更されていない値を含めしないでください。

プロパティ 説明
applicationRestrictions appManagementConfiguration テナント内のすべてのアプリケーション オブジェクトに既定で適用される制限。
displayName String 既定のポリシーの表示名。 policyBase から継承されます
description String 既定のポリシーの説明。 policyBase から継承されます
isEnabled ブール値 ポリシーが有効になっている場合を示します。 既定値は False です。
servicePrincipalRestrictions appManagementConfiguration テナント内のすべてのサービス プリンシパル オブジェクトに既定で適用される制限。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。応答本文には何も返されません。

要求

要求の例を次に示します。

PATCH https://graph.microsoft.com/beta/policies/defaultAppManagementPolicy
Content-Type: application/json

{
    "isEnabled": true,
    "applicationRestrictions": {
        "passwordCredentials": [
            {
                "restrictionType": "passwordAddition",
                "maxLifetime": null,
                "restrictForAppsCreatedAfterDateTime": "2021-01-01T10:37:00Z"
            },
            {
                "restrictionType": "passwordLifetime",
                "maxLifetime": "P4DT12H30M5S",
                "restrictForAppsCreatedAfterDateTime": "2017-01-01T10:37:00Z"
            },
            {
                "restrictionType": "symmetricKeyAddition",
                "maxLifetime": null,
                "restrictForAppsCreatedAfterDateTime": "2021-01-01T10:37:00Z"
            },
            {
                "restrictionType": "customPasswordAddition",
                "maxLifetime": null,
                "restrictForAppsCreatedAfterDateTime": "2015-01-01T10:37:00Z"
            },
            {
                "restrictionType": "symmetricKeyLifetime",
                "maxLifetime": "P40D",
                "restrictForAppsCreatedAfterDateTime": "2015-01-01T10:37:00Z"
            }
        ],
        "keyCredentials":[
            {
                "restrictionType": "asymmetricKeyLifetime",
                "maxLifetime": "P30D",
                "restrictForAppsCreatedAfterDateTime": "2015-01-01T10:37:00Z"
            },
        ]
    }
}

応答

応答の例を次に示します。

HTTP/1.1 204 No Content