授权信息

访问控制(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:DescribeClusterNodePoolsDescribeClusterNodePoolsget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeClusterDetailDescribeClusterDetailget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeNodePoolVulsDescribeNodePoolVulsget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#cluster_id}
cs:DeployPolicyInstanceDeployPolicyInstanceget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:CreateClusterNodePoolCreateClusterNodePoolcreate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:ModifyClusterAddonModifyClusterAddonupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:AddonName
cs:AddonNames
cs:CheckControlPlaneLogEnableCheckControlPlaneLogEnableget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribePoliciesDescribePoliciesget
全部资源
*
cs:DescribeUserClusterNamespacesDescribeUserClusterNamespacesget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:TagResourcesTagResourcesupdate
全部资源
*
cs:DescribeClusterResourcesDescribeClusterResourcesget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribePolicyGovernanceInClusterDescribePolicyGovernanceInClusterget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeClusterAddonInstanceDescribeClusterAddonInstanceget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeKubernetesVersionMetadataDescribeKubernetesVersionMetadataget
全部资源
*
cs:DescribeClusterTasksDescribeClusterTasksget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#cluster_id}
cs:ResumeTaskResumeTaskupdate
全部资源
*
cs:DescribeClusterNodesDescribeClusterNodesget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeTemplateAttributeDescribeTemplateAttributeget
全部资源
*
cs:DescribeClusterVulsDescribeClusterVulsget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:GetUserPermissionsDescribeUserPermissionget
全部资源
*
cs:CreateTriggerCreateTriggercreate
全部资源
*
cs:CreateAutoscalingConfigCreateAutoscalingConfigcreate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:GrantPermissionGrantPermissionsupdate
全部资源
*
cs:PauseClusterUpgradePauseClusterUpgradeupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeClusterUserKubeconfigDescribeClusterUserKubeconfigget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:KubeConfigDurationMinutes
cs:CreateTemplateCreateTemplatecreate
全部资源
*
cs:Queryk8sComponentsUpdateVersionDescribeClusterAddonsVersionget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeEventsForRegionDescribeEventsForRegionlist
全部资源
*
cs:ModifyClusterTagsModifyClusterTagsupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:UntagResourcesUntagResourcesdelete
全部资源
*
cs:DeleteTemplateDeleteTemplatedelete
全部资源
*
cs:DescribeTriggerDescribeTriggerget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeClusterAddonsUpgradeStatusDescribeClusterAddonsUpgradeStatusget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:UpdateControlPlaneLogUpdateControlPlaneLogWrite
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:EnableCoreControlPlaneComponentsLog
cs:AttachInstancesToNodePoolAttachInstancesToNodePoolupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:ModifyClusterNodePoolModifyClusterNodePoolupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:InstallClusterAddonsInstallClusterAddonscreate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:AddonNames
cs:UpgradeClusterUpgradeClusterupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:ListOperationPlansListOperationPlanslist
全部资源
*
cs:CreateClusterCreateClustercreate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/*
cs:ClusterType
cs:ClusterSpec
cs:ClusterProfile
cs:EnableSecretEncryption
cs:EnableApiServerEip
cs:EnableAddonLogtailDs
cs:EnableCoreControlPlaneComponentsLog
cs:AddonNames
cs:DeleteClusterNodesDeleteClusterNodesdelete
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeClusterNodePoolDetailDescribeClusterNodePoolDetailget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:ListClusterChecksListClusterCheckslist
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:ListTagResourcesListTagResourcesget
全部资源
*
cs:UpdateTemplateUpdateTemplateupdate
全部资源
*
cs:ModifyPolicyInstanceModifyPolicyInstanceupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribePolicyDetailsDescribePolicyDetailsget
全部资源
*
cs:ListClusterAddonInstancesListClusterAddonInstanceslist
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:ModifyNodePoolNodeConfigModifyNodePoolNodeConfigupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeClusterLogsDescribeClusterLogsget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:GetUpgradeStatusGetUpgradeStatusget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeClusterAddonMetadataDescribeClusterAddonMetadataget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeAddonDescribeAddonget
全部资源
*
cs:GetClusterAddonInstanceGetClusterAddonInstanceget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeSubaccountK8sClusterUserConfigDescribeSubaccountK8sClusterUserConfigget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeTaskInfoDescribeTaskInfoget
全部资源
*
cs:ScanClusterVulsScanClusterVulsupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DeleteTriggerDeleteTriggerdelete
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeClustersForRegionDescribeClustersForRegionlist
全部资源
*
cs:UpgradeClusterNodepoolUpgradeClusterNodepoolupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:RepairClusterNodePoolRepairClusterNodePoolupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#cluster_id}
cs:DescribePolicyInstancesStatusDescribePolicyInstancesStatusget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:PauseTaskPauseTaskupdate
全部资源
*
cs:DeleteClusterDeleteClusterdelete
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:UpdateUserPermissionsUpdateUserPermissionsnone
全部资源
*
cs:SyncClusterNodePoolSyncClusterNodePoolupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeEventsDescribeEventsget
全部资源
*
cs:DescribePolicyInstancesDescribePolicyInstancesget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:ListAddonsListAddonslist
全部资源
*
cs:DeletePolicyInstanceDeletePolicyInstancedelete
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:GetClustersDescribeClustersV1get
全部资源
*
cs:DeleteClusterNodepoolDeleteClusterNodepooldelete
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:UpdateK8sClusterUserConfigExpireUpdateK8sClusterUserConfigExpireupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:CancelClusterUpgradeCancelClusterUpgradedelete
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeClusterAttachScriptsDescribeClusterAttachScriptsupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:UpgradeK8sComponentsUpgradeClusterAddonsupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:ResumeUpgradeClusterResumeUpgradeClusterupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:CancelOperationPlanCancelOperationPlandelete
全部资源
*
cs:GetClusterCheckGetClusterChecklist
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:UnInstallClusterAddonsUnInstallClusterAddonsdelete
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:EnableAddonLogtailDs
cs:ScaleClusterNodePoolScaleClusterNodePoolupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeTemplatesDescribeTemplatesget
全部资源
*
cs:RunClusterCheckRunClusterChecknone
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:DescribeAddonsDescribeAddonsget
全部资源
*
cs:FixNodePoolVulsFixNodePoolVulsupdate
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#cluster_id}
cs:DescribeClusterEventsDescribeClusterEventsget
Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
cs:CancelTaskCancelTaskupdate
全部资源
*

资源(Resource)

下表是容器服务Kubernetes版(CS)定义的资源,这些资源可以在RAM权限策略语句的Resource元素中使用,用来授予对该资源执行具体操作的权限。 其中,资源ARN是资源在阿里云上的唯一标识。具体说明如下:
  • {#}为变量标识,需要您替换为实际值。例如:{#ramcode}需要您替换为实际的云服务RAM代码。
  • *表示全部。例如:
    • {#resourceType}*时:表示全部资源。
    • {#regionId}*时:表示全部地域。
    • {#accountId}*时:表示全部阿里云账号。
资源类型资源ARN
Clusteracs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
Clusteracs:cs:{#regionId}:{#accountId}:cluster/{#cluster_id}
Unrestrictedacs:cs:*:{#accountId}:cluster/*
Clusteracs:cs:{#regionId}:{#accountId}:cluster/*
Clusteracs:cs:*:{#accountId}:cluster/*
Unrestrictedacs:cs:{#regionId}:{#accountId}:*
Clusteracs:cs::{#accountId}:cluster/{#ClusterId}

条件(Condition)

下表是容器服务Kubernetes版(CS)定义的产品级条件关键字,这些条件关键字可以在RAM权限策略语句的Condition元素中使用,用来描述授予权限的条件。以下仅列举产品级的条件关键字,阿里云定义的通用条件关键字也同样适用容器服务Kubernetes版(CS)
其中,数据类型决定了您可以使用哪些条件运算符将请求中的值与权限策略语句中的值进行比较。您必须使用与数据类型匹配的条件运算符,否则无法匹配策略语句,授权行为无效。数据类型与条件运算符的对应关系,请参见条件操作类型
条件关键字描述类型
cs:ClusterType集群类型String
cs:ClusterSpec托管版集群规格String
cs:ClusterProfile托管版集群子类型标识String
cs:EnableSecretEncryptionACK集群是否开启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-serverString
cs:EnableAddonLogtailDs集群是否开启日志组件logtail-dsBoolean
cs:EnableCoreControlPlaneComponentsLog集群是否开启控制面核心组件日志功能Boolean
cs:AddonNames集群组件操作的对象,示例值:[&quot;metrics-server&quot;,&quot;terway-eniip&quot;]String

相关操作

您可以创建自定义权限策略,并将权限策略授予RAM用户、RAM用户组或RAM角色。具体操作如下: