特征操作接口

功能介绍

特征操作接口。

URI

POST /v3/{project_id}/abm/instances/{instance_id}/metadata3/signatures

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方法请参考获取项目ID。
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	特征。

表3 MetadataSignatureChangeReq
参数	是否必选	参数类型	描述
change_type	否	String	操作类型。枚举值： UPSERT DELETE CREATE UPDATE RESTATE
signature_type	是	String	特征类型。最小长度：1 最大长度：150
signature_name	否	String	特征名称。
signature_attributes	否	Array of 表4 objects	特征属性。

表4 MetadataAttributeRequest
参数	是否必选	参数类型	描述
attribute_id	是	String	属性ID。最大长度：200
attribute_value	否	String	属性值。

响应参数

状态码： 200

表5 响应Body参数
参数	参数类型	描述
success	Array of 表6 objects	操作成功列表。
failure	Array of 表8 objects	操作失败列表。
msg	String	提示信息。

表6 MetadaSignatureResp
参数	参数类型	描述
signature_name	String	特征名称。
signature_type	String	特征类型。
signature_attributes	Array of 表7 objects	特征属性。

表7 MetadataAttributeResp
参数	参数类型	描述
attribute_id	String	属性ID。
attribute_value	String	属性值。
attribute_code	String	属性编码。
attribute_name	String	属性名称。

表8 MetadataSignatureFailureResp
参数	参数类型	描述
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": []
}