Triggers - Create Or Replace

リファレンス

サービス:: Purview

API バージョン:: 2023-09-01

トリガーのインスタンスを作成または置換します。

PUT {endpoint}/scan/datasources/{dataSourceName}/scans/{scanName}/triggers/default?api-version=2023-09-01

URI パラメーター

名前	/	必須	型	説明
dataSourceName	path	True	string	dataSource 名。正規表現パターン: `^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$`
endpoint	path	True	string url	purview アカウントのスキャンエンドポイント。例: https://{accountName}.purview.azure.com。
scanName	path	True	string	スキャン名。正規表現パターン: `^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$`
api-version	query	True	string	使用する API バージョン。

要求本文

名前	型	説明
properties	TriggerProperties	トリガーのプロパティ。
validationErrorInfo	string	トリガーの検証エラー情報。

応答

名前	型	説明
200 OK	Trigger	正常終了しました。
201 Created	Trigger	正常終了しました。
Other Status Codes	ErrorResponseModel	スキャンサービスから受信したエラー応答。ヘッダー x-ms-error-code: string

名前

型

説明

200 OK

Trigger

正常終了しました。

201 Created

Trigger

正常終了しました。

Other Status Codes

ErrorResponseModel

スキャンサービスから受信したエラー応答。

ヘッダー

x-ms-error-code: string

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントの借用

例

Triggers_CreateOrReplace

要求のサンプル

HTTP

PUT {endpoint}/scan/datasources/DataSource1/scans/Scan1/triggers/default?api-version=2023-09-01

{
  "properties": {
    "recurrenceInterval": null,
    "scanLevel": "Incremental",
    "state": "Enabled",
    "recurrence": {
      "startTime": "2021-02-12T14:59:00.416Z",
      "endTime": "2021-02-25T00:00:00.000Z",
      "interval": 1,
      "frequency": "Month",
      "schedule": {
        "hours": [
          23
        ],
        "minutes": [
          56
        ],
        "monthDays": [
          10
        ]
      }
    }
  }
}

応答のサンプル

状態コード:: 201

x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea888

{
  "name": "default",
  "id": "datasources/AzureBlob-DSTDParv/scans/Scan-PUl/triggers/default",
  "properties": {
    "recurrence": {
      "frequency": "Month",
      "interval": 4,
      "startTime": "2021-02-12T14:59:00.416Z",
      "endTime": "2021-02-25T00:00:00Z",
      "schedule": {
        "minutes": [
          56
        ],
        "hours": [
          23
        ],
        "weekDays": null,
        "monthDays": null,
        "monthlyOccurrences": [
          {
            "day": "Wednesday",
            "occurrence": 2
          }
        ]
      }
    },
    "recurrenceInterval": null,
    "createdAt": "2021-02-12T14:58:58.0478425Z",
    "lastModifiedAt": "2021-02-12T15:39:53.6482996Z",
    "lastScheduled": null,
    "scanLevel": "Incremental",
    "state": "Enabled"
  }
}

状態コード:: 200

x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea888

{
  "name": "default",
  "id": "datasources/AzureBlob-DSTDParv/scans/Scan-PUl/triggers/default",
  "properties": {
    "recurrence": {
      "frequency": "Month",
      "interval": 4,
      "startTime": "2021-02-12T14:59:00.416Z",
      "endTime": "2021-02-25T00:00:00Z",
      "schedule": {
        "minutes": [
          56
        ],
        "hours": [
          23
        ],
        "weekDays": null,
        "monthDays": null,
        "monthlyOccurrences": [
          {
            "day": "Wednesday",
            "occurrence": 2
          }
        ]
      }
    },
    "recurrenceInterval": null,
    "createdAt": "2021-02-12T14:58:58.0478425Z",
    "lastModifiedAt": "2021-02-12T15:39:53.6482996Z",
    "lastScheduled": null,
    "scanLevel": "Incremental",
    "state": "Enabled"
  }
}

定義

名前	説明
DayOfWeek	繰り返しスケジュールの発生日。
DaysOfWeek	定期的なスケジュールの曜日。
ErrorModel	エラーモデル。
ErrorResponseModel	エラー応答モデル。
RecurrenceSchedule	繰り返しのスケジュール。
RecurrenceScheduleOccurrence	繰り返しスケジュールの発生。
ScanLevelType	スキャンレベルの種類。
Trigger	トリガーオブジェクト。
TriggerFrequency	トリガーの繰り返しの頻度。
TriggerProperties	トリガーのプロパティの詳細。
TriggerRecurrence	トリガーの繰り返し。
TriggerState	トリガーの状態。

DayOfWeek

繰り返しスケジュールの発生日。

名前	型	説明
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

DaysOfWeek

定期的なスケジュールの曜日。

名前	型	説明
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

ErrorModel

エラーモデル。

名前	型	説明
code	string	特定のエラーを識別する一意のエラーコード。
details	ErrorModel[]	追加のエラーの詳細を提供する入れ子になった ErrorModel オブジェクトの配列。
message	string	エラーの詳細を示す、人間が判読できるエラーメッセージ。
target	string	エラーが関連付けられている特定のコンポーネント。

ErrorResponseModel

エラー応答モデル。

名前	型	説明
error	ErrorModel	エラーモデル。

RecurrenceSchedule

繰り返しのスケジュール。

名前	型	説明
hours	integer[]	繰り返しスケジュールの時間。
minutes	integer[]	繰り返しスケジュールの分数。
monthDays	integer[]	繰り返しスケジュールの月日。
monthlyOccurrences	RecurrenceScheduleOccurrence[]	繰り返しスケジュールの毎月の出現回数。
weekDays	DaysOfWeek[]	定期的なスケジュールの曜日。

RecurrenceScheduleOccurrence

繰り返しスケジュールの発生。

名前	型	説明
day	DayOfWeek	繰り返しスケジュールの発生日。
occurrence	integer

ScanLevelType

スキャンレベルの種類。

名前	型	説明
Full	string	スキャンがフルスキャンである
Incremental	string	スキャンが増分スキャンである

Trigger

トリガーオブジェクト。

名前	型	説明
id	string	リソース識別子。
name	string	リソースの名前。
properties	TriggerProperties	トリガーのプロパティ。
validationErrorInfo	string	トリガーの検証エラー情報。

TriggerFrequency

トリガーの繰り返しの頻度。

名前	型	説明
Day	string
Hour	string
Month	string
Week	string

TriggerProperties

トリガーのプロパティの詳細。

名前	型	規定値	説明
createdAt	string		トリガーの作成時刻。
incrementalScanStartTime	string		トリガーの増分スキャン開始時刻。
lastModifiedAt	string		トリガーの最終変更時刻。
lastScheduled	string		トリガーの最後にスケジュールされた時刻。
recurrence	TriggerRecurrence		トリガーの繰り返し。
recurrenceInterval	string		トリガーの繰り返し間隔。
scanLevel	ScanLevelType		トリガーのスキャンレベル。
state	TriggerState	Enabled	トリガーの状態。

TriggerRecurrence

トリガーの繰り返し。

名前	型	説明
endTime	string	トリガーの繰り返しの終了時刻。
frequency	TriggerFrequency	トリガーの繰り返しの頻度。
interval	integer	トリガーの繰り返しの間隔。
schedule	RecurrenceSchedule	トリガーの繰り返しのスケジュール。
startTime	string	トリガーの繰り返しの開始時刻。
timeZone	string	トリガーの繰り返しのタイムゾーン。

TriggerState

トリガーの状態。

名前	型	説明
Disabled	string
Enabled	string

次の方法で共有

Triggers - Create Or Replace

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

Triggers_CreateOrReplace

要求のサンプル

応答のサンプル

定義

DayOfWeek

DaysOfWeek

ErrorModel

ErrorResponseModel

RecurrenceSchedule

RecurrenceScheduleOccurrence

ScanLevelType

Trigger

TriggerFrequency

TriggerProperties

TriggerRecurrence

TriggerState

その他のリソース