--- title: "監査ログの公開API" slug: "publishing-audit-log-api" abstract: "公開作業を追跡するために使用できる公開監査ログAPIの概要。" --- # 監査ログの公開API Publishing audit log APIは、Sitecore Content Hub環境内のすべての公開操作(例えばエンティティの更新・削除、スキーマの変更など)を追跡できます。各操作には2つの監査レコードがあります。1つは開始時と成功または失敗時です。 ## ベースURL 公開監査ログAPIの基本URLは以下の通りです: https:///api/publishaudit/ ## 認証 公開監査ログAPIにアクセスするには [認証トークン](https://doc.sitecore.com/ch/ja/developers/cloud-dev/authentication.html "Authentication")が必要です。トークンを生成できるのはスーパーユーザーだけです。 ## 方法 公開監査ログAPIは情報の取得用であり、GET方式のみをサポートしています。 ## エンドポイント 公開監査ログAPIには以下のエンドポイントがあります。 終着点 概要 history/ すべての公開操作の一般的な監査ログをタイムスタンプで降順に並べて返します。 tenant name パラメータは大文字を区別しません。 entityhistory// エンティティ識別子で特定のエンティティに関連する公開操作を返します。結果はタイムスタンプで降順に並べ替えられます。 entityhistory//id/ 特定のエンティティに関連する公開操作をエンティティIDでタイムスタンプで降順に並べて返します。 entitystatus// 特定の事業体の発行状況を返します。 schemahistory/ スキーマに関連するすべての公開操作をタイムスタンプで降順に返します。 inprogresscount/ 進行中の出版作業数を返します。 entitiesByLastOperationStatus// 特定の公開ステータスを持つすべてのエンティティを返します。有効な操作ステータスは、 InProgress、 Success、 Failure、 Cancelledです。 \> \[!注\] \>このエンドポイントは主に失敗または進行中の操作の取得を目的としています。「成功」ステータスのクエリは多くの結果を返すことがあり、パフォーマンスに影響を及ぼしたり、リクエストが失敗したりすることがあります。 performance/snapshot/ パフォーマンススナップショットを返します。startDateとオプションパラメータを使って*datetime*の範囲を指定するendDate。指定しない場合、日付はスキップされ、時間は過去15分にデフォルトで表示されます。 performance/queues すべてのキューとその現在の状態のリストを返します。 ## オプションのクエリパラメータ api/publishaudit/history、api/publishaudit/entityhistory、api/publishaudit/schemahistoryにクエリを書く際には、以下のオプションパラメータを含めることができます。 パラメータ 種類 概要 startDate *デートタイム* 検索のdatetime範囲の開始点(UTC単位)。これが指定されていない場合、クエリは利用可能なすべての監査エントリーを返します。 endDate *デートタイム* 検索のdatetime範囲の終わり(UTC単位)。これが指定されていない場合、クエリは利用可能なすべての監査エントリを返します。 searchAfter *ストリング* 次の検索をどこから始めるか、前のクエリで返された searchAfter プロパティ値に基づいています。複数の値はカンマで区切ってください。 take *整数* 1回のリクエストで返すべきアイテム数。デフォルト値: *10*。 fullText *ストリング* 全文検索で使用される用語です。このパラメータに値が与えられた場合、リクエストはその値を含むフィールドの監査エントリのみを返します。 ## 一般的な監査ログ例クエリ 以下のサンプルクエリは、history/ エンドポイントを用いてすべての公開操作の一般的な監査ログを取得します。 クエリ: GET https:///api/publishAudit/history/CaaS 回答: { "items": {...}, {...}, ... , "total": 10000, "searchAfter": "1692293242818,129c39ab-6e3a-4eb2-bb8e-84a2e43e4b32" } > !注応答はスクロールを使用します。 totalプロパティはクエリで返されるアイテム数を示し、上限は10,000です。 次のサンプルでは、takeとsearchAfterオプションパラメータを使って初期クエリを精緻化します。 takeパラメータは3に設定され、searchAfterパラメータで指定されたポイントから始まる3つの結果を返します。 クエリ: GET https:///api/publishAudit/history/CaaS?searchAfter=1692293242843,7483c2f8-653b-4f77-9ee4-9bed00a23845&take=20 回答: { "items": { "delivery\_messsage\_id": "3667f906-bb0c-4d2e-8cee-45eb75763371", "tenant": "CaaS", "operation": "EntityUpdateACK", "operation\_status": "Success", "detailed\_description": null, "publish\_status": "Published", "is\_latest\_publish\_status": true, "user\_name": "Superuser", "operation\_attributes": "SkipUserNotification", "skip\_notification": true, "id": "78705504-05d9-4bfe-900d-836482ae3a03", "event\_type": null, "severity": null, "target\_id": 9788, "target\_identifier": "M.ContentType.WhitePaper", "timestamp": "2023-08-17T17:\`27:22\`.8337201Z", "@timestamp": "2023-08-17T17:\`27:22\`.8337201Z", "user\_id": 805 }, { "delivery\_messsage\_id": "a9e5997f-e484-4eaa-a9a7-748e9f2ba712", "tenant": "CaaS", "operation": "EntityUpdateACK", "operation\_status": "Success", "detailed\_description": null, "publish\_status": "Published", "is\_latest\_publish\_status": true, "user\_name": "Superuser", "operation\_attributes": "SkipUserNotification", "skip\_notification": true, "id": "d7dbfe7d-8375-47fd-8ede-1a7e2796f205", "event\_type": null, "severity": null, "target\_id": 9787, "target\_identifier": "M.ContentType.SocialMediaMessage", "timestamp": "2023-08-17T17:\`27:22\`.8263286Z", "@timestamp": "2023-08-17T17:\`27:22\`.8263286Z", "user\_id": 805 }, { "delivery\_messsage\_id": "20628934-e62b-4471-88c5-468d930e4bd6", "tenant": "CaaS", "operation": "EntityUpdateACK", "operation\_status": "Success", "detailed\_description": null, "publish\_status": "Published", "is\_latest\_publish\_status": true, "user\_name": "Superuser", "operation\_attributes": "SkipUserNotification", "skip\_notification": true, "id": "129c39ab-6e3a-4eb2-bb8e-84a2e43e4b32", "event\_type": null, "severity": null, "target\_id": 9791, "target\_identifier": "M.ContentType.Email", "timestamp": "2023-08-17T17:\`27:22\`.8186412Z", "@timestamp": "2023-08-17T17:\`27:22\`.8186412Z", "user\_id": 805 } , "total\_items": 873, "searchAfter": "1692293242818,129c39ab-6e3a-4eb2-bb8e-84a2e43e4b32" }