Microsoft Cloud Printing イベント
この記事では、Microsoft Graph API によって発行される Microsoft Cloud Printing イベントのプロパティとスキーマについて説明します。 イベント スキーマの概要については、CloudEvents スキーマに関する記事を参照してください。
使用可能なイベントの種類
これらのイベントは、Microsoft Graph API を使用してこれらのリソースを操作することによって、クラウド印刷 ジョブ または printTaskDefinition が作成または更新されるときにトリガーされます。
イベント名 | 説明 |
---|---|
Microsoft.Graph.PrinterUpdated | プリンターの印刷ジョブが JobFetchable 状態になり、印刷用にフェッチする準備ができたときにトリガーされます。 |
Microsoft.Graph.PrintTaskDefinitionCreated | ユニバーサル印刷で印刷タスクが開始されたときにトリガーされます。 |
イベントの例
イベントがトリガーされると、Event Grid サービスにより、そのイベントに関するデータがサブスクライブしている宛先に送信されます。 このセクションでは、各 Microsoft セキュリティ アラート イベントのデータの例を示します。
Microsoft.Graph.PrinterUpdated イベント
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.PrinterUpdated",
"source": "print/printers/<printer-Id>/jobs/<job-id>",
"subject": "print/printers/<printer-Id>/jobs/<job-id>",
"time": "2022-05-24T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"subscriptionId": "<guid>",
"changeType": "updated",
"clientState": "<user provided secret>",
"subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
"resource": "print/printers/<printer-Id>/jobs/<job-id>",
"resourceData": {
"@odata.type": "#microsoft.graph.todoTask",
"@odata.id": "print/printers/<printer-Id>/jobs/<job-id>",
"id": "<job-id>"
},
"subscriptionId": "<microsoft-graph-subscription-id>",
"tenantId": "<tenant-id>
}
}
イベントのプロパティ
イベントのトップレベルのデータを次に示します。
プロパティ | タイプ | 説明 |
---|---|---|
source |
string | テナント イベント ソース。 このフィールドは書き込み可能ではありません。 この値は Microsoft Graph API によって指定されます。 |
subject |
string | 発行元が定義したイベントの対象のパス。 |
type |
string | このイベント ソース用イベントの種類のいずれか。 |
time |
string | プロバイダーの UTC 時刻に基づくイベントの生成時刻。 |
id |
string | イベントの一意識別子。 |
data |
object | リソースの状態変更に関するデータを提供するイベント ペイロード。 |
specversion |
string | CloudEvents スキーマ仕様バージョン。 |
データ オブジェクトには、次のプロパティがあります。
プロパティ | タイプ | 説明 |
---|---|---|
changeType |
string | リソースの状態変更の種類。 |
resource |
string | イベントが発生したリソースの識別子。 |
tenantId |
string | アラートが発生した組織 ID。 |
clientState |
string | Graph API サブスクリプションの作成時にユーザーが指定したシークレット。 |
@odata.type |
string | Graph API の変更の種類。 |
@odata.id |
string | イベントが発生した Graph API リソースの識別子。 |
id |
string | イベントが発生したリソースの識別子。 |
subscriptionExpirationDateTime |
string | Graph API サブスクリプションが期限切れになる RFC 3339 形式の時刻。 |
subscriptionId |
string | Graph API サブスクリプション識別子。 |
tenantId |
string | Microsoft Entra テナント識別子。 |
次のステップ
- Azure Event Grid のパートナー イベントの概要については、パートナー イベントの概要に関する記事を参照してください。
- イベントを受信するために Microsoft Graph API をサブスクライブする方法については、Microsoft Graph API イベントのサブスクライブを参照してください。
- Azure Event Grid イベント ハンドラーの詳細については、イベント ハンドラーに関する記事を参照してください。
- Azure Event Grid サブスクリプションの作成の詳細については、「イベント サブスクリプションの作成」と「Event Grid サブスクリプション スキーマ」を参照してください。
- 配信する特定のイベントを選ぶようにイベント サブスクリプションを構成する方法の詳細については、イベントのフィルター処理に関する記事を参照してください。 フィルター イベントを参照することもできます。