Triggers - Create Or Update

Dienst:: Data Factory

API-Version:: 2018-06-01

Erstellt oder aktualisiert einen Trigger.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/triggers/{triggerName}?api-version=2018-06-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
factoryName	path	True	string minLength: 3 maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$	Der Werksname.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.
triggerName	path	True	string minLength: 1 maxLength: 260 pattern: ^[A-Za-z0-9_][^<>#.%&:\\+?/]$	Der Triggername.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
if-match		string	ETag der Triggerentität. Sollte nur für updates angegeben werden, für die sie mit der vorhandenen Entität übereinstimmen soll oder * für bedingungslose Updates sein kann.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties	True	Trigger: MultiplePipelineTrigger ChainingTrigger RerunTumblingWindowTrigger TumblingWindowTrigger BlobEventsTrigger BlobTrigger CustomEventsTrigger ScheduleTrigger	Eigenschaften des Triggers.

Antworten

Name	Typ	Beschreibung
200 OK	TriggerResource	Die Aktualisierung der Ressource 'TriggerResource' war erfolgreich
Other Status Codes	CloudError	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

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

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Triggers_Create

Triggers_Update

Triggers_Create

Beispielanforderung

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/triggers/exampleTrigger?api-version=2018-06-01

{
  "properties": {
    "type": "ScheduleTrigger",
    "pipelines": [
      {
        "parameters": {
          "OutputBlobNameList": [
            "exampleoutput.csv"
          ]
        },
        "pipelineReference": {
          "type": "PipelineReference",
          "referenceName": "examplePipeline"
        }
      }
    ],
    "typeProperties": {
      "recurrence": {
        "endTime": "2018-06-16T00:55:13.8441801Z",
        "frequency": "Minute",
        "interval": 4,
        "startTime": "2018-06-16T00:39:13.8441801Z",
        "timeZone": "UTC"
      }
    }
  }
}


import com.azure.core.management.serializer.SerializerFactory;
import com.azure.core.util.serializer.SerializerEncoding;
import com.azure.resourcemanager.datafactory.models.PipelineReference;
import com.azure.resourcemanager.datafactory.models.PipelineReferenceType;
import com.azure.resourcemanager.datafactory.models.RecurrenceFrequency;
import com.azure.resourcemanager.datafactory.models.ScheduleTrigger;
import com.azure.resourcemanager.datafactory.models.ScheduleTriggerRecurrence;
import com.azure.resourcemanager.datafactory.models.TriggerPipelineReference;
import java.io.IOException;
import java.time.OffsetDateTime;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Triggers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2018-06-01/Triggers_Create.json
     */
    /**
     * Sample code: Triggers_Create.
     * 
     * @param manager Entry point to DataFactoryManager.
     */
    public static void triggersCreate(com.azure.resourcemanager.datafactory.DataFactoryManager manager)
        throws IOException {
        manager.triggers().define("exampleTrigger").withExistingFactory("exampleResourceGroup", "exampleFactoryName")
            .withProperties(new ScheduleTrigger()
                .withPipelines(Arrays.asList(new TriggerPipelineReference()
                    .withPipelineReference(new PipelineReference().withType(PipelineReferenceType.PIPELINE_REFERENCE)
                        .withReferenceName("examplePipeline"))
                    .withParameters(mapOf("OutputBlobNameList",
                        SerializerFactory.createDefaultManagementSerializerAdapter()
                            .deserialize("[\"exampleoutput.csv\"]", Object.class, SerializerEncoding.JSON)))))
                .withRecurrence(new ScheduleTriggerRecurrence().withFrequency(RecurrenceFrequency.MINUTE)
                    .withInterval(4).withStartTime(OffsetDateTime.parse("2018-06-16T00:39:13.8441801Z"))
                    .withEndTime(OffsetDateTime.parse("2018-06-16T00:55:13.8441801Z")).withTimeZone("UTC")
                    .withAdditionalProperties(mapOf())))
            .create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.datafactory import DataFactoryManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-datafactory
# USAGE
    python triggers_create.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DataFactoryManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="12345678-1234-1234-1234-12345678abc",
    )

    response = client.triggers.create_or_update(
        resource_group_name="exampleResourceGroup",
        factory_name="exampleFactoryName",
        trigger_name="exampleTrigger",
        trigger={
            "properties": {
                "pipelines": [
                    {
                        "parameters": {"OutputBlobNameList": ["exampleoutput.csv"]},
                        "pipelineReference": {"referenceName": "examplePipeline", "type": "PipelineReference"},
                    }
                ],
                "type": "ScheduleTrigger",
                "typeProperties": {
                    "recurrence": {
                        "endTime": "2018-06-16T00:55:13.8441801Z",
                        "frequency": "Minute",
                        "interval": 4,
                        "startTime": "2018-06-16T00:39:13.8441801Z",
                        "timeZone": "UTC",
                    }
                },
            }
        },
    )
    print(response)


# x-ms-original-file: specification/datafactory/resource-manager/Microsoft.DataFactory/DataFactory/stable/2018-06-01/examples/Triggers_Create.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.DataFactory.Models;
using Azure.ResourceManager.DataFactory;

// Generated from example definition: specification/datafactory/resource-manager/Microsoft.DataFactory/DataFactory/stable/2018-06-01/examples/Triggers_Create.json
// this example is just showing the usage of "Triggers_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this DataFactoryTriggerResource created on azure
// for more information of creating DataFactoryTriggerResource, please refer to the document of DataFactoryTriggerResource
string subscriptionId = "12345678-1234-1234-1234-12345678abc";
string resourceGroupName = "exampleResourceGroup";
string factoryName = "exampleFactoryName";
string triggerName = "exampleTrigger";
ResourceIdentifier dataFactoryTriggerResourceId = DataFactoryTriggerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, factoryName, triggerName);
DataFactoryTriggerResource dataFactoryTrigger = client.GetDataFactoryTriggerResource(dataFactoryTriggerResourceId);

// invoke the operation
DataFactoryTriggerData data = new DataFactoryTriggerData(new DataFactoryScheduleTrigger(new ScheduleTriggerRecurrence
{
    Frequency = DataFactoryRecurrenceFrequency.Minute,
    Interval = 4,
    StartOn = DateTimeOffset.Parse("2018-06-16T00:39:13.8441801Z"),
    EndOn = DateTimeOffset.Parse("2018-06-16T00:55:13.8441801Z"),
    TimeZone = "UTC",
})
{
    Pipelines = {new TriggerPipelineReference
    {
    PipelineReference = new DataFactoryPipelineReference(DataFactoryPipelineReferenceType.PipelineReference, "examplePipeline"),
    Parameters =
    {
    ["OutputBlobNameList"] = BinaryData.FromObjectAsJson(new object[]
    {
    "exampleoutput.csv"
    })
    },
    }},
});
ArmOperation<DataFactoryTriggerResource> lro = await dataFactoryTrigger.UpdateAsync(WaitUntil.Completed, data);
DataFactoryTriggerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
DataFactoryTriggerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

Date: Sat, 16 Jun 2018 00:40:14 GMT
X-Content-Type-Options: nosniff
x-ms-correlation-request-id: 373f1a49-685d-4c07-8857-0fcf1bcaffcb
x-ms-ratelimit-remaining-subscription-writes: 1186
x-ms-request-id: 373f1a49-685d-4c07-8857-0fcf1bcaffcb

{
  "name": "exampleTrigger",
  "type": "Microsoft.DataFactory/factories/triggers",
  "etag": "0a008ad4-0000-0000-0000-5b245c6e0000",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/triggers/exampleTrigger",
  "properties": {
    "type": "ScheduleTrigger",
    "pipelines": [
      {
        "parameters": {
          "OutputBlobNameList": [
            "exampleoutput.csv"
          ]
        },
        "pipelineReference": {
          "type": "PipelineReference",
          "referenceName": "examplePipeline"
        }
      }
    ],
    "runtimeState": "Stopped",
    "typeProperties": {
      "recurrence": {
        "endTime": "2018-06-16T00:55:13.8441801Z",
        "frequency": "Minute",
        "interval": 4,
        "startTime": "2018-06-16T00:39:13.8441801Z",
        "timeZone": "UTC"
      }
    }
  }
}

Triggers_Update

Beispielanforderung

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/triggers/exampleTrigger?api-version=2018-06-01

{
  "properties": {
    "type": "ScheduleTrigger",
    "description": "Example description",
    "pipelines": [
      {
        "parameters": {
          "OutputBlobNameList": [
            "exampleoutput.csv"
          ]
        },
        "pipelineReference": {
          "type": "PipelineReference",
          "referenceName": "examplePipeline"
        }
      }
    ],
    "typeProperties": {
      "recurrence": {
        "endTime": "2018-06-16T00:55:14.905167Z",
        "frequency": "Minute",
        "interval": 4,
        "startTime": "2018-06-16T00:39:14.905167Z",
        "timeZone": "UTC"
      }
    }
  }
}


import com.azure.core.management.serializer.SerializerFactory;
import com.azure.core.util.serializer.SerializerEncoding;
import com.azure.resourcemanager.datafactory.models.PipelineReference;
import com.azure.resourcemanager.datafactory.models.PipelineReferenceType;
import com.azure.resourcemanager.datafactory.models.RecurrenceFrequency;
import com.azure.resourcemanager.datafactory.models.ScheduleTrigger;
import com.azure.resourcemanager.datafactory.models.ScheduleTriggerRecurrence;
import com.azure.resourcemanager.datafactory.models.TriggerPipelineReference;
import com.azure.resourcemanager.datafactory.models.TriggerResource;
import java.io.IOException;
import java.time.OffsetDateTime;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Triggers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2018-06-01/Triggers_Update.json
     */
    /**
     * Sample code: Triggers_Update.
     * 
     * @param manager Entry point to DataFactoryManager.
     */
    public static void triggersUpdate(com.azure.resourcemanager.datafactory.DataFactoryManager manager)
        throws IOException {
        TriggerResource resource = manager.triggers().getWithResponse("exampleResourceGroup", "exampleFactoryName",
            "exampleTrigger", null, com.azure.core.util.Context.NONE).getValue();
        resource.update()
            .withProperties(new ScheduleTrigger().withDescription("Example description")
                .withPipelines(Arrays.asList(new TriggerPipelineReference()
                    .withPipelineReference(new PipelineReference().withType(PipelineReferenceType.PIPELINE_REFERENCE)
                        .withReferenceName("examplePipeline"))
                    .withParameters(mapOf("OutputBlobNameList",
                        SerializerFactory.createDefaultManagementSerializerAdapter()
                            .deserialize("[\"exampleoutput.csv\"]", Object.class, SerializerEncoding.JSON)))))
                .withRecurrence(new ScheduleTriggerRecurrence().withFrequency(RecurrenceFrequency.MINUTE)
                    .withInterval(4).withStartTime(OffsetDateTime.parse("2018-06-16T00:39:14.905167Z"))
                    .withEndTime(OffsetDateTime.parse("2018-06-16T00:55:14.905167Z")).withTimeZone("UTC")
                    .withAdditionalProperties(mapOf())))
            .apply();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.datafactory import DataFactoryManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-datafactory
# USAGE
    python triggers_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DataFactoryManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="12345678-1234-1234-1234-12345678abc",
    )

    response = client.triggers.create_or_update(
        resource_group_name="exampleResourceGroup",
        factory_name="exampleFactoryName",
        trigger_name="exampleTrigger",
        trigger={
            "properties": {
                "description": "Example description",
                "pipelines": [
                    {
                        "parameters": {"OutputBlobNameList": ["exampleoutput.csv"]},
                        "pipelineReference": {"referenceName": "examplePipeline", "type": "PipelineReference"},
                    }
                ],
                "type": "ScheduleTrigger",
                "typeProperties": {
                    "recurrence": {
                        "endTime": "2018-06-16T00:55:14.905167Z",
                        "frequency": "Minute",
                        "interval": 4,
                        "startTime": "2018-06-16T00:39:14.905167Z",
                        "timeZone": "UTC",
                    }
                },
            }
        },
    )
    print(response)


# x-ms-original-file: specification/datafactory/resource-manager/Microsoft.DataFactory/DataFactory/stable/2018-06-01/examples/Triggers_Update.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.DataFactory.Models;
using Azure.ResourceManager.DataFactory;

// Generated from example definition: specification/datafactory/resource-manager/Microsoft.DataFactory/DataFactory/stable/2018-06-01/examples/Triggers_Update.json
// this example is just showing the usage of "Triggers_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this DataFactoryTriggerResource created on azure
// for more information of creating DataFactoryTriggerResource, please refer to the document of DataFactoryTriggerResource
string subscriptionId = "12345678-1234-1234-1234-12345678abc";
string resourceGroupName = "exampleResourceGroup";
string factoryName = "exampleFactoryName";
string triggerName = "exampleTrigger";
ResourceIdentifier dataFactoryTriggerResourceId = DataFactoryTriggerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, factoryName, triggerName);
DataFactoryTriggerResource dataFactoryTrigger = client.GetDataFactoryTriggerResource(dataFactoryTriggerResourceId);

// invoke the operation
DataFactoryTriggerData data = new DataFactoryTriggerData(new DataFactoryScheduleTrigger(new ScheduleTriggerRecurrence
{
    Frequency = DataFactoryRecurrenceFrequency.Minute,
    Interval = 4,
    StartOn = DateTimeOffset.Parse("2018-06-16T00:39:14.905167Z"),
    EndOn = DateTimeOffset.Parse("2018-06-16T00:55:14.905167Z"),
    TimeZone = "UTC",
})
{
    Pipelines = {new TriggerPipelineReference
    {
    PipelineReference = new DataFactoryPipelineReference(DataFactoryPipelineReferenceType.PipelineReference, "examplePipeline"),
    Parameters =
    {
    ["OutputBlobNameList"] = BinaryData.FromObjectAsJson(new object[]
    {
    "exampleoutput.csv"
    })
    },
    }},
    Description = "Example description",
});
ArmOperation<DataFactoryTriggerResource> lro = await dataFactoryTrigger.UpdateAsync(WaitUntil.Completed, data);
DataFactoryTriggerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
DataFactoryTriggerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

Date: Sat, 16 Jun 2018 00:40:15 GMT
X-Content-Type-Options: nosniff
x-ms-correlation-request-id: d5ccf096-0618-4b26-9829-db77e4c391c7
x-ms-ratelimit-remaining-subscription-writes: 1185
x-ms-request-id: d5ccf096-0618-4b26-9829-db77e4c391c7

{
  "name": "exampleTrigger",
  "type": "Microsoft.DataFactory/factories/triggers",
  "etag": "0a008dd4-0000-0000-0000-5b245c6f0000",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/triggers/exampleTrigger",
  "properties": {
    "type": "ScheduleTrigger",
    "description": "Example description",
    "pipelines": [
      {
        "parameters": {
          "OutputBlobNameList": [
            "exampleoutput.csv"
          ]
        },
        "pipelineReference": {
          "type": "PipelineReference",
          "referenceName": "examplePipeline"
        }
      }
    ],
    "runtimeState": "Stopped",
    "typeProperties": {
      "recurrence": {
        "endTime": "2018-06-16T00:55:14.905167Z",
        "frequency": "Minute",
        "interval": 4,
        "startTime": "2018-06-16T00:39:14.905167Z",
        "timeZone": "UTC"
      }
    }
  }
}

Definitionen

Name	Beschreibung
BlobEventsTrigger	Trigger, der bei jedem Auftreten eines Blob-Ereignisses ausgeführt wird.
BlobEventTypes
BlobTrigger	Trigger, der bei jeder Änderung des ausgewählten Blobcontainers ausgeführt wird.
ChainingTrigger	Trigger, der es der referenzierten Pipeline ermöglicht, von anderen Pipelineausführungen abhängig zu sein, basierend auf runDimension Name/Value-Paaren. Vorgelagerte Pipelines sollten denselben runDimension-Namen deklarieren, und ihre Ausführung sollte die Werte für diese runDimensions aufweisen. Die Ausführung der referenzierten Pipeline würde ausgelöst, wenn die Werte für die runDimension-Übereinstimmung für alle upstream-Pipelineläufe ausgeführt werden.
CloudError	Das Objekt, das die Struktur einer Azure Data Factory-Fehlerantwort definiert.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
CustomEventsTrigger	Trigger, der jedes Mal ausgeführt wird, wenn ein benutzerdefiniertes Ereignis empfangen wird.
DayOfWeek	Die Wochentage.
DaysOfWeek
LinkedServiceReference	Verknüpfter Dienstverweistyp.
MultiplePipelineTrigger	Basisklasse für alle Trigger, die ein bis viele Modell für trigger to pipeline unterstützen.
PipelineReference	Pipelineverweistyp.
PipelineReferenceType	Pipelineverweistyp.
RecurrenceFrequency	Listet mögliche Frequenzoptionen für den Schedule-Trigger auf.
RecurrenceSchedule	Der Terminplan der Serie.
RecurrenceScheduleOccurrence	Das Auftreten des Wiederholungszeitplans.
RerunTumblingWindowTrigger	Trigger, der Pipeline-Wiederholungen für alle Fenster mit festen Zeitintervallen von einer angeforderten Startzeit bis zur angeforderten Endzeit plant.
RetryPolicy	Ausführungsrichtlinie für eine Aktivität.
ScheduleTrigger	Trigger, der Pipeline erstellt, wird regelmäßig nach Zeitplan ausgeführt.
ScheduleTriggerRecurrence	Der Workflow-Auslöser für die Wiederholung.
SelfDependencyTumblingWindowTriggerReference	Selbstverweis auf das Tumbling-Fenster löst Abhängigkeit aus.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
TriggerDependencyReference	Trigger, auf die verwiesen wird, Abhängigkeit.
TriggerPipelineReference	Pipeline, die mit den angegebenen Parametern ausgelöst werden muss.
TriggerReference	Triggerverweistyp.
TriggerReferenceType	Triggerverweistyp.
TriggerResource	Ressourcentyp auslösen.
TriggerRuntimeState	Listet den möglichen Zustand von Triggern auf.
TumblingWindowFrequency	Zählt die mögliche Frequenzoption für den Trigger-Tumbling-Fenster auf.
TumblingWindowTrigger	Trigger, der die Pipeline für alle fenster mit festen Zeitintervallen ab einer Startzeit ohne Lücken ausführt und auch Backfill-Szenarien unterstützt (wenn die Startzeit in der Vergangenheit liegt).
TumblingWindowTriggerDependencyReference	Referenzierte Sturzfenster lösen Abhängigkeit aus.
Type	Verknüpfter Dienstverweistyp.

BlobEventsTrigger

Objekt

Trigger, der bei jedem Auftreten eines Blob-Ereignisses ausgeführt wird.

Name	Typ	Beschreibung
annotations	Trigger.Annotations[]	Liste der Tags, die zum Beschreiben des Triggers verwendet werden können.
description	string	Triggerbeschreibung.
pipelines	TriggerPipelineReference[]	Pipelines, die gestartet werden müssen.
runtimeState	TriggerRuntimeState	Gibt an, ob trigger ausgeführt wird oder nicht. Aktualisiert, wenn Start-/Stopp-APIs für den Trigger aufgerufen werden.
type	string: BlobEventsTrigger	Triggertyp.
typeProperties.blobPathBeginsWith	string	Der BLOB-Pfad muss mit dem Muster beginnen, das zum Auslösen vorgesehen ist. Beispielsweise löst "/records/blobs/december/" nur den Trigger für Blobs im Dezemberordner unter dem Datensatzcontainer aus. Mindestens eine dieser Elemente muss bereitgestellt werden: blobPathBeginsWith, blobPathEndsWith.
typeProperties.blobPathEndsWith	string	Der BLOB-Pfad muss mit dem Muster enden, das zum Auslösen vorgesehen ist. Beispielsweise löst "dezember/boxes.csv" nur den Auslöser für Blobs benannter Felder in einem Dezemberordner aus. Mindestens eine dieser Elemente muss bereitgestellt werden: blobPathBeginsWith, blobPathEndsWith.
typeProperties.events	BlobEventTypes[]	Die Arten von Ereignissen, die diesen Trigger auslösen.
typeProperties.ignoreEmptyBlobs	boolean	Wenn dieser Wert auf "true" festgelegt ist, werden Blobs mit null Bytes ignoriert.
typeProperties.scope	string	Die ARM-Ressourcen-ID des Speicherkontos.

BlobEventTypes

Enumeration

Wert	Beschreibung
Microsoft.Storage.BlobCreated	Microsoft.Storage.BlobCreated
Microsoft.Storage.BlobDeleted	Microsoft.Storage.BlobDeleted

BlobTrigger

Objekt

Trigger, der bei jeder Änderung des ausgewählten Blobcontainers ausgeführt wird.

Name	Typ	Beschreibung
annotations	Trigger.Annotations[]	Liste der Tags, die zum Beschreiben des Triggers verwendet werden können.
description	string	Triggerbeschreibung.
pipelines	TriggerPipelineReference[]	Pipelines, die gestartet werden müssen.
runtimeState	TriggerRuntimeState	Gibt an, ob trigger ausgeführt wird oder nicht. Aktualisiert, wenn Start-/Stopp-APIs für den Trigger aufgerufen werden.
type	string: BlobTrigger	Triggertyp.
typeProperties.folderPath	string	Der Pfad des Containers/Ordners, der die Pipeline auslöst.
typeProperties.linkedService	LinkedServiceReference	Der Verweis auf den verknüpften Azure Storage-Dienst.
typeProperties.maxConcurrency	integer (int32)	Die maximale Anzahl paralleler Dateien, die verarbeitet werden sollen, wenn sie ausgelöst wird.

ChainingTrigger

Objekt

Trigger, der es der referenzierten Pipeline ermöglicht, von anderen Pipelineausführungen abhängig zu sein, basierend auf runDimension Name/Value-Paaren. Vorgelagerte Pipelines sollten denselben runDimension-Namen deklarieren, und ihre Ausführung sollte die Werte für diese runDimensions aufweisen. Die Ausführung der referenzierten Pipeline würde ausgelöst, wenn die Werte für die runDimension-Übereinstimmung für alle upstream-Pipelineläufe ausgeführt werden.

Name	Typ	Beschreibung
annotations	Trigger.Annotations[]	Liste der Tags, die zum Beschreiben des Triggers verwendet werden können.
description	string	Triggerbeschreibung.
pipeline	TriggerPipelineReference	Pipeline, für die ausgeführt wird, wenn alle upstream-Pipelines erfolgreich abgeschlossen werden.
runtimeState	TriggerRuntimeState	Gibt an, ob trigger ausgeführt wird oder nicht. Aktualisiert, wenn Start-/Stopp-APIs für den Trigger aufgerufen werden.
type	string: ChainingTrigger	Triggertyp.
typeProperties.dependsOn	PipelineReference[]	Vorgelagerte Pipelines.
typeProperties.runDimension	string	Führen Sie die Dimension-Eigenschaft aus, die von vorgelagerten Pipelines ausgegeben werden muss.

CloudError

Objekt

Das Objekt, das die Struktur einer Azure Data Factory-Fehlerantwort definiert.

Name	Typ	Beschreibung
error.code	string	Fehlercode.
error.details	CloudError[]	Array mit zusätzlichen Fehlerdetails.
error.message	string	Fehlermeldung.
error.target	string	Eigenschaftsname/Pfad in Anforderung, die fehler zugeordnet ist.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

CustomEventsTrigger

Objekt

Trigger, der jedes Mal ausgeführt wird, wenn ein benutzerdefiniertes Ereignis empfangen wird.

Name	Typ	Beschreibung
annotations	Trigger.Annotations[]	Liste der Tags, die zum Beschreiben des Triggers verwendet werden können.
description	string	Triggerbeschreibung.
pipelines	TriggerPipelineReference[]	Pipelines, die gestartet werden müssen.
runtimeState	TriggerRuntimeState	Gibt an, ob trigger ausgeführt wird oder nicht. Aktualisiert, wenn Start-/Stopp-APIs für den Trigger aufgerufen werden.
type	string: CustomEventsTrigger	Triggertyp.
typeProperties.events	CustomEventsTriggerTypeProperties.Events[]	Die Liste der Ereignistypen, die dazu führen, dass dieser Trigger ausgelöst wird.
typeProperties.scope	string	Die ARM-Ressourcen-ID des Azure Event Grid-Themas.
typeProperties.subjectBeginsWith	string	Der Betreff des Ereignisses muss mit dem Muster beginnen, das zum Auslösen vorgesehen ist. Mindestens eine dieser Angaben muss bereitgestellt werden: subjectBeginsWith, subjectEndsWith.
typeProperties.subjectEndsWith	string	Der Betreff des Ereignisses muss mit dem Muster enden, das zum Auslösen vorgesehen ist. Mindestens eine dieser Angaben muss bereitgestellt werden: subjectBeginsWith, subjectEndsWith.

DayOfWeek

Enumeration

Die Wochentage.

Wert	Beschreibung
Sunday	Sonntag
Monday	Monday
Tuesday	Dienstag
Wednesday	Wednesday
Thursday	Thursday
Friday	Freitag
Saturday	Samstag

DaysOfWeek

Enumeration

Wert	Beschreibung
Sunday	Sonntag
Monday	Monday
Tuesday	Dienstag
Wednesday	Wednesday
Thursday	Thursday
Friday	Freitag
Saturday	Samstag

LinkedServiceReference

Objekt

Verknüpfter Dienstverweistyp.

Name	Typ	Beschreibung
parameters		Argumente für LinkedService.
referenceName	string	Verweisverknüpfungsname.
type	Type	Verknüpfter Dienstverweistyp.

MultiplePipelineTrigger

Objekt

Basisklasse für alle Trigger, die ein bis viele Modell für trigger to pipeline unterstützen.

Name	Typ	Beschreibung
annotations	Trigger.Annotations[]	Liste der Tags, die zum Beschreiben des Triggers verwendet werden können.
description	string	Triggerbeschreibung.
pipelines	TriggerPipelineReference[]	Pipelines, die gestartet werden müssen.
runtimeState	TriggerRuntimeState	Gibt an, ob trigger ausgeführt wird oder nicht. Aktualisiert, wenn Start-/Stopp-APIs für den Trigger aufgerufen werden.
type	string: MultiplePipelineTrigger	Triggertyp.

PipelineReference

Objekt

Pipelineverweistyp.

Name	Typ	Beschreibung
name	string	Verweisname.
referenceName	string	Referenzpipelinename.
type	PipelineReferenceType	Pipelineverweistyp.

PipelineReferenceType

Enumeration

Pipelineverweistyp.

Wert	Beschreibung
PipelineReference	PipelineReference

RecurrenceFrequency

Enumeration

Listet mögliche Frequenzoptionen für den Schedule-Trigger auf.

Wert	Beschreibung
NotSpecified	Nicht angegeben
Minute	Minute
Hour	Stunde
Day	Tag
Week	Woche
Month	Monat
Year	Jahr

RecurrenceSchedule

Objekt

Der Terminplan der Serie.

Name	Typ	Beschreibung
hours	integer[] (int32)	Die Stunden.
minutes	integer[] (int32)	Die Minuten.
monthDays	integer[] (int32)	Die Monatstage.
monthlyOccurrences	RecurrenceScheduleOccurrence[]	Die monatlichen Vorkommen.
weekDays	DaysOfWeek[]	Die Wochentage.

RecurrenceScheduleOccurrence

Objekt

Das Auftreten des Wiederholungszeitplans.

Name	Typ	Beschreibung
day	DayOfWeek	Der Wochentag.
occurrence	integer (int32)	Das Vorkommen.

RerunTumblingWindowTrigger

Objekt

Trigger, der Pipeline-Wiederholungen für alle Fenster mit festen Zeitintervallen von einer angeforderten Startzeit bis zur angeforderten Endzeit plant.

Name	Typ	Beschreibung
annotations	Trigger.Annotations[]	Liste der Tags, die zum Beschreiben des Triggers verwendet werden können.
description	string	Triggerbeschreibung.
runtimeState	TriggerRuntimeState	Gibt an, ob trigger ausgeführt wird oder nicht. Aktualisiert, wenn Start-/Stopp-APIs für den Trigger aufgerufen werden.
type	string: RerunTumblingWindowTrigger	Triggertyp.
typeProperties.parentTrigger		Der übergeordnete Triggerverweis.
typeProperties.requestedEndTime	string (date-time)	Die Endzeit für den Zeitraum, für den die Restatement initiiert wird. Zurzeit wird nur UTC-Zeit unterstützt.
typeProperties.requestedStartTime	string (date-time)	Die Startzeit für den Zeitraum, für den die Restatement initiiert wird. Zurzeit wird nur UTC-Zeit unterstützt.
typeProperties.rerunConcurrency	integer (int32) minimum: 1 maximum: 50	Die maximale Anzahl paralleler Zeitfenster (bereit für die Ausführung), für die eine erneute Ausführung ausgelöst wird.

RetryPolicy

Objekt

Ausführungsrichtlinie für eine Aktivität.

Name	Typ	Beschreibung
count		Maximale normale Wiederholungsversuche. Standard ist "0". Typ: ganze Zahl (oder Ausdruck mit ganzzahliger Ergebnistyp), Minimum: 0.
intervalInSeconds	integer (int32) minimum: 30 maximum: 86400	Intervall zwischen Wiederholungsversuchen in Sekunden. Der Standardwert ist 30.

ScheduleTrigger

Objekt

Trigger, der Pipeline erstellt, wird regelmäßig nach Zeitplan ausgeführt.

Name	Typ	Beschreibung
annotations	Trigger.Annotations[]	Liste der Tags, die zum Beschreiben des Triggers verwendet werden können.
description	string	Triggerbeschreibung.
pipelines	TriggerPipelineReference[]	Pipelines, die gestartet werden müssen.
runtimeState	TriggerRuntimeState	Gibt an, ob trigger ausgeführt wird oder nicht. Aktualisiert, wenn Start-/Stopp-APIs für den Trigger aufgerufen werden.
type	string: ScheduleTrigger	Triggertyp.
typeProperties.recurrence	ScheduleTriggerRecurrence	Terminplankonfiguration für Serien.

ScheduleTriggerRecurrence

Objekt

Der Workflow-Auslöser für die Wiederholung.

Name	Typ	Beschreibung
endTime	string (date-time)	Die Endzeit.
frequency	RecurrenceFrequency	Die Häufigkeit.
interval	integer (int32)	Das Intervall.
schedule	RecurrenceSchedule	Der Terminplan der Serie.
startTime	string (date-time)	Die Startzeit.
timeZone	string	Die Zeitzone.

SelfDependencyTumblingWindowTriggerReference

Objekt

Selbstverweis auf das Tumbling-Fenster löst Abhängigkeit aus.

Name	Typ	Beschreibung
offset	string minLength: 8 maxLength: 15 pattern: -((\d+)\.)?(\d\d):(60\|([0-5][0-9])):(60\|([0-5][0-9]))	Der Zeitbereich, der beim Auswerten der Abhängigkeit auf die Startzeit eines Stürzenfensters angewendet wird.
size	string minLength: 8 maxLength: 15 pattern: ((\d+)\.)?(\d\d):(60\|([0-5][0-9])):(60\|([0-5][0-9]))	Die Größe des Fensters beim Auswerten der Abhängigkeit. Wenn die Häufigkeit des Sturzfensters nicht definiert ist, wird verwendet.
type	string: SelfDependencyTumblingWindowTriggerReference	Der Typ des Abhängigkeitsverweises.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

TriggerDependencyReference

Objekt

Trigger, auf die verwiesen wird, Abhängigkeit.

Name	Typ	Beschreibung
referenceTrigger	TriggerReference	Referenzierter Trigger.
type	string: TriggerDependencyReference	Der Typ des Abhängigkeitsverweises.

TriggerPipelineReference

Objekt

Pipeline, die mit den angegebenen Parametern ausgelöst werden muss.

Name	Typ	Beschreibung
parameters		Pipelineparameter.
pipelineReference	PipelineReference	Pipelineverweis.

TriggerReference

Objekt

Triggerverweistyp.

Name	Typ	Beschreibung
referenceName	string	Verweistriggername.
type	TriggerReferenceType	Triggerverweistyp.

TriggerReferenceType

Enumeration

Triggerverweistyp.

Wert	Beschreibung
TriggerReference	TriggerReference

TriggerResource

Objekt

Ressourcentyp auslösen.

Name	Typ	Beschreibung
etag	string	"Wenn etag im Antworttext bereitgestellt wird, kann es auch als Header gemäß der normalen etag-Konvention bereitgestellt werden. Entitätstags werden zum Vergleichen von zwei oder mehr Entitäten aus derselben angeforderten Ressource verwendet. HTTP/1.1 verwendet Entity-Tags in den Header-Feldern etag (Abschnitt 14.19), If-Match (Abschnitt 14.24), If-None-Match (Abschnitt 14.26) und If-Range (Abschnitt 14.27).")
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties	Trigger: BlobEventsTrigger BlobTrigger ChainingTrigger CustomEventsTrigger MultiplePipelineTrigger RerunTumblingWindowTrigger ScheduleTrigger TumblingWindowTrigger	Eigenschaften des Triggers.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

TriggerRuntimeState

Enumeration

Listet den möglichen Zustand von Triggern auf.

Wert	Beschreibung
Started	Gestartet
Stopped	Angehalten
Disabled	Deaktiviert

TumblingWindowFrequency

Enumeration

Zählt die mögliche Frequenzoption für den Trigger-Tumbling-Fenster auf.

Wert	Beschreibung
Minute	Minute
Hour	Stunde
Month	Monat

TumblingWindowTrigger

Objekt

Trigger, der die Pipeline für alle fenster mit festen Zeitintervallen ab einer Startzeit ohne Lücken ausführt und auch Backfill-Szenarien unterstützt (wenn die Startzeit in der Vergangenheit liegt).

Name	Typ	Beschreibung
annotations	Trigger.Annotations[]	Liste der Tags, die zum Beschreiben des Triggers verwendet werden können.
description	string	Triggerbeschreibung.
pipeline	TriggerPipelineReference	Pipeline, für die ausgeführt wird, wenn ein Ereignis für triggerfenster ausgelöst wird, das bereit ist.
runtimeState	TriggerRuntimeState	Gibt an, ob trigger ausgeführt wird oder nicht. Aktualisiert, wenn Start-/Stopp-APIs für den Trigger aufgerufen werden.
type	string: TumblingWindowTrigger	Triggertyp.
typeProperties.delay		Gibt an, wie lange der Trigger überfällig wartet, bevor eine neue Ausführung ausgelöst wird. Es ändert die Start- und Endzeit des Fensters nicht. Der Standardwert lautet 0. Typ: Zeichenfolge (oder Ausdruck mit resultType-Zeichenfolge), Muster: (\d+).)? (\d\d):(60\|( [0-5][0-9])):(60\|( [0-5][0-9])).
typeProperties.dependsOn	DependencyReference[]: SelfDependencyTumblingWindowTriggerReference[] TriggerDependencyReference[] TumblingWindowTriggerDependencyReference[]	Trigger, von denen dieser Auslöser abhängig ist. Es werden nur Tumbling-Fenstertrigger unterstützt.
typeProperties.endTime	string (date-time)	Die Endzeit für den Zeitraum für den Trigger, in dem Ereignisse für Fenster ausgelöst werden, die bereit sind. Zurzeit wird nur UTC-Zeit unterstützt.
typeProperties.frequency	TumblingWindowFrequency	Die Häufigkeit der Zeitfenster.
typeProperties.interval	integer (int32)	Das Intervall der Zeitfenster. Das mindest zulässige Intervall beträgt 15 Minuten.
typeProperties.maxConcurrency	integer (int32) minimum: 1 maximum: 50	Die maximale Anzahl paralleler Zeitfenster (bereit für die Ausführung), für die eine neue Ausführung ausgelöst wird.
typeProperties.retryPolicy	RetryPolicy	Wiederholen Sie die Richtlinie, die für fehlgeschlagene Pipelineausführungen angewendet wird.
typeProperties.startTime	string (date-time)	Die Startzeit für den Zeitraum für den Trigger, in dem Ereignisse für Fenster ausgelöst werden, die bereit sind. Zurzeit wird nur UTC-Zeit unterstützt.

TumblingWindowTriggerDependencyReference

Objekt

Referenzierte Sturzfenster lösen Abhängigkeit aus.

Name	Typ	Beschreibung
offset	string minLength: 8 maxLength: 15 pattern: -?((\d+)\.)?(\d\d):(60\|([0-5][0-9])):(60\|([0-5][0-9]))	Der Zeitbereich, der beim Auswerten der Abhängigkeit auf die Startzeit eines Stürzenfensters angewendet wird.
referenceTrigger	TriggerReference	Referenzierter Trigger.
size	string minLength: 8 maxLength: 15 pattern: ((\d+)\.)?(\d\d):(60\|([0-5][0-9])):(60\|([0-5][0-9]))	Die Größe des Fensters beim Auswerten der Abhängigkeit. Wenn die Häufigkeit des Sturzfensters nicht definiert ist, wird verwendet.
type	string: TumblingWindowTriggerDependencyReference	Der Typ des Abhängigkeitsverweises.

Type

Enumeration

Verknüpfter Dienstverweistyp.

Wert	Beschreibung
LinkedServiceReference	LinkedServiceReference

Freigeben über

Triggers - Create Or Update

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Triggers_Create

Beispielanforderung

Beispiel für eine Antwort

Triggers_Update

Beispielanforderung

Beispiel für eine Antwort

Definitionen

BlobEventsTrigger

BlobEventTypes

BlobTrigger

ChainingTrigger

CloudError

createdByType

CustomEventsTrigger

DayOfWeek

DaysOfWeek

LinkedServiceReference

MultiplePipelineTrigger

PipelineReference

PipelineReferenceType

RecurrenceFrequency

RecurrenceSchedule

RecurrenceScheduleOccurrence

RerunTumblingWindowTrigger

RetryPolicy

ScheduleTrigger

ScheduleTriggerRecurrence

SelfDependencyTumblingWindowTriggerReference

systemData

TriggerDependencyReference

TriggerPipelineReference

TriggerReference

TriggerReferenceType

TriggerResource

TriggerRuntimeState

TumblingWindowFrequency

TumblingWindowTrigger

TumblingWindowTriggerDependencyReference

Type