ブックのリソースの種類

名前空間: microsoft.graph.security

重要

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

表示名と JSON ドキュメントを含む、テナント スコープの Microsoft セキュリティ ブックを表します。

/security/workbooks API を使用して、これらのリソースを管理します。 このリソースは、Excel ブックとは別のものです。

POST を使用してブックを作成すると、その ID が生成されます。 クライアントが選択した GUID で PATCH を使用すると、その ID のブックが作成されるか、または置き換えられます。 同じ GUID で要求を繰り返すと、ブックの ID が保持されます。 更新プログラムによって コンテンツ ドキュメント全体が置き換えられます。入れ子になったプロパティはマージされません。 サービスでは、元の作成監査情報が保持されます。

エンティティ から継承します。

メソッド

メソッド 戻り値の種類 説明
List Microsoft.Graph.Security.Workbook コレクション テナントでブックを取得します。
Create microsoft.graph.security.workbook サーバー生成 ID を使用してブックを作成します。
Get microsoft.graph.security.workbook ID を使用してブックを取得します。
Update microsoft.graph.security.workbook クライアントが選択した ID を使用してブックを作成または置換する。
Delete なし ID でブックを削除する。

プロパティ

プロパティ 型 説明
content microsoft.graph.security.workbookContent ブックの JSON ドキュメント。 ブックを作成または置き換えるときに必要です。 JSON でエンコードされた文字列ではなく、JSON オブジェクトを指定します。 アップデート時に全体として置き換えられました。 既定では、コレクションの応答から省略されます。 $select を使用してそれを含めます。
createdAtDateTime DateTimeOffset ブックが作成された日時。 サービスによって設定され、更新時に保存されます。 読み取り専用です。
createdByUpn 文字列 ブックの作成時に記録されたユーザー プリンシパル名。 サービスによって設定され、更新時に保存されます。 読み取り専用です。
etag 文字列 ブックのストレージ ETag から派生した不透明な同時実行トークン。 サービスによって設定されます。 読み取り専用です。 条件付き更新の場合は、HTTP ETag 応答ヘッダーで返された値を使用します。
id 文字列 ブックを識別する GUID。 必須かつ不変。 POST によって生成されるか、反復可能なデプロイのために PATCH アイテム ルートで提供されます。 このプロパティを要求本文には指定しないでください。 エンティティ から継承します。
lastUpdatedByUpn 文字列 最新の更新プログラムに対して記録されたユーザー プリンシパル名。 サービスによって設定されます。 読み取り専用です。
name String ブックの表示名。 ブックを作成または置き換えるときに必要です。 最大文字数は 256 文字です。
updatedAtDateTime DateTimeOffset 最新の更新の日時。 サービスによって設定されます。 読み取り専用です。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.security.workbook",
  "id": "String (identifier)",
  "name": "String",
  "content": {
    "@odata.type": "microsoft.graph.security.workbookContent"
  },
  "etag": "String",
  "createdByUpn": "String",
  "lastUpdatedByUpn": "String",
  "createdAtDateTime": "String (timestamp)",
  "updatedAtDateTime": "String (timestamp)"
}