Triggers - Create Or Update

Servizio:

Data Factory

Versione API:

2018-06-01

Crea o aggiorna un trigger.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
factoryName	path	True	string minLength: 3 maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$	Nome della factory.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
triggerName	path	True	string minLength: 1 maxLength: 260 pattern: ^[A-Za-z0-9_][^<>*#.%&:\\+?/]*$	Nome del trigger.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
if-match		string	ETag dell'entità trigger. Deve essere specificato solo per l'aggiornamento, per cui deve corrispondere all'entità esistente o può essere * per l'aggiornamento incondizionato.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties	True	Trigger: MultiplePipelineTrigger ChainingTrigger RerunTumblingWindowTrigger TumblingWindowTrigger BlobEventsTrigger BlobTrigger CustomEventsTrigger ScheduleTrigger	Proprietà del trigger.

Risposte

Nome	Tipo	Descrizione
200 OK	TriggerResource	Operazione di aggiornamento 'TriggerResource' della risorsa riuscita
Other Status Codes	CloudError	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Triggers_Create

Triggers_Update

Triggers_Create

Esempio di richiesta

HTTP

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

Java

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

Python

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

JavaScript

const { DataFactoryManagementClient } = require("@azure/arm-datafactory");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates a trigger.
 *
 * @summary creates or updates a trigger.
 * x-ms-original-file: 2018-06-01/Triggers_Create.json
 */
async function triggersCreate() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "12345678-1234-1234-1234-123456789012";
  const client = new DataFactoryManagementClient(credential, subscriptionId);
  const result = await client.triggers.createOrUpdate(
    "exampleResourceGroup",
    "exampleFactoryName",
    "exampleTrigger",
    {
      properties: {
        type: "ScheduleTrigger",
        pipelines: [
          {
            parameters: { OutputBlobNameList: ["exampleoutput.csv"] },
            pipelineReference: { type: "PipelineReference", referenceName: "examplePipeline" },
          },
        ],
        recurrence: {
          endTime: new Date("2018-06-16T00:55:13.8441801Z"),
          frequency: "Minute",
          interval: 4,
          startTime: new Date("2018-06-16T00:39:13.8441801Z"),
          timeZone: "UTC",
        },
      },
    },
  );
  console.log(result);
}

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

dotnet

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

Risposta di esempio

Codice di stato:

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

Esempio di richiesta

HTTP

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

Java

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

Python

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

JavaScript

const { DataFactoryManagementClient } = require("@azure/arm-datafactory");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates a trigger.
 *
 * @summary creates or updates a trigger.
 * x-ms-original-file: 2018-06-01/Triggers_Update.json
 */
async function triggersUpdate() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "12345678-1234-1234-1234-123456789012";
  const client = new DataFactoryManagementClient(credential, subscriptionId);
  const result = await client.triggers.createOrUpdate(
    "exampleResourceGroup",
    "exampleFactoryName",
    "exampleTrigger",
    {
      properties: {
        type: "ScheduleTrigger",
        description: "Example description",
        pipelines: [
          {
            parameters: { OutputBlobNameList: ["exampleoutput.csv"] },
            pipelineReference: { type: "PipelineReference", referenceName: "examplePipeline" },
          },
        ],
        recurrence: {
          endTime: new Date("2018-06-16T00:55:14.905167Z"),
          frequency: "Minute",
          interval: 4,
          startTime: new Date("2018-06-16T00:39:14.905167Z"),
          timeZone: "UTC",
        },
      },
    },
  );
  console.log(result);
}

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

dotnet

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
BlobEventsTrigger	Trigger che viene eseguito ogni volta che si verifica un evento BLOB.
BlobEventTypes
BlobTrigger	Trigger che viene eseguito ogni volta che cambia il contenitore BLOB selezionato.
ChainingTrigger	Trigger che consente alla pipeline di riferimento di dipendere da altre esecuzioni della pipeline in base alle coppie runDimension Name/Value. Le pipeline upstream devono dichiarare lo stesso nome runDimension e le relative esecuzioni devono avere i valori per tali runDimensions. L'esecuzione della pipeline di riferimento viene attivata se i valori per la corrispondenza runDimension per tutte le esecuzioni di pipeline upstream.
CloudError	Oggetto che definisce la struttura di una risposta di errore di Azure Data Factory.
createdByType	Tipo di identità che ha creato la risorsa.
CustomEventsTrigger	Trigger che viene eseguito ogni volta che viene ricevuto un evento personalizzato.
DayOfWeek	I giorni della settimana.
DaysOfWeek
LinkedServiceReference	Tipo di riferimento del servizio collegato.
MultiplePipelineTrigger	Classe di base per tutti i trigger che supportano uno-a molti modelli per il trigger alla pipeline.
PipelineReference	Tipo di riferimento della pipeline.
PipelineReferenceType	Tipo di riferimento della pipeline.
RecurrenceFrequency	Elenca possibili opzioni di frequenza per il trigger di programmazione.
RecurrenceSchedule	Pianificazione della ricorrenza.
RecurrenceScheduleOccurrence	Occorrenza della pianificazione della ricorrenza.
RerunTumblingWindowTrigger	Trigger che pianifica le riesecuzioni della pipeline per tutte le finestre dell'intervallo di tempo fisso da un'ora di inizio richiesta all'ora di fine richiesta.
RetryPolicy	Criteri di esecuzione per un'attività.
ScheduleTrigger	Trigger che crea periodicamente le esecuzioni della pipeline, in base alla pianificazione.
ScheduleTriggerRecurrence	Il flusso di lavoro attiva la ricorrenza.
SelfDependencyTumblingWindowTriggerReference	Dipendenza del trigger di finestra a cascata a cascata self referenced.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TriggerDependencyReference	Dipendenza a cui si fa riferimento al trigger.
TriggerPipelineReference	Pipeline che deve essere attivata con i parametri specificati.
TriggerReference	Tipo di riferimento del trigger.
TriggerReferenceType	Tipo di riferimento del trigger.
TriggerResource	Tipo di risorsa trigger.
TriggerRuntimeState	Enumera il possibile stato dei trigger.
TumblingWindowFrequency	Elenca possibili opzioni di frequenza per il trigger della finestra di rotazione.
TumblingWindowTrigger	Trigger che pianifica le esecuzioni della pipeline per tutte le finestre dell'intervallo di tempo fisso da un'ora di inizio senza gap e supporta anche scenari di backfill (quando l'ora di inizio è in passato).
TumblingWindowTriggerDependencyReference	Dipendenza del trigger di finestra a cascata a cascata.
Type	Tipo di riferimento del servizio collegato.

BlobEventsTrigger

Oggetto

Trigger che viene eseguito ogni volta che si verifica un evento BLOB.

Nome	Tipo	Descrizione
annotations	Trigger.Annotations[]	Elenco di tag che possono essere usati per descrivere il trigger.
description	string	Descrizione del trigger.
pipelines	TriggerPipelineReference[]	Pipeline che devono essere avviate.
runtimeState	TriggerRuntimeState	Indica se il trigger è in esecuzione o meno. Aggiornato quando le API di avvio/arresto vengono chiamate sul trigger.
type	string: BlobEventsTrigger	Tipo di trigger.
typeProperties.blobPathBeginsWith	string	Il percorso del BLOB deve iniziare con il modello fornito per attivare il trigger. Ad esempio, "/records/blobs/dicembre/" attiverà il trigger solo per i BLOB nella cartella dicembre nel contenitore dei record. È necessario specificare almeno uno di questi elementi: blobPathBeginsWith, blobPathEndsWith.
typeProperties.blobPathEndsWith	string	Il percorso DEL BLOB deve terminare con il modello fornito per attivare il trigger. Ad esempio, "dicembre/boxes.csv" attiverà solo il trigger per i BLOB denominati box in una cartella dicembre. È necessario specificare almeno uno di questi elementi: blobPathBeginsWith, blobPathEndsWith.
typeProperties.events	BlobEventTypes[]	Tipo di eventi che causano l'attivazione del trigger.
typeProperties.ignoreEmptyBlobs	boolean	Se impostato su true, i BLOB con zero byte verranno ignorati.
typeProperties.scope	string	ID risorsa ARM dell'account di archiviazione.

BlobEventTypes

Enumerazione

Valore	Descrizione
Microsoft.Storage.BlobCreated	Microsoft.Storage.BlobCreated
Microsoft.Storage.BlobDeleted	Microsoft.Storage.BlobEliminato

BlobTrigger

Oggetto

Trigger che viene eseguito ogni volta che cambia il contenitore BLOB selezionato.

Nome	Tipo	Descrizione
annotations	Trigger.Annotations[]	Elenco di tag che possono essere usati per descrivere il trigger.
description	string	Descrizione del trigger.
pipelines	TriggerPipelineReference[]	Pipeline che devono essere avviate.
runtimeState	TriggerRuntimeState	Indica se il trigger è in esecuzione o meno. Aggiornato quando le API di avvio/arresto vengono chiamate sul trigger.
type	string: BlobTrigger	Tipo di trigger.
typeProperties.folderPath	string	Percorso del contenitore o della cartella che attiverà la pipeline.
typeProperties.linkedService	LinkedServiceReference	Riferimento al servizio collegato Azure Storage.
typeProperties.maxConcurrency	integer (int32)	Numero massimo di file paralleli da gestire quando viene attivato.

ChainingTrigger

Oggetto

Trigger che consente alla pipeline di riferimento di dipendere da altre esecuzioni della pipeline in base alle coppie runDimension Name/Value. Le pipeline upstream devono dichiarare lo stesso nome runDimension e le relative esecuzioni devono avere i valori per tali runDimensions. L'esecuzione della pipeline di riferimento viene attivata se i valori per la corrispondenza runDimension per tutte le esecuzioni di pipeline upstream.

Nome	Tipo	Descrizione
annotations	Trigger.Annotations[]	Elenco di tag che possono essere usati per descrivere il trigger.
description	string	Descrizione del trigger.
pipeline	TriggerPipelineReference	Pipeline per cui vengono create esecuzioni quando tutte le pipeline upstream vengono completate correttamente.
runtimeState	TriggerRuntimeState	Indica se il trigger è in esecuzione o meno. Aggiornato quando le API di avvio/arresto vengono chiamate sul trigger.
type	string: ChainingTrigger	Tipo di trigger.
typeProperties.dependsOn	PipelineReference[]	Condotte a monte.
typeProperties.runDimension	string	Eseguire la proprietà Dimension che deve essere generata dalle pipeline upstream.

CloudError

Oggetto

Oggetto che definisce la struttura di una risposta di errore di Azure Data Factory.

Nome	Tipo	Descrizione
error.code	string	Codice di errore.
error.details	CloudError[]	Matrice con dettagli aggiuntivi sull'errore.
error.message	string	Messaggio di errore.
error.target	string	Nome/percorso della proprietà nella richiesta associata all'errore.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

CustomEventsTrigger

Oggetto

Trigger che viene eseguito ogni volta che viene ricevuto un evento personalizzato.

Nome	Tipo	Descrizione
annotations	Trigger.Annotations[]	Elenco di tag che possono essere usati per descrivere il trigger.
description	string	Descrizione del trigger.
pipelines	TriggerPipelineReference[]	Pipeline che devono essere avviate.
runtimeState	TriggerRuntimeState	Indica se il trigger è in esecuzione o meno. Aggiornato quando le API di avvio/arresto vengono chiamate sul trigger.
type	string: CustomEventsTrigger	Tipo di trigger.
typeProperties.events	CustomEventsTriggerTypeProperties.Events[]	Elenco di tipi di evento che causano l'attivazione di questo trigger.
typeProperties.scope	string	L'ID della risorsa ARM dell'argomento Azure Event Grid.
typeProperties.subjectBeginsWith	string	L'oggetto dell'evento deve iniziare con il modello fornito per l'attivazione del trigger. È necessario specificare almeno uno di questi elementi: subjectBeginsWith, subjectEndsWith.
typeProperties.subjectEndsWith	string	L'oggetto dell'evento deve terminare con il modello fornito per l'attivazione del trigger. È necessario specificare almeno uno di questi elementi: subjectBeginsWith, subjectEndsWith.

DayOfWeek

Enumerazione

I giorni della settimana.

Valore	Descrizione
Sunday	Domenica
Monday	Lunedì
Tuesday	Martedì
Wednesday	Wednesday
Thursday	Giovedì
Friday	Venerdì
Saturday	Sabato

DaysOfWeek

Enumerazione

Valore	Descrizione
Sunday	Domenica
Monday	Lunedì
Tuesday	Martedì
Wednesday	Wednesday
Thursday	Giovedì
Friday	Venerdì
Saturday	Sabato

LinkedServiceReference

Oggetto

Tipo di riferimento del servizio collegato.

Nome	Tipo	Descrizione
parameters		Argomenti per LinkedService.
referenceName	string	Fare riferimento al nome LinkedService.
type	Type	Tipo di riferimento del servizio collegato.

MultiplePipelineTrigger

Oggetto

Classe di base per tutti i trigger che supportano uno-a molti modelli per il trigger alla pipeline.

Nome	Tipo	Descrizione
annotations	Trigger.Annotations[]	Elenco di tag che possono essere usati per descrivere il trigger.
description	string	Descrizione del trigger.
pipelines	TriggerPipelineReference[]	Pipeline che devono essere avviate.
runtimeState	TriggerRuntimeState	Indica se il trigger è in esecuzione o meno. Aggiornato quando le API di avvio/arresto vengono chiamate sul trigger.
type	string: MultiplePipelineTrigger	Tipo di trigger.

PipelineReference

Oggetto

Tipo di riferimento della pipeline.

Nome	Tipo	Descrizione
name	string	Nome riferimento.
referenceName	string	Nome della pipeline di riferimento.
type	PipelineReferenceType	Tipo di riferimento della pipeline.

PipelineReferenceType

Enumerazione

Tipo di riferimento della pipeline.

Valore	Descrizione
PipelineReference	PipelineReference

RecurrenceFrequency

Enumerazione

Elenca possibili opzioni di frequenza per il trigger di programmazione.

Valore	Descrizione
NotSpecified	Non specificato
Minute	Minuto
Hour	Ore
Day	Day
Week	Settimana
Month	Mese
Year	Anno

RecurrenceSchedule

Oggetto

Pianificazione della ricorrenza.

Nome	Tipo	Descrizione
hours	integer[] (int32)	Gli orari.
minutes	integer[] (int32)	I verbali.
monthDays	integer[] (int32)	Giorni del mese.
monthlyOccurrences	RecurrenceScheduleOccurrence[]	Occorrenze mensili.
weekDays	DaysOfWeek[]	I giorni della settimana.

RecurrenceScheduleOccurrence

Oggetto

Occorrenza della pianificazione della ricorrenza.

Nome	Tipo	Descrizione
day	DayOfWeek	Giorno della settimana.
occurrence	integer (int32)	L'evento.

RerunTumblingWindowTrigger

Oggetto

Trigger che pianifica le riesecuzioni della pipeline per tutte le finestre dell'intervallo di tempo fisso da un'ora di inizio richiesta all'ora di fine richiesta.

Nome	Tipo	Descrizione
annotations	Trigger.Annotations[]	Elenco di tag che possono essere usati per descrivere il trigger.
description	string	Descrizione del trigger.
runtimeState	TriggerRuntimeState	Indica se il trigger è in esecuzione o meno. Aggiornato quando le API di avvio/arresto vengono chiamate sul trigger.
type	string: RerunTumblingWindowTrigger	Tipo di trigger.
typeProperties.parentTrigger		Riferimento al trigger padre.
typeProperties.requestedEndTime	string (date-time)	Ora di fine per il periodo di tempo per il quale viene avviato il ripristino. Attualmente è supportata solo l'ora UTC.
typeProperties.requestedStartTime	string (date-time)	Ora di inizio per il periodo di tempo per il quale viene avviata la ristrutturazione. Attualmente è supportata solo l'ora UTC.
typeProperties.rerunConcurrency	integer (int32) minimum: 1 maximum: 50	Numero massimo di finestre temporali parallele (pronte per l'esecuzione) per cui viene attivata una riesecuzione.

RetryPolicy

Oggetto

Criteri di esecuzione per un'attività.

Nome	Tipo	Descrizione
count		Numero massimo di tentativi ordinari. Il valore predefinito è 0. Tipo: integer (o Expression con resultType integer), minimo: 0.
intervalInSeconds	integer (int32) minimum: 30 maximum: 86400	Intervallo tra tentativi in secondi. Il valore predefinito è 30.

ScheduleTrigger

Oggetto

Trigger che crea periodicamente le esecuzioni della pipeline, in base alla pianificazione.

Nome	Tipo	Descrizione
annotations	Trigger.Annotations[]	Elenco di tag che possono essere usati per descrivere il trigger.
description	string	Descrizione del trigger.
pipelines	TriggerPipelineReference[]	Pipeline che devono essere avviate.
runtimeState	TriggerRuntimeState	Indica se il trigger è in esecuzione o meno. Aggiornato quando le API di avvio/arresto vengono chiamate sul trigger.
type	string: ScheduleTrigger	Tipo di trigger.
typeProperties.recurrence	ScheduleTriggerRecurrence	Configurazione della pianificazione ricorrenza.

ScheduleTriggerRecurrence

Oggetto

Il flusso di lavoro attiva la ricorrenza.

Nome	Tipo	Descrizione
endTime	string (date-time)	Ora di fine.
frequency	RecurrenceFrequency	La frequenza.
interval	integer (int32)	L'intervallo.
schedule	RecurrenceSchedule	Pianificazione della ricorrenza.
startTime	string (date-time)	Ora di inizio.
timeZone	string	Fuso orario.

SelfDependencyTumblingWindowTriggerReference

Oggetto

Dipendenza del trigger di finestra a cascata a cascata self referenced.

Nome	Tipo	Descrizione
offset	string minLength: 8 maxLength: 15 pattern: -((\d+)\.)?(\d\d):(60|([0-5][0-9])):(60|([0-5][0-9]))	Intervallo di tempo applicato all'ora di inizio di una finestra a cascata durante la valutazione della dipendenza.
size	string minLength: 8 maxLength: 15 pattern: ((\d+)\.)?(\d\d):(60|([0-5][0-9])):(60|([0-5][0-9]))	Dimensioni della finestra durante la valutazione della dipendenza. Se non definita, verrà utilizzata la frequenza della finestra a cascata.
type	string: SelfDependencyTumblingWindowTriggerReference	Tipo di riferimento alle dipendenze.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

TriggerDependencyReference

Oggetto

Dipendenza a cui si fa riferimento al trigger.

Nome	Tipo	Descrizione
referenceTrigger	TriggerReference	Trigger di riferimento.
type	string: TriggerDependencyReference	Tipo di riferimento alle dipendenze.

TriggerPipelineReference

Oggetto

Pipeline che deve essere attivata con i parametri specificati.

Nome	Tipo	Descrizione
parameters		Parametri della pipeline.
pipelineReference	PipelineReference	Riferimento alla pipeline.

TriggerReference

Oggetto

Tipo di riferimento del trigger.

Nome	Tipo	Descrizione
referenceName	string	Nome del trigger di riferimento.
type	TriggerReferenceType	Tipo di riferimento del trigger.

TriggerReferenceType

Enumerazione

Tipo di riferimento del trigger.

Valore	Descrizione
TriggerReference	TriggerReference

TriggerResource

Oggetto

Tipo di risorsa trigger.

Nome	Tipo	Descrizione
etag	string	"Se l'etag viene fornito nel corpo della risposta, può anche essere fornito come intestazione secondo la normale convenzione dell'etag. I tag di entità vengono usati per confrontare due o più entità dalla stessa risorsa richiesta. HTTP/1.1 utilizza i tag di entità nei campi di intestazione etag (sezione 14.19), If-Match (sezione 14.24), If-None-Match (sezione 14.26) e If-Range (sezione 14.27).")
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties	Trigger: BlobEventsTrigger BlobTrigger ChainingTrigger CustomEventsTrigger MultiplePipelineTrigger RerunTumblingWindowTrigger ScheduleTrigger TumblingWindowTrigger	Proprietà del trigger.
systemData	systemData	Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TriggerRuntimeState

Enumerazione

Enumera il possibile stato dei trigger.

Valore	Descrizione
Started	Avviato
Stopped	Fermato
Disabled	Disattivato

TumblingWindowFrequency

Enumerazione

Elenca possibili opzioni di frequenza per il trigger della finestra di rotazione.

Valore	Descrizione
Minute	Minuto
Hour	Ore
Month	Mese

TumblingWindowTrigger

Oggetto

Trigger che pianifica le esecuzioni della pipeline per tutte le finestre dell'intervallo di tempo fisso da un'ora di inizio senza gap e supporta anche scenari di backfill (quando l'ora di inizio è in passato).

Nome	Tipo	Descrizione
annotations	Trigger.Annotations[]	Elenco di tag che possono essere usati per descrivere il trigger.
description	string	Descrizione del trigger.
pipeline	TriggerPipelineReference	Pipeline per cui vengono create esecuzioni quando viene generato un evento per la finestra del trigger pronta.
runtimeState	TriggerRuntimeState	Indica se il trigger è in esecuzione o meno. Aggiornato quando le API di avvio/arresto vengono chiamate sul trigger.
type	string: TumblingWindowTrigger	Tipo di trigger.
typeProperties.delay		Specifica per quanto tempo il trigger attende il tempo di scadenza prima di attivare una nuova esecuzione. Non modifica l'ora di inizio e di fine della finestra. Il valore predefinito è 0. Type: string (o Expression with resultType string), pattern: ((\d+).)? (\d\d):(60|( [0-5][0-9])):(60|( [0-5][0-9])).
typeProperties.dependsOn	DependencyReference[]: SelfDependencyTumblingWindowTriggerReference[] TriggerDependencyReference[] TumblingWindowTriggerDependencyReference[]	Trigger da cui dipende questo trigger. Sono supportati solo i trigger di finestra a cascata.
typeProperties.endTime	string (date-time)	Ora di fine per il periodo di tempo per il trigger durante il quale gli eventi vengono attivati per le finestre pronte. Attualmente è supportata solo l'ora UTC.
typeProperties.frequency	TumblingWindowFrequency	Frequenza delle finestre temporali.
typeProperties.interval	integer (int32)	Intervallo delle finestre temporali. L'intervallo minimo consentito è 15 minuti.
typeProperties.maxConcurrency	integer (int32) minimum: 1 maximum: 50	Numero massimo di finestre temporali parallele (pronte per l'esecuzione) per cui viene attivata una nuova esecuzione.
typeProperties.retryPolicy	RetryPolicy	Criteri di ripetizione dei tentativi che verranno applicati per le esecuzioni di pipeline non riuscite.
typeProperties.startTime	string (date-time)	Ora di inizio per il periodo di tempo per il trigger durante il quale gli eventi vengono attivati per le finestre pronte. Attualmente è supportata solo l'ora UTC.

TumblingWindowTriggerDependencyReference

Oggetto

Dipendenza del trigger di finestra a cascata a cascata.

Nome	Tipo	Descrizione
offset	string minLength: 8 maxLength: 15 pattern: -?((\d+)\.)?(\d\d):(60|([0-5][0-9])):(60|([0-5][0-9]))	Intervallo di tempo applicato all'ora di inizio di una finestra a cascata durante la valutazione della dipendenza.
referenceTrigger	TriggerReference	Trigger di riferimento.
size	string minLength: 8 maxLength: 15 pattern: ((\d+)\.)?(\d\d):(60|([0-5][0-9])):(60|([0-5][0-9]))	Dimensioni della finestra durante la valutazione della dipendenza. Se non definita, verrà utilizzata la frequenza della finestra a cascata.
type	string: TumblingWindowTriggerDependencyReference	Tipo di riferimento alle dipendenze.

Type

Enumerazione

Tipo di riferimento del servizio collegato.

Valore	Descrizione
LinkedServiceReference	LinkedServiceReference