你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Glossary - Get Term

参考

服务:: Purview

API 版本:: 2023-09-01

按 GUID 获取特定术语表术语。

GET {endpoint}/datamap/api/atlas/v2/glossary/term/{termId}

具有可选参数:

GET {endpoint}/datamap/api/atlas/v2/glossary/term/{termId}?api-version=2023-09-01

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string
termId	path	True	string	术语表术语的全局唯一标识符。
api-version	query		string	要用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	AtlasGlossaryTerm	请求已成功。
Other Status Codes	AtlasErrorResponse	意外的错误响应。

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
https://purview.azure.net/.default

示例

Glossary_GetTerm

Glossary_GetTermWithoutAssets

Glossary_GetTerm

示例请求

HTTP

GET {endpoint}/datamap/api/atlas/v2/glossary/term/54688d39-b298-4104-9e80-f2a16f44aaea?api-version=2023-09-01

示例响应

状态代码:: 200

{
  "guid": "54688d39-b298-4104-9e80-f2a16f44aaea",
  "qualifiedName": "ExampleTerm1@Glossary",
  "name": "ExampleTerm1",
  "shortDescription": "Example Short Description",
  "lastModifiedTS": "1",
  "abbreviation": "T1",
  "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61",
  "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61",
  "createTime": 1606287247276,
  "updateTime": 1606287247276,
  "status": "Approved",
  "anchor": {
    "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8",
    "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0"
  },
  "seeAlso": [
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008",
      "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01",
      "displayText": "ExampleTerm2"
    }
  ],
  "synonyms": [
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008",
      "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c",
      "displayText": "ExampleTerm2"
    }
  ],
  "contacts": {
    "Expert": [
      {
        "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df",
        "info": "Example Expert Info"
      }
    ],
    "Steward": [
      {
        "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df",
        "info": "Example Steward Info"
      }
    ]
  },
  "resources": [
    {
      "displayName": "Example Display Name",
      "url": "Example Url"
    }
  ],
  "assignedEntities": [
    {
      "guid": "7e255139-b654-4c8d-a4bd-fbb5a243e83f",
      "typeName": "azure_datalake_gen2_path",
      "entityStatus": "ACTIVE",
      "displayText": "moviesDB.csv",
      "relationshipType": "AtlasGlossarySemanticAssignment",
      "relationshipGuid": "ace36560-6259-4e7f-9214-3850b2af0a86",
      "relationshipStatus": "ACTIVE",
      "relationshipAttributes": {
        "typeName": "AtlasGlossarySemanticAssignment",
        "attributes": {
          "expression": null,
          "createdBy": null,
          "steward": null,
          "confidence": null,
          "description": null,
          "source": null,
          "status": null
        }
      }
    }
  ]
}

Glossary_GetTermWithoutAssets

示例请求

HTTP

GET {endpoint}/datamap/api/atlas/v2/glossary/term/54688d39-b298-4104-9e80-f2a16f44aaea?api-version=2023-09-01

示例响应

状态代码:: 200

{
  "guid": "54688d39-b298-4104-9e80-f2a16f44aaea",
  "qualifiedName": "ExampleTerm1@Glossary",
  "name": "ExampleTerm1",
  "shortDescription": "Example Short Description",
  "lastModifiedTS": "1",
  "abbreviation": "T1",
  "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61",
  "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61",
  "createTime": 1606287247276,
  "updateTime": 1606287247276,
  "status": "Approved",
  "anchor": {
    "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8",
    "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0"
  },
  "seeAlso": [
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008",
      "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01",
      "displayText": "ExampleTerm2"
    }
  ],
  "synonyms": [
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008",
      "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c",
      "displayText": "ExampleTerm2"
    }
  ],
  "contacts": {
    "Expert": [
      {
        "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df",
        "info": "Example Expert Info"
      }
    ],
    "Steward": [
      {
        "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df",
        "info": "Example Steward Info"
      }
    ]
  },
  "resources": [
    {
      "displayName": "Example Display Name",
      "url": "Example Url"
    }
  ]
}

定义

名称	说明
AtlasClassification	分类的实例;它没有标识，此对象仅在与实体关联时才存在。
AtlasErrorResponse	来自服务的错误响应
AtlasGlossaryHeader	包含基本信息的术语表标题。
AtlasGlossaryTerm	术语表术语。
AtlasRelatedObjectId	对关系属性值中使用的 AtlasEntity 类型的对象实例的引用
AtlasRelatedTermHeader	相关术语的标头。
AtlasStruct	捕获结构内容的详细信息。不直接实例化，仅通过 AtlasEntity、AtlasClassification 使用。
AtlasTermCategorizationHeader	术语分类的基本信息。
AtlasTermRelationshipStatus	atlas 术语关系的状态
EntityStatus	状态 - 可以是活动状态，也可以已删除
PurviewObjectId	PurviewObjectId
ResourceLink	ResourceLink
StatusAtlasRelationship	atlas 关系的状态
TermStatus	术语的状态
TimeBoundary	捕获时间边界详细信息

AtlasClassification

分类的实例;它没有标识，此对象仅在与实体关联时才存在。

名称	类型	说明
attributes		结构的属性。
entityGuid	string	实体的 GUID。
entityStatus	EntityStatus	实体的状态 - 可以是活动状态，也可以是已删除的。不会删除已删除的实体。
lastModifiedTS	string	用于并发控制的 ETag。
removePropagationsOnEntityDelete	boolean	确定是否在删除实体时删除传播。
typeName	string	类型的名称。
validityPeriods	TimeBoundary[]	指示有效期的时间边界数组。

AtlasErrorResponse

来自服务的错误响应

名称	类型	说明
errorCode	string	错误代码。
errorMessage	string	错误消息。
requestId	string	请求 ID。

AtlasGlossaryHeader

包含基本信息的术语表标题。

名称	类型	说明
displayText	string	显示文本。
glossaryGuid	string	术语表的 GUID。
relationGuid	string	关系的 GUID。

AtlasGlossaryTerm

术语表术语。

名称	类型	说明
abbreviation	string	术语的缩写。
anchor	AtlasGlossaryHeader	包含基本信息的术语表标题。
antonyms	AtlasRelatedTermHeader[]	相关术语标头的数组，作为自义词。
assignedEntities	AtlasRelatedObjectId[]	相关对象 ID 的数组。
attributes	object	术语的自定义属性，即 map<string，map<string，object>>。第一层映射的关键是术语模板名称。
categories	AtlasTermCategorizationHeader[]	术语分类标头的数组。
classifications	AtlasClassification[]	分类数组。
classifies	AtlasRelatedTermHeader[]	相关术语标头的数组。
contacts	object	术语联系人字典。密钥可以是“专家”或“专员”。
createTime	integer	记录的创建时间。
createdBy	string	创建记录的用户。
examples	string[]	示例数组。
guid	string	对象的 GUID。
hierarchyInfo	PurviewObjectId[]	术语的层次结构信息。
isA	AtlasRelatedTermHeader[]	指示 is-a 关系的相关术语标头的数组。
lastModifiedTS	string	用于并发控制的 ETag。
longDescription	string	长版本说明。
name	string	术语表对象的名称。
nickName	string	术语的昵称。
preferredTerms	AtlasRelatedTermHeader[]	首选相关术语标头的数组。
preferredToTerms	AtlasRelatedTermHeader[]	首选的相关术语标头的数组。
qualifiedName	string	术语表对象的限定名称。
replacedBy	AtlasRelatedTermHeader[]	由替换的相关术语标头的数组。
replacementTerms	AtlasRelatedTermHeader[]	要替换的相关术语标头的数组。
resources	ResourceLink[]	术语的资源链接数组
seeAlso	AtlasRelatedTermHeader[]	另请参阅的相关术语标头的数组。
shortDescription	string	说明的简短版本。
status	TermStatus	AtlasGlossaryTerm 的状态
synonyms	AtlasRelatedTermHeader[]	作为同义词的相关术语标头的数组。
templateName	TemplateName[]	模板的名称。
translatedTerms	AtlasRelatedTermHeader[]	已翻译的相关术语标头的数组。
translationTerms	AtlasRelatedTermHeader[]	用于翻译的相关术语标头的数组。
updateTime	integer	记录的更新时间。
updatedBy	string	更新记录的用户。
usage	string	术语的用法。
validValues	AtlasRelatedTermHeader[]	作为有效值的相关术语标头的数组。
validValuesFor	AtlasRelatedTermHeader[]	作为其他记录的有效值的相关术语标头的数组。

AtlasRelatedObjectId

对关系属性值中使用的 AtlasEntity 类型的对象实例的引用

名称	类型	说明
displayText	string	显示文本。
entityStatus	EntityStatus	实体的状态 - 可以是活动状态，也可以是已删除的。不会删除已删除的实体。
guid	string	对象的 GUID。
relationshipAttributes	AtlasStruct	捕获结构内容的详细信息。不直接实例化，仅通过 AtlasEntity、AtlasClassification 使用。
relationshipGuid	string	关系的 GUID。
relationshipStatus	StatusAtlasRelationship	关系状态的枚举。
relationshipType	string	关系类型
typeName	string	类型的名称。
uniqueAttributes		对象的唯一属性。

AtlasRelatedTermHeader

名称	类型	说明
description	string	相关术语的说明。
displayText	string	显示文本。
expression	string	术语的表达式。
relationGuid	string	关系的 GUID。
status	AtlasTermRelationshipStatus	术语关系的状态。
steward	string	术语的管理员。
termGuid	string	术语的 GUID。

AtlasStruct

捕获结构内容的详细信息。不直接实例化，仅通过 AtlasEntity、AtlasClassification 使用。

名称	类型	说明
attributes		结构的属性。
lastModifiedTS	string	用于并发控制的 ETag。
typeName	string	类型的名称。

AtlasTermCategorizationHeader

术语分类的基本信息。

名称	类型	说明
categoryGuid	string	类别的 GUID。
description	string	记录的说明。
displayText	string	显示文本。
relationGuid	string	关系的 GUID。
status	AtlasTermRelationshipStatus	术语关系的状态。

AtlasTermRelationshipStatus

atlas 术语关系的状态

名称	类型	说明
ACTIVE	string	活动
DEPRECATED	string	已弃用
DRAFT	string	草案
OBSOLETE	string	已过时
OTHER	string	其他

EntityStatus

状态 - 可以是活动状态，也可以已删除

名称	类型	说明
ACTIVE	string	状态为“活动”。
DELETED	string	状态已删除。

PurviewObjectId

名称	类型	说明
displayText	string	显示文本
guid	string	对象的 GUID。
itemPath	string	项路径
name	string	名称
properties		字典
resourceId	string	资源 ID
typeName	string	类型的名称。
uniqueAttributes		对象的唯一属性。

ResourceLink

名称	类型	说明
displayName	string	URL 的显示名称。
url	string	Web URL。 http 或 https

StatusAtlasRelationship

atlas 关系的状态

名称	类型	说明
ACTIVE	string	活动
DELETED	string	deleted

TermStatus

术语的状态

名称	类型	说明
Alert	string	警报
Approved	string	批准
Draft	string	草案
Expired	string	过期

TimeBoundary

捕获时间边界详细信息

名称	类型	说明
endTime	string	时间边界的结束。
startTime	string	时间边界的开始。
timeZone	string	时间边界的时区。

通过

Glossary - Get Term

URI 参数

响应

安全性

OAuth2Auth

作用域

示例

Glossary_GetTerm

示例请求

示例响应

Glossary_GetTermWithoutAssets

示例请求

示例响应

定义

AtlasClassification

AtlasErrorResponse

AtlasGlossaryHeader

AtlasGlossaryTerm

AtlasRelatedObjectId

AtlasRelatedTermHeader

AtlasStruct

AtlasTermCategorizationHeader

AtlasTermRelationshipStatus

EntityStatus

PurviewObjectId

ResourceLink

StatusAtlasRelationship

TermStatus

TimeBoundary

其他资源