文档首页/ Astro轻应用 AstroZero/ API参考/ API/ 连接器/ 获取endpoint,即文件存储地址的前缀
更新时间:2024-06-28 GMT+08:00
分享

获取endpoint,即文件存储地址的前缀

endpoint为文件存储地址的前缀,该前缀加上传对象的路径,是实际访问对象的全路径。上传文件返回的是上传文件在桶上的路径。通过调用本节接口,返回endpoint,组装起来才是文件完整的访问地址。

URI

GET AstroZero域名/u-route/baas/sys/v1.1/connectors/{connector_type}/{connector_name}/getendpoint

表1 路径参数

参数

是否必选

参数类型

描述

connector_type

String

参数解释

连接器的类型。

约束限制

不涉及。

取值范围

  • obs:与OBS对接的连接器。
  • minio:与MINIO对接的连接器。
  • objectstorageproxy:对象存储代理类型。

默认取值

不涉及。

connector_name

String

参数解释

连接器实例的名称,即创建连接器时设置的连接器实例名。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

响应参数

表2 响应参数说明

参数

参数类型

描述

resCode

String

参数解释

返回码。

取值范围

如果返回“0”代表请求成功,其他错误码说明请参考错误码

resMsg

String

参数解释

返回消息。

取值范围

如果成功状态,通常会返回“Success”,其他情况会返回具体的错误信息。

result

Object

参数解释

如果请求成功,返回“endpoint”,即文件存储地址的前缀。“endpoint”和上传文件返回的上传文件,在桶上的路径组装起来才是文件完整的访问地址。

请求示例

已创建好OBS类型连接器,连接器实例名称为“命名空间__TestOBS”,执行如下请求,获取endpoint,即文件存储地址的前缀。

GET https://AstroZero域名/u-route/baas/sys/v1.1/connectors/obs/命名空间__TestOBS/getendpoint

响应示例

{
	"resCode": "0",
	"resMsg": "成功",
	"result": {
		"endpoint": "https://test.obs.***.com/"
	}
}

调用上传文件接口在桶“a/b/c”路径下成功上传了“1.txt”文件后,该文件的完整访问地址为“https://test.obs.***.com/a/b/c/1.txt”。

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档