Triggers - Create Or Update

Služba:: Data Factory

Verze rozhraní API:: 2018-06-01

Vytvoří nebo aktualizuje trigger.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
factoryName	path	True	string minLength: 3 maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$	Název továrny.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
triggerName	path	True	string minLength: 1 maxLength: 260 pattern: ^[A-Za-z0-9_][^<>#.%&:\\+?/]$	Název triggeru.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
if-match		string	ETag entity triggeru Měla by být zadána pouze pro aktualizaci, pro kterou by měla odpovídat stávající entitě, nebo může být * pro nepodmíněnou aktualizaci.

Text požadavku

Name	Vyžadováno	Typ	Description
properties	True	Trigger: MultiplePipelineTrigger ChainingTrigger RerunTumblingWindowTrigger TumblingWindowTrigger BlobEventsTrigger BlobTrigger CustomEventsTrigger ScheduleTrigger	Vlastnosti triggeru.

Odpovědi

Name	Typ	Description
200 OK	TriggerResource	Aktualizace zdroje 'TriggerResource' byla úspěšná
Other Status Codes	CloudError	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Triggers_Create

Triggers_Update

Triggers_Create

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
      }
    }
  }
}

Definice

Name	Description
BlobEventsTrigger	Trigger, který se spustí pokaždé, když dojde k události objektu blob.
BlobEventTypes
BlobTrigger	Trigger, který se spustí při každé změně vybraného kontejneru objektů blob.
ChainingTrigger	Trigger, který umožňuje, aby odkazovaný kanál závisel na jiných spuštěních kanálu na základě párů runDimension Name/Value. Upstreamové kanály by měly deklarovat stejný název runDimension a jejich spuštění by měly mít hodnoty pro tyto runDimensions. Odkazované spuštění kanálu by se aktivovalo, pokud se hodnoty runDimension shodují pro všechna nadřazená spuštění kanálu.
CloudError	Objekt, který definuje strukturu chybové odpovědi služby Azure Data Factory.
createdByType	Typ identity, která prostředek vytvořila.
CustomEventsTrigger	Trigger, který se spustí při každém přijetí vlastní události.
DayOfWeek	Dny v týdnu.
DaysOfWeek
LinkedServiceReference	Referenční typ propojené služby
MultiplePipelineTrigger	Základní třída pro všechny triggery, které podporují jeden až mnoho modelů pro trigger do kanálu.
PipelineReference	Referenční typ kanálu
PipelineReferenceType	Referenční typ kanálu
RecurrenceFrequency	Vyjmenovává možnou volbu frekvence pro spouštěč rozvrhu.
RecurrenceSchedule	Plán opakování.
RecurrenceScheduleOccurrence	Výskyt plánu opakování.
RerunTumblingWindowTrigger	Trigger, který naplánuje opětovné spuštění kanálu pro všechna okna pevného časového intervalu z požadovaného počátečního času na požadovaný koncový čas.
RetryPolicy	Zásady spouštění pro aktivitu
ScheduleTrigger	Trigger, který pravidelně vytváří spuštění kanálu podle plánu.
ScheduleTriggerRecurrence	Opakování triggeru pracovního postupu.
SelfDependencyTumblingWindowTriggerReference	Závislost triggeru pro přeskakující okno odkazovaná na sebe.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
TriggerDependencyReference	Závislost odkazovaná na triggery
TriggerPipelineReference	Kanál, který se musí aktivovat s danými parametry.
TriggerReference	Typ odkazu aktivační události
TriggerReferenceType	Typ odkazu aktivační události
TriggerResource	Typ prostředku triggeru
TriggerRuntimeState	Vytvoří výčet možného stavu triggerů.
TumblingWindowFrequency	Vyjmenovává možnou frekvenční možnost pro spouštěč tumbling window.
TumblingWindowTrigger	Aktivace, která naplánuje spuštění kanálu pro všechna časová intervaly s pevným časovým intervalem od času spuštění bez mezer a podporuje také scénáře obnovení (pokud je čas spuštění v minulosti).
TumblingWindowTriggerDependencyReference	Odkazovaná závislost aktivační události pro přeskakující okno
Type	Referenční typ propojené služby

BlobEventsTrigger

Objekt

Trigger, který se spustí pokaždé, když dojde k události objektu blob.

Name	Typ	Description
annotations	Trigger.Annotations[]	Seznam značek, které lze použít k popisu triggeru
description	string	Popis triggeru
pipelines	TriggerPipelineReference[]	Kanály, které je potřeba spustit.
runtimeState	TriggerRuntimeState	Označuje, jestli je trigger spuštěný nebo ne. Aktualizace při zavolání rozhraní API pro spuštění/zastavení na triggeru
type	string: BlobEventsTrigger	Typ aktivační události.
typeProperties.blobPathBeginsWith	string	Cesta k objektu blob musí začínat vzorem, který se má aktivovat. Například /records/blobs/december/' aktivuje aktivační událost pouze pro objekty blob v prosincové složce v kontejneru záznamů. Musí být k dispozici alespoň jedna z těchto možností: blobPathBeginsWith, blobPathEndsWith.
typeProperties.blobPathEndsWith	string	Cesta k objektu blob musí končit vzorem, který se má aktivovat. Například prosinec/boxes.csvaktivuje trigger pouze pro objekty blob pojmenované pole v prosincové složce. Musí být k dispozici alespoň jedna z těchto možností: blobPathBeginsWith, blobPathEndsWith.
typeProperties.events	BlobEventTypes[]	Typ událostí, které způsobují aktivaci tohoto triggeru.
typeProperties.ignoreEmptyBlobs	boolean	Pokud je nastavená hodnota true, budou objekty blob s nulovými bajty ignorovány.
typeProperties.scope	string	ARM resource ID Storage Account.

BlobEventTypes

Výčet

Hodnota	Description
Microsoft.Storage.BlobCreated	Microsoft.Storage.BlobCreated
Microsoft.Storage.BlobDeleted	Microsoft.Storage.BlobDeleted

BlobTrigger

Objekt

Trigger, který se spustí při každé změně vybraného kontejneru objektů blob.

Name	Typ	Description
annotations	Trigger.Annotations[]	Seznam značek, které lze použít k popisu triggeru
description	string	Popis triggeru
pipelines	TriggerPipelineReference[]	Kanály, které je potřeba spustit.
runtimeState	TriggerRuntimeState	Označuje, jestli je trigger spuštěný nebo ne. Aktualizace při zavolání rozhraní API pro spuštění/zastavení na triggeru
type	string: BlobTrigger	Typ aktivační události.
typeProperties.folderPath	string	Cesta ke kontejneru nebo složce, která kanál aktivuje.
typeProperties.linkedService	LinkedServiceReference	Odkaz na propojenou službu Azure Storage.
typeProperties.maxConcurrency	integer (int32)	Maximální počet paralelních souborů, které se mají zpracovat při aktivaci.

ChainingTrigger

Objekt

Trigger, který umožňuje, aby odkazovaný kanál závisel na jiných spuštěních kanálu na základě párů runDimension Name/Value. Upstreamové kanály by měly deklarovat stejný název runDimension a jejich spuštění by měly mít hodnoty pro tyto runDimensions. Odkazované spuštění kanálu by se aktivovalo, pokud se hodnoty runDimension shodují pro všechna nadřazená spuštění kanálu.

Name	Typ	Description
annotations	Trigger.Annotations[]	Seznam značek, které lze použít k popisu triggeru
description	string	Popis triggeru
pipeline	TriggerPipelineReference	Pipeline, pro které se vytvoří běhy, když všechny upstream pipelines úspěšně dokončí.
runtimeState	TriggerRuntimeState	Označuje, jestli je trigger spuštěný nebo ne. Aktualizace při zavolání rozhraní API pro spuštění/zastavení na triggeru
type	string: ChainingTrigger	Typ aktivační události.
typeProperties.dependsOn	PipelineReference[]	Upstream potrubí.
typeProperties.runDimension	string	Spusť vlastnost Dimension, kterou musí vysílat upstream pipelines.

CloudError

Objekt

Objekt, který definuje strukturu chybové odpovědi služby Azure Data Factory.

Name	Typ	Description
error.code	string	Kód chyby
error.details	CloudError[]	Pole s dalšími podrobnostmi o chybě
error.message	string	Zpráva o chybě.
error.target	string	Název vlastnosti nebo cesta v požadavku přidruženém k chybě.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

CustomEventsTrigger

Objekt

Trigger, který se spustí při každém přijetí vlastní události.

Name	Typ	Description
annotations	Trigger.Annotations[]	Seznam značek, které lze použít k popisu triggeru
description	string	Popis triggeru
pipelines	TriggerPipelineReference[]	Kanály, které je potřeba spustit.
runtimeState	TriggerRuntimeState	Označuje, jestli je trigger spuštěný nebo ne. Aktualizace při zavolání rozhraní API pro spuštění/zastavení na triggeru
type	string: CustomEventsTrigger	Typ aktivační události.
typeProperties.events	CustomEventsTriggerTypeProperties.Events[]	Seznam typů událostí, které způsobují aktivaci tohoto triggeru.
typeProperties.scope	string	ARM resource ID v tématu Azure Event Grid.
typeProperties.subjectBeginsWith	string	Předmět události musí začínat vzorem zadaným k aktivaci triggeru. Je třeba zadat alespoň jednu z těchto možností: subjectBeginsWith, subjectEndsWith.
typeProperties.subjectEndsWith	string	Předmět události musí končit vzorem, který je k dispozici pro aktivaci triggeru. Je třeba zadat alespoň jednu z těchto možností: subjectBeginsWith, subjectEndsWith.

DayOfWeek

Výčet

Dny v týdnu.

Hodnota	Description
Sunday	Neděle
Monday	Monday
Tuesday	Úterý
Wednesday	Wednesday
Thursday	Thursday
Friday	Friday
Saturday	Sobota

DaysOfWeek

Výčet

Hodnota	Description
Sunday	Neděle
Monday	Monday
Tuesday	Úterý
Wednesday	Wednesday
Thursday	Thursday
Friday	Friday
Saturday	Sobota

LinkedServiceReference

Objekt

Referenční typ propojené služby

Name	Typ	Description
parameters		Argumenty pro LinkedService
referenceName	string	Odkaz na název propojené služby.
type	Type	Referenční typ propojené služby

MultiplePipelineTrigger

Objekt

Základní třída pro všechny triggery, které podporují jeden až mnoho modelů pro trigger do kanálu.

Name	Typ	Description
annotations	Trigger.Annotations[]	Seznam značek, které lze použít k popisu triggeru
description	string	Popis triggeru
pipelines	TriggerPipelineReference[]	Kanály, které je potřeba spustit.
runtimeState	TriggerRuntimeState	Označuje, jestli je trigger spuštěný nebo ne. Aktualizace při zavolání rozhraní API pro spuštění/zastavení na triggeru
type	string: MultiplePipelineTrigger	Typ aktivační události.

PipelineReference

Objekt

Referenční typ kanálu

Name	Typ	Description
name	string	Název odkazu.
referenceName	string	Název referenčního kanálu
type	PipelineReferenceType	Referenční typ kanálu

PipelineReferenceType

Výčet

Referenční typ kanálu

Hodnota	Description
PipelineReference	PipelineReference

RecurrenceFrequency

Výčet

Vyjmenovává možnou volbu frekvence pro spouštěč rozvrhu.

Hodnota	Description
NotSpecified	Nespecifikováno
Minute	Minuta
Hour	Hodina
Day	Den
Week	Týden
Month	Měsíc
Year	Rok

RecurrenceSchedule

Objekt

Plán opakování.

Name	Typ	Description
hours	integer[] (int32)	Hodiny.
minutes	integer[] (int32)	Minuty.
monthDays	integer[] (int32)	Dny měsíce.
monthlyOccurrences	RecurrenceScheduleOccurrence[]	Měsíční výskyty.
weekDays	DaysOfWeek[]	Dny v týdnu.

RecurrenceScheduleOccurrence

Objekt

Výskyt plánu opakování.

Name	Typ	Description
day	DayOfWeek	Den v týdnu.
occurrence	integer (int32)	Výskyt.

RerunTumblingWindowTrigger

Objekt

Trigger, který naplánuje opětovné spuštění kanálu pro všechna okna pevného časového intervalu z požadovaného počátečního času na požadovaný koncový čas.

Name	Typ	Description
annotations	Trigger.Annotations[]	Seznam značek, které lze použít k popisu triggeru
description	string	Popis triggeru
runtimeState	TriggerRuntimeState	Označuje, jestli je trigger spuštěný nebo ne. Aktualizace při zavolání rozhraní API pro spuštění/zastavení na triggeru
type	string: RerunTumblingWindowTrigger	Typ aktivační události.
typeProperties.parentTrigger		Referenční informace k nadřazené aktivační události.
typeProperties.requestedEndTime	string (date-time)	Koncový čas pro časové období, pro které se zahájí opětovné obnovení. V současné době se podporuje pouze čas UTC.
typeProperties.requestedStartTime	string (date-time)	Počáteční čas pro časové období, pro které je zahájeno opětovné obnovení. V současné době se podporuje pouze čas UTC.
typeProperties.rerunConcurrency	integer (int32) minimum: 1 maximum: 50	Maximální počet paralelních časových intervalů (připravených ke spuštění), pro které se aktivuje opětovné spuštění.

RetryPolicy

Objekt

Zásady spouštění pro aktivitu

Name	Typ	Description
count		Maximální počet běžných pokusů o opakování. Výchozí hodnota je 0. Typ: celé číslo (nebo výraz s celočíselnou hodnotou resultType), minimum: 0.
intervalInSeconds	integer (int32) minimum: 30 maximum: 86400	Interval mezi opakovanými pokusy v sekundách Výchozí hodnota je 30.

ScheduleTrigger

Objekt

Trigger, který pravidelně vytváří spuštění kanálu podle plánu.

Name	Typ	Description
annotations	Trigger.Annotations[]	Seznam značek, které lze použít k popisu triggeru
description	string	Popis triggeru
pipelines	TriggerPipelineReference[]	Kanály, které je potřeba spustit.
runtimeState	TriggerRuntimeState	Označuje, jestli je trigger spuštěný nebo ne. Aktualizace při zavolání rozhraní API pro spuštění/zastavení na triggeru
type	string: ScheduleTrigger	Typ aktivační události.
typeProperties.recurrence	ScheduleTriggerRecurrence	Konfigurace plánu opakování

ScheduleTriggerRecurrence

Objekt

Opakování triggeru pracovního postupu.

Name	Typ	Description
endTime	string (date-time)	Čas ukončení.
frequency	RecurrenceFrequency	Frekvence.
interval	integer (int32)	Interval.
schedule	RecurrenceSchedule	Plán opakování.
startTime	string (date-time)	Čas zahájení.
timeZone	string	Časové pásmo.

SelfDependencyTumblingWindowTriggerReference

Objekt

Závislost triggeru pro přeskakující okno odkazovaná na sebe.

Name	Typ	Description
offset	string minLength: 8 maxLength: 15 pattern: -((\d+)\.)?(\d\d):(60\|([0-5][0-9])):(60\|([0-5][0-9]))	Časový rozsah použitý na počáteční čas přeskakujícího okna při vyhodnocování závislosti.
size	string minLength: 8 maxLength: 15 pattern: ((\d+)\.)?(\d\d):(60\|([0-5][0-9])):(60\|([0-5][0-9]))	Velikost okna při vyhodnocování závislosti Pokud nebude definována frekvence přeskakujícího okna, použije se.
type	string: SelfDependencyTumblingWindowTriggerReference	Typ odkazu na závislost.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

TriggerDependencyReference

Objekt

Závislost odkazovaná na triggery

Name	Typ	Description
referenceTrigger	TriggerReference	Odkazovaná aktivační událost.
type	string: TriggerDependencyReference	Typ odkazu na závislost.

TriggerPipelineReference

Objekt

Kanál, který se musí aktivovat s danými parametry.

Name	Typ	Description
parameters		Parametry kanálu.
pipelineReference	PipelineReference	Referenční informace ke kanálu

TriggerReference

Objekt

Typ odkazu aktivační události

Name	Typ	Description
referenceName	string	Název aktivační události odkazu
type	TriggerReferenceType	Typ odkazu aktivační události

TriggerReferenceType

Výčet

Typ odkazu aktivační události

Hodnota	Description
TriggerReference	TriggerReference

TriggerResource

Objekt

Typ prostředku triggeru

Name	Typ	Description
etag	string	"Pokud je v těle odpovědi uveden etag, může být také poskytnut jako hlavička podle normální konvence etag. Značky entit se používají k porovnání dvou nebo více entit ze stejného požadovaného prostředku. Protokol HTTP/1.1 používá značky entit v polích záhlaví značek etag (oddíl 14.19), If-Match (oddíl 14.24), If-None-Match (oddíl 14.26) a If-Range (oddíl 14.27).")
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Název prostředku
properties	Trigger: BlobEventsTrigger BlobTrigger ChainingTrigger CustomEventsTrigger MultiplePipelineTrigger RerunTumblingWindowTrigger ScheduleTrigger TumblingWindowTrigger	Vlastnosti triggeru.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

TriggerRuntimeState

Výčet

Vytvoří výčet možného stavu triggerů.

Hodnota	Description
Started	Zahájeno
Stopped	Zastavený
Disabled	Disabled

TumblingWindowFrequency

Výčet

Vyjmenovává možnou frekvenční možnost pro spouštěč tumbling window.

Hodnota	Description
Minute	Minuta
Hour	Hodina
Month	Měsíc

TumblingWindowTrigger

Objekt

Aktivace, která naplánuje spuštění kanálu pro všechna časová intervaly s pevným časovým intervalem od času spuštění bez mezer a podporuje také scénáře obnovení (pokud je čas spuštění v minulosti).

Name	Typ	Description
annotations	Trigger.Annotations[]	Seznam značek, které lze použít k popisu triggeru
description	string	Popis triggeru
pipeline	TriggerPipelineReference	Kanál, pro který se spustí při aktivaci události pro okno triggeru, které je připravené.
runtimeState	TriggerRuntimeState	Označuje, jestli je trigger spuštěný nebo ne. Aktualizace při zavolání rozhraní API pro spuštění/zastavení na triggeru
type	string: TumblingWindowTrigger	Typ aktivační události.
typeProperties.delay		Určuje, jak dlouho aktivační událost čeká po termínu splnění před aktivací nového spuštění. Nezmění počáteční a koncový čas okna. Výchozí hodnota je 0. Typ: řetězec (nebo výraz s řetězcem resultType), vzor: ((\d+).)? (\d\d):(60\|( [0-5][0-9])):(60\|( [0-5][0-9])).
typeProperties.dependsOn	DependencyReference[]: SelfDependencyTumblingWindowTriggerReference[] TriggerDependencyReference[] TumblingWindowTriggerDependencyReference[]	Aktivační události, na které tato aktivační událost závisí. Podporují se jenom triggery pro přeskakující okno.
typeProperties.endTime	string (date-time)	Koncový čas časového období triggeru, během kterého se události aktivují pro okna, která jsou připravená. V současné době se podporuje pouze čas UTC.
typeProperties.frequency	TumblingWindowFrequency	Frekvence časových intervalů.
typeProperties.interval	integer (int32)	Interval časových intervalů. Minimální povolený interval je 15 minut.
typeProperties.maxConcurrency	integer (int32) minimum: 1 maximum: 50	Maximální počet paralelních časových intervalů (připravených ke spuštění), pro které se aktivuje nové spuštění.
typeProperties.retryPolicy	RetryPolicy	Zásady opakování, které se použijí pro neúspěšná spuštění kanálu.
typeProperties.startTime	string (date-time)	Počáteční čas pro časové období triggeru, během kterého se události aktivují pro okna, která jsou připravená. V současné době se podporuje pouze čas UTC.

TumblingWindowTriggerDependencyReference

Objekt

Odkazovaná závislost aktivační události pro přeskakující okno

Name	Typ	Description
offset	string minLength: 8 maxLength: 15 pattern: -?((\d+)\.)?(\d\d):(60\|([0-5][0-9])):(60\|([0-5][0-9]))	Časový rozsah použitý na počáteční čas přeskakujícího okna při vyhodnocování závislosti.
referenceTrigger	TriggerReference	Odkazovaná aktivační událost.
size	string minLength: 8 maxLength: 15 pattern: ((\d+)\.)?(\d\d):(60\|([0-5][0-9])):(60\|([0-5][0-9]))	Velikost okna při vyhodnocování závislosti Pokud nebude definována frekvence přeskakujícího okna, použije se.
type	string: TumblingWindowTriggerDependencyReference	Typ odkazu na závislost.

Type

Výčet

Referenční typ propojené služby

Hodnota	Description
LinkedServiceReference	LinkedServiceReference

Sdílet prostřednictvím

Triggers - Create Or Update

Parametry identifikátoru URI

Hlavička požadavku

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Triggers_Create

Ukázkový požadavek

Ukázková odpověď

Triggers_Update

Ukázkový požadavek

Ukázková odpověď

Definice

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