文档首页> VPC终端节点 VPCEP> API参考> API> 终端节点服务功能> 查询终端节点服务的白名单列表
更新时间:2023-12-07 GMT+08:00

查询终端节点服务的白名单列表

功能介绍

查询当前用户下终端节点服务的白名单列表。 说明 本帐号默认在当前用户下终端节点服务的白名单中。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/permissions

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

最小长度:1

最大长度:64

vpc_endpoint_service_id

String

终端节点服务的ID。

最小长度:1

最大长度:64

表2 Query参数

参数

是否必选

参数类型

描述

permission

String

权限帐号ID,格式为“iam:domain::domain_id”。 其中“domain_id”为授权用户的帐号ID, 例如“iam:domain::6e9dfd51d1124e8d8498dce894923a0d”,支持模糊搜索。

最小长度:1

最大长度:1000

limit

Integer

查询返回终端节点服务的白名单数量限制,即每页返回的个数。 取值范围:0~500,取值一般为10,20或者50,默认为10。

最小值:1

最大值:500

缺省值:10

offset

Integer

偏移量。 偏移量为一个大于0小于终端节点服务总个数的整数, 表示从偏移量后面的终端节点服务开始查询。

最小值:0

sort_key

String

查询结果中终端节点服务列表的排序字段,取值为:

  • create_at:终端节点服务的创建时间

  • update_at:终端节点服务的更新时间 默认值为create_at。

缺省值:create_at

sort_dir

String

查询结果中白名单列表的排序方式,取值为:

  • desc:降序排序

  • asc:升序排序 默认值为desc。

缺省值:desc

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Content-Type

String

发送的实体的MIME类型。推荐用户默认使用application/json, 如果API是对象、镜像上传等接口,媒体类型可按照流类型的不同进行确定。

缺省值:application/json

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

permissions

Array of PermissionObject objects

permission列表。

total_count

Integer

满足查询条件的终端节点服务的白名单总条数,不受分页(即limit、offset参数)影响。

表5 PermissionObject

参数

参数类型

描述

id

String

permission的ID,唯一标识。

最小长度:1

最大长度:64

permission

String

permission列表。 权限格式为:iam:domain::domain_id或者organizations:orgPath::org_path其中,

  • “iam:domain::”和“organizations:orgPath::”为固定格式。

  • “domain_id”为可连接用户的帐号ID,org_path可连接用户的组织路径 domain_id类型支持输入包括“a~z”、“A~Z”、“0~9”或者“”,org_path类型支持“a~z”、“A~Z”、“0~9”、“/-?”或者“”。 “”表示所有终端节点可连接。 例如:iam:domain::6e9dfd51d1124e8d8498dce894923a0dd或者organizations:orgPath::o-3j59d1231uprgk9yuvlidra7zbzfi578/r-rldbu1vmxdw5ahdkknxnvd5rgag77m2z/ou-7tuddd8nh99rebxltawsm6qct5z7rklv/*

最小长度:1

最大长度:1024

permission_type

String

终端节点服务白名单类型。

  • domainId:基于账户ID配置终端节点服务白名单。

  • orgPath:基于账户所在组织路径配置终端节点服务白名单。

created_at

String

白名单的添加时间。 采用UTC时间格式,格式为:YYYY-MMDDTHH:MM:SSZ

请求示例

查询终端节点服务的白名单列表

GET https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88/permissions?permission={permission}&sort_dir={sort_dir}&limit={limit}&offset={offset}

查询终端节点服务ID为“4189d3c2-8882-4871-a3c2-d380272eed88”的白名单列表。 GET https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88/permissions

响应示例

状态码: 200

服务器已成功处理了请求

{
  "permissions" : [ {
    "id" : "f2659906-c622-480a-83e9-ef42bdb67b90",
    "permission" : "*",
    "created_at" : "2018-10-18T13:26:40Z"
  } ],
  "total_count" : 1
}

状态码

状态码

描述

200

服务器已成功处理了请求

错误码

请参见错误码