# 上传A号码报备文件 - CreateReportFiles
#### 接口功能
企业租户通过该接口上传号码所属人现场照片报备文件。
#### 使用说明
前提条件：
1. 已[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)或已获取AK（Access Key ID）/SK（Secret Access Key）。
2. 已[开通隐私号业务](https://console.huaweicloud.com/privatenumber/?ttl=866042086#/overview)。
3. 请根据业务的预计使用情况准备企业相关报备信息，详细内容可参照下表的材料说明。企业报备材料通过本接口上传。
   表1租户级A号码报备材料 
   | 名称        | 规范性要求                                   |
   |:---|:---|
   | 号码所属人现场照片 | 号码所属人现场照片，半身或者寸照的头像，照片jpg或png格式，32KB以下。 |
      
   
 
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限管理](https://support.huaweicloud.com/productdesc-PrivateNumber/privatenumber_permissions.html)。
#### URI
POST /v1/privatenumber/a-number/files
#### 请求参数
表2请求Headers参数说明 
| 参数名称         | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 说明： - Token的有效期为24小时，到期后请重新获取。  - 使用AKSK鉴权不需要携带此参数。   |
   
表3请求URL参数说明 
| 参数名称                          | 是否必选 | 参数类型    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| agree_authorization_statement | 是    | Boolean | 是否同意个人数据授权声明。 - true：同意。   说明： - "A号码报备文件上传"操作会收集您的现场照片信息，该信息属于敏感个人信息，仅用于隐私号业务向运营商报备号码，如果非本人操作，请确定已获得相应授权。  - 如果不同意个人数据授权声明，上传文件会失败。  - 点击查看[隐私政策声明](https://www.huaweicloud.com/declaration/sa_prp.html)、[服务使用声明](https://www.huaweicloud.com/declaration/tsa_privatenumber.html)。   |
   
表4请求Body参数说明 
| 参数名称  | 是否必选 | 参数类型              | 说明                                                                     |
|:---|:---|:---|:---|
| files | 是    | MultipartFile\[\] | 号码所属人现场照片文件，支持jpg或png格式，单个文件最大支持32KB，最大支持10个文件，文件名全局保持唯一，文件名长度不超过64字符。 |
   
#### 响应参数
表5响应结果参数 
| 参数名称        | 是否必须 | 参数类型                                                               | 说明                                 |
|:---|:---|:---|:---|
| result      | 否    | String                                                             | 值为"Upload Successful."，响应码为200时携带。 |
| error_code  | 否    | String                                                             | 请求异常时返回的错误码，响应码不为200时携带。           |
| error_msg   | 否    | String                                                             | 请求异常时返回的错误描述，响应码不为200时携带。          |
| failedFiles | 否    | [FailedFile]\[\] | 部分文件上传失败时，返回的失败文件列表。               |
   
 表6FailedFile定义 
| 参数名称       | 是否必选 | 参数类型       | 说明      |
|:---|:---|:---|:---|
| file       | 是    | String(64) | 文件名。    |
| failReason | 是    | String     | 失败原因描述。 |
   
#### 结果码说明
表7响应结果码 
| 响应码                                                                                                                   | 返回值       | 英文描述                                                                                                         | 中文描述              | 处理方法                                                                                 |
|:---|:---|:---|:---|:---|
| 400    | PPT.0002  | Invalid Parameter.                                                                                           | 参数错误。             | 请检查请求参数填写是否正确。                                                                       |
| 400    | PPT.0009  | Order does not exist.                                                                                        | 服务未开通完成。          | 点击[开通隐私号业务](https://console.huaweicloud.com/privatenumber/?ttl=866042086#/overview)。 |
| 400    | PPT.00032 | The operation is forbidden because tenant has been frozen.                                                   | 租户已被冻结，不能进行该操作。   | 请联系管理员处理。                                                                            |
| 400    | PPT.00033 | The operation is forbidden because tenant has been restricted.                                               | 租户受限，不允许操作。       | 请联系管理员处理。                                                                            |
| 400    | PPT.00039 | Operation failed.                                                                                            | 操作失败。             | 请联系管理员处理。                                                                            |
| 403                                                                                                                   | PPT.00053 | The name of the uploaded file can contain up to 64 characters. | 上传文件名称长度最大支持64字符。 | 请修改文件名称的长度。                                                                          |
| 500                                                                                                                   | PPT.0001  | Internal server error.                                                                                       | 内部服务错误。           | 请联系管理员处理。                                                                            |
   
#### 接口示例
- 请求示例
  ```
  POST /v1/privatenumber/a-number/files
  {
   "files": "/**/xxx.jpg"            
  }
  ```
  
- 响应示例
  ```
  成功：
  { 
      "result": "Upload Successful."
  }
  失败：
  { 
    "error_code":"PPT.0009","error_msg"："Order does not exist"
  }
  ```