auditEvent の更新
名前空間: microsoft.graph
大事な: /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
auditEvent オブジェクトのプロパティを更新します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
---|---|
委任 (職場または学校のアカウント) | DeviceManagementApps.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 |
アプリケーション | DeviceManagementApps.ReadWrite.All |
HTTP 要求
PATCH /deviceManagement/auditEvents/{auditEventId}
要求ヘッダー
ヘッダー | 値 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
承諾 | application/json |
要求本文
要求本文で、auditEvent オブジェクトの JSON 表記を指定します。
次の表に、auditEvent の作成時に必要なプロパティを示します。
プロパティ | 型 | 説明 |
---|---|---|
id | String | エンティティのキー。 |
displayName | String | イベントの表示名。 |
componentName | String | コンポーネント名。 |
actor | auditActor | 監査イベントに関連付けられている AAD ユーザーとアプリケーション。 |
activity | String | わかりやすいアクティビティの名前。 |
activityDateTime | DateTimeOffset | アクティビティが実行された日時 (UTC)。 |
activityType | String | 実行されたアクティビティの種類。 |
activityOperationType | String | アクティビティの HTTP 操作の種類。 |
activityResult | String | アクティビティの結果。 |
correlationId | Guid | システム内でのアクティビティに関連付けるために使用されるクライアント要求 ID。 |
resources | auditResource コレクション | 変更中のリソースです。 |
category | String | 監査のカテゴリです。 |
応答
成功した場合、このメソッドは 200 OK
応答コードと、更新された auditEvent オブジェクトを応答本文で返します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/beta/deviceManagement/auditEvents/{auditEventId}
Content-type: application/json
Content-length: 1803
{
"@odata.type": "#microsoft.graph.auditEvent",
"displayName": "Display Name value",
"componentName": "Component Name value",
"actor": {
"@odata.type": "microsoft.graph.auditActor",
"type": "Type value",
"auditActorType": "Audit Actor Type value",
"userPermissions": [
"User Permissions value"
],
"applicationId": "Application Id value",
"applicationDisplayName": "Application Display Name value",
"userPrincipalName": "User Principal Name value",
"servicePrincipalName": "Service Principal Name value",
"ipAddress": "Ip Address value",
"userId": "User Id value",
"userRoleScopeTags": [
{
"@odata.type": "microsoft.graph.roleScopeTagInfo",
"displayName": "Display Name value",
"roleScopeTagId": "Role Scope Tag Id value"
}
],
"remoteTenantId": "Remote Tenant Id value",
"remoteUserId": "Remote User Id value"
},
"activity": "Activity value",
"activityDateTime": "2016-12-31T23:59:51.6363086-08:00",
"activityType": "Activity Type value",
"activityOperationType": "Activity Operation Type value",
"activityResult": "Activity Result value",
"correlationId": "52effe71-fe71-52ef-71fe-ef5271feef52",
"resources": [
{
"@odata.type": "microsoft.graph.auditResource",
"displayName": "Display Name value",
"modifiedProperties": [
{
"@odata.type": "microsoft.graph.auditProperty",
"displayName": "Display Name value",
"oldValue": "Old Value value",
"newValue": "New Value value"
}
],
"type": "Type value",
"auditResourceType": "Audit Resource Type value",
"resourceId": "Resource Id value"
}
],
"category": "Category value"
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1852
{
"@odata.type": "#microsoft.graph.auditEvent",
"id": "59653ce8-3ce8-5965-e83c-6559e83c6559",
"displayName": "Display Name value",
"componentName": "Component Name value",
"actor": {
"@odata.type": "microsoft.graph.auditActor",
"type": "Type value",
"auditActorType": "Audit Actor Type value",
"userPermissions": [
"User Permissions value"
],
"applicationId": "Application Id value",
"applicationDisplayName": "Application Display Name value",
"userPrincipalName": "User Principal Name value",
"servicePrincipalName": "Service Principal Name value",
"ipAddress": "Ip Address value",
"userId": "User Id value",
"userRoleScopeTags": [
{
"@odata.type": "microsoft.graph.roleScopeTagInfo",
"displayName": "Display Name value",
"roleScopeTagId": "Role Scope Tag Id value"
}
],
"remoteTenantId": "Remote Tenant Id value",
"remoteUserId": "Remote User Id value"
},
"activity": "Activity value",
"activityDateTime": "2016-12-31T23:59:51.6363086-08:00",
"activityType": "Activity Type value",
"activityOperationType": "Activity Operation Type value",
"activityResult": "Activity Result value",
"correlationId": "52effe71-fe71-52ef-71fe-ef5271feef52",
"resources": [
{
"@odata.type": "microsoft.graph.auditResource",
"displayName": "Display Name value",
"modifiedProperties": [
{
"@odata.type": "microsoft.graph.auditProperty",
"displayName": "Display Name value",
"oldValue": "Old Value value",
"newValue": "New Value value"
}
],
"type": "Type value",
"auditResourceType": "Audit Resource Type value",
"resourceId": "Resource Id value"
}
],
"category": "Category value"
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示