华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度：1 最大长度：2048 Content-Type 否 String 发送的实体的MIME类型。推荐用户默认使用application/json， 如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 缺省值：application/json

请求示例 查询终端节点服务的白名单列表 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 服务器已成功处理了请求 400 服务器未能处理请求 401 被请求的页面需要用户名和密码 403 对被请求页面的访问被禁止 404 服务器无法找到被请求的页面 405 请求中指定的方法不被允许 406 服务器生成的响应无法被客户端所接受 407 用户必须首先使用代理服务器进行验证，这样请求才会被处理 408 请求超出了服务器的等待时间 409 由于冲突，请求无法被完成 500 请求未完成。服务异常 501 请求未完成。服务器不支持所请求的功能 502 请求未完成。服务器从上游服务器收到一个无效的响应 503 请求未完成。系统暂时异常 504 网关超时

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，表示白名单的添加时间。 缺省值：create_at sort_dir 否 String 查询结果中白名单列表的排序方式，取值为： ● desc：降序排序 ● asc：升序排序 默认值为desc。 缺省值：desc

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度：1 最大长度：2048 Content-Type 否 String 发送的实体的MIME类型。推荐用户默认使用application/json， 如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 缺省值：application/json 最小长度：1 最大长度：64

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 permissions Array of PermissionObject objects permission列表。 total_count Integer 满足查询条件的终端节点服务的白名单总条数，不受分页（即limit、offset参数）影响。 表5 PermissionObject 参数 参数类型 描述 id String permission的ID，唯一标识。 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/* permission_type String 终端节点服务白名单类型。 ● domainId：基于账户ID配置终端节点服务白名单。 ● orgPath：基于账户所在组织路径配置终端节点服务白名单。 created_at String 白名单的添加时间。 采用UTC时间格式，格式为：YYYY-MMDDTHH:MM:SSZ 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表7 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 401 表8 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表9 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 403 表10 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表11 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 404 表12 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表13 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 405 表14 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表15 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 406 表16 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表17 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 407 表18 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表19 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 408 表20 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表21 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 409 表22 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表23 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 500 表24 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表25 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 501 表26 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表27 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 502 表28 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表29 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 503 表30 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表31 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 504 表32 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表33 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码

状态码 状态码 描述 200 服务器已成功处理了请求 400 服务器未能处理请求 401 被请求的页面需要用户名和密码 403 对被请求页面的访问被禁止 404 服务器无法找到被请求的页面 405 请求中指定的方法不被允许 406 服务器生成的响应无法被客户端所接受 407 用户必须首先使用代理服务器进行验证，这样请求才会被处理 408 请求超出了服务器的等待时间 409 由于冲突，请求无法被完成 500 请求未完成。服务异常 501 请求未完成。服务器不支持所请求的功能 502 请求未完成。服务器从上游服务器收到一个无效的响应 503 请求未完成。系统暂时异常 504 网关超时

响应示例 状态码： 200 服务器已成功处理了请求 { "version":{ { "updated":"2018-09-30T00:00:00Z", "version":"1", "min_version":"", "status":"CURRENT", "id":"v1", "links":[ { "href":"https://{vpcep_uri}/v1", "type":"application/json", "rel":"self" } ] } }}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 version VersionObject object 描述VPCEP服务API版本信息列表 表4 VersionObject 参数 参数类型 描述 status String 版本状态。 ● CURRENT：表示该版本为主推版本。 ● SUPPORT：表示为老版本，但是现在还在继续支持。 ● DEPRECATED：表示为废弃版本，存在后续删除的可能。 id String 版本ID。 updated String 版本发布时间。采用UTC时间格式，格式为：YYYY-MMDDTHH:MM:SSZ version String 支持的版本号。 min_version String 支持的微版本号。若该版本API不支持微版本，则为空。 links Array of Link objects API的URL地址 表5 Link 参数 参数类型 描述 href String 当前API版本的引用地址。 type String 发送的实体的MIME类型，取值为application/json。 rel String 当前API版本和被引用地址的关系。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表7 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 401 表8 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表9 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 403 表10 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表11 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 404 表12 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表13 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 405 表14 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表15 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 406 表16 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表17 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 407 表18 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表19 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 408 表20 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表21 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 409 表22 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表23 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 500 表24 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表25 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 501 表26 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表27 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 502 表28 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表29 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 503 表30 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表31 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 504 表32 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表33 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码

响应示例 状态码： 200 服务器已成功处理了请求 { "quotas" : { "resources" : [ { "type" : "endpoint", "used" : 4, "quota" : 150 }, { "type" : "endpoint_service", "used" : 10, "quota" : 100 } ] }}

状态码 状态码 描述 200 服务器已成功处理了请求 400 服务器未能处理请求 401 被请求的页面需要用户名和密码 403 对被请求页面的访问被禁止 404 服务器无法找到被请求的页面 405 请求中指定的方法不被允许 406 服务器生成的响应无法被客户端所接受 407 用户必须首先使用代理服务器进行验证，这样请求才会被处理 408 请求超出了服务器的等待时间 409 由于冲突，请求无法被完成 500 请求未完成。服务异常 501 请求未完成。服务器不支持所请求的功能 502 请求未完成。服务器从上游服务器收到一个无效的响应 503 请求未完成。系统暂时异常 504 网关超时

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Content-Type 否 String 发送的实体的MIME类型。推荐用户默认使用application/json， 如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 缺省值：application/json

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 quotas ResourcesResp object 查询配额接口响应结构体 表5 ResourcesResp 参数 参数类型 描述 resources Array of Quotas objects 资源列表 表6 Quotas 参数 参数类型 描述 type String 资源类型。支持根据资源类型过滤查询指定类型的配额。 ● endpoint_service：终端节点服务 ● endpoint：终端节点 used Integer 已创建的资源个数。 取值范围：0~quota数。 quota Integer 资源的最大配额数。 取值范围：各类型资源默认配额数的最大值。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表8 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表10 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 403 表11 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表12 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 404 表13 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表14 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 405 表15 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表16 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 406 表17 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表18 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 407 表19 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表20 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 408 表21 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表22 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 409 表23 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表24 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 500 表25 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表26 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 501 表27 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表28 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 502 表29 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表30 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 503 表31 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表32 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 504 表33 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表34 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码

调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "project_name", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" }}

响应示例 状态码： 200 服务器已成功处理了请求 { "connections" : [ { "id" : "adb7b229-bb11-4072-bcc0-3327cd784263", "status" : "accepted", "marker_id" : 16777510, "domain_id" : "5fc973eea581490997e82ea11a1df31f", "created_at" : "2018-09-17T11:10:11Z", "updated_at" : "2018-09-17T11:10:12Z" }, { "id" : "fd69d29f-dc29-4a9b-80d8-b51d1e7e58ea", "status" : "accepted", "marker_id" : 16777513, "domain_id" : "5fc973eea581490997e82ea11a1df31f", "created_at" : "2018-09-17T07:28:56Z", "updated_at" : "2018-09-17T07:28:58Z" } ], "total_count" : 2}

状态码 状态码 描述 200 服务器已成功处理了请求 400 服务器未能处理请求 401 被请求的页面需要用户名和密码 403 对被请求页面的访问被禁止 404 服务器无法找到被请求的页面 405 请求中指定的方法不被允许 406 服务器生成的响应无法被客户端所接受 407 用户必须首先使用代理服务器进行验证，这样请求才会被处理 408 请求超出了服务器的等待时间 409 由于冲突，请求无法被完成 500 请求未完成。服务异常 501 请求未完成。服务器不支持所请求的功能 502 请求未完成。服务器从上游服务器收到一个无效的响应 503 请求未完成。系统暂时异常 504 网关超时

请求示例 查询连接终端节点服务的连接列表 GET https://{endpoint}/v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/connections? id={vpc_endpoint_id}&marker_id={marker_id}&status={status}&sort_key={sort_key }&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/connections

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Content-Type 否 String 发送的实体的MIME类型。推荐用户默认使用application/json， 如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 缺省值：application/json

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 connections Array of ConnectionEndpoints objects 连接列表。 total_count Integer 满足查询条件的终端节点总条数，不受分页（即limit、offset参数）影响。 表5 ConnectionEndpoints 参数 参数类型 描述 id String 终端节点的ID，唯一标识。 marker_id Integer 终端节点的报文标识。 created_at String 终端节点的创建时间。 采用UTC时间格式，格式为：YYYY-MMDDTHH:MM:SSZ updated_at String 终端节点的更新时间。 采用UTC时间格式，格式为：YYYY-MMDDTHH:MM:SSZ domain_id String 用户的Domain ID。 error Array of QueryError objects 错误信息。 当终端节点服务状态异常，即“status”的值为“failed”时，会返回该字段。 status String 终端节点的连接状态。 ● pendingAcceptance：待接受 ● creating：创建中 ● accepted：已接受 ● rejected：已拒绝 ● failed：失败 ● deleting：删除中 description String 终端节点连接描述。 表6 QueryError 参数 参数类型 描述 error_code String 错误编码。 error_message String 错误信息。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表8 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表10 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 403 表11 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表12 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 404 表13 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表14 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 405 表15 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表16 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 406 表17 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表18 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 407 表19 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表20 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 408 表21 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表22 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 409 表23 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表24 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 500 表25 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表26 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 501 表27 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表28 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 502 表29 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表30 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 503 表31 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表32 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码 状态码： 504 表33 响应Body参数 参数 参数类型 描述 error Error object 提交任务异常时返回的异常信息 表34 Error 参数 参数类型 描述 message String 任务异常错误信息描述 code String 任务异常错误信息编码

URI GET /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/connections 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 最小长度：1 vpc_endpoint_service_id 是 String 终端节点服务的ID。 表2 Query参数 参数 是否必选 参数类型 描述 id 否 String 终端节点的ID，唯一标识。 marker_id 否 String 终端节点的报文标识。 status 否 String 终端节点的连接状态。 ● pendingAcceptance：待接受 ● accepted：已接受 ● rejected：已拒绝 ● failed：失败 sort_key 否 String 查询结果中终端节点列表的排序字段，取值为： ● create_at：终端节点的创建时间 ● update_at：终端节点的更新时间 默认值为create_at。 缺省值：create_at sort_dir 否 String 查询结果中终端节点列表的排序方式，取值为： ● desc：降序排序 ● asc：升序排序 默认值为desc。 缺省值：desc limit 否 Integer 查询返回终端节点服务的连接列表限制每页个数，即每页返回的个数。 取值范围：0~1000，取值一般为10，20或者50，默认为10。 最小值：1 最大值：1000 缺省值：10 offset 否 Integer 偏移量。 偏移量为一个大于0小于终端节点服务总个数的整数， 表示从偏移量后面的终端节点服务开始查询。 最小值：0

支持审计的关键操作列表 表1 云审计服务支持的RAM操作列表 操作名称 资源类型 事件名称 创建权限 Permission createPermission 删除权限 Permission deletePermission 更新权限 Permission updatePermission 创建资源共享实例 ResourceShare createResourceShare 删除资源共享实例 ResourceShare deleteResourceShare 更新资源共享实例 ResourceShare updateResourceShare 为资源共享实例中包含的资源类型添加或替换RAM权限 ResourceShare associateResourceSharePermission 取消资源共享实例关联的RAM权限 ResourceShare disassociateResourceSharePermission 向资源共享实例增加角色和资源 ResourceShare associateResourceShare 取消角色和资源与资源共享实例的关联 ResourceShare disassociateResourceShare 接受资源共享实例的邀请 ResourceShare acceptResourceShareInvitation 拒绝资源共享实例的邀请 ResourceShare rejectResourceShareInvitation 开启与组织的共享 ResourceShare enableShareWithOrganization 关闭与组织的共享 ResourceShare disableShareWithOrganization

操作场景 当您的帐号由华为云Organizations管理时，您可以利用此优势更轻松地共享资源。如果您的帐号在组织中，则您可以与单个帐号共享，也可以与组织或OU中的所有帐号共享，而不必枚举每个帐号。 要在组织内共享资源，您还需先使用RAM控制台来启用与组织共享资源。当您在组织中共享资源时，您组织或OU中的帐号无需接受邀请即可访问和使用共享资源。 如果您不再需要与整个组织或OU共享资源，您可以禁用与组织共享资源，该功能禁用后，创建共享时指定的使用者将无法选择组织。 在启用与组织共享资源期间，如果组织的成员帐号主动退出组织或被管理员移出组织，该成员帐号创建的资源共享实例中将解绑同组织的资源使用者；组织中共享给此成员帐号的资源共享实例中将解绑此成员帐号。 在启用与组织共享资源期间，如果组织管理员删除某个OU，则共享给此OU的资源共享实例中将解绑此OU。 在启用与组织共享资源期间，如果删除整个组织，则与组织共享的资源共享实例中将解绑组织内的全部帐号。

操作场景 要访问共享资源，资源所有者必须将您指定为共享资源的使用者。 如果资源所有者与您属于同一组织，且启用“启用与组织共享资源”功能，则您将自动获得共享资源的访问权限，无需接受邀请。 如果资源所有者与您不属于同一组织，或者属于同一组织但未启用“启用与组织共享资源”功能，则您将收到加入资源共享实例的邀请。 如果您收到加入资源共享实例的邀请，则必须接受该邀请才能访问其共享的资源。这些资源可直接在每个资源的管理控制台上使用。如果您拒绝资源共享实例的邀请，您将无法访问此共享资源。 资源共享实例的邀请默认保留7天，如果您在到期前未接受邀请，系统会自动拒绝邀请，如您还需使用共享资源，请再次创建共享实例以生成新的邀请。

标签简介 标签用于标识云资源，当您拥有相同类型的许多云资源时，可以使用标签按各种维度（例如用途、所有者或环境）对云资源进行分类。 RAM支持为资源共享实例添加标签，您可以根据标签快速搜索和筛选特定的资源共享实例，使您可以更轻松高效的识别和管理拥有的资源共享实例。 您可以在创建资源共享实例时添加标签，也可以在资源共享实例创建完成后，在共享的详情页添加、修改、查看、删除标签，您最多可以给每个资源共享实例添加20个标签。

标签的使用约束 每个标签由“标签键”和“标签值”组成，“标签键”和“标签值”的命名规则如下： “标签键”： 不能为空。 长度不超过128个字符。 由英文字母、数字、下划线、中划线、UNICODE字符（\u4E00-\u9FFF）组成。 “标签值”： 可以为空。 长度不超过225个字符。 由英文字母、数字、下划线、点、中划线、UNICODE字符（\u4E00-\u9FFF）组成。 每个云资源最多可以添加20个标签。 对于每个云资源，每个“标签键”都必须是唯一的，每个“标签键”只能有一个“标签值”。

SDK列表 表1提供了Config服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导 NodeJs huaweicloud-sdk-nodejs-v3 NodeJs SDK使用指导 PHP huaweicloud-sdk-php-v3 PHP SDK使用指导

RAM自定义策略样例 示例1：授权用户可以接受共享邀请 { "Version": "1.0", "Statement": [ { "Effect": "Allow", "Action": [ "ram:resourceShareInvitations:accept", ], "Resource": "*" } ]} 示例2：授权用户可查看权限列表和内容 { "Version": "1.0", "Statement": [ { "Effect": "Allow", "Action": [ "ram:permissions:list", "ram:permissions:get", ], "Resource": "*" } ]}

SDK列表 表1提供了云专线服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导

SDK列表 表1提供了云专线服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导

修订记录 发布日期 修改说明 2022-11-30 第十九次正式发布，新增如下内容： DRS对接云日志服务，配置访问日志后，DRS实例新生成的所有日志记录会上传到云日志服务进行管理。 2022-07-30 第十八次正式发布，新增如下内容： 备份迁移界面优化“最后一次备份”说明。 对于创建失败的任务，DRS默认保留3天，超过3天将会自动结束任务。 2022-04-30 第十七次正式发布，相较于上一个版本有如下变更： 任务标签的键和值支持长度和字符范围调整。 2022-02-28 第十六次正式发布，新增如下内容： DRS备份迁移功能界面词优化。 2022-01-30 第十五次正式发布，新增如下内容： DRS备份迁移支持Microsoft SQL Server 2019备份还原迁移上云能力。 2021-11-30 第十四次正式发布，相较于上一个版本有如下变更： 帮助文档结构按照功能调整。 2021-08-30 第十三次正式发布，新增如下内容： DRS任务异常通知支持从SMN主题选取。 2021-07-05 第十二次正式发布，新增如下内容： DRS新增权限，支持除删除实例外的所有权限。 2020-07-31 第十一次正式发布，新增如下内容： DRS支持同一租户下的不同用户可以各自管理DRS任务，且各用户之间任务互不可见。 2019-11-30 第十次正式发布，新增如下内容： SQL Server备份恢复还原需要支持数据库改名称。 2019-10-30 第九次正式发布，新增如下内容： 备份迁移支持对备份文件的预校验。 支持标签系统。 2019-08-30 第八正式发布，新增如下内容： SQL Server 数据库名称支持添加中划线"-"。 2019-01-30 第七次正式发布，新增如下内容： 全量备份迁移支持数据库别名设置，支持默认全部数据库恢复。 2018-11-30 第六次正式发布，新增如下内容： 备份迁移支持bak文件多选。 支持批量删除任务。 2018-10-30 第五次正式发布，新增如下内容： 备份迁移 离线迁移更名为备份迁移。 2018-09-30 第四次发布，新增以下内容： 离线迁移 支持Microsoft SQL Server增量备份迁移。 2018-08-31 第三次发布，新增以下内容： 离线迁移 故障排查案例。 2018-03-09 第二次正式发布，新增以下内容： 离线迁移 支持从OBS桶中或者从数据库备份中还原数据库到RDS中。 增加查看迁移任务详情、查看迁移日志，删除迁移任务。 2017-11-30 第一次正式发布。