身份策略授权参考
云服务在IAM预置了常用授权项,称为系统身份策略。如果IAM系统身份策略无法满足授权要求,管理员可以根据各服务支持的授权项,创建IAM自定义身份策略来进行精细的访问控制,IAM自定义身份策略是对系统身份策略的扩展和补充。
除IAM服务外,Organizations服务中的服务控制策略(Service Control Policy,以下简称SCP)也可以使用这些授权项元素设置访问控制策略。
SCP不直接进行授权,只划定权限边界。将SCP绑定到组织单元或者成员账号时,并没有直接对组织单元或成员账号授予操作权限,而是规定了成员账号或组织单元包含的成员账号的授权范围。IAM身份策略授予权限的有效性受SCP限制,只有在SCP允许范围内的权限才能生效。
IAM服务与Organizations服务在使用这些元素进行访问控制时,存在着一些区别,详情请参见:IAM服务与Organizations服务权限访问控制的区别。
本章节介绍IAM服务身份策略授权场景中自定义身份策略和组织服务中SCP使用的元素,这些元素包含了操作(Action)、资源类型(Resource)和条件(Condition)。
操作(Action)
操作(Action)即为身份策略中支持的授权项。
- “访问级别”列描述如何对操作进行分类(List、Read、Write和Tagging等)。此分类可帮助您了解在身份策略中相应操作对应的访问级别。
- “资源类型”列指每个操作是否支持资源级权限。
- 资源类型支持通配符号*表示所有。如果此列没有值(-),则必须在身份策略语句的Resource元素中指定所有资源类型(*)。
- 如果该列包含资源类型,则必须在具有该操作的语句中指定该资源的URN。
- 资源类型列中必需资源在表中用星号(*)标识,表示使用此操作必须指定该资源类型。
关于CloudDC定义的资源类型的详细信息请参见资源类型(Resource)。
- “条件键”列包括了可以在身份策略语句的Condition元素中支持指定的键值。
- 如果该授权项资源类型列存在值,则表示条件键仅对列举的资源类型生效。
- 如果该授权项资源类型列没有值(-),则表示条件键对整个授权项生效。
- 如果此列条件键没有值(-),表示此操作不支持指定条件键。
关于CloudDC定义的条件键的详细信息请参见条件(Condition)。
您可以在身份策略语句的Action元素中指定以下CloudDC的相关操作。
授权项 |
描述 |
访问级别 |
资源类型 |
资源条件键 |
全局条件键 |
---|---|---|---|---|---|
clouddc:imetal:list |
批量查询物理服务器 |
list |
imetal |
- |
- |
clouddc:imetal:get |
查询物理服务器信息 |
read |
imetal |
g:ResourceTag/<tag-key> |
- |
clouddc:imetal:getHardwareAttribute |
查询服务器硬件详细信息 |
read |
imetal |
g:ResourceTag/<tag-key> |
- |
clouddc:imetal:getFirmwareAttribute |
查询服务器固件详细信息 |
read |
imetal |
g:ResourceTag/<tag-key> |
- |
clouddc:imetal:updatePowerStatus |
修改物理服务器电源状态 |
write |
imetal |
g:ResourceTag/<tag-key> |
- |
clouddc:imetal:createDumpLog |
导出服务器日志请求 |
write |
imetal |
g:ResourceTag/<tag-key> |
- |
clouddc:imetal:getDumpLogProgress |
查询日志导出状态 |
read |
imetal |
g:ResourceTag/<tag-key> |
- |
clouddc:imetal:createDownloadLog |
下载日志文件 |
write |
imetal |
g:ResourceTag/<tag-key> |
- |
clouddc:imetal:createRemoteConsoleLink |
获取console地址信息 |
write |
imetal |
g:ResourceTag/<tag-key> |
- |
clouddc:instance:createBatch |
批量创建裸机实例 |
write |
imetal |
- |
- |
clouddc:instance:list |
批量查询裸机实例 |
list |
imetal |
- |
- |
clouddc:instance:deleteBatch |
批量删除裸机实例 |
write |
imetal |
- |
- |
clouddc:instance:create |
创建裸机实例 |
write |
imetal |
- |
- |
clouddc:instance:delete |
删除裸机实例 |
write |
imetal |
- |
- |
clouddc:instance:changePassword |
修改裸机实例密码 |
write |
imetal |
- |
- |
clouddc:instance:reinstallOS |
重新安装裸机实例OS |
write |
imetal |
- |
- |
clouddc:instance:get |
查询裸机实例状态 |
read |
imetal |
- |
- |
clouddc:imetal:updateIP |
修改裸机实例ip |
write |
imetal |
g:ResourceTag/<tag-key> |
- |
clouddc::listResourcesByTag |
查询资源实例列表 |
list |
imetal |
g:TagKeys |
|
clouddc::listTagsForResource |
查询资源标签 |
list |
imetal |
g:ResourceTag/<tag-key> |
|
clouddc::listTags |
查询项目标签 |
list |
imetal |
||
clouddc::listResourcesByTag |
查询实例数量 |
list |
imetal |
g:TagKeys |
|
clouddc::tagResource |
批量创建资源标签 |
tagging |
imetal |
g:ResourceTag/<tag-key> |
g:RequestTag/<tag-key> g:TagKeys |
clouddc::unTagResource |
批量删除资源标签 |
tagging |
imetal |
g:ResourceTag/<tag-key> |
g:RequestTag/<tag-key> g:TagKeys |
clouddc::listStatus |
服务器概览 |
list |
imetal |
- |
- |
clouddc::listAlarmStat |
服务器告警概览 |
list |
imetal |
- |
- |
clouddc::listAlarmTrend |
服务器告警趋势 |
list |
imetal |
- |
- |
clouddc::listAlarm |
服务器告警列表 |
list |
imetal |
- |
- |
clouddc::listEvent |
服务器事件列表 |
list |
imetal |
- |
- |
clouddc::listIEventDicts |
查询事件定义 |
list |
imetal |
- |
- |
clouddc::updateRepairs |
更新/创建服务器维修数据 |
write |
imetal |
- |
- |
clouddc::listRepairs |
服务器维修数据查询 |
list |
imetal |
- |
- |
clouddc::updateSpareParts |
创建与更新备件 |
write |
imetal |
- |
- |
clouddc::listSpareParts |
备件查询 |
list |
imetal |
- |
- |
clouddc:irack:update |
修改 iRack描述 |
write |
irack |
g:ResourceTag/<tag-key> |
- |
clouddc:irack:list |
查询 iRack 实例列表 |
list |
irack |
- |
- |
clouddc:idc:update |
修改 IDC 描述 |
write |
irack |
- |
- |
clouddc:idc:list |
查询 IDC 列表 |
list |
irack |
- |
- |
clouddc::listResourcesByTag |
查询机柜实例列表 |
list |
irack |
g:TagKeys |
|
clouddc::listTagsForResource |
查询机柜标签 |
list |
irack |
g:ResourceTag/<tag-key> |
|
clouddc::listTags |
查询机柜项目标签 |
list |
irack |
||
clouddc::listResourcesByTag |
查询机柜实例数量 |
list |
irack |
g:TagKeys |
|
clouddc::tagResource |
批量创建机柜标签 |
tagging |
irack |
g:ResourceTag/<tag-key> |
g:RequestTag/<tag-key> g:TagKeys |
clouddc::unTagResource |
批量删除机柜标签 |
tagging |
irack |
g:ResourceTag/<tag-key> |
g:RequestTag/<tag-key> g:TagKeys |
clouddc::createIRackOrder |
授予购买资源时下单参数检查权限 |
write |
irack |
- |
- |
CloudDC的API通常对应着一个或多个授权项。表2展示了API与授权项的关系,以及该API需要依赖的授权项。
API URI |
请求类型 |
描述 |
对应的授权项 |
依赖的授权项 |
---|---|---|---|---|
/v1/{project_id}/physicalservers |
GET |
批量查询物理服务器 |
clouddc:imetal:list |
- |
/v1/{project_id}/physicalservers/{id} |
GET |
查询物理服务器信息 |
clouddc:imetal:get |
- |
/v1/{project_id}/physicalservers/{id}/hardware-attributes |
GET |
查询服务器硬件详细信息 |
clouddc:imetal:getHardwareAttribute |
- |
/v1/{project_id}/physicalservers/{id}/firmware-attributes |
GET |
查询服务器固件详细信息 |
clouddc:imetal:getFirmwareAttribute |
- |
/v1/{project_id}/physicalservers/{id}/power-state |
PUT |
修改物理服务器电源状态 |
clouddc:imetal:updatePowerStatus |
- |
/v1/{project_id}/physicalservers/{id}/logs/exports |
POST |
导出服务器日志请求 |
clouddc:imetal:createDumpLog |
- |
/v1/{project_id}/physicalservers/{id}/logs/exports/{export_id} |
GET |
查询日志导出状态 |
clouddc:imetal:getDumpLogProgress |
- |
/v1/{project_id}/physicalservers/{id}/logs/exports/{export_id}/content |
GET |
下载日志文件 |
clouddc:imetal:createDownloadLog |
- |
/v1/{project_id}/physicalservers/{id}/remote-console-address |
GET |
获取console地址信息 |
clouddc:imetal:createRemoteConsoleLink |
- |
/v1/{project_id}/instances/batch-create |
POST |
批量创建裸机实例 |
clouddc:instance:createBatch |
- |
/v1/{project_id}/instances |
GET |
批量查询裸机实例 |
clouddc:instance:list |
- |
/v1/{project_id}/instances/batch-delete |
DELETE |
批量删除裸机实例 |
clouddc:instance:deleteBatch |
- |
/v1/{project_id}/instance |
POST |
创建裸机实例 |
clouddc:instance:create |
- |
/v1/{project_id}/instances/{id} |
DELETE |
删除裸机实例 |
clouddc:instance:delete |
- |
/v1/{project_id}/instances/{id}/password |
PUT |
修改裸机实例密码 |
clouddc:instance:changePassword |
- |
/v1/{project_id}/instances/{id}/reinstall |
PUT |
重新安装裸机实例OS |
clouddc:instance:reinstallOS |
- |
/v1/{project_id}/instances/{id}/status |
GET |
查询裸机实例状态 |
clouddc:instance:get |
- |
/v1/{project_id}/instances/{id}/ip |
PUT |
修改裸机实例ip |
clouddc:imetal:updateIP |
- |
/{version}/{project_id}/{resource_type}/resource-instances/filter |
POST |
查询资源实例列表 |
clouddc::listResourcesByTag |
- |
/{version}/{project_id}/{resource_type}/{resource_id}/tags |
GET |
查询资源标签 |
clouddc::listTagsForResource |
- |
/{version}/{project_id}/{resource_type}/tags |
GET |
查询项目标签 |
clouddc::listTags |
- |
/{version}/{project_id}/{resource_type}/resource-instances/count |
POST |
查询实例数量 |
clouddc::listResourcesByTag |
- |
/v1/{project_id}/{resource_type}/{resource_id}/tags/create |
POST |
批量创建资源标签 |
clouddc::tagResource |
- |
/v1/{project_id}/{resource_type}/{resource_id}/tags/delete |
POST |
批量删除资源标签 |
clouddc::unTagResource |
- |
/v1/{project_id}/physicalservers/status |
GET |
服务器概览 |
clouddc::listStatus |
- |
/v1/{project_id}/physicalservers/alarms/summary |
GET |
服务器告警概览 |
clouddc::listAlarmStat |
ces:alarmHistory:list |
/v1/{project_id}/physicalservers/alarms/trend |
GET |
服务器告警趋势 |
clouddc::listAlarmTrend |
ces:alarmHistory:list |
/v1/{project_id}/physicalservers/alarms |
GET |
服务器告警列表 |
clouddc::listAlarm |
ces:alarmHistory:list |
/v1/{project_id}/physicalservers/events |
GET |
服务器事件列表 |
clouddc::listEvent |
ces:events:get |
/v1/{project_id}/physicalservers/events/{event_id} |
GET |
查询事件定义 |
clouddc::listIEventDicts |
- |
/v1/{project_id}/repairs |
PUT |
更新/创建服务器维修数据 |
clouddc::updateRepairs |
- |
/v1/{project_id}/repairs |
GET |
服务器维修数据查询 |
clouddc::listRepairs |
- |
/v1/{project_id}/spareparts |
PUT |
创建与更新备件 |
clouddc::updateSpareParts |
- |
/v1/{project_id}/spareparts |
GET |
备件查询 |
clouddc::listSpareParts |
- |
/v1/{project_id}/iracks/{irack_id} |
PUT |
修改 iRack描述 |
clouddc:irack:update |
- |
/v1/{project_id}/iracks |
GET |
查询 iRack 实例列表 |
clouddc:irack:list |
- |
/v1/{project_id}/idcs |
PUT |
修改 IDC 描述 |
clouddc:idc:update |
- |
/v1/{project_id}/idcs |
GET |
查询 IDC 列表 |
clouddc:idc:list |
- |
/{version}/{project_id}/{resource_type}/resource-instances/filter |
POST |
查询机柜实例列表 |
clouddc::listResourcesByTag |
- |
/{version}/{project_id}/{resource_type}/{resource_id}/tags |
GET |
查询机柜标签 |
clouddc::listTagsForResource |
- |
/{version}/{project_id}/{resource_type}/tags |
GET |
查询机柜项目标签 |
clouddc::listTags |
- |
/{version}/{project_id}/{resource_type}/resource-instances/count |
POST |
查询机柜实例数量 |
clouddc::listResourcesByTag |
- |
/v1/{project_id}/iracks/{id}/tags/create |
POST |
批量创建机柜标签 |
clouddc::tagResource |
- |
/v1/{project_id}/iracks/{id}/tags/delete |
POST |
批量删除机柜标签 |
clouddc::unTagResource |
- |
/v1/services/unibuy/extend |
POST |
授予购买资源时下单参数检查权限 |
clouddc::createIRackOrder |
- |
资源类型(Resource)
资源类型(Resource)表示身份策略所作用的资源,如表3中的某些操作指定了可以在该操作指定的资源类型,则必须在具有该操作的身份策略语句中指定该资源的URN,身份策略仅作用于此资源;如未指定,Resource默认为 “*”,则身份策略将应用到所有资源。您也可以在身份策略中设置条件,从而指定资源类型。
CloudDC定义了以下可以在身份策略的Resource元素中使用的资源类型。
条件(Condition)
条件键概述
条件(Condition)是身份策略生效的特定条件,包括条件键和运算符。
- 条件键表示身份策略语句的Condition元素中的键值。根据适用范围,分为全局级条件键和服务级条件键。
- 全局级条件键(前缀为g:)适用于所有操作,在鉴权过程中,云服务不需要提供用户身份信息,系统将自动获取并鉴权。详情请参见表4。更多全局条件键说明,可参见全局条件键。
- 服务级条件键(前缀通常为服务缩写,如clouddc:)仅适用于对应服务的操作,CloudDC服务不支持在身份策略中的条件键中配置服务级的条件键。
- 单值/多值表示API调用时请求中与条件关联的值数。单值条件键在API调用时的请求中最多包含一个值,多值条件键在API调用时请求可以包含多个值。例如:g:SourceVpce是单值条件键,表示仅允许通过某个VPC终端节点发起请求访问某资源,一个请求最多包含一个VPC终端节点ID值。g:TagKeys是多值条件键,表示请求中携带的所有标签的key组成的列表,当用户在调用API请求时传入标签可以传入多个值。
- 运算符与条件键、条件值一起构成完整的条件判断语句,当请求信息满足该条件时,身份策略才能生效。
CloudDC定义了以下可以在身份策略的Condition元素中使用的条件键,您可以使用这些条件键进一步细化身份策略语句应用的条件。