获取分享Token

• 功能介绍

  用于获取临时Token，使用该Token可访问文件，不用再使用“access-token”进行鉴权。获取的Token是临时性的，存在有效期。

• URI

  POST 华为云Astro轻应用 域名 /u-route/baas/sys/v1.1/connectors/{connector_type}/{connector_name}/sharetoken

  表1 路径参数

  参数	是否必选	参数类型	描述
  connector_type	是	String	参数解释： 连接器的类型。 约束限制： 不涉及。 取值范围： obs：与OBS对接的连接器。 minio：与MINIO对接的连接器。 objectstorageproxy：对象存储代理类型。 默认取值： 不涉及。
  connector_name	是	String	参数解释： 连接器实例的名称，即创建连接器时设置的连接器实例名。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

• 请求参数

  表2 请求body参数

  参数	是否必选	参数类型	描述
  shareType	是	Integer	参数解释： 分享类型。 约束限制： 不涉及。 取值范围： 0：代表按文件分享。 1：代表按目录分享。 2：用字符数组表示多个文件路径。 默认取值： 不涉及。
  key	否	String	参数解释： 分享的对象、目录。 约束限制： 如果是目录，必须以“/”结尾。 取值范围： 不涉及。 默认取值： 不涉及。
  keys	否	String	参数解释： 多个文件路径。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。
  timeoutInMinutes	是	Integer	参数解释： 分享的有效期，单位为分钟。 约束限制： 不涉及。 取值范围： 1~1440，即最短1分钟，最长1440分钟。 默认取值： 不涉及

• 响应参数

  表3 响应参数说明

  参数	参数类型	描述
  resCode	String	参数解释： 返回码。 取值范围： 如果返回“0”代表请求成功，其他错误码说明请参考错误码。
  resMsg	String	参数解释： 返回消息。 取值范围： 成功返回“成功”，其他情况会返回具体的错误信息。
  result	Object	参数解释： 返回结果对象。对象中包含“shareToken”字段，表示临时Token。

• 请求示例

  已创建好OBS类型连接器，连接器实例名称为“命名空间__TestOBS”。调用如下请求，获取某些文件的临时访问Token。

  POST https://华为云Astro轻应用域名/u-route/baas/sys/v1.1/connectors/obs/命名空间__TestOBS/sharetoken
  
  {
   "shareType": 0,
   "key": "a/b/c/1.txt",
   "keys": [
    "a/b/c/2.txt",
    "ROMAExchange.zip",
    "some/dir/c.jpg"
   ],
   "timeoutInMinutes": 60
  }

  使用者拿到URL后即可访问，请注意避免分享敏感文件。

• 响应示例

  {
   "resCode": "0",
   "resMsg": "成功",
   "result": {
    "shareToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJz***tOejj6NEo"
   }
  }

  请记录下“shareToken”的值，后续访问文件使用。