Triggers - Query By Factory

Query triggers.

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

URI Parameters

Name In Required Type Description
factoryName
path True

string

The factory name.

Regex pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

resourceGroupName
path True

string

The resource group name.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

The subscription identifier.

api-version
query True

string

The API version.

Request Body

Name Type Description
continuationToken

string

The continuation token for getting the next page of results. Null for first page.

parentTriggerName

string

The name of the parent TumblingWindowTrigger to get the child rerun triggers

Responses

Name Type Description
200 OK

TriggerQueryResponse

OK.

Other Status Codes

CloudError

An error response received from the Azure Data Factory service.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

Triggers_QueryByFactory

Sample request

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/querytriggers?api-version=2018-06-01

{
  "parentTriggerName": "exampleTrigger"
}

Sample response

Date: Sat, 16 Jun 2018 00:40:20 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-reads: 14986
x-ms-request-id: e474f8f8-b34f-4536-b059-ca740e6b44c3
x-ms-correlation-request-id: e474f8f8-b34f-4536-b059-ca740e6b44c3
{
  "value": [
    {
      "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName/triggers/exampleRerunTrigger",
      "name": "exampleRerunTrigger",
      "type": "Microsoft.DataFactory/factories/triggers",
      "properties": {
        "type": "RerunTumblingWindowTrigger",
        "typeProperties": {
          "parentTrigger": "exampleTrigger",
          "requestedStartTime": "2018-06-16T00:39:14.905167Z",
          "requestedEndTime": "2018-06-16T00:55:14.905167Z",
          "rerunConcurrency": 4
        },
        "description": "Example description"
      }
    }
  ]
}

Definitions

Name Description
CloudError

The object that defines the structure of an Azure Data Factory error response.

MultiplePipelineTrigger

Base class for all triggers that support one to many model for trigger to pipeline.

PipelineReference

Pipeline reference type.

TriggerFilterParameters

Query parameters for triggers.

TriggerPipelineReference

Pipeline that needs to be triggered with the given parameters.

TriggerQueryResponse

A query of triggers.

TriggerResource

Trigger resource type.

TriggerRuntimeState

Enumerates possible state of Triggers.

CloudError

The object that defines the structure of an Azure Data Factory error response.

Name Type Description
error.code

string

Error code.

error.details

CloudError[]

Array with additional error details.

error.message

string

Error message.

error.target

string

Property name/path in request associated with error.

MultiplePipelineTrigger

Base class for all triggers that support one to many model for trigger to pipeline.

Name Type Description
annotations

object[]

List of tags that can be used for describing the trigger.

description

string

Trigger description.

pipelines

TriggerPipelineReference[]

Pipelines that need to be started.

runtimeState

TriggerRuntimeState

Indicates if trigger is running or not. Updated when Start/Stop APIs are called on the Trigger.

type string:

MultiplePipelineTrigger

Trigger type.

PipelineReference

Pipeline reference type.

Name Type Description
name

string

Reference name.

referenceName

string

Reference pipeline name.

type enum:

PipelineReference

Pipeline reference type.

TriggerFilterParameters

Query parameters for triggers.

Name Type Description
continuationToken

string

The continuation token for getting the next page of results. Null for first page.

parentTriggerName

string

The name of the parent TumblingWindowTrigger to get the child rerun triggers

TriggerPipelineReference

Pipeline that needs to be triggered with the given parameters.

Name Type Description
parameters

object

Pipeline parameters.

pipelineReference

PipelineReference

Pipeline reference.

TriggerQueryResponse

A query of triggers.

Name Type Description
continuationToken

string

The continuation token for getting the next page of results, if any remaining results exist, null otherwise.

value

TriggerResource[]

List of triggers.

TriggerResource

Trigger resource type.

Name Type Description
etag

string

Etag identifies change in the resource.

id

string

The resource identifier.

name

string

The resource name.

properties Trigger:

MultiplePipelineTrigger

Properties of the trigger.

type

string

The resource type.

TriggerRuntimeState

Enumerates possible state of Triggers.

Name Type Description
Disabled

string

Started

string

Stopped

string