dheerajturaga commented on code in PR #73763: URL: https://github.com/apache/airflow/pull/73763#discussion_r4166631705
########## airflow-core/docs/core-concepts/dags.rst: ########## @@ -813,6 +815,16 @@ the scheduler automatically changes the Dag to paused. A backfill started while the drain until its Dag runs have been created and finished. While a Dag is draining, you can cancel the drain to make the Dag active again. +A manual run, backfill or asset materialization on a paused Dag can drain the Dag instead of unpausing it. +Choose **Drain** under **Dag is paused** in the UI form, or set ``drain_dag`` to ``true`` in the REST API +request. This changes the whole Dag, not only the new run: every unfinished Dag run proceeds, so Dag runs that Review Comment: Updated the docs, existing newsfragment, API field descriptions, and UI copy to name the paused-backfill exception: those runs remain held and keep the Dag draining until the backfill resumes and its runs finish. Regenerated the API spec and clients. --- Drafted-by: Codex (GPT-6); reviewed by @dheerajturaga before posting -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
