Skip to main content

ecs prefix-list

Manage prefix lists

Run ecctl ecs prefix-list <action> -h for usage, or ecctl schema ecs.prefix-list.<action> --full for the complete, agent-readable spec of every parameter and behavior.

create​

ecctl ecs prefix-list create [flags]

Create prefix list

  • Kind: mutation · Risk: medium
  • Synchronous: waits for matched (waiter entries_visible, timeout 300s); use --no-wait to skip.
  • Idempotent via ClientToken.
APIWhen calledPurpose
CreatePrefixListEvery time the command runs.Perform the resource operation.
DescribePrefixListAttributesWhen --no-wait is not specified and --entry is specified.Poll until the resource reaches the target state. (repeated)
DescribePrefixListAttributesWhen --no-wait is not specified.Read the resource view.
ParameterTypeRequiredDescription
--address-familystring✓IP address family
--max-entriesinteger✓maximum number of entries
--namestring✓prefix list name
--regionstring✓Alibaba Cloud region
--descriptionstringprefix list description
--entryobjectprefix list entries to create
--resource-groupstringresource group ID
--tagkey_valuetag assignment key=value

update​

ecctl ecs prefix-list update <id> [flags]

Update prefix list

  • Kind: mutation · Risk: medium
  • Synchronous: waits for matched (waiter entries_visible, timeout 300s); use --no-wait to skip.
APIWhen calledPurpose
ModifyPrefixListEvery time the command runs.Perform the resource operation.
DescribePrefixListAttributesWhen --no-wait is not specified and --entry contains a value prefixed with +.Poll until the resource reaches the target state. (repeated)
DescribePrefixListAttributesWhen --no-wait is not specified and --entry contains a value prefixed with -.Poll until the resource reaches the target state. (repeated)
DescribePrefixListAttributesWhen --no-wait is not specified.Read the resource view.
ParameterTypeRequiredDescription
--regionstring✓Alibaba Cloud region
--descriptionstringprefix list description
--entrystringentry change; prefix with + to add or - to remove
--namestringprefix list name

delete​

ecctl ecs prefix-list delete <id> [flags]

Delete prefix list

  • Kind: mutation · Risk: high
APIWhen calledPurpose
DeletePrefixListEvery time the command runs.Perform the resource operation.
ParameterTypeRequiredDescription
--regionstring✓Alibaba Cloud region

get​

ecctl ecs prefix-list get <id> [flags]

Get prefix list

  • Kind: read · Risk: low
APIWhen calledPurpose
DescribePrefixListAttributesEvery time the command runs.Read the resource view.
DescribePrefixListAssociationsWhen --with-associations is specified.Read the resource view.
ParameterTypeRequiredDescription
--regionstring✓Alibaba Cloud region
--fieldsstringcomma-separated resource fields to include
--with-associationsbooleaninclude associated resources

list​

ecctl ecs prefix-list list [<ids>...] [flags]

List prefix lists

  • Kind: read · Risk: low
APIWhen calledPurpose
DescribePrefixListsEvery time the command runs.Read the resource view.
ParameterTypeRequiredDescription
--regionstring✓Alibaba Cloud region
--fieldsstringcomma-separated resource fields to include
--filterkey_valuefilter expression key=value
--limitintegermaximum resources to return (default: 100)
--next-tokenstringtoken for the next result page