Triggers - Create Or Replace

參考

服務:: Purview

API 版本:: 2023-09-01

建立或取代觸發程序的實例。

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

URI 參數

名稱	位於	必要	類型	Description
dataSourceName	path	True	string	dataSource 名稱。 Regex 模式: `^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$`
endpoint	path	True	string url	purview 帳戶的掃描端點。範例：https://{accountName}.purview.azure.com。
scanName	path	True	string	掃描名稱。 Regex 模式: `^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$`
api-version	query	True	string	要使用的 API 版本。

要求本文

名稱	類型	Description
properties	TriggerProperties	觸發程序的屬性。
validationErrorInfo	string	觸發程式的驗證錯誤資訊。

回應

名稱	類型	Description
200 OK	Trigger	成功。
201 Created	Trigger	成功。
Other Status Codes	ErrorResponseModel	從掃描服務收到的錯誤回應。標題 x-ms-error-code: string

名稱

類型

Description

200 OK

Trigger

成功。

201 Created

Trigger

成功。

Other Status Codes

ErrorResponseModel

從掃描服務收到的錯誤回應。

標題

x-ms-error-code: string

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
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"
  }
}

定義

名稱	Description
DayOfWeek	週期排程發生的日期。
DaysOfWeek	週期排程的星期幾。
ErrorModel	錯誤模型。
ErrorResponseModel	錯誤回應模型。
RecurrenceSchedule	週期排程。
RecurrenceScheduleOccurrence	週期排程的出現次數。
ScanLevelType	掃描層級類型。
Trigger	觸發程序物件。
TriggerFrequency	觸發程式週期的頻率。
TriggerProperties	觸發程式的屬性詳細數據。
TriggerRecurrence	觸發程序的週期。
TriggerState	觸發程序的狀態。

DayOfWeek

週期排程發生的日期。

名稱	類型	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

DaysOfWeek

週期排程的星期幾。

名稱	類型	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

ErrorModel

錯誤模型。

名稱	類型	Description
code	string	識別特定錯誤的唯一錯誤碼。
details	ErrorModel[]	提供其他錯誤詳細數據的巢狀 ErrorModel 物件陣列。
message	string	人類看得懂的錯誤訊息，可提供更多有關錯誤的詳細數據。
target	string	與錯誤相關聯的特定元件。

ErrorResponseModel

錯誤回應模型。

名稱	類型	Description
error	ErrorModel	錯誤模型。

RecurrenceSchedule

週期排程。

名稱	類型	Description
hours	integer[]	週期排程的時數。
minutes	integer[]	週期排程的分鐘數。
monthDays	integer[]	週期排程的月份天數。
monthlyOccurrences	RecurrenceScheduleOccurrence[]	週期排程的每月出現次數。
weekDays	DaysOfWeek[]	週期排程的星期幾。

RecurrenceScheduleOccurrence

週期排程的出現次數。

名稱	類型	Description
day	DayOfWeek	週期排程發生的日期。
occurrence	integer

ScanLevelType

掃描層級類型。

名稱	類型	Description
Full	string	掃描已完整掃描
Incremental	string	掃描是累加掃描

Trigger

觸發程序物件。

名稱	類型	Description
id	string	資源標識碼。
name	string	資源名稱。
properties	TriggerProperties	觸發程序的屬性。
validationErrorInfo	string	觸發程式的驗證錯誤資訊。

TriggerFrequency

觸發程式週期的頻率。

名稱	類型	Description
Day	string
Hour	string
Month	string
Week	string

TriggerProperties

觸發程式的屬性詳細數據。

名稱	類型	預設值	Description
createdAt	string		觸發程式的建立時間。
incrementalScanStartTime	string		觸發程式的累加掃描開始時間。
lastModifiedAt	string		觸發程式上次修改的時間。
lastScheduled	string		觸發程式的最後一個排程時間。
recurrence	TriggerRecurrence		觸發程序的週期。
recurrenceInterval	string		觸發程式的周期間隔。
scanLevel	ScanLevelType		觸發程式的掃描層級。
state	TriggerState	Enabled	觸發程序的狀態。

TriggerRecurrence

觸發程序的週期。

名稱	類型	Description
endTime	string	觸發程式週期的結束時間。
frequency	TriggerFrequency	觸發程式週期的頻率。
interval	integer	觸發程式週期的間隔。
schedule	RecurrenceSchedule	觸發程式週期的排程。
startTime	string	觸發程式週期的開始時間。
timeZone	string	觸發程式週期的時區。

TriggerState

觸發程序的狀態。

名稱	類型	Description
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

其他資源