Triggers - Create Or Replace

Dienst:

Purview

API-Version:

2023-09-01

Erstellt oder ersetzt einen instance eines Triggers.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
dataSourceName	path	True	string	Der Name von dataSource. RegEx-Muster: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$
endpoint	path	True	string url	Der Scanendpunkt Ihres Purview-Kontos. Beispiel: https://{accountName}.purview.azure.com.
scanName	path	True	string	Der Name der Überprüfung. RegEx-Muster: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$
api-version	query	True	string	Die zu verwendende API-Version.

Anforderungstext

Name	Typ	Beschreibung
properties	TriggerProperties	Die Eigenschaften des Triggers.
validationErrorInfo	string	Die Validierungsfehlerinformationen des Triggers.

Antworten

Name	Typ	Beschreibung
200 OK	Trigger	Erfolg.
201 Created	Trigger	Erfolg.
Other Status Codes	ErrorResponseModel	Eine Vom Überprüfungsdienst empfangene Fehlerantwort. Header x-ms-error-code: string

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Triggers_CreateOrReplace

Beispielanforderung

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
        ]
      }
    }
  }
}

Beispiel für eine Antwort

Statuscode:

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"
  }
}

Statuscode:

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"
  }
}

Definitionen

Name	Beschreibung
DayOfWeek	Der Tag des Vorkommens des Wiederholungszeitplans.
DaysOfWeek	Die Wochentage des Wiederholungszeitplans.
ErrorModel	Das Fehlermodell.
ErrorResponseModel	Das Fehlerantwortmodell.
RecurrenceSchedule	Zeitplan der Wiederholung.
RecurrenceScheduleOccurrence	Das Auftreten eines Wiederholungszeitplans.
ScanLevelType	Typ der Scanebene.
Trigger	Das Triggerobjekt.
TriggerFrequency	Die Häufigkeit der Triggerserie.
TriggerProperties	Eigenschaftendetails des Triggers.
TriggerRecurrence	Die Wiederholung des Triggers.
TriggerState	Der Status des Triggers.

DayOfWeek

Der Tag des Vorkommens des Wiederholungszeitplans.

Name	Typ	Beschreibung
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

DaysOfWeek

Die Wochentage des Wiederholungszeitplans.

Name	Typ	Beschreibung
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

ErrorModel

Das Fehlermodell.

Name	Typ	Beschreibung
code	string	Ein eindeutiger Fehlercode, der den spezifischen Fehler identifiziert.
details	ErrorModel[]	Ein Array geschachtelter ErrorModel-Objekte, das zusätzliche Fehlerdetails bereitstellt.
message	string	Eine lesbare Fehlermeldung, die weitere Details zum Fehler enthält.
target	string	Die spezifische Komponente, der der Fehler zugeordnet ist.

ErrorResponseModel

Das Fehlerantwortmodell.

Name	Typ	Beschreibung
error	ErrorModel	Das Fehlermodell.

RecurrenceSchedule

Zeitplan der Wiederholung.

Name	Typ	Beschreibung
hours	integer[]	Der Wiederholungszeitplan.
minutes	integer[]	Der Wiederholungszeitplan für Minuten.
monthDays	integer[]	Monatstage des Wiederholungszeitplans.
monthlyOccurrences	RecurrenceScheduleOccurrence[]	Die monatlichen Vorkommen des Wiederholungszeitplans.
weekDays	DaysOfWeek[]	Die Wochentage des Wiederholungszeitplans.

RecurrenceScheduleOccurrence

Das Auftreten eines Wiederholungszeitplans.

Name	Typ	Beschreibung
day	DayOfWeek	Der Tag des Vorkommens des Wiederholungszeitplans.
occurrence	integer

ScanLevelType

Typ der Scanebene.

Name	Typ	Beschreibung
Full	string	Der Scan ist eine vollständige Überprüfung.
Incremental	string	Die Überprüfung ist eine inkrementelle Überprüfung.

Trigger

Das Triggerobjekt.

Name	Typ	Beschreibung
id	string	Der Ressourcenbezeichner.
name	string	Der Name der Ressource.
properties	TriggerProperties	Die Eigenschaften des Triggers.
validationErrorInfo	string	Die Validierungsfehlerinformationen des Triggers.

TriggerFrequency

Die Häufigkeit der Triggerserie.

Name	Typ	Beschreibung
Day	string
Hour	string
Month	string
Week	string

TriggerProperties

Eigenschaftendetails des Triggers.

Name	Typ	Standardwert	Beschreibung
createdAt	string		Die Erstellungszeit des Triggers.
incrementalScanStartTime	string		Die Startzeit des Triggers für die inkrementelle Überprüfung.
lastModifiedAt	string		Der Zeitpunkt der letzten Änderung des Triggers.
lastScheduled	string		Der letzte geplante Zeitpunkt des Triggers.
recurrence	TriggerRecurrence		Die Wiederholung des Triggers.
recurrenceInterval	string		Das Wiederholungsintervall des Triggers.
scanLevel	ScanLevelType		Die Scanebene des Triggers.
state	TriggerState	Enabled	Der Status des Triggers.

TriggerRecurrence

Die Wiederholung des Triggers.

Name	Typ	Beschreibung
endTime	string	Die Endzeit der Triggerserie.
frequency	TriggerFrequency	Die Häufigkeit der Triggerserie.
interval	integer	Das Intervall der Triggerserie.
schedule	RecurrenceSchedule	Der Zeitplan der Triggerserie.
startTime	string	Die Startzeit der Triggerserie.
timeZone	string	Die Zeitzone der Triggerserie.

TriggerState

Der Status des Triggers.

Name	Typ	Beschreibung
Disabled	string
Enabled	string