This is an automated email from the ASF dual-hosted git repository.
henry3260 pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new f47e7c8ddb0 Rename airflowctl assets get-by-alias to get-alias (#70453)
f47e7c8ddb0 is described below
commit f47e7c8ddb08f06d76941ebea5f0f5de4b9064bb
Author: Justin Pakzad <[email protected]>
AuthorDate: Sat Aug 8 12:38:25 2026 -0400
Rename airflowctl assets get-by-alias to get-alias (#70453)
* Rename airflowctl assets get-by-alias to get-alias
* Update deprecation message and test
* Apply suggestion from @henry3260
---------
Co-authored-by: Henry Chen <[email protected]>
---
.../src/airflow/cli/commands/asset_command.py | 2 +-
.../unit/cli/commands/test_command_deprecations.py | 2 +-
airflow-ctl/docs/images/command_hashes.txt | 2 +-
airflow-ctl/docs/images/output_assets.svg | 128 ++++++++++-----------
airflow-ctl/src/airflowctl/api/operations.py | 6 +-
airflow-ctl/src/airflowctl/ctl/help_texts.yaml | 2 +-
.../tests/airflow_ctl/api/test_operations.py | 9 +-
.../ci/prek/check_airflowctl_command_coverage.py | 2 +-
8 files changed, 77 insertions(+), 76 deletions(-)
diff --git a/airflow-core/src/airflow/cli/commands/asset_command.py
b/airflow-core/src/airflow/cli/commands/asset_command.py
index c5ea47d10d2..090525d5985 100644
--- a/airflow-core/src/airflow/cli/commands/asset_command.py
+++ b/airflow-core/src/airflow/cli/commands/asset_command.py
@@ -107,7 +107,7 @@ def _detail_asset(args, *, session: Session) -> BaseModel:
return AssetResponse.model_validate(asset)
-@deprecated_for_airflowctl("airflowctl assets get / airflowctl assets
get-by-alias")
+@deprecated_for_airflowctl("airflowctl assets get / airflowctl assets
get-alias")
@cli_utils.action_cli
@provide_session
def asset_details(args, *, session: Session = NEW_SESSION) -> None:
diff --git a/airflow-core/tests/unit/cli/commands/test_command_deprecations.py
b/airflow-core/tests/unit/cli/commands/test_command_deprecations.py
index 27aa75e4938..bcb2d7bf01f 100644
--- a/airflow-core/tests/unit/cli/commands/test_command_deprecations.py
+++ b/airflow-core/tests/unit/cli/commands/test_command_deprecations.py
@@ -76,7 +76,7 @@ MIGRATED_CLI_COMMANDS = [
(variable_command.variables_import, "airflowctl variables import"),
(asset_command.asset_materialize, "airflowctl assets materialize"),
(asset_command.asset_list, "airflowctl assets list / airflowctl assets
list-aliases"),
- (asset_command.asset_details, "airflowctl assets get / airflowctl assets
get-by-alias"),
+ (asset_command.asset_details, "airflowctl assets get / airflowctl assets
get-alias"),
(provider_command.provider_get, "airflowctl providers get"),
(provider_command.providers_list, "airflowctl providers list"),
(config_command.get_value, "airflowctl config get"),
diff --git a/airflow-ctl/docs/images/command_hashes.txt
b/airflow-ctl/docs/images/command_hashes.txt
index a6fd590fcf6..4e48ad37fee 100644
--- a/airflow-ctl/docs/images/command_hashes.txt
+++ b/airflow-ctl/docs/images/command_hashes.txt
@@ -1,5 +1,5 @@
main:2c358f5fc894541cab11854dcd67658a
-assets:6419e20452692f577c4c6f570b74be0c
+assets:f225579fbecb3d919d152b4f1ba83185
auth:d79e9c7d00c432bdbcbc2a86e2e32053
backfill:74c8737b0a62a86ed3605fa9e6165874
config:a3d936cb15fe3b547bf6c82cf93d923f
diff --git a/airflow-ctl/docs/images/output_assets.svg
b/airflow-ctl/docs/images/output_assets.svg
index 12214b4fd74..c5dc475c84a 100644
--- a/airflow-ctl/docs/images/output_assets.svg
+++ b/airflow-ctl/docs/images/output_assets.svg
@@ -19,108 +19,108 @@
font-weight: 700;
}
- .terminal-2929493646-matrix {
+ .terminal-2396817043-matrix {
font-family: Fira Code, monospace;
font-size: 20px;
line-height: 24.4px;
font-variant-east-asian: full-width;
}
- .terminal-2929493646-title {
+ .terminal-2396817043-title {
font-size: 18px;
font-weight: bold;
font-family: arial;
}
- .terminal-2929493646-r1 { fill: #ff8700 }
-.terminal-2929493646-r2 { fill: #c5c8c6 }
-.terminal-2929493646-r3 { fill: #808080 }
-.terminal-2929493646-r4 { fill: #68a0b3 }
+ .terminal-2396817043-r1 { fill: #ff8700 }
+.terminal-2396817043-r2 { fill: #c5c8c6 }
+.terminal-2396817043-r3 { fill: #808080 }
+.terminal-2396817043-r4 { fill: #68a0b3 }
</style>
<defs>
- <clipPath id="terminal-2929493646-clip-terminal">
+ <clipPath id="terminal-2396817043-clip-terminal">
<rect x="0" y="0" width="914.0" height="682.1999999999999" />
</clipPath>
- <clipPath id="terminal-2929493646-line-0">
+ <clipPath id="terminal-2396817043-line-0">
<rect x="0" y="1.5" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-1">
+<clipPath id="terminal-2396817043-line-1">
<rect x="0" y="25.9" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-2">
+<clipPath id="terminal-2396817043-line-2">
<rect x="0" y="50.3" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-3">
+<clipPath id="terminal-2396817043-line-3">
<rect x="0" y="74.7" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-4">
+<clipPath id="terminal-2396817043-line-4">
<rect x="0" y="99.1" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-5">
+<clipPath id="terminal-2396817043-line-5">
<rect x="0" y="123.5" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-6">
+<clipPath id="terminal-2396817043-line-6">
<rect x="0" y="147.9" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-7">
+<clipPath id="terminal-2396817043-line-7">
<rect x="0" y="172.3" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-8">
+<clipPath id="terminal-2396817043-line-8">
<rect x="0" y="196.7" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-9">
+<clipPath id="terminal-2396817043-line-9">
<rect x="0" y="221.1" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-10">
+<clipPath id="terminal-2396817043-line-10">
<rect x="0" y="245.5" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-11">
+<clipPath id="terminal-2396817043-line-11">
<rect x="0" y="269.9" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-12">
+<clipPath id="terminal-2396817043-line-12">
<rect x="0" y="294.3" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-13">
+<clipPath id="terminal-2396817043-line-13">
<rect x="0" y="318.7" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-14">
+<clipPath id="terminal-2396817043-line-14">
<rect x="0" y="343.1" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-15">
+<clipPath id="terminal-2396817043-line-15">
<rect x="0" y="367.5" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-16">
+<clipPath id="terminal-2396817043-line-16">
<rect x="0" y="391.9" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-17">
+<clipPath id="terminal-2396817043-line-17">
<rect x="0" y="416.3" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-18">
+<clipPath id="terminal-2396817043-line-18">
<rect x="0" y="440.7" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-19">
+<clipPath id="terminal-2396817043-line-19">
<rect x="0" y="465.1" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-20">
+<clipPath id="terminal-2396817043-line-20">
<rect x="0" y="489.5" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-21">
+<clipPath id="terminal-2396817043-line-21">
<rect x="0" y="513.9" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-22">
+<clipPath id="terminal-2396817043-line-22">
<rect x="0" y="538.3" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-23">
+<clipPath id="terminal-2396817043-line-23">
<rect x="0" y="562.7" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-24">
+<clipPath id="terminal-2396817043-line-24">
<rect x="0" y="587.1" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-25">
+<clipPath id="terminal-2396817043-line-25">
<rect x="0" y="611.5" width="915" height="24.65"/>
</clipPath>
-<clipPath id="terminal-2929493646-line-26">
+<clipPath id="terminal-2396817043-line-26">
<rect x="0" y="635.9" width="915" height="24.65"/>
</clipPath>
</defs>
@@ -132,37 +132,37 @@
<circle cx="44" cy="0" r="7" fill="#28c840"/>
</g>
- <g transform="translate(9, 41)"
clip-path="url(#terminal-2929493646-clip-terminal)">
+ <g transform="translate(9, 41)"
clip-path="url(#terminal-2396817043-clip-terminal)">
- <g class="terminal-2929493646-matrix">
- <text class="terminal-2929493646-r1" x="0" y="20" textLength="73.2"
clip-path="url(#terminal-2929493646-line-0)">Usage:</text><text
class="terminal-2929493646-r3" x="85.4" y="20" textLength="207.4"
clip-path="url(#terminal-2929493646-line-0)">airflowctl assets</text><text
class="terminal-2929493646-r2" x="292.8" y="20" textLength="24.4"
clip-path="url(#terminal-2929493646-line-0)"> [</text><text
class="terminal-2929493646-r4" x="317.2" y="20" textLength="24.4" clip-path="ur
[...]
-</text><text class="terminal-2929493646-r2" x="915" y="44.4" textLength="12.2"
clip-path="url(#terminal-2929493646-line-1)">
-</text><text class="terminal-2929493646-r2" x="0" y="68.8" textLength="305"
clip-path="url(#terminal-2929493646-line-2)">Perform Assets operations</text><text
class="terminal-2929493646-r2" x="915" y="68.8" textLength="12.2"
clip-path="url(#terminal-2929493646-line-2)">
-</text><text class="terminal-2929493646-r2" x="915" y="93.2" textLength="12.2"
clip-path="url(#terminal-2929493646-line-3)">
-</text><text class="terminal-2929493646-r1" x="0" y="117.6" textLength="256.2"
clip-path="url(#terminal-2929493646-line-4)">Positional Arguments:</text><text
class="terminal-2929493646-r2" x="915" y="117.6" textLength="12.2"
clip-path="url(#terminal-2929493646-line-4)">
-</text><text class="terminal-2929493646-r4" x="24.4" y="142" textLength="85.4"
clip-path="url(#terminal-2929493646-line-5)">COMMAND</text><text
class="terminal-2929493646-r2" x="915" y="142" textLength="12.2"
clip-path="url(#terminal-2929493646-line-5)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="166.4"
textLength="146.4"
clip-path="url(#terminal-2929493646-line-6)">create-event</text><text
class="terminal-2929493646-r2" x="292.8" y="166.4" textLength="402.6"
clip-path="url(#terminal-2929493646-line-6)">Create an event for a given asset</text><text
class="terminal-2929493646-r2" x="915" y="166.4" textLength="12.2"
clip-path="url(#terminal-2929493646-line-6)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="190.8"
textLength="292.8"
clip-path="url(#terminal-2929493646-line-7)">delete-dag-queued-events</text><text
class="terminal-2929493646-r2" x="915" y="190.8" textLength="12.2"
clip-path="url(#terminal-2929493646-line-7)">
-</text><text class="terminal-2929493646-r2" x="292.8" y="215.2"
textLength="561.2"
clip-path="url(#terminal-2929493646-line-8)">Delete all queued asset events for a given Dag</text><text
class="terminal-2929493646-r2" x="915" y="215.2" textLength="12.2"
clip-path="url(#terminal-2929493646-line-8)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="239.6"
textLength="231.8"
clip-path="url(#terminal-2929493646-line-9)">delete-queued-event</text><text
class="terminal-2929493646-r2" x="915" y="239.6" textLength="12.2"
clip-path="url(#terminal-2929493646-line-9)">
-</text><text class="terminal-2929493646-r2" x="292.8" y="264"
textLength="597.8"
clip-path="url(#terminal-2929493646-line-10)">Delete a specific queued asset event for a given </text><text
class="terminal-2929493646-r2" x="915" y="264" textLength="12.2"
clip-path="url(#terminal-2929493646-line-10)">
-</text><text class="terminal-2929493646-r2" x="0" y="288.4" textLength="158.6"
clip-path="url(#terminal-2929493646-line-11)">Dag and asset</text><text
class="terminal-2929493646-r2" x="915" y="288.4" textLength="12.2"
clip-path="url(#terminal-2929493646-line-11)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="312.8"
textLength="244"
clip-path="url(#terminal-2929493646-line-12)">delete-queued-events</text><text
class="terminal-2929493646-r2" x="915" y="312.8" textLength="12.2"
clip-path="url(#terminal-2929493646-line-12)">
-</text><text class="terminal-2929493646-r2" x="292.8" y="337.2"
textLength="512.4"
clip-path="url(#terminal-2929493646-line-13)">Delete all queued events for a given asset</text><text
class="terminal-2929493646-r2" x="915" y="337.2" textLength="12.2"
clip-path="url(#terminal-2929493646-line-13)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="361.6"
textLength="36.6" clip-path="url(#terminal-2929493646-line-14)">get</text><text
class="terminal-2929493646-r2" x="292.8" y="361.6" textLength="329.4"
clip-path="url(#terminal-2929493646-line-14)">Retrieve an asset by its ID</text><text
class="terminal-2929493646-r2" x="915" y="361.6" textLength="12.2"
clip-path="url(#terminal-2929493646-line-14)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="386"
textLength="146.4"
clip-path="url(#terminal-2929493646-line-15)">get-by-alias</text><text
class="terminal-2929493646-r2" x="292.8" y="386" textLength="366"
clip-path="url(#terminal-2929493646-line-15)">Retrieve an asset by its alias</text><text
class="terminal-2929493646-r2" x="915" y="386" textLength="12.2"
clip-path="url(#terminal-2929493646-line-15)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="410.4"
textLength="244"
clip-path="url(#terminal-2929493646-line-16)">get-dag-queued-event</text><text
class="terminal-2929493646-r2" x="915" y="410.4" textLength="12.2"
clip-path="url(#terminal-2929493646-line-16)">
-</text><text class="terminal-2929493646-r2" x="292.8" y="434.8"
textLength="622.2"
clip-path="url(#terminal-2929493646-line-17)">Retrieve a specific queued asset event for a given </text><text
class="terminal-2929493646-r2" x="915" y="434.8" textLength="12.2"
clip-path="url(#terminal-2929493646-line-17)">
-</text><text class="terminal-2929493646-r2" x="0" y="459.2" textLength="158.6"
clip-path="url(#terminal-2929493646-line-18)">Dag and asset</text><text
class="terminal-2929493646-r2" x="915" y="459.2" textLength="12.2"
clip-path="url(#terminal-2929493646-line-18)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="483.6"
textLength="256.2"
clip-path="url(#terminal-2929493646-line-19)">get-dag-queued-events</text><text
class="terminal-2929493646-r2" x="915" y="483.6" textLength="12.2"
clip-path="url(#terminal-2929493646-line-19)">
-</text><text class="terminal-2929493646-r2" x="292.8" y="508" textLength="488"
clip-path="url(#terminal-2929493646-line-20)">List queued asset events for a given Dag</text><text
class="terminal-2929493646-r2" x="915" y="508" textLength="12.2"
clip-path="url(#terminal-2929493646-line-20)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="532.4"
textLength="207.4"
clip-path="url(#terminal-2929493646-line-21)">get-queued-events</text><text
class="terminal-2929493646-r2" x="292.8" y="532.4" textLength="439.2"
clip-path="url(#terminal-2929493646-line-21)">List queued events for a given asset</text><text
class="terminal-2929493646-r2" x="915" y="532.4" textLength="12.2"
clip-path="url(#terminal-2929493646-line-21)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="556.8"
textLength="48.8"
clip-path="url(#terminal-2929493646-line-22)">list</text><text
class="terminal-2929493646-r2" x="292.8" y="556.8" textLength="183"
clip-path="url(#terminal-2929493646-line-22)">List all assets</text><text
class="terminal-2929493646-r2" x="915" y="556.8" textLength="12.2"
clip-path="url(#terminal-2929493646-line-22)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="581.2"
textLength="146.4"
clip-path="url(#terminal-2929493646-line-23)">list-aliases</text><text
class="terminal-2929493646-r2" x="292.8" y="581.2" textLength="268.4"
clip-path="url(#terminal-2929493646-line-23)">List all asset aliases</text><text
class="terminal-2929493646-r2" x="915" y="581.2" textLength="12.2"
clip-path="url(#terminal-2929493646-line-23)">
-</text><text class="terminal-2929493646-r4" x="48.8" y="605.6"
textLength="134.2"
clip-path="url(#terminal-2929493646-line-24)">materialize</text><text
class="terminal-2929493646-r2" x="292.8" y="605.6" textLength="549"
clip-path="url(#terminal-2929493646-line-24)">Trigger materialization of an asset by its ID</text><text
class="terminal-2929493646-r2" x="915" y="605.6" textLength="12.2"
clip-path="url(#terminal-2929493646-line-24)">
-</text><text class="terminal-2929493646-r2" x="915" y="630" textLength="12.2"
clip-path="url(#terminal-2929493646-line-25)">
-</text><text class="terminal-2929493646-r1" x="0" y="654.4" textLength="97.6"
clip-path="url(#terminal-2929493646-line-26)">Options:</text><text
class="terminal-2929493646-r2" x="915" y="654.4" textLength="12.2"
clip-path="url(#terminal-2929493646-line-26)">
-</text><text class="terminal-2929493646-r4" x="24.4" y="678.8"
textLength="24.4" clip-path="url(#terminal-2929493646-line-27)">-h</text><text
class="terminal-2929493646-r2" x="48.8" y="678.8" textLength="24.4"
clip-path="url(#terminal-2929493646-line-27)">, </text><text
class="terminal-2929493646-r4" x="73.2" y="678.8" textLength="73.2"
clip-path="url(#terminal-2929493646-line-27)">--help</text><text
class="terminal-2929493646-r2" x="292.8" y="678.8" textLength="378.2"
clip-path="ur [...]
+ <g class="terminal-2396817043-matrix">
+ <text class="terminal-2396817043-r1" x="0" y="20" textLength="73.2"
clip-path="url(#terminal-2396817043-line-0)">Usage:</text><text
class="terminal-2396817043-r3" x="85.4" y="20" textLength="207.4"
clip-path="url(#terminal-2396817043-line-0)">airflowctl assets</text><text
class="terminal-2396817043-r2" x="292.8" y="20" textLength="24.4"
clip-path="url(#terminal-2396817043-line-0)"> [</text><text
class="terminal-2396817043-r4" x="317.2" y="20" textLength="24.4" clip-path="ur
[...]
+</text><text class="terminal-2396817043-r2" x="915" y="44.4" textLength="12.2"
clip-path="url(#terminal-2396817043-line-1)">
+</text><text class="terminal-2396817043-r2" x="0" y="68.8" textLength="305"
clip-path="url(#terminal-2396817043-line-2)">Perform Assets operations</text><text
class="terminal-2396817043-r2" x="915" y="68.8" textLength="12.2"
clip-path="url(#terminal-2396817043-line-2)">
+</text><text class="terminal-2396817043-r2" x="915" y="93.2" textLength="12.2"
clip-path="url(#terminal-2396817043-line-3)">
+</text><text class="terminal-2396817043-r1" x="0" y="117.6" textLength="256.2"
clip-path="url(#terminal-2396817043-line-4)">Positional Arguments:</text><text
class="terminal-2396817043-r2" x="915" y="117.6" textLength="12.2"
clip-path="url(#terminal-2396817043-line-4)">
+</text><text class="terminal-2396817043-r4" x="24.4" y="142" textLength="85.4"
clip-path="url(#terminal-2396817043-line-5)">COMMAND</text><text
class="terminal-2396817043-r2" x="915" y="142" textLength="12.2"
clip-path="url(#terminal-2396817043-line-5)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="166.4"
textLength="146.4"
clip-path="url(#terminal-2396817043-line-6)">create-event</text><text
class="terminal-2396817043-r2" x="292.8" y="166.4" textLength="402.6"
clip-path="url(#terminal-2396817043-line-6)">Create an event for a given asset</text><text
class="terminal-2396817043-r2" x="915" y="166.4" textLength="12.2"
clip-path="url(#terminal-2396817043-line-6)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="190.8"
textLength="292.8"
clip-path="url(#terminal-2396817043-line-7)">delete-dag-queued-events</text><text
class="terminal-2396817043-r2" x="915" y="190.8" textLength="12.2"
clip-path="url(#terminal-2396817043-line-7)">
+</text><text class="terminal-2396817043-r2" x="292.8" y="215.2"
textLength="561.2"
clip-path="url(#terminal-2396817043-line-8)">Delete all queued asset events for a given Dag</text><text
class="terminal-2396817043-r2" x="915" y="215.2" textLength="12.2"
clip-path="url(#terminal-2396817043-line-8)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="239.6"
textLength="231.8"
clip-path="url(#terminal-2396817043-line-9)">delete-queued-event</text><text
class="terminal-2396817043-r2" x="915" y="239.6" textLength="12.2"
clip-path="url(#terminal-2396817043-line-9)">
+</text><text class="terminal-2396817043-r2" x="292.8" y="264"
textLength="597.8"
clip-path="url(#terminal-2396817043-line-10)">Delete a specific queued asset event for a given </text><text
class="terminal-2396817043-r2" x="915" y="264" textLength="12.2"
clip-path="url(#terminal-2396817043-line-10)">
+</text><text class="terminal-2396817043-r2" x="0" y="288.4" textLength="158.6"
clip-path="url(#terminal-2396817043-line-11)">Dag and asset</text><text
class="terminal-2396817043-r2" x="915" y="288.4" textLength="12.2"
clip-path="url(#terminal-2396817043-line-11)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="312.8"
textLength="244"
clip-path="url(#terminal-2396817043-line-12)">delete-queued-events</text><text
class="terminal-2396817043-r2" x="915" y="312.8" textLength="12.2"
clip-path="url(#terminal-2396817043-line-12)">
+</text><text class="terminal-2396817043-r2" x="292.8" y="337.2"
textLength="512.4"
clip-path="url(#terminal-2396817043-line-13)">Delete all queued events for a given asset</text><text
class="terminal-2396817043-r2" x="915" y="337.2" textLength="12.2"
clip-path="url(#terminal-2396817043-line-13)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="361.6"
textLength="36.6" clip-path="url(#terminal-2396817043-line-14)">get</text><text
class="terminal-2396817043-r2" x="292.8" y="361.6" textLength="329.4"
clip-path="url(#terminal-2396817043-line-14)">Retrieve an asset by its ID</text><text
class="terminal-2396817043-r2" x="915" y="361.6" textLength="12.2"
clip-path="url(#terminal-2396817043-line-14)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="386"
textLength="109.8"
clip-path="url(#terminal-2396817043-line-15)">get-alias</text><text
class="terminal-2396817043-r2" x="292.8" y="386" textLength="402.6"
clip-path="url(#terminal-2396817043-line-15)">Retrieve an asset alias by its ID</text><text
class="terminal-2396817043-r2" x="915" y="386" textLength="12.2"
clip-path="url(#terminal-2396817043-line-15)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="410.4"
textLength="244"
clip-path="url(#terminal-2396817043-line-16)">get-dag-queued-event</text><text
class="terminal-2396817043-r2" x="915" y="410.4" textLength="12.2"
clip-path="url(#terminal-2396817043-line-16)">
+</text><text class="terminal-2396817043-r2" x="292.8" y="434.8"
textLength="622.2"
clip-path="url(#terminal-2396817043-line-17)">Retrieve a specific queued asset event for a given </text><text
class="terminal-2396817043-r2" x="915" y="434.8" textLength="12.2"
clip-path="url(#terminal-2396817043-line-17)">
+</text><text class="terminal-2396817043-r2" x="0" y="459.2" textLength="158.6"
clip-path="url(#terminal-2396817043-line-18)">Dag and asset</text><text
class="terminal-2396817043-r2" x="915" y="459.2" textLength="12.2"
clip-path="url(#terminal-2396817043-line-18)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="483.6"
textLength="256.2"
clip-path="url(#terminal-2396817043-line-19)">get-dag-queued-events</text><text
class="terminal-2396817043-r2" x="915" y="483.6" textLength="12.2"
clip-path="url(#terminal-2396817043-line-19)">
+</text><text class="terminal-2396817043-r2" x="292.8" y="508" textLength="488"
clip-path="url(#terminal-2396817043-line-20)">List queued asset events for a given Dag</text><text
class="terminal-2396817043-r2" x="915" y="508" textLength="12.2"
clip-path="url(#terminal-2396817043-line-20)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="532.4"
textLength="207.4"
clip-path="url(#terminal-2396817043-line-21)">get-queued-events</text><text
class="terminal-2396817043-r2" x="292.8" y="532.4" textLength="439.2"
clip-path="url(#terminal-2396817043-line-21)">List queued events for a given asset</text><text
class="terminal-2396817043-r2" x="915" y="532.4" textLength="12.2"
clip-path="url(#terminal-2396817043-line-21)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="556.8"
textLength="48.8"
clip-path="url(#terminal-2396817043-line-22)">list</text><text
class="terminal-2396817043-r2" x="292.8" y="556.8" textLength="183"
clip-path="url(#terminal-2396817043-line-22)">List all assets</text><text
class="terminal-2396817043-r2" x="915" y="556.8" textLength="12.2"
clip-path="url(#terminal-2396817043-line-22)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="581.2"
textLength="146.4"
clip-path="url(#terminal-2396817043-line-23)">list-aliases</text><text
class="terminal-2396817043-r2" x="292.8" y="581.2" textLength="268.4"
clip-path="url(#terminal-2396817043-line-23)">List all asset aliases</text><text
class="terminal-2396817043-r2" x="915" y="581.2" textLength="12.2"
clip-path="url(#terminal-2396817043-line-23)">
+</text><text class="terminal-2396817043-r4" x="48.8" y="605.6"
textLength="134.2"
clip-path="url(#terminal-2396817043-line-24)">materialize</text><text
class="terminal-2396817043-r2" x="292.8" y="605.6" textLength="549"
clip-path="url(#terminal-2396817043-line-24)">Trigger materialization of an asset by its ID</text><text
class="terminal-2396817043-r2" x="915" y="605.6" textLength="12.2"
clip-path="url(#terminal-2396817043-line-24)">
+</text><text class="terminal-2396817043-r2" x="915" y="630" textLength="12.2"
clip-path="url(#terminal-2396817043-line-25)">
+</text><text class="terminal-2396817043-r1" x="0" y="654.4" textLength="97.6"
clip-path="url(#terminal-2396817043-line-26)">Options:</text><text
class="terminal-2396817043-r2" x="915" y="654.4" textLength="12.2"
clip-path="url(#terminal-2396817043-line-26)">
+</text><text class="terminal-2396817043-r4" x="24.4" y="678.8"
textLength="24.4" clip-path="url(#terminal-2396817043-line-27)">-h</text><text
class="terminal-2396817043-r2" x="48.8" y="678.8" textLength="24.4"
clip-path="url(#terminal-2396817043-line-27)">, </text><text
class="terminal-2396817043-r4" x="73.2" y="678.8" textLength="73.2"
clip-path="url(#terminal-2396817043-line-27)">--help</text><text
class="terminal-2396817043-r2" x="292.8" y="678.8" textLength="378.2"
clip-path="ur [...]
</text>
</g>
</g>
diff --git a/airflow-ctl/src/airflowctl/api/operations.py
b/airflow-ctl/src/airflowctl/api/operations.py
index 0e561027887..4916203247a 100644
--- a/airflow-ctl/src/airflowctl/api/operations.py
+++ b/airflow-ctl/src/airflowctl/api/operations.py
@@ -264,9 +264,9 @@ class AssetsOperations(BaseOperations):
self.response = self.client.get(f"assets/{asset_id}")
return AssetResponse.model_validate_json(self.response.content)
- def get_by_alias(self, alias: str) -> AssetAliasResponse |
ServerResponseError:
- """Get an asset by alias from the API server."""
- self.response = self.client.get(f"assets/aliases/{alias}")
+ def get_alias(self, asset_alias_id: str) -> AssetAliasResponse |
ServerResponseError:
+ """Get an asset alias by its ID from the API server."""
+ self.response = self.client.get(f"assets/aliases/{asset_alias_id}")
return AssetAliasResponse.model_validate_json(self.response.content)
def list(self) -> AssetCollectionResponse | ServerResponseError:
diff --git a/airflow-ctl/src/airflowctl/ctl/help_texts.yaml
b/airflow-ctl/src/airflowctl/ctl/help_texts.yaml
index 08626e00930..4944c60dbdf 100644
--- a/airflow-ctl/src/airflowctl/ctl/help_texts.yaml
+++ b/airflow-ctl/src/airflowctl/ctl/help_texts.yaml
@@ -17,7 +17,7 @@
---
assets:
get: "Retrieve an asset by its ID"
- get-by-alias: "Retrieve an asset by its alias"
+ get-alias: "Retrieve an asset alias by its ID"
list: "List all assets"
list-aliases: "List all asset aliases"
create-event: "Create an event for a given asset"
diff --git a/airflow-ctl/tests/airflow_ctl/api/test_operations.py
b/airflow-ctl/tests/airflow_ctl/api/test_operations.py
index 1bc183d4f45..52fa594afd5 100644
--- a/airflow-ctl/tests/airflow_ctl/api/test_operations.py
+++ b/airflow-ctl/tests/airflow_ctl/api/test_operations.py
@@ -287,6 +287,7 @@ class TestBaseOperations:
class TestAssetsOperations:
asset_id: int = 1
+ asset_alias_id: int = 2
dag_id: str = "dag_id"
before: str = "2024-12-31T23:59:59+00:00"
asset_response = AssetResponse(
@@ -304,7 +305,7 @@ class TestAssetsOperations:
group="group",
)
asset_alias_response = AssetAliasResponse(
- id=asset_id,
+ id=asset_alias_id,
name="asset",
group="group",
)
@@ -395,13 +396,13 @@ class TestAssetsOperations:
response = client.assets.get(self.asset_id)
assert response == self.asset_response
- def test_get_by_alias(self):
+ def test_get_alias(self):
def handle_request(request: httpx.Request) -> httpx.Response:
- assert request.url.path ==
f"/api/v2/assets/aliases/{self.asset_id}"
+ assert request.url.path ==
f"/api/v2/assets/aliases/{self.asset_alias_id}"
return httpx.Response(200,
json=json.loads(self.asset_alias_response.model_dump_json()))
client = make_api_client(transport=httpx.MockTransport(handle_request))
- response = client.assets.get_by_alias(self.asset_id)
+ response = client.assets.get_alias(self.asset_alias_id)
assert response == self.asset_alias_response
def test_list(self):
diff --git a/scripts/ci/prek/check_airflowctl_command_coverage.py
b/scripts/ci/prek/check_airflowctl_command_coverage.py
index 44ef0c34bb8..a8a767453fc 100755
--- a/scripts/ci/prek/check_airflowctl_command_coverage.py
+++ b/scripts/ci/prek/check_airflowctl_command_coverage.py
@@ -53,7 +53,7 @@ EXCLUDED_COMMANDS = {
"assets delete-dag-queued-events",
"assets delete-queued-event",
"assets delete-queued-events",
- "assets get-by-alias",
+ "assets get-alias",
"assets get-dag-queued-event",
"assets get-dag-queued-events",
"assets get-queued-events",
