Appearance
spad.ltip.alibaba.create_dns_cname ​
Create Alibaba Cloud DNS CNAME record pointing to CDN CNAME domain
Create Alibaba Cloud DNS CNAME record for CDN domain.
Overview ​
| Property | Value |
|---|---|
| Workflow type | Linear |
| Library | App-spad |
| Version | 1.0 |
Input Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
cloud_connection_uuid | string | Yes | — | Alibaba CloudConnection.id (required when cname is set) |
alibaba_cdn_cname | string | No | — | CDN-assigned CNAME target; step skips when omitted |
alibaba_cdn_domain | string | No | — | Full CDN domain used to derive the record subdomain |
dns_zone_ref | string | No | — | DNS zone (root domain); step skips when neither input nor connection has it |
slug | string | No | — | Fallback record name when subdomain cannot be derived from cdn_domain |
oss_region | string | No | — | OSS region (cached on resource record) |
site_uuid | string | No | — | SpadSite.id for context propagation |
organization_uuid | string | No | — | Organization that owns the site |
workflow_run_id | string | No | — | Injected by the parent DAG; propagated through state_data |
workflow_run_uuid | string | No | — | Parent workflow run ID stamped by the DAG engine (legacy alias) |
Output Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
alibaba_dns_record_ref | string | No | — | Provider record id (set when DNS record is created) |
dns_skipped | boolean | No | — | True when the step skipped (no CNAME target or no zone) |
dns_skip_reason | string | No | — | Reason for skip (skip path only) |
completed_at | string | No | — | ISO8601 timestamp when the step reached COMPLETED |
failed_at | string | No | — | ISO8601 timestamp when the step reached FAILED |
failure_reason | string | No | — | Reason recorded on the failure path |
workflow_run_id | string | No | — | Injected by the parent DAG; propagated through state_data |
cloud_connection_uuid | string | No | — | Alibaba CloudConnection.id (required when cname is set) |
alibaba_cdn_cname | string | No | — | CDN-assigned CNAME target; step skips when omitted |
alibaba_cdn_domain | string | No | — | Full CDN domain used to derive the record subdomain |
dns_zone_ref | string | No | — | DNS zone (root domain); step skips when neither input nor connection has it |
slug | string | No | — | Fallback record name when subdomain cannot be derived from cdn_domain |
oss_region | string | No | — | OSS region (cached on resource record) |
site_uuid | string | No | — | SpadSite.id for context propagation |
organization_uuid | string | No | — | Organization that owns the site |
workflow_run_uuid | string | No | — | Parent workflow run ID stamped by the DAG engine (legacy alias) |
error | string | No | — | Engine-stamped failure metadata |
error_type | string | No | — | Engine-stamped failure metadata |
failed_at_state | json | No | — | Engine-stamped failure metadata |
failed_layer | json | No | — | Engine-stamped failure metadata |
failed_step | json | No | — | Engine-stamped failure metadata |
States ​
| State | Initial | Terminal | Success | Auto-advance | Description |
|---|---|---|---|---|---|
initiated | Yes | No | — | run | Step accepted |
run | No | No | — | complete | Creating DNS CNAME record |
completed | No | Yes | Yes | — | DNS CNAME created |
failed | No | Yes | No | — | DNS CNAME creation failed |
State Diagram ​
Transitions ​
| From | Action | To | Description |
|---|---|---|---|
initiated | run | run | Start DNS record creation |
run | complete | completed | Mark step completed |
* (any state) | fail | failed | Mark step failed |
API Usage ​
bash
POST /api/workflows/start
Content-Type: application/json
{
"workflow_type": "spad.ltip.alibaba.create_dns_cname",
"initial_data": {
"cloud_connection_uuid": "value"
}
}