该接口用于给实体打标签，实体包括表、列。

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

const columns = [
  {
    width: '20%',
    title: '参数',
    dataIndex: 'Name',
    className: 'openapi-doc-parameter-table-name'
  },
  {
    width: 130,
    title: '类型',
    dataIndex: 'DataType',
    className: 'openapi-doc-parameter-table-type'
  },
  {
    width: 90,
    title: '是否必填',
    dataIndex: 'IsRequired',
    className: 'openapi-doc-parameter-table-required'
  },
  {
    width: '20%',
    title: '示例值',
    dataIndex: 'Example',
    className: 'openapi-doc-parameter-table-example'
  },
  {
    title: '描述',
    dataIndex: 'Description',
    className: 'openapi-doc-parameter-table-description'
  },
];

const queryData = [
  {
    rowKey: '->Action',
    Name: 'Action',
    DataType: 'String',
    IsRequired: '是',
    Example: <RenderMd content={"UpdateEntityTag"} />,
    Description: <RenderMd content={"要执行的操作，取值：UpdateEntityTag。"} />,
    children: [
    ]
  },
  {
    rowKey: '->Version',
    Name: 'Version',
    DataType: 'String',
    IsRequired: '是',
    Example: <RenderMd content={"2026-03-01"} />,
    Description: <RenderMd content={"API的版本，取值：2026-03-01。"} />,
    children: [
    ]
  },
];

return (<Table
  rowKey="rowKey"
  className="openapi-doc-parameter-table"
  columns={columns}
  data={queryData}
  border={ { cell: true, wrapper: true } }
  scroll={ { x: "auto" } }
  pagination={false}
/>);

Body

const columns = [
  {
    width: '20%',
    title: '参数',
    dataIndex: 'Name',
    className: 'openapi-doc-parameter-table-name'
  },
  {
    width: 130,
    title: '类型',
    dataIndex: 'DataType',
    className: 'openapi-doc-parameter-table-type'
  },
  {
    width: 90,
    title: '是否必填',
    dataIndex: 'IsRequired',
    className: 'openapi-doc-parameter-table-required'
  },
  {
    width: '20%',
    title: '示例值',
    dataIndex: 'Example',
    className: 'openapi-doc-parameter-table-example'
  },
  {
    title: '描述',
    dataIndex: 'Description',
    className: 'openapi-doc-parameter-table-description'
  },
];

const bodyData = [
  {
    rowKey: '->EntityTypeName',
    Name: 'EntityTypeName',
    DataType: 'String',
    IsRequired: '是',
    Example: <RenderMd content={"LasFormationColumn"} />,
    Description: <RenderMd content={"实体的元数据类型"} />,
    children: [
    ]
  },
  {
    rowKey: '->EntityQualifiedName',
    Name: 'EntityQualifiedName',
    DataType: 'String',
    IsRequired: '是',
    Example: <RenderMd content={"LasFormationColumn:///hive2/zbc_test_06_02/test_table_06_22_04/name@102/default/default@21000xxxxx"} />,
    Description: <RenderMd content={"实体的元数据唯一键"} />,
    children: [
    ]
  },
  {
    rowKey: '->Tags',
    Name: 'Tags',
    DataType: 'Array of Object',
    IsRequired: '是',
    Example: <RenderMd content={"\"Tags\": [\n    {\n      \"TypeName\": \"Tag\",\n      \"QualifiedName\": \"Tag:///zbc的标签1@102/default/default@21000xxxxx\"\n    }\n]"} />,
    Description: <RenderMd content={"更新的tag标签信息"} />,
    children: [
        {
          rowKey: '->Tags->TypeName',
          Name: 'TypeName',
          DataType: 'String',
          IsRequired: '是',
          Example: <RenderMd content={""} />,
          Description: <RenderMd content={"元数据类型"} />,
          children: [
          ]
        },
        {
          rowKey: '->Tags->QualifiedName',
          Name: 'QualifiedName',
          DataType: 'String',
          IsRequired: '是',
          Example: <RenderMd content={""} />,
          Description: <RenderMd content={"实体的唯一键"} />,
          children: [
          ]
        },
    ]
  },
];

return (<Table
  rowKey="rowKey"
  className="openapi-doc-parameter-table"
  columns={columns}
  data={bodyData}
  border={ { cell: true, wrapper: true } }
  scroll={ { x: "auto" } }
  pagination={false}
/>);

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

const columns = [
  {
    width: '25%',
    title: '参数',
    dataIndex: 'Name',
    className: 'openapi-doc-parameter-table-name',
  },
  {
    width: 130,
    title: '类型',
    dataIndex: 'DataType',
    className: 'openapi-doc-parameter-table-type'
  },
  {
    width: '25%',
    title: '示例值',
    dataIndex: 'Example',
    className: 'openapi-doc-parameter-table-example'
  },
  {
    title: '描述',
    dataIndex: 'Description',
    className: 'openapi-doc-parameter-table-description'
  },
];

const data = [
  {
    rowKey: "->Success",
    Name: "Success",
    DataType: "Double",
    Example: <RenderMd content={"true"} />,
    Description: <RenderMd content={"更新是否成功"} />,
    children: [
    ]
  },
  {
    rowKey: "->AffectedCount",
    Name: "AffectedCount",
    DataType: "Integer",
    Example: <RenderMd content={"1"} />,
    Description: <RenderMd content={"更新的实体数"} />,
    children: [
    ]
  },
];

return (<Table
  rowKey="rowKey"
  className="openapi-doc-parameter-table"
  columns={columns}
  data={data}
  border={ { cell: true, wrapper: true } }
  scroll={ { x: "auto" } }
  pagination={false}
/>);

请求示例

POST /?Action=UpdateEntityTag&Version=2026-03-01 HTTP/1.1
Host: dataleap-qa.cn-beijing.volcengineapi.com
Content-Type: application/json
X-Date: 20260301T120000Z
Authorization: HMAC-SHA256 Credential=AK****/20260301/cn-beijing/dataleap_qa/request, SignedHeaders=host;x-date, Signature=***

{
  "EntityTypeName": "LasFormationColumn",
  "EntityQualifiedName": "LasFormationColumn:///hive2/zbc_test_06_02/test_table_06_22_04/name@102/default/default@21000xxxxx",
  "Tags": [
    {
      "TypeName": "Tag",
      "QualifiedName": "Tag:///zbc的标签1@102/default/default@21000xxxxx"
    },
    {
      "TypeName": "Tag",
      "QualifiedName": "Tag:///zbc的标签2@102/default/default@21000xxxxx"
    }
  ]
}

返回示例

={
    "ResponseMetadata": {
        "RequestId": "20260629181214FBC2F1C5D06CEDA9AF46",
        "Action": "UpdateEntityTag",
        "Version": "2026-03-01",
        "Service": "dataleap_qa",
        "Region": "cn-beijing"
    },
    "Result": {
        "ErrorCode": "01-200-C00000",
        "Code": 0,
        "Version": "v2",
        "Message": "success",
        "Data": {
            "Success": true,
            "AffectedCount": 1
        }
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

const columns = [
  {
    title: '状态码',
    dataIndex: 'HttpCode',
    width: '12%',
    className: 'openapi-doc-errorcode-table-httpcode'
  },
  {
    title: '错误码',
    dataIndex: 'ErrorCode',
    width: '22%',
    className: 'openapi-doc-errorcode-table-errorcode'
  },
  {
    title: '错误信息',
    dataIndex: 'ErrorMessage',
    width: '33%',
    className: 'openapi-doc-errorcode-table-errormessage'
  },
  {
    title: '说明',
    dataIndex: 'Description',
    width: '33%',
    className: 'openapi-doc-errorcode-table-description'
  },
];

const data = [
  {
    HttpCode: 400,
    ErrorCode: 'InvalidParameter',
    ErrorMessage: <RenderMd content={"The specified parameter %s is invalid."} />,
    Description: <RenderMd content={""} />,
  },
  {
    HttpCode: 400,
    ErrorCode: 'MissingParameter',
    ErrorMessage: <RenderMd content={"The required parameter %s is missing."} />,
    Description: <RenderMd content={""} />,
  },
  {
    HttpCode: 404,
    ErrorCode: 'NotFound',
    ErrorMessage: <RenderMd content={"The requested resource does not exist."} />,
    Description: <RenderMd content={""} />,
  },
  {
    HttpCode: 500,
    ErrorCode: 'InternalError',
    ErrorMessage: <RenderMd content={"The request has failed due to an unknown error."} />,
    Description: <RenderMd content={""} />,
  },
];

return (<Table
  columns={columns}
  data={data}
  border={ { cell: true, wrapper: true } }
  scroll={ { x: "auto" } }
  pagination={false}
/>);