
# 创建SAS Token
#### 功能介绍
创建SAS token凭据，用于访问瓦片。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=MapDS&api=CreateSasToken)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v1/map/sastoken
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                    |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | IAM用户的token，无需特殊权限。                   |
| Content-Type | 是    | String | 该字段填为"application/json;charset=utf8"。 |
   
表2请求Body参数 
| 参数      | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| keytype | 是    | String | 用于为用户生成令牌的密钥 取值为primary或者secondary 每个用户只有2个apikey，primary的原则就是对比apiKey时间最早的那个。 如果只有一个apikey，primary和secondary都指同一个apiKey |
| expiry  | 是    | String | 令牌到期UTC时间，格式如：2019-04-21T00:44:24Z 日期符合以下格式： yyyy-MM-ddTHH:mm:ssZ 由 ISO 8601 标准指定。 最小值不小于15min，最大值不超过24h                                                    |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数        | 参数类型   | 描述                |
|:---|:---|:---|
| client_id | String | API key的client_id |
| expiry    | String | 超期时间，UTC格式        |
| signature | String | 签名字符串             |
   
#### 请求示例
创建用于访问地图瓦片的SAS token凭据，并设置令牌到期时间。
```
POST https://mapds.cn-north-4.myhuaweicloud.com/v1/map/sastoken
{
  "keytype" : "primary",
  "expiry" : "2019-04-21T00:44:24Z"
}
```
#### 响应示例
**状态码： 200**
成功
```
{
  "client_id" : "ecfb52c6e2fc43d391a9ea9ab1e60d61",
  "expiry" : "2022-07-20T12:12:12Z",
  "signature" : "tXyTn9LBnQzuI4FOAHgPDFdW28G34ZFSwCzEv72ZXnE%3D"
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | 成功          |
| 400 | 客户端错误，参数无效。 |
| 403 | 没有操作权限。     |
| 500 | 内部服务错误。     |
| 503 | 服务不可用。      |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-mapds/ErrorCode.html)。
