名前空間: 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)"
}