
# 用户设置头像 - SetProfileImage
#### 描述
用户通过调用该接口设置头像。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=Meeting&api=SetProfileImage)中调试该接口。
#### URI
POST /v1/usg/abs/profile-images
#### 请求参数
表1参数说明 
| 参数             | 是否必须 | 类型     | 位置       | 描述                                                                                                     |
|:---|:---|:---|:---|:---|
| X-Access-Token | 是    | String | Header   | 授权令牌。获取"[执行App ID鉴权](https://support.huaweicloud.com/api-meeting/meeting_21_0311.html)"响应的accessToken。 |
| X-Request-Id   | 否    | String | Header   | 请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用UUID，若不携带，则后台自动生成。                                                   |
| file           | 是    | File   | FormData | 上传的头像图片，图片文件不超过10MB，尺寸不超过4096\*4096。                                                                   |
   
#### 状态码
表2状态码说明 
| HTTP状态码 | 描述                                         |
|:---|:---|
| 200     | 操作成功，头域中会包含ETag以方便后续查询。                    |
| 400     | 无法处理的请求。                                   |
| 401     | 未鉴权或鉴权失败。                                  |
| 413     | 图片大小过大，目前服务端大小限制最大为10MB，具体限制可受网络中前置负载均衡影响。 |
| 415     | 不支持的数据类型，意味着上传的图片类型无法解析或者不支持。              |
| 500     | 服务端异常。                                     |
   
#### 响应参数
无
#### 请求消息示例
```
POST /v1/usg/abs/profile-images
Connection: keep-alive
X-Access-Token: cnrfzn5OLRjwoaOf2F7PfMwVjJ6zScFogbDE
content-type: multipart/form-data
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
{
    "file":[binary]
}
```
#### 响应消息示例
```
HTTP/1.1 200 
Date: Mon, 13 Jul 2020 02:20:32 GMT
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 5032547386ab1e2e6a24842e9e1abea9
ETag: 1365f1205df0b5b4b991c94250a36af0
```
#### 错误码
当您使用华为云会议服务端API时，如果遇到"MMC"或者"USG"开头的错误码，请参考[华为云API错误中心](https://apierrorcenter.developer.huaweicloud.com/apierrorcenter/errorcode?product=Meeting)。
#### CURL命令示例
```
curl -k -i -H 'content-type: multipart/form-data' -X POST -H 'X-Access-Token: cnrfzn5OLRjwoaOf2F7PfMwVjJ6zScFogbDE' -F 'file=@c:/Users/Administrator/Desktop/test.png'
https://api.meeting.huaweicloud.com/v1/usg/abs/profile-images
```
