
# 根据center、size、padding参数生成可渲染的口袋文件内容 - GeneratePocketFile
#### 功能介绍
根据center、size、padding参数生成可渲染的口袋文件内容。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0100.html)。
#### URI
POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/toolkit/pocket
表1路径参数 
| 参数                  | 是否必选 | 参数类型   | 描述                                                                                                                                                                                |
|:---|:---|:---|:---|
| project_id          | 是    | String | **参数解释**： 项目ID，您可以从[获取项目ID](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0033.html)中获取。 **约束限制**： 不涉及 **取值范围**： 仅支持字母、数字、中划线和下划线，长度为\[1-128\]个字符。 **默认取值**： 不涉及 |
| eihealth_project_id | 是    | String | **参数解释**： 空间ID，您可以从[获取空间ID](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0099.html)中获取。 **约束限制**： 不涉及 **取值范围**： 仅支持字母、数字、中划线和下划线，长度为\[1-128\]个字符。 **默认取值**： 不涉及 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释**： 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，[获取Token](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0011.html)接口响应消息头中X-Subject-Token的值即为Token。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-32768\]个字符。 **默认取值**： 不涉及 |
   
表3请求Body参数 
| 参数      | 是否必选 | 参数类型             | 描述                                                                                               |
|:---|:---|:---|:---|
| center  | 是    | Array of doubles | **参数解释**： 口袋中心坐标。 **约束限制**： 坐标数量固定为3，坐标大小取值范围为\[-9999999-99999999\]。 **取值范围**： 不涉及 **默认取值**： 不涉及 |
| size    | 是    | Array of floats  | **参数解释**： 口袋大小。 **约束限制**： 口袋数量固定为3，口袋大小范围为\[2-500\]。 **取值范围**： 不涉及 **默认取值**： 不涉及                 |
| padding | 是    | Float            | **参数解释**： 口袋的padding值。 **约束限制**： 不涉及 **取值范围**： 0-20 **默认取值**： 不涉及                                |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数 | 参数类型   | 描述        |
|:---|:---|:---|
| -  | String | 生成的口袋字符串。 |
   
#### 请求示例
设置口袋中心位置、大小和padding的值生成可渲染的口袋文件内容。
```
https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/toolkit/pocket
{
  "center" : [ 0, 0, 0 ],
  "size" : [ 10, 10, 10 ],
  "padding" : 6
}
```
#### 响应示例
**状态码：200**
生成的口袋字符串。
```
HEADER    CORNERS OF BOX
REMARK    CENTER (X Y Z)   0.0  0.0  0.0
REMARK    DIMENSIONS (X Y Z)   10.0  10.0  10.0
ATOM      1  DUA BOX     1     -11.000 -11.000 -11.000
ATOM      2  DUB BOX     1      11.000 -11.000 -11.000
ATOM      3  DUC BOX     1      11.000 -11.000  11.000
ATOM      4  DUD BOX     1     -11.000 -11.000  11.000
ATOM      5  DUE BOX     1     -11.000  11.000 -11.000
ATOM      6  DUF BOX     1      11.000  11.000 -11.000
ATOM      7  DUG BOX     1      11.000  11.000  11.000
ATOM      8  DUH BOX     1     -11.000  11.000  11.000
CONECT    1    2    4    5
CONECT    2    1    3    6
CONECT    3    2    4    7
CONECT    4    1    3    8
CONECT    5    1    6    8
CONECT    6    2    5    7
CONECT    7    3    6    8
CONECT    8    4    5    7
```
#### 状态码
| 状态码 | 描述        |
|:---|:---|
| 200 | 生成的口袋字符串。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ai4sservice/ErrorCode.html)。
