Entity - Get By Unique Attributes
エンティティの型と一意の属性を指定して、エンティティの完全な定義を取得します。
typeName パス パラメーターに加えて、属性のキーと値のペアは、attr:<attrName>= の形式で指定できます。
注: attrName と attrValue は、エンティティ間で一意である必要があります。たとえば、qualifiedName。
REST 要求は、GET /v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue のようになります。
GET {endpoint}/datamap/api/atlas/v2/entity/uniqueAttribute/type/{typeName}
GET {endpoint}/datamap/api/atlas/v2/entity/uniqueAttribute/type/{typeName}?minExtInfo={minExtInfo}&ignoreRelationships={ignoreRelationships}&attr:qualifiedName={attr:qualifiedName}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
endpoint
|
path | True |
string |
|
type
|
path | True |
string |
型の名前。 |
attr:qualified
|
query |
string |
エンティティの修飾名。 (これは一例にすぎません。qualifiedName は他の一意の属性に変更できます) |
|
ignore
|
query |
boolean |
リレーションシップ属性を無視するかどうか。 |
|
min
|
query |
boolean |
参照されるエンティティの最小限の情報を返すかどうか。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
要求は成功しました。 |
|
Other Status Codes |
予期しないエラー応答。 |
セキュリティ
OAuth2Auth
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
https://purview.azure.net/.default |
例
Entity_GetByUniqueAttributes
要求のサンプル
GET {endpoint}/datamap/api/atlas/v2/entity/uniqueAttribute/type/azure_storage_account?minExtInfo=True&attr:qualifiedName=https://exampleaccount.core.windows.net
応答のサンプル
{
"entity": {
"createTime": 1605703532110,
"createdBy": "8c062c84-5d25-449f-a990-9d8ab70b8ec7",
"guid": "e0ba3f20-f3b5-4d52-b769-ed35a02df60a",
"relationshipAttributes": {
"services": [],
"meanings": []
},
"status": "ACTIVE",
"updateTime": 1605703532110,
"updatedBy": "8c062c84-5d25-449f-a990-9d8ab70b8ec7",
"lastModifiedTS": "2",
"version": 0,
"attributes": {
"owner": "ExampleOwner",
"qualifiedName": "https://exampleaccount.core.windows.net",
"createTime": 0,
"name": "ExampleNewName"
},
"typeName": "azure_storage_account"
},
"referredEntities": {}
}
定義
名前 | 説明 |
---|---|
Atlas |
分類のインスタンス。ID がありません。このオブジェクトはエンティティに関連付けられている場合にのみ存在します。 |
Atlas |
エンティティのインスタンス (hive_table、hive_databaseなど)。 |
Atlas |
エンティティのインスタンスと拡張情報 (hive_table、hive_databaseなど)。 |
Atlas |
サービスからのエラー応答 |
Atlas |
用語割り当てのヘッダー。 |
Atlas |
用語割り当ての状態 |
Entity |
状態 - アクティブまたは削除できます |
Time |
時間境界の詳細をキャプチャします |
AtlasClassification
分類のインスタンス。ID がありません。このオブジェクトはエンティティに関連付けられている場合にのみ存在します。
名前 | 型 | 説明 |
---|---|---|
attributes |
構造体の属性。 |
|
entityGuid |
string |
エンティティの GUID。 |
entityStatus |
エンティティの状態 - アクティブまたは削除できます。 削除されたエンティティは削除されません。 |
|
lastModifiedTS |
string |
コンカレンシー制御の ETag。 |
removePropagationsOnEntityDelete |
boolean |
エンティティの削除時に伝達を削除するかどうかを決定します。 |
typeName |
string |
型の名前。 |
validityPeriods |
有効期間を示す時間境界の配列。 |
AtlasEntity
エンティティのインスタンス (hive_table、hive_databaseなど)。
名前 | 型 | 説明 |
---|---|---|
attributes |
構造体の属性。 |
|
businessAttributes |
ビジネス属性 |
|
classifications |
分類の配列。 |
|
collectionId |
string |
エンティティのコレクション ID。 |
contacts |
object |
エンティティの連絡先のディクショナリ。 キーには、エキスパートまたは所有者を指定できます。 |
createTime |
integer |
レコードの作成時刻。 |
createdBy |
string |
レコードを作成したユーザー。 |
customAttributes |
object |
カスタム属性 |
guid |
string |
エンティティの GUID。 |
homeId |
string |
エンティティのホーム ID。 |
isIncomplete |
boolean |
シェル エンティティかどうか |
labels |
string[] |
labels |
lastModifiedTS |
string |
コンカレンシー制御の ETag。 |
meanings |
エンティティの意味を示す用語代入ヘッダーの配列。 |
|
provenanceType |
integer |
エンティティまたはリレーションシップのインスタンスの証明を記録するために使用されます。 |
proxy |
boolean |
プロキシがあるかどうかを判断します。 |
relationshipAttributes |
リレーションシップの属性。 |
|
status |
エンティティの状態 - アクティブまたは削除できます。 削除されたエンティティは削除されません。 |
|
typeName |
string |
型の名前。 |
updateTime |
integer |
レコードの更新時刻。 |
updatedBy |
string |
レコードを更新したユーザー。 |
version |
integer |
エンティティのバージョン。 |
AtlasEntityWithExtInfo
エンティティのインスタンスと拡張情報 (hive_table、hive_databaseなど)。
名前 | 型 | 説明 |
---|---|---|
entity |
エンティティのインスタンス (hive_table、hive_databaseなど)。 |
|
referredEntities |
<string,
Atlas |
参照されるエンティティ。 |
AtlasErrorResponse
サービスからのエラー応答
名前 | 型 | 説明 |
---|---|---|
errorCode |
string |
エラー コード。 |
errorMessage |
string |
エラー メッセージ。 |
requestId |
string |
要求 ID です。 |
AtlasTermAssignmentHeader
用語割り当てのヘッダー。
名前 | 型 | 説明 |
---|---|---|
confidence |
integer |
用語の割り当ての信頼度。 |
createdBy |
string |
レコードを作成したユーザー。 |
description |
string |
用語の割り当ての説明。 |
displayText |
string |
表示テキスト。 |
expression |
string |
代入という用語の式。 |
relationGuid |
string |
リレーションシップの GUID。 |
status |
用語の割り当ての状態。 |
|
steward |
string |
用語のスチュワード。 |
termGuid |
string |
用語の GUID。 |
AtlasTermAssignmentStatus
用語割り当ての状態
名前 | 型 | 説明 |
---|---|---|
DEPRECATED |
string |
状態は非推奨です。 |
DISCOVERED |
string |
状態が検出されました。 |
IMPORTED |
string |
状態がインポートされます。 |
OBSOLETE |
string |
状態は廃止されました。 |
OTHER |
string |
その他の状態。 |
PROPOSED |
string |
状態が提案されます。 |
VALIDATED |
string |
状態が検証されます。 |
EntityStatus
状態 - アクティブまたは削除できます
名前 | 型 | 説明 |
---|---|---|
ACTIVE |
string |
状態がアクティブです。 |
DELETED |
string |
状態が削除されます。 |
TimeBoundary
時間境界の詳細をキャプチャします
名前 | 型 | 説明 |
---|---|---|
endTime |
string |
時間境界の終わり。 |
startTime |
string |
時間境界の開始。 |
timeZone |
string |
時間境界のタイムゾーン。 |