Skip to main content

rg role

Manage RAM roles

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

create

ecctl rg role create [flags]

Create role

  • Kind: mutation · Risk: medium
APIWhen calledPurpose
CreateRoleEvery time the command runs.Perform the resource operation.
GetRoleEvery time the command runs.Read the resource view.
ParameterTypeRequiredDescription
--assume-role-policy-documentstringtrust policy JSON or @file
--namestringrole name
--regionstringAlibaba Cloud region
--descriptionstringrole description
--max-session-durationintegermaximum session duration in seconds

update

ecctl rg role update <name> [flags]

Update role

  • Kind: mutation · Risk: medium
APIWhen calledPurpose
UpdateRoleEvery time the command runs.Perform the resource operation.
GetRoleEvery time the command runs.Read the resource view.
ParameterTypeRequiredDescription
--regionstringAlibaba Cloud region
--assume-role-policy-documentstringtrust policy JSON or @file
--descriptionstringrole description
--max-session-durationintegermaximum session duration in seconds

delete

ecctl rg role delete <name> [flags]

Delete role

  • Kind: mutation · Risk: high
APIWhen calledPurpose
DeleteRoleEvery time the command runs.Perform the resource operation.
ParameterTypeRequiredDescription
--regionstringAlibaba Cloud region

get

ecctl rg role get <name> [flags]

Get role

  • Kind: read · Risk: low
APIWhen calledPurpose
GetRoleEvery time the command runs.Read the resource view.
ParameterTypeRequiredDescription
--regionstringAlibaba Cloud region
--fieldsstringcomma-separated resource fields to include
--languagestringlanguage for role info

list

ecctl rg role list [flags]

List roles

  • Kind: read · Risk: low
APIWhen calledPurpose
ListRolesEvery time the command runs.Read the resource view.
ParameterTypeRequiredDescription
--regionstringAlibaba Cloud region
--fieldsstringcomma-separated resource fields to include
--limitintegermaximum resources to return (default: 100)
--pageintegerresults page to return (default: 1)