# 获取策略定义列表 - ListPolicyDefinitions #### 功能介绍 获取策略定义列表 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ucs/ucs_api_0026.html)。 #### URI GET /v1/policydefinitions #### 请求参数 无 #### 响应参数 **状态码：200** 表1响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | items | Array of [UCSConstraintTemplate] objects | 约束模板列表 | | kind | String | API类型 | | apiVersion | String | API版本 | 表2UCSConstraintTemplate | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kind | String | API类型，固定值"ConstraintTemplate" | | apiVersion | String | API版本 | | metadata | [ObjectMeta] object | 约束模板元数据 | | spec | Object | 约束模板的详细属性 | 表3ObjectMeta | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uid | String | 资源ID | | name | String | 资源名称 | | generateName | String | 当未提供name时，服务器使用的前缀来生成唯一名称 | | namespace | String | 命名空间 | | labels | Map\ | 标签 | | annotations | Map\ | 注解 | | creationTimestamp | String | 创建时间 | | updateTimestamp | String | 更新时间 | | resourceVersion | String | 资源内部版本 | | generation | Integer | 资源期望状态的代数 | | managedFields | Array of [ManagedFieldsEntry] objects | 记录哪些字段由哪些工作流管理 | | ownerReferences | Array of [OwnerReference] objects | 用于定义对象间所有权关系，管理对象的依赖关系和垃圾回收机制，支持控制器对资源的管理 | 表4ManagedFieldsEntry | 参数 | 参数类型 | 描述 | |:---|:---|:---| | manager | String | 管理者的名称 | | operation | String | 记录导致此条目创建的操作类型，只能是 Apply 或 Update 两种操作类型 | | apiVersion | String | 该管理者定义字段时所依据的资源 API 版本 | | time | String | 此管理条目被创建或最后一次更新的时间戳 | | fieldsType | String | 固定为 "FieldsV1"，标记字段结构格式 | | fieldsV1 | Object | 用于存储实际被管理的字段信息 | 表5OwnerReference | 参数 | 参数类型 | 描述 | |:---|:---|:---| | apiVersion | String | 标识引用对象的API版本 | | kind | String | 引用对象的类型 | | name | String | 引用对象的名称 | | uid | String | 引用对象的uid | | controller | Boolean | 如果为true，表示该引用指向管理该资源的控制器 | | blockOwnerDeletion | Boolean | 当为true且拥有者有名为"foregroundDeletion"的finalizer 时，会阻止拥有者被删除，直到这个引用被移除 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | String | - | **状态码：404** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | String | - | **状态码：500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | String | - | #### 请求示例 无 #### 响应示例 **状态码：200** 策略定义列表 ``` { "items" : [ { "kind" : "ConstraintTemplate", "apiVersion" : "templates.gatekeeper.sh/v1beta1", "metadata" : { "name" : "k8spspvolumetypes", "uid" : "f1519ae2-adf8-11ed-9f9c-0255ac100186", "creationTimestamp" : "2023-02-16 12:53:43.050938 +0000 UTC", "updateTimestamp" : "2025-11-05 03:29:41.797896 +0000 UTC", "annotations" : { "description-chinese" : "限制Pod使用指定的Volume挂载类型", "name-chinese" : "K8sPSPVolumeTypes", "tag-chinese" : "容器/应用安全策略" } }, "spec" : { "type" : "security", "tag" : "k1", "officialTag" : "Container/ApplicationSecurityPolicies", "level" : "3", "targetKind" : "Pod", "official" : true, "description" : "Restricts mountable volume types to those specified by the user. Corresponds to the `volumes` field in a PodSecurityPolicy.", "constraintTemplate" : { "kind" : "ConstraintTemplate", "apiVersion" : "templates.gatekeeper.sh/v1", "metadata" : { "name" : "k8spspvolumetypes", "creationTimestamp" : null, "annotations" : { "description" : "Restricts mountable volume types to those specified by the user. Corresponds to the `volumes` field in a PodSecurityPolicy.", "description-chinese" : "限制Pod使用指定的Volume挂载类型", "level" : "3", "metadata.gatekeeper.sh/title" : "Volume Types", "metadata.gatekeeper.sh/version" : "1.0.0", "name-chinese" : "K8sPSPVolumeTypes", "tag" : "Container/ApplicationSecurityPolicies", "tag-chinese" : "容器/应用安全策略", "targetKind" : "Pod", "type" : "security" } } } } } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 策略定义列表 | | 400 | 客户端请求错误，服务器无法执行请求 | | 404 | 资源不存在 | | 500 | 服务器内部错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ucs/ErrorCode.html)。