訪問控制(RAM)是阿里云提供的管理用戶身份與資源訪問權限的服務。使用RAM可以讓您避免與其他用戶共享阿里云賬號密鑰,并可按需為用戶授予最小權限。RAM中使用權限策略描述授權的具體內容。
本文為您介紹容器服務Kubernetes版(CS)為RAM權限策略定義的操作(Action)、資源(Resource)和條件(Condition)。容器服務Kubernetes版(CS)的RAM代碼(RamCode)為[{"popCode":"CS","ramCodes":["cs"]},{"popCode":"cs-inner","ramCodes":["cs"]}],支持的授權粒度為RESOURCE。
權限策略通用結構
權限策略支持JSON格式,其通用結構如下:
{
"Version": "1",
"Statement": [
{
"Effect": "<Effect>",
"Action": "<Action>",
"Resource": "<Resource>",
"Condition": {
"<Condition_operator>": {
"<Condition_key>": [
"<Condition_value>"
]
}
}
}
]
}
- Effect:權限策略效果。取值:Allow(允許)、Deny(拒絕)。
- Action:授予允許或拒絕權限的具體操作。具體信息,請參見操作(Action)。
- Resource:受操作影響的具體對象,您可以使用資源ARN來描述指定資源。具體信息,請參見資源(Resource)。
- Condition:指授權生效的條件。可選字段。具體信息,請參見條件(Condition)。
- Condition_operator:條件運算符,不同類型的條件對應不同的條件運算符。具體信息,請參見權限策略基本元素。
- Condition_key:條件關鍵字。
- Condition_value:條件關鍵字對應的值。
操作(Action)
下表是容器服務Kubernetes版(CS)定義的操作,這些操作可以在RAM權限策略語句的Action
元素中使用,用來授予執行該操作的權限。下面對表中的具體項提供說明:- 操作:是指具體的權限點。
- API:是指操作對應的API接口。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。該列不體現適用于任何操作的通用條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | API | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|---|
cs:GetClusterDiagnosisResult | GetClusterDiagnosisResult | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeClusterDetail | DescribeClusterDetail | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeClusterResources | DescribeClusterResources | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeClusterNodePools | DescribeClusterNodePools | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:OpenAckService | OpenAckService | update | 全部資源 * | 無 | 無 |
cs:DescribeKubernetesVersionMetadata | DescribeKubernetesVersionMetadata | get | 全部資源 * | 無 | 無 |
cs:DescribeNodePoolVuls | DescribeNodePoolVuls | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#cluster_id} | 無 | 無 |
cs:ResumeTask | ResumeTask | update | 全部資源 * | 無 | 無 |
cs:TagResources | TagResources | update | 全部資源 * | 無 | 無 |
cs:CreateClusterNodePool | CreateClusterNodePool | create | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeTemplateAttribute | DescribeTemplateAttribute | get | 全部資源 * | 無 | 無 |
cs:DescribeClusterAddonInstance | DescribeClusterAddonInstance | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribePolicies | DescribePolicies | get | 全部資源 * | 無 | 無 |
cs:PauseClusterUpgrade | PauseClusterUpgrade | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:CheckControlPlaneLogEnable | CheckControlPlaneLogEnable | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DeployPolicyInstance | DeployPolicyInstance | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:CreateAutoscalingConfig | CreateAutoscalingConfig | create | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeUserClusterNamespaces | DescribeUserClusterNamespaces | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ModifyClusterAddon | ModifyClusterAddon | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | cs:AddonName cs:AddonNames | 無 |
cs:DescribeClusterNodes | DescribeClusterNodes | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribePolicyGovernanceInCluster | DescribePolicyGovernanceInCluster | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:GetUserPermissions | DescribeUserPermission | get | 全部資源 * | 無 | 無 |
cs:MigrateCluster | MigrateCluster | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:CreateTrigger | CreateTrigger | create | 全部資源 * | 無 | 無 |
cs:DescribeClusterTasks | DescribeClusterTasks | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#cluster_id} | 無 | 無 |
cs:GrantPermission | GrantPermissions | update | 全部資源 * | 無 | 無 |
cs:DescribeEventsForRegion | DescribeEventsForRegion | list | 全部資源 * | 無 | 無 |
cs:DescribeClusterUserKubeconfig | DescribeClusterUserKubeconfig | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | cs:KubeConfigDurationMinutes | 無 |
cs:DescribeClusterVuls | DescribeClusterVuls | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:CreateTemplate | CreateTemplate | create | 全部資源 * | 無 | 無 |
cs:Queryk8sComponentsUpdateVersion | DescribeClusterAddonsVersion | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ModifyClusterTags | ModifyClusterTags | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:UntagResources | UntagResources | delete | 全部資源 * | 無 | 無 |
cs:DeleteTemplate | DeleteTemplate | delete | 全部資源 * | 無 | 無 |
cs:ModifyPolicyInstance | ModifyPolicyInstance | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeTrigger | DescribeTrigger | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:UpdateControlPlaneLog | UpdateControlPlaneLog | Write | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | cs:EnableCoreControlPlaneComponentsLog | 無 |
cs:DescribeClusterAddonsUpgradeStatus | DescribeClusterAddonsUpgradeStatus | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ListOperationPlans | ListOperationPlans | list | 全部資源 * | 無 | 無 |
cs:DescribeClusterNodePoolDetail | DescribeClusterNodePoolDetail | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ModifyNodePoolNodeConfig | ModifyNodePoolNodeConfig | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ModifyClusterNodePool | ModifyClusterNodePool | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:CreateCluster | CreateCluster | create | Cluster acs:cs:{#regionId}:{#accountId}:cluster/* | cs:ClusterType cs:ClusterSpec cs:ClusterProfile cs:EnableSecretEncryption cs:EnableApiServerEip cs:EnableAddonLogtailDs cs:EnableCoreControlPlaneComponentsLog cs:AddonNames | 無 |
cs:GetUpgradeStatus | GetUpgradeStatus | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ListClusterChecks | ListClusterChecks | list | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:UpgradeCluster | UpgradeCluster | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ModifyCluster | ModifyCluster | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | cs:EnableApiServerEip cs:ApiServerEipId | 無 |
cs:DescribeAddon | DescribeAddon | get | 全部資源 * | 無 | 無 |
cs:DeleteClusterNodes | DeleteClusterNodes | delete | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribePolicyDetails | DescribePolicyDetails | get | 全部資源 * | 無 | 無 |
cs:AttachInstancesToNodePool | AttachInstancesToNodePool | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ListClusterAddonInstances | ListClusterAddonInstances | list | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:InstallClusterAddons | InstallClusterAddons | create | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | cs:AddonNames | 無 |
cs:DescribeTaskInfo | DescribeTaskInfo | get | 全部資源 * | 無 | 無 |
cs:UpdateTemplate | UpdateTemplate | update | 全部資源 * | 無 | 無 |
cs:GetClusterAddonInstance | GetClusterAddonInstance | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:CreateClusterDiagnosis | CreateClusterDiagnosis | create | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ListTagResources | ListTagResources | get | 全部資源 * | 無 | 無 |
cs:DeleteTrigger | DeleteTrigger | delete | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeClusterLogs | DescribeClusterLogs | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeClusterAddonMetadata | DescribeClusterAddonMetadata | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeClustersForRegion | DescribeClustersForRegion | list | 全部資源 * | 無 | 無 |
cs:DescribeSubaccountK8sClusterUserConfig | DescribeSubaccountK8sClusterUserConfig | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:UpgradeClusterNodepool | UpgradeClusterNodepool | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ScanClusterVuls | ScanClusterVuls | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:RepairClusterNodePool | RepairClusterNodePool | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#cluster_id} | 無 | 無 |
cs:DescribePolicyInstancesStatus | DescribePolicyInstancesStatus | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:PauseTask | PauseTask | update | 全部資源 * | 無 | 無 |
cs:DeleteCluster | DeleteCluster | delete | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribePolicyInstances | DescribePolicyInstances | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:RemoveNodePoolNodes | RemoveNodePoolNodes | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:GetClusters | DescribeClustersV1 | get | 全部資源 * | 無 | 無 |
cs:SyncClusterNodePool | SyncClusterNodePool | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ListAddons | ListAddons | list | 全部資源 * | 無 | 無 |
cs:DescribeClusterAttachScripts | DescribeClusterAttachScripts | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeTemplates | DescribeTemplates | get | 全部資源 * | 無 | 無 |
cs:UpdateUserPermissions | UpdateUserPermissions | none | 全部資源 * | 無 | 無 |
cs:CancelOperationPlan | CancelOperationPlan | delete | 全部資源 * | 無 | 無 |
cs:DescribeEvents | DescribeEvents | get | 全部資源 * | 無 | 無 |
cs:GetClusterDiagnosisCheckItems | GetClusterDiagnosisCheckItems | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DeletePolicyInstance | DeletePolicyInstance | delete | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ScaleClusterNodePool | ScaleClusterNodePool | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:CancelClusterUpgrade | CancelClusterUpgrade | delete | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:ResumeUpgradeCluster | ResumeUpgradeCluster | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:UpgradeK8sComponents | UpgradeClusterAddons | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DescribeClusterEvents | DescribeClusterEvents | get | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:GetClusterCheck | GetClusterCheck | list | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:DeleteClusterNodepool | DeleteClusterNodepool | delete | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:UpdateK8sClusterUserConfigExpire | UpdateK8sClusterUserConfigExpire | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:RunClusterCheck | RunClusterCheck | none | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | 無 | 無 |
cs:UnInstallClusterAddons | UnInstallClusterAddons | delete | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} | cs:EnableAddonLogtailDs | 無 |
cs:FixNodePoolVuls | FixNodePoolVuls | update | Cluster acs:cs:{#regionId}:{#accountId}:cluster/{#cluster_id} | 無 | 無 |
cs:DescribeAddons | DescribeAddons | get | 全部資源 * | 無 | 無 |
cs:CancelTask | CancelTask | update | 全部資源 * | 無 | 無 |
資源(Resource)
下表是容器服務Kubernetes版(CS)定義的資源,這些資源可以在RAM權限策略語句的Resource
元素中使用,用來授予對該資源執行具體操作的權限。 其中,資源ARN是資源在阿里云上的唯一標識。具體說明如下:{#}
為變量標識,需要您替換為實際值。例如:{#ramcode}
需要您替換為實際的云服務RAM代碼。-
*
表示全部。例如:{#resourceType}
為*
時:表示全部資源。{#regionId}
為*
時:表示全部地域。{#accountId}
為*
時:表示全部阿里云賬號。
資源類型 | 資源ARN |
---|---|
Cluster | acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId} |
Cluster | acs:cs:{#regionId}:{#accountId}:cluster/{#cluster_id} |
Unrestricted | acs:cs:*:{#accountId}:cluster/* |
Cluster | acs:cs:{#regionId}:{#accountId}:cluster/* |
Cluster | acs:cs:*:{#accountId}:cluster/* |
Unrestricted | acs:cs:{#regionId}:{#accountId}:* |
Cluster | acs:cs::{#accountId}:cluster/{#ClusterId} |
條件(Condition)
下表是容器服務Kubernetes版(CS)定義的產品級條件關鍵字,這些條件關鍵字可以在RAM權限策略語句的
Condition
元素中使用,用來描述授予權限的條件。以下僅列舉產品級的條件關鍵字,阿里云定義的通用條件關鍵字也同樣適用容器服務Kubernetes版(CS)。其中,數據類型決定了您可以使用哪些條件運算符將請求中的值與權限策略語句中的值進行比較。您必須使用與數據類型匹配的條件運算符,否則無法匹配策略語句,授權行為無效。數據類型與條件運算符的對應關系,請參見條件操作類型。
條件關鍵字 | 描述 | 類型 |
---|---|---|
cs:ClusterType | 集群類型 | String |
cs:ClusterSpec | 托管版集群規格 | String |
cs:ClusterProfile | 托管版集群子類型標識 | String |
cs:EnableSecretEncryption | ACK集群是否開啟Secret落盤加密 | Boolean |
cs:EnableApiServerEip | 集群是否開啟API Server公網訪問 | Boolean |
cs:ApiServerEipId | 集群API Server綁定的EIP實例ID,示例值:eip-2zep1n4o1ic48m3m**** | String |
cs:KubeConfigDurationMinutes | 集群KubeConfig憑證的有效期(分鐘) | Numeric |
cs:AddonName | 集群組件名稱,示例值:aliyun-acr-credential-helper,metrics-server | String |
cs:EnableAddonLogtailDs | 集群是否開啟日志組件logtail-ds | Boolean |
cs:EnableCoreControlPlaneComponentsLog | 集群是否開啟控制面核心組件日志功能 | Boolean |
cs:AddonNames | 集群組件操作的對象,示例值:["metrics-server","terway-eniip"] | String |