身份策略授权参考
云服务在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等)。此分类可帮助您了解在身份策略中相应操作对应的访问级别。
- “资源类型”列指每个操作是否支持资源级权限。
- 资源类型支持通配符号*表示所有。如果此列没有值(-),则必须在身份策略语句的Resource元素中指定所有资源类型(“*”)。
- 如果该列包含资源类型,则必须在具有该操作的语句中指定该资源的URN。
- 资源类型列中必需资源在表中用星号(*)标识,表示使用此操作必须指定该资源类型。
关于AgentArts定义的资源类型的详细信息请参见资源类型(Resource)。
- “条件键”列包括了可以在身份策略语句的Condition元素中支持指定的键值。
- 如果该授权项资源类型列存在值,则表示条件键仅对列举的资源类型生效。
- 如果该授权项资源类型列没有值(-),则表示条件键对整个授权项生效。
- 如果此列条件键没有值(-),表示此操作不支持指定条件键。
关于AgentArts定义的条件键的详细信息请参见条件(Condition)。
- “别名”列包括了可以在身份策略中配置的策略授权项。通过这些授权项,可以控制支持策略授权的API访问。详细信息请参见身份策略兼容性说明。
您可以在身份策略语句的Action元素中指定以下AgentArts的相关操作。
| 授权项 | 描述 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 |
|---|---|---|---|---|---|
| agentarts:dataset:createOpsDataset | 授予权限以创建评测集。 | Write | dataset * | - | - |
| agentarts:dataset:listOpsDatasets | 授予权限以查询评测集列表。 | List | dataset * | - | |
| agentarts:dataset:batchDeleteOpsDatasets | 授予权限以批量删除评测集。 | Write | dataset * | - | |
| agentarts:dataset:showOpsDataset | 授予权限以查询评测集。 | Read | dataset * | - | |
| agentarts:dataset:updateOpsDataset | 授予权限以更新评测集。 | Write | dataset * | - | |
| - | |||||
| agentarts:dataset:deleteOpsDataset | 授予权限以删除评测集。 | Write | dataset * | - | |
| agentarts:dataset:listOpsDatasetSchemas | 授予权限以查询评测集schema。 | List | dataset * | - | |
| agentarts:dataset:batchCreateOpsDatasetItems | 授予权限以批量创建评测集条目。 | Write | dataset * | - | |
| agentarts:dataset:listOpsDatasetItems | 授予权限以查询评测集条目列表。 | List | dataset * | - | |
| agentarts:dataset:batchDeleteOpsDatasetItems | 授予权限以批量删除评测集条目。 | Write | dataset * | - | |
| agentarts:dataset:showOpsDatasetItem | 授予权限以查询评测集条目。 | Read | dataset * | - | |
| agentarts:dataset:updateOpsDatasetItem | 授予权限以更新评测集条目。 | Write | dataset * | - | |
| agentarts:dataset:deleteOpsDatasetItem | 授予权限以删除评测集条目。 | Write | dataset * | - | |
| agentarts:dataset:publishOpsDatasetVersion | 授予权限以发布评测集版本。 | Write | dataset * | - | |
| agentarts:dataset:listOpsDatasetVersions | 授予权限以查询评测集版本列表。 | List | dataset * | - | |
| agentarts:dataset:showOpsDatasetVersion | 授予权限以查询评测集版本。 | Read | dataset * | - | |
| agentarts:dataset:deleteOpsDatasetVersion | 授予权限以删除评测集版本。 | Write | dataset * | - | |
| agentarts:dataset:importOpsDatasetItems | 授予权限以导入评测集条目。 | Write | dataset * | - | |
| agentarts:dataset:listOpsDatasetItemsImportTasks | 授予权限以查询评测集导入任务列表。 | List | dataset * | - | |
| agentarts:dataset:createOpsSynthesisTask | 授予权限以创建评测集合成任务。 | Write | dataset * | - | |
| agentarts:dataset:listOpsSynthesisTasks | 授予权限以查询评测集合成任务列表。 | List | dataset * | - | |
| agentarts:dataset:batchDeleteOpsSynthesisTasks | 授予权限以批量删除评测集合成任务。 | Write | dataset * | - | |
| agentarts:dataset:showOpsSynthesisTask | 授予权限以查询评测集合成任务。 | Read | dataset * | - | |
| agentarts:dataset:updateOpsSynthesisTask | 授予权限以更新评测集合成任务。 | Write | dataset * | - | |
| agentarts:dataset:deleteOpsSynthesisTask | 授予权限以删除评测集合成任务。 | Write | dataset * | - | |
| agentarts:dataset:listOpsSynthesisItems | 授予权限以获取评测集合成任务数据项列表。 | List | dataset * | - | |
| agentarts:dataset:importOpsResults | 授予权限以导入评测集数据项到评测集。 | Write | dataset * | - | |
| agentarts:dataset:updateOpsDatasetTags | 授予权限以更新评测集标签。 | Tagging | dataset * | - | |
| - | |||||
| agentarts:evaluator:createOpsEvaluator | 授予权限以创建评估器。 | Write | evaluator * | - | - |
| agentarts:evaluator:batchDeleteOpsEvaluator | 授予权限以批量删除评估器。 | Write | evaluator * | - | |
| agentarts:evaluator:listOpsEvaluators | 授予权限以查询评估器列表。 | List | evaluator * | - | |
| agentarts:evaluator:showOpsEvaluator | 授予权限以查询评估器。 | Read | evaluator * | - | |
| agentarts:evaluator:deleteOpsEvaluator | 授予权限以删除评估器。 | Write | evaluator * | - | |
| agentarts:evaluator:publishOpsEvaluatorVersion | 授予权限以发布评估器版本。 | Write | evaluator * | - | |
| agentarts:evaluator:listOpsEvaluatorVersions | 授予权限以查询评估器版本列表。 | List | evaluator * | - | |
| agentarts:evaluator:showOpsEvaluatorVersion | 授予权限以查询评估器版本。 | Read | evaluator * | - | |
| agentarts:evaluator:deleteOpsEvaluatorVersion | 授予权限以删除评估器版本。 | Write | evaluator * | - | |
| agentarts:evaluator:listOpsEvaluationModels | 授予权限以查询模型列表。 | List | evaluator * | - | |
| agentarts:evaluator:showOpsEvaluationModel | 授予权限以查询模型信息。 | Read | evaluator * | - | |
| agentarts:evaluator:debugOpsEvaluator | 授予权限以调试评估器模型。 | Write | evaluator * | - | |
| agentarts:evaluator:updateOpsEvaluatorTags | 授予权限以更新评估器标签。 | Tagging | evaluator * | - | |
| - | |||||
| agentarts::listOpsEvaluatorTemplates | 授予权限以查询评估器模版列表。 | List | - | - | - |
| agentarts::showOpsEvaluatorTemplate | 授予权限以查询评估器模版。 | Read | - | - | - |
| agentarts:evaluationTask:createOpsEvaluationTask | 授予权限以创建评估任务。 | Write | evaluationTask * | - | - |
| agentarts:evaluationTask:batchDeleteOpsEvaluationTasks | 授予权限以批量删除评估任务。 | Write | evaluationTask * | - | |
| agentarts:evaluationTask:checkOpsEvaluationTaskName | 授予权限以检查评估任务名字。 | Read | evaluationTask * | - | |
| agentarts:evaluationTask:listOpsEvaluationTasks | 授予权限以查询评估任务列表。 | List | evaluationTask * | - | |
| agentarts:evaluationTask:stopOpsEvaluationTask | 授予权限以停止评估任务。 | Write | evaluationTask * | - | |
| agentarts:evaluationTask:showOpsEvaluationTask | 授予权限以查询评估任务。 | Read | evaluationTask * | - | |
| agentarts:evaluationTask:listOpsEvaluationTaskResults | 授予权限以查询评估任务结果。 | List | evaluationTask * | - | |
| agentarts:evaluationTask:updateOpsEvaluationTaskResult | 授予权限以更新评估任务结果。 | Write | evaluationTask * | - | |
| agentarts:evaluationTask:showOpsEvaluationTaskChartsStatus | 授予权限以查询评估任务统计。 | Read | evaluationTask * | - | |
| agentarts:evaluationTask:showOpsEvaluationTaskChartsScoreStats | 授予权限以查询评估任务分数统计。 | Read | evaluationTask * | - | |
| agentarts:evaluationTask:showOpsEvaluationTaskChartsLabelsDistribution | 授予权限以查询评估任务的标签分布。 | Read | evaluationTask * | - | |
| agentarts:evaluationTask:showOpsEvaluationTaskChartsScoreDistribution | 授予权限以查询评估任务的分数分布。 | Read | evaluationTask * | - | |
| agentarts::createOpsLabel | 授予权限以创建标记。 | Write | - | - | - |
| agentarts::listOpsLabels | 授予权限以查询标记列表。 | List | - | - | - |
| agentarts::showOpsLabel | 授予权限以查询标记。 | Read | - | - | - |
| agentarts::updateOpsLabel | 授予权限以更新标记。 | Write | - | - | - |
| agentarts:evaluationTask:listOpsEvaluationTaskCustomLabels | 授予权限以查询自定义标记列表。 | List | evaluationTask * | - | |
| agentarts:evaluationTask:batchAddOpsEvaluationTaskCustomLabels | 授予权限以批量添加自定义标记。 | Write | evaluationTask * | - | |
| agentarts:evaluationTask:deleteOpsEvaluationTaskCustomLabels | 授予权限以删除自定义标记。 | Write | evaluationTask * | - | |
| agentarts:evaluationTask:batchAddOpsEvaluationTaskCustomLabelValues | 授予权限以批量添加自定义标记值。 | Write | evaluationTask * | - | |
| agentarts:evaluationTask:listOpsEvaluationTaskCustomLabelValues | 授予权限以查询自定义标记值列表。 | List | evaluationTask * | - | |
| agentarts:evaluationTask:batchUpdateOpsEvaluationTaskCustomLabelValues | 授予权限以批量更新自定义标记值。 | Write | evaluationTask * | - | |
| agentarts:evaluationTask:deleteOpsEvaluationTaskCustomLabelValues | 授予权限以删除自定义标记值。 | Write | evaluationTask * | - | |
| agentarts:evaluationTask:updateOpsEvaluationTaskTags | 授予权限以更新评估任务标签。 | Tagging | evaluationTask * | - | |
| - |
AgentArts的API通常对应着一个或多个授权项。表2展示了API与授权项的关系,以及该API需要依赖的授权项。
| API | 对应的授权项 | 依赖的授权项 |
|---|---|---|
| agentarts:dataset:createOpsDataset | - | |
| agentarts:dataset:listOpsDatasets | - | |
| agentarts:dataset:batchDeleteOpsDatasets | - | |
| agentarts:dataset:showOpsDataset | - | |
| agentarts:dataset:updateOpsDataset | - | |
| agentarts:dataset:deleteOpsDataset | - | |
| agentarts:dataset:listOpsDatasetSchemas | - | |
| agentarts:dataset:batchCreateOpsDatasetItems | - | |
| agentarts:dataset:listOpsDatasetItems | - | |
| agentarts:dataset:batchDeleteOpsDatasetItems | - | |
| agentarts:dataset:showOpsDatasetItem | - | |
| agentarts:dataset:updateOpsDatasetItem | - | |
| agentarts:dataset:deleteOpsDatasetItem | - | |
| agentarts:dataset:publishOpsDatasetVersion | - | |
| agentarts:dataset:listOpsDatasetVersions | - | |
| agentarts:dataset:showOpsDatasetVersion | - | |
| agentarts:dataset:deleteOpsDatasetVersion | - | |
| agentarts:dataset:importOpsDatasetItems | - | |
| agentarts:dataset:listOpsDatasetItemsImportTasks | - | |
| agentarts:dataset:createOpsSynthesisTask | - | |
| agentarts:dataset:listOpsSynthesisTasks | - | |
| agentarts:dataset:batchDeleteOpsSynthesisTasks | - | |
| agentarts:dataset:showOpsSynthesisTask | - | |
| agentarts:dataset:updateOpsSynthesisTask | - | |
| agentarts:dataset:deleteOpsSynthesisTask | - | |
| agentarts:dataset:listOpsSynthesisItems | - | |
| agentarts:dataset:importOpsResults | - | |
| agentarts:evaluator:createOpsEvaluator | - | |
| agentarts:evaluator:batchDeleteOpsEvaluator | - | |
| agentarts:evaluator:listOpsEvaluators | - | |
| agentarts:evaluator:showOpsEvaluator | - | |
| agentarts:evaluator:deleteOpsEvaluator | - | |
| agentarts:evaluator:publishOpsEvaluatorVersion | - | |
| agentarts:evaluator:listOpsEvaluatorVersions | - | |
| agentarts:evaluator:showOpsEvaluatorVersion | - | |
| DELETE /v1/ops/evaluators/{evaluator_id}/versions/{version_id} | agentarts:evaluator:deleteOpsEvaluatorVersion | - |
| agentarts:evaluator:listOpsEvaluationModels | - | |
| agentarts:evaluator:showOpsEvaluationModel | - | |
| agentarts:evaluator:debugOpsEvaluator | - | |
| agentarts::listOpsEvaluatorTemplates | - | |
| agentarts::showOpsEvaluatorTemplate | - | |
| agentarts:evaluationTask:createOpsEvaluationTask | - | |
| agentarts:evaluationTask:batchDeleteOpsEvaluationTasks | - | |
| agentarts:evaluationTask:checkOpsEvaluationTaskName | - | |
| agentarts:evaluationTask:listOpsEvaluationTasks | - | |
| agentarts:evaluationTask:stopOpsEvaluationTask | - | |
| agentarts:evaluationTask:showOpsEvaluationTask | - | |
| agentarts:evaluationTask:listOpsEvaluationTaskResults | - | |
| agentarts:evaluationTask:updateOpsEvaluationTaskResult | - | |
| agentarts:evaluationTask:showOpsEvaluationTaskChartsStatus | - | |
| agentarts:evaluationTask:showOpsEvaluationTaskChartsScoreStats | - | |
| GET /v1/ops/evaluation-tasks/{task_id}/charts/tag-distribution | agentarts:evaluationTask:showOpsEvaluationTaskChartsLabelsDistribution | - |
| GET /v1/ops/evaluation-tasks/{task_id}/charts/score-distribution | agentarts:evaluationTask:showOpsEvaluationTaskChartsScoreDistribution | - |
| agentarts:evaluationTask:listOpsEvaluationTaskCustomLabels | - | |
| agentarts:evaluationTask:batchAddOpsEvaluationTaskCustomLabels | - | |
| DELETE /v1/ops/evaluation-tasks/{task_id}/custom-labels/{label_id} | agentarts:evaluationTask:deleteOpsEvaluationTaskCustomLabels | - |
| POST /v1/ops/evaluation-tasks/{task_id}/custom-labels-values | agentarts:evaluationTask:batchAddOpsEvaluationTaskCustomLabelValues | - |
| agentarts:evaluationTask:listOpsEvaluationTaskCustomLabelValues | - | |
| agentarts:evaluationTask:batchUpdateOpsEvaluationTaskCustomLabelValues | - | |
| DELETE /v1/ops/evaluation-tasks/{task_id}/custom-labels-values | agentarts:evaluationTask:deleteOpsEvaluationTaskCustomLabelValues | - |
| agentarts::createOpsLabel | - | |
| agentarts::listOpsLabels | - | |
| agentarts::showOpsLabel | - | |
| agentarts::updateOpsLabel | - | |
| agentarts:dataset:updateOpsDatasetTags | - | |
| agentarts:evaluator:updateOpsEvaluatorTags | - | |
| agentarts:evaluationTask:updateOpsEvaluationTaskTags | - |
资源类型(Resource)
资源类型(Resource)表示身份策略所作用的资源。如表3中的某些操作指定了可以在该操作指定的资源类型,则必须在具有该操作的身份策略语句中指定该资源的URN,身份策略仅作用于此资源;如未指定,Resource默认为“*”,则身份策略将应用到所有资源。您也可以在身份策略中设置条件,从而指定资源类型。
AgentArts定义了以下可以在自定义身份策略的Resource元素中使用的资源类型。