Airflow URI Format

The Uniform Resource Identifier (URI) definition for Airflow follows this standard:

Identifier Fragments

  • Namespace: airflow://{host}:{port}
    • Scheme = airflow
    • Authority = {host}:{port}
  • Unique name:
    • For a directed acyclic graph (DAG): {dagName}
    • For a task: {dagName}.{taskName}

Asset URI Format

  • For a DAG: airflow://{host}:{port}/{dagName}
  • For a task: airflow://{host}:{port}/{dagName}.{taskName}

Instance URI Format

  • airflow://{host}:{port}

Parameter Limitations

  • host must start with a lowercase letter and include only lowercase letters, numbers, dash and dot (regex: [a-z][a-z0-9-.]+)
  • port must include only numbers
  • dagName and taskName must include only lowercase letters, uppercase letters, numbers, underscore, dot and dash (regex: [a-zA-Z0-9_.-]+)

Asset Examples

  • airflow://sifflet-ec2.eu-west-1:3333/DAG-ID.TASK-ID
  • airflow://airflow.example.com:8080/my-dag

Instance Examples

  • airflow://sifflet-ec2.eu-west-1:3333
  • airflow://airflow.example.com:8080

Did this page help you?