AndroidForWorkCompliancePolicy を作成するCreate androidForWorkCompliancePolicy

名前空間: microsoft.graphNamespace: microsoft.graph

重要: ベータ版の Microsoft Graph Api は変更される可能性があります。運用環境での使用はサポートされていません。Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

注: Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

新しい androidForWorkCompliancePolicy オブジェクトを作成します。Create a new androidForWorkCompliancePolicy object.

前提条件Prerequisites

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の大きいものから小さいものへ)Permissions (from most to least privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

HTTP 要求HTTP Request

POST /deviceManagement/deviceCompliancePolicies

要求ヘッダーRequest headers

ヘッダーHeader Value
AuthorizationAuthorization ベアラー <トークン> が必要です。Bearer <token> Required.
承諾Accept application/jsonapplication/json

要求本文Request body

要求本文で、androidForWorkCompliancePolicy オブジェクトの JSON 表記を指定します。In the request body, supply a JSON representation for the androidForWorkCompliancePolicy object.

次の表に、androidForWorkCompliancePolicy の作成時に必要なプロパティを示します。The following table shows the properties that are required when you create the androidForWorkCompliancePolicy.

プロパティProperty Type 説明Description
roleScopeTagIdsroleScopeTagIds String collectionString collection このエンティティインスタンスの範囲タグのリスト。List of Scope Tags for this Entity instance. deviceCompliancePolicy から継承しますInherited from deviceCompliancePolicy
idid StringString エンティティのキー。Key of the entity. deviceCompliancePolicy から継承しますInherited from deviceCompliancePolicy
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset オブジェクトが作成された DateTime。DateTime the object was created. deviceCompliancePolicy から継承しますInherited from deviceCompliancePolicy
descriptiondescription StringString 管理者が指定した、デバイス構成についての説明。Admin provided description of the Device Configuration. deviceCompliancePolicy から継承しますInherited from deviceCompliancePolicy
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset オブジェクトの最終更新の DateTime。DateTime the object was last modified. deviceCompliancePolicy から継承しますInherited from deviceCompliancePolicy
displayNamedisplayName StringString 管理者が指定した、デバイス構成の名前。Admin provided name of the device configuration. deviceCompliancePolicy から継承しますInherited from deviceCompliancePolicy
versionversion Int32Int32 デバイス構成のバージョン。Version of the device configuration. deviceCompliancePolicy から継承しますInherited from deviceCompliancePolicy
passwordRequiredpasswordRequired BooleanBoolean デバイスのロックを解除するパスワードを要求します。Require a password to unlock device.
passwordMinimumLengthpasswordMinimumLength Int32Int32 パスワードの最小文字数。Minimum password length. 有効な値は 4 から 16 までですValid values 4 to 16
passwordRequiredTypepasswordRequiredType androidRequiredPasswordTypeandroidRequiredPasswordType パスワードの文字の種類。Type of characters in password. 可能な値は、deviceDefaultalphabeticalphanumericalphanumericWithSymbolslowSecurityBiometricnumericnumericComplexany です。Possible values are: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any.
passwordMinutesOfInactivityBeforeLockpasswordMinutesOfInactivityBeforeLock Int32Int32 パスワードが要求されるまでの非アクティブ時間 (分)。Minutes of inactivity before a password is required.
passwordExpirationDayspasswordExpirationDays Int32Int32 パスワードの有効期限が切れるまでの日数。Number of days before the password expires. 有効な値は 1 から 365 までですValid values 1 to 365
passwordPreviousPasswordBlockCountpasswordPreviousPasswordBlockCount Int32Int32 禁止する、以前のパスワードの数です。Number of previous passwords to block. 有効な値は 1 から 24 までですValid values 1 to 24
passwordSignInFailureCountBeforeFactoryResetpasswordSignInFailureCountBeforeFactoryReset Int32Int32 出荷時のリセットまでに許可されるサインインの失敗回数。Number of sign-in failures allowed before factory reset. 有効な値は1から16までですValid values 1 to 16
securityPreventInstallAppsFromUnknownSourcessecurityPreventInstallAppsFromUnknownSources BooleanBoolean デバイスが不明なソースからのアプリのインストールを許可しないことを要求します。Require that devices disallow installation of apps from unknown sources.
securityDisableUsbDebuggingsecurityDisableUsbDebugging BooleanBoolean Android デバイスでの USB デバッグを無効にします。Disable USB debugging on Android devices.
securityRequireVerifyAppssecurityRequireVerifyApps BooleanBoolean Android の検証アプリ機能をオンにするよう要求します。Require the Android Verify apps feature is turned on.
deviceThreatProtectionEnableddeviceThreatProtectionEnabled BooleanBoolean デバイスの脅威保護が有効になっていることを要求します。Require that devices have enabled device threat protection.
deviceThreatProtectionRequiredSecurityLeveldeviceThreatProtectionRequiredSecurityLevel deviceThreatProtectionLeveldeviceThreatProtectionLevel Mobile Threat Protection に、コンプライアンス違反をレポートするための最小のリスク レベルを要求します。Require Mobile Threat Protection minimum risk level to report noncompliance. 可能な値は、unavailablesecuredlowmediumhighnotSet です。Possible values are: unavailable, secured, low, medium, high, notSet.
securityBlockJailbrokenDevicessecurityBlockJailbrokenDevices BooleanBoolean デバイスの脱獄またはルート化を認めません。Devices must not be jailbroken or rooted.
osMinimumVersionosMinimumVersion StringString Android の最小バージョン。Minimum Android version.
osMaximumVersionosMaximumVersion StringString Android の最大バージョン。Maximum Android version.
minAndroidSecurityPatchLevelminAndroidSecurityPatchLevel StringString Android セキュリティ パッチの最小レベル。Minimum Android security patch level.
storageRequireEncryptionstorageRequireEncryption BooleanBoolean Android デバイスでの暗号化を要求します。Require encryption on Android devices.
securityRequireSafetyNetAttestationBasicIntegritysecurityRequireSafetyNetAttestationBasicIntegrity BooleanBoolean デバイスが SafetyNet の基本整合性チェックに合格することを要求します。Require the device to pass the SafetyNet basic integrity check.
securityRequireSafetyNetAttestationCertifiedDevicesecurityRequireSafetyNetAttestationCertifiedDevice BooleanBoolean デバイスが SafetyNet の認定デバイス チェックに合格することを要求します。Require the device to pass the SafetyNet certified device check.
securityRequireGooglePlayServicessecurityRequireGooglePlayServices BooleanBoolean Google Play 開発者サービスがデバイスにインストールされて有効になっていることを要求します。Require Google Play Services to be installed and enabled on the device.
securityRequireUpToDateSecurityProviderssecurityRequireUpToDateSecurityProviders BooleanBoolean デバイスに最新のセキュリティ プロバイダーが必要です。Require the device to have up to date security providers. デバイスで Google Play 開発者サービスが有効かつ最新の状態になっている必要があります。The device will require Google Play Services to be enabled and up to date.
securityRequireCompanyPortalAppIntegritysecurityRequireCompanyPortalAppIntegrity BooleanBoolean デバイスが会社のポータル クライアント アプリのランタイム整合性チェックに合格することを要求します。Require the device to pass the Company Portal client app runtime integrity check.

応答Response

成功した場合、このメソッドは応答 201 Created コードと、応答本文で androidForWorkCompliancePolicy オブジェクトを返します。If successful, this method returns a 201 Created response code and a androidForWorkCompliancePolicy object in the response body.

Example

要求Request

以下は、要求の例です。Here is an example of the request.

POST https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies
Content-type: application/json
Content-length: 1283

{
  "@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",
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordExpirationDays": 6,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "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
}

応答Response

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1455

{
  "@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",
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordExpirationDays": 6,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "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
}