
# 获取微服务引擎专享版用户Token - ObtainUserTokenOfExclusiveMicroserviceEngine
#### 功能介绍
仅用于开启了安全认证的微服务引擎专享版。
在访问开启了安全认证的微服务引擎专享版的接口前，需要先调用该接口获取用户Token，该Token是访问接口的唯一凭据。
发送访问请求时需要在请求头中带上该Token，格式为：
```
Authorization:Bearer {Token}
```
#### 接口约束
无
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-servicestage/servicestage_06_0183.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v4/token
#### 请求参数
表1请求Body参数 
| 参数       | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| name     | 是    | String | 用户账号名称。 |
| password | 是    | String | 用户账号密码。 |
   
#### 响应参数
**状态码： 200**
表2响应Body参数 
| 参数    | 参数类型   | 描述                   |
|:---|:---|:---|
| token | String | 获取的用户Token，有效期为12小时。 |
   
**状态码： 401**
表3响应Body参数 
| 参数           | 参数类型   | 描述      |
|:---|:---|:---|
| errorCode    | String | 错误代码。   |
| errorMessage | String | 错误信息。   |
| detail       | String | 详细定位信息。 |
   
**状态码： 500**
表4响应Body参数 
| 参数           | 参数类型   | 描述      |
|:---|:---|:---|
| errorCode    | String | 错误代码。   |
| errorMessage | String | 错误信息。   |
| detail       | String | 详细定位信息。 |
   
#### 请求示例
```
POST https://{服务注册发现地址}/v4/token
{
    "name": "root",
    "password": "*******"
}
```
#### 响应示例
**状态码： 200**
用于获取用户Token的响应结构体。
```
{
  "token" : "****bGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9.****************.****************-2JxeUe3eOl5Md5kzOIAE_EYUATxCbJ5GmgpSSJf*****"
}
```
#### 状态码
| 状态码 | 描述                 |
|:---|:---|
| 200 | 用于获取用户Token的响应结构体。 |
| 401 | 错误的请求，鉴权失败。        |
| 500 | 服务内部错误             |
   
#### 错误码
请参见[ServiceComb错误码](https://support.huaweicloud.com/api-servicestage/cse_06_0137.html)。
