androidForWorkCompliancePolicy を更新する
名前空間: microsoft.graph
大事な: /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
androidForWorkCompliancePolicy オブジェクトのプロパティを更新します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
---|---|
委任 (職場または学校のアカウント) | DeviceManagementConfiguration.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 |
アプリケーション | DeviceManagementConfiguration.ReadWrite.All |
HTTP 要求
PATCH /deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}
要求ヘッダー
ヘッダー | 値 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
承諾 | application/json |
要求本文
要求本文で、 androidForWorkCompliancePolicy オブジェクトの JSON 表現を指定します。
次の表は、 androidForWorkCompliancePolicy を作成するときに必要なプロパティを示しています。
プロパティ | 型 | 説明 |
---|---|---|
roleScopeTagIds | String collection | このエンティティ インスタンスのスコープ タグの一覧。 deviceCompliancePolicy から継承します |
id | String | エンティティのキー。 deviceCompliancePolicy から継承します |
createdDateTime | DateTimeOffset | オブジェクトが作成された DateTime。 deviceCompliancePolicy から継承します |
description | String | 管理者が指定した、デバイス構成についての説明。 deviceCompliancePolicy から継承します |
lastModifiedDateTime | DateTimeOffset | オブジェクトの最終更新の DateTime。 deviceCompliancePolicy から継承します |
displayName | String | 管理者が指定した、デバイス構成の名前。 deviceCompliancePolicy から継承します |
version | Int32 | デバイス構成のバージョン。 deviceCompliancePolicy から継承します |
passwordRequired | Boolean | デバイスのロックを解除するパスワードを要求します。 |
passwordMinimumLength | Int32 | パスワードの最小文字数。 有効な値は 4 から 16 までです |
passwordRequiredType | androidRequiredPasswordType | パスワードの文字の種類。 可能な値は、deviceDefault 、alphabetic 、alphanumeric 、alphanumericWithSymbols 、lowSecurityBiometric 、numeric 、numericComplex 、any です。 |
requiredPasswordComplexity | androidRequiredPasswordComplexity | Android で必要なデバイス パスワードの複雑さを示します。 次のいずれか: NONE、LOW、MEDIUM、HIGH。 これは、Android API 12 以降を対象とする新しい API です。 使用可能な値: none 、low 、medium 、high 。 |
passwordMinutesOfInactivityBeforeLock | Int32 | パスワードが要求されるまでの非アクティブ時間 (分)。 |
passwordExpirationDays | Int32 | パスワードの有効期限が切れるまでの日数。 有効な値は 1 から 365 までです |
passwordPreviousPasswordBlockCount | Int32 | 禁止する、以前のパスワードの数です。 有効な値は 1 から 24 までです |
passwordSignInFailureCountBeforeFactoryReset | Int32 | 出荷時のリセット前に許可されたサインイン エラーの数。 有効な値 1 ~ 16 |
workProfilePasswordExpirationInDays | Int32 | 仕事用プロファイルのパスワードの有効期限が切れるまでの日数。 有効な値は 1 から 365 までです |
workProfilePasswordMinimumLength | Int32 | 仕事用プロファイルパスワードの最小長。 有効な値は 4 から 16 までです |
workProfileInactiveBeforeScreenLockInMinutes | Int32 | 画面がタイムアウトになるまでの非アクティブ時間 (分)。 |
workProfilePreviousPasswordBlockCount | Int32 | ブロックする以前の作業プロファイル パスワードの数。 有効な値は 0 から 24 までです |
workProfilePasswordRequiredType | androidForWorkRequiredPasswordType | 必要な仕事用プロファイル パスワードの種類。 可能な値は、deviceDefault 、lowSecurityBiometric 、required 、atLeastNumeric 、numericComplex 、atLeastAlphabetic 、atLeastAlphanumeric 、alphanumericWithSymbols です。 |
workProfileRequiredPasswordComplexity | androidRequiredPasswordComplexity | Android で必要な仕事用プロファイルのパスワードの複雑さを示します。 次のいずれか: NONE、LOW、MEDIUM、HIGH。 これは、Android 12 以降を対象とする新しい API です。 使用可能な値: none 、low 、medium 、high 。 |
workProfileRequirePassword | ブール型 | 仕事用プロファイルにパスワードが必要かどうか |
securityPreventInstallAppsFromUnknownSources | Boolean | デバイスが不明なソースからのアプリのインストールを許可しないことを要求します。 |
securityDisableUsbDebugging | Boolean | Android デバイスでの USB デバッグを無効にします。 |
securityRequireVerifyApps | Boolean | Android の検証アプリ機能をオンにするよう要求します。 |
deviceThreatProtectionEnabled | Boolean | デバイスの脅威保護が有効になっていることを要求します。 |
deviceThreatProtectionRequiredSecurityLevel | deviceThreatProtectionLevel | Mobile Threat Protection に、コンプライアンス違反をレポートするための最小のリスク レベルを要求します。 可能な値は、unavailable 、secured 、low 、medium 、high 、notSet です。 |
securityBlockJailbrokenDevices | Boolean | デバイスの脱獄またはルート化を認めません。 |
osMinimumVersion | String | Android の最小バージョン。 |
osMaximumVersion | String | Android の最大バージョン。 |
minAndroidSecurityPatchLevel | String | Android セキュリティ パッチの最小レベル。 |
storageRequireEncryption | Boolean | Android デバイスでの暗号化を要求します。 |
securityRequireSafetyNetAttestationBasicIntegrity | ブール型 | デバイスに Play Integrity 基本整合性チェックを渡す必要があります。 |
securityRequireSafetyNetAttestationCertifiedDevice | ブール型 | デバイスに Play Integrity デバイスの整合性チェックを渡す必要があります。 |
securityRequireGooglePlayServices | Boolean | Google Play 開発者サービスがデバイスにインストールされて有効になっていることを要求します。 |
securityRequireUpToDateSecurityProviders | Boolean | デバイスに最新のセキュリティ プロバイダーが必要です。 デバイスで Google Play 開発者サービスが有効かつ最新の状態になっている必要があります。 |
securityRequireCompanyPortalAppIntegrity | Boolean | デバイスが会社のポータル クライアント アプリのランタイム整合性チェックに合格することを要求します。 |
securityRequiredAndroidSafetyNetEvaluationType | androidSafetyNetEvaluationType | コンプライアンスのために特定の SafetyNet 評価の種類が必要です。 可能な値は、basic 、hardwareBacked です。 |
応答
成功した場合、このメソッドは応答本文に 200 OK
応答コードと更新された androidForWorkCompliancePolicy オブジェクトを返します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}
Content-type: application/json
Content-length: 1735
{
"@odata.type": "#microsoft.graph.androidForWorkCompliancePolicy",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"passwordRequired": true,
"passwordMinimumLength": 5,
"passwordRequiredType": "alphabetic",
"requiredPasswordComplexity": "low",
"passwordMinutesOfInactivityBeforeLock": 5,
"passwordExpirationDays": 6,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"workProfilePasswordExpirationInDays": 3,
"workProfilePasswordMinimumLength": 0,
"workProfileInactiveBeforeScreenLockInMinutes": 12,
"workProfilePreviousPasswordBlockCount": 5,
"workProfilePasswordRequiredType": "lowSecurityBiometric",
"workProfileRequiredPasswordComplexity": "low",
"workProfileRequirePassword": true,
"securityPreventInstallAppsFromUnknownSources": true,
"securityDisableUsbDebugging": true,
"securityRequireVerifyApps": true,
"deviceThreatProtectionEnabled": true,
"deviceThreatProtectionRequiredSecurityLevel": "secured",
"securityBlockJailbrokenDevices": true,
"osMinimumVersion": "Os Minimum Version value",
"osMaximumVersion": "Os Maximum Version value",
"minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
"storageRequireEncryption": true,
"securityRequireSafetyNetAttestationBasicIntegrity": true,
"securityRequireSafetyNetAttestationCertifiedDevice": true,
"securityRequireGooglePlayServices": true,
"securityRequireUpToDateSecurityProviders": true,
"securityRequireCompanyPortalAppIntegrity": true,
"securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1907
{
"@odata.type": "#microsoft.graph.androidForWorkCompliancePolicy",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"id": "a8d667bd-67bd-a8d6-bd67-d6a8bd67d6a8",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"displayName": "Display Name value",
"version": 7,
"passwordRequired": true,
"passwordMinimumLength": 5,
"passwordRequiredType": "alphabetic",
"requiredPasswordComplexity": "low",
"passwordMinutesOfInactivityBeforeLock": 5,
"passwordExpirationDays": 6,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"workProfilePasswordExpirationInDays": 3,
"workProfilePasswordMinimumLength": 0,
"workProfileInactiveBeforeScreenLockInMinutes": 12,
"workProfilePreviousPasswordBlockCount": 5,
"workProfilePasswordRequiredType": "lowSecurityBiometric",
"workProfileRequiredPasswordComplexity": "low",
"workProfileRequirePassword": true,
"securityPreventInstallAppsFromUnknownSources": true,
"securityDisableUsbDebugging": true,
"securityRequireVerifyApps": true,
"deviceThreatProtectionEnabled": true,
"deviceThreatProtectionRequiredSecurityLevel": "secured",
"securityBlockJailbrokenDevices": true,
"osMinimumVersion": "Os Minimum Version value",
"osMaximumVersion": "Os Maximum Version value",
"minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",
"storageRequireEncryption": true,
"securityRequireSafetyNetAttestationBasicIntegrity": true,
"securityRequireSafetyNetAttestationCertifiedDevice": true,
"securityRequireGooglePlayServices": true,
"securityRequireUpToDateSecurityProviders": true,
"securityRequireCompanyPortalAppIntegrity": true,
"securityRequiredAndroidSafetyNetEvaluationType": "hardwareBacked"
}