# 特征操作接口
#### 功能介绍
特征操作接口。
#### URI
POST /v3/{project_id}/abm/instances/{instance_id}/metadata3/signatures
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| project_id  | 是    | String | 项目ID，获取方法请参考[获取项目ID](https://support.huaweicloud.com/api-mssi/mssi_03_0079.html)。                                                                                                                                              |
| instance_id | 是    | String | 实例的ID。 - 最小长度：1  - 最大长度：64   |
   
#### 请求参数
表2请求Body参数 
| 参数         | 是否必选 | 参数类型                                                                        | 描述                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| package_id | 是    | String                                                                      | 模型包ID。 - 最小长度：1  - 最大长度：50         |
| entity_urn | 是    | String                                                                      | 实体urn。 - 最小长度：1  - 最大长度：2000   |
| signatures | 否    | Array of [表3] objects | 特征。                                                                                                                                                                                                                                         |
   
 表3MetadataSignatureChangeReq 
| 参数                   | 是否必选 | 参数类型                                             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| change_type          | 否    | String                                           | 操作类型。 枚举值： - **UPSERT**  - **DELETE**  - **CREATE**  - **UPDATE**  - **RESTATE**   |
| signature_type       | 是    | String                                           | 特征类型。 - 最小长度：1  - 最大长度：150                                                                                                                                                                                                                                                                        |
| signature_name       | 否    | String                                           | 特征名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| signature_attributes | 否    | Array of [表4] objects | 特征属性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
 表4MetadataAttributeRequest 
| 参数              | 是否必选 | 参数类型   | 描述                                            |
|:---|:---|:---|:---|
| attribute_id    | 是    | String | 属性ID。 最大长度：200 |
| attribute_value | 否    | String | 属性值。                                          |
   
#### 响应参数
**状态码： 200**
表5响应Body参数 
| 参数      | 参数类型                                                                           | 描述      |
|:---|:---|:---|
| success | Array of [表6] objects          | 操作成功列表。 |
| failure | Array of [表8] objects | 操作失败列表。 |
| msg     | String                                                                         | 提示信息。   |
   
 表6MetadaSignatureResp 
| 参数                   | 参数类型                                             | 描述    |
|:---|:---|:---|
| signature_name       | String                                           | 特征名称。 |
| signature_type       | String                                           | 特征类型。 |
| signature_attributes | Array of [表7] objects | 特征属性。 |
   
 表7MetadataAttributeResp 
| 参数              | 参数类型   | 描述    |
|:---|:---|:---|
| attribute_id    | String | 属性ID。 |
| attribute_value | String | 属性值。  |
| attribute_code  | String | 属性编码。 |
| attribute_name  | String | 属性名称。 |
   
 表8MetadataSignatureFailureResp 
| 参数             | 参数类型   | 描述    |
|:---|:---|:---|
| error_code     | String | 错误码。  |
| error_msg      | String | 错误信息。 |
| signature_name | String | 特征名称。 |
| signature_type | String | 特征类型。 |
   
**状态码： 400**
表9响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误描述。 |
   
**状态码： 500**
表10响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误描述。 |
   
#### 请求示例
```
POST https://{endpoint}/v3/{project_id}/abm/instances/{instance_id}/metadata3/signatures
{
    "package_id": "Metamodel3",
    "entity_urn": "urn:abm:Metamodel3-Dataset:(urn:abm:Metamodel3-DataPlatformInstance:(MYSQL,3ca1d906860167e88b9bfbe0577a69),def.sys.x$wait_classes_global_by_avg_latency)",
    "entity_type": "Metamodel3-Dataset",
    "signatures": [
        {
            "change_type": "UPSERT",
            "signature_type": "Metamodel3-securityPrivacy",
            "signature_name": "密级隐私",
            "signature_attributes": [
                {
                    "attribute_id": "Metamodel3-securityPrivacy-NAME",
                    "attribute_name": "名称",
                    "attribute_value": "tesk0"
                },
                {
                    "attribute_id": "Metamodel3-securityPrivacy-securityLevel",
                    "attribute_name": "密级",
                    "attribute_value": ""
                },
                {
                    "attribute_id": "Metamodel3-securityPrivacy-privacyLevel",
                    "attribute_name": "隐私分级",
                    "attribute_value": ""
                }
            ]
        }
    ]
}
```
#### 响应示例
**状态码： 200**
successful operation
```
{
    "msg": null,
    "success": [
        {
            "signature_attributes": [
                {
                    "attribute_id": "Metamodel3-securityPrivacy-NAME",
                    "attribute_name_en": "NAME",
                    "attribute_name": "名称",
                    "attribute_value": "tesk0",
                    "attribute_code": "NAME"
                },
                {
                    "attribute_id": "Metamodel3-securityPrivacy-securityLevel",
                    "attribute_name_en": "SecurityLevel",
                    "attribute_name": "密级",
                    "attribute_value": "",
                    "attribute_code": "securityLevel"
                },
                {
                    "attribute_id": "Metamodel3-securityPrivacy-privacyLevel",
                    "attribute_name_en": "PrivacyLevel",
                    "attribute_name": "隐私分级",
                    "attribute_value": "",
                    "attribute_code": "privacyLevel"
                }
            ],
            "signature_name": "密级隐私",
            "signature_type": "Metamodel3-securityPrivacy"
        }
    ],
    "failure": []
}
```
#### 状态码
| 状态码 | 描述                     |
|:---|:---|
| 200 | successful operation.  |
| 400 | Bad Request.           |
| 500 | Internal Server Error. |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-mssi/ErrorCode.html)。