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

PurviewCollections.CreateOrUpdateEntity 方法

定义

创建实体或将实体更新为集合。 现有实体使用其唯一 guid(如果提供)或其唯一属性(例如:qualifiedName)进行匹配。 不支持集合的映射和数组。 例如,数组<数组 int>>、数组<映射<字符串、int>><。

public virtual Azure.Response CreateOrUpdateEntity (string collection, Azure.Core.RequestContent content, Azure.RequestContext context = default);
abstract member CreateOrUpdateEntity : string * Azure.Core.RequestContent * Azure.RequestContext -> Azure.Response
override this.CreateOrUpdateEntity : string * Azure.Core.RequestContent * Azure.RequestContext -> Azure.Response
Public Overridable Function CreateOrUpdateEntity (collection As String, content As RequestContent, Optional context As RequestContext = Nothing) As Response

参数

collection
String

集合的唯一名称。

content
RequestContent

要作为请求正文发送的内容。

context
RequestContext

请求上下文,它可以基于每个调用覆盖请求的默认行为。

返回

例外

collectioncontent 为 null。

collection 是一个空字符串,预期为非空。

注解

Request Body架构:

{
              referredEntities: Dictionary<string, AtlasEntity>,
              entity: {
                attributes: Dictionary<string, AnyObject>,
                typeName: string,
                lastModifiedTS: string,
                businessAttributes: Dictionary<string, AnyObject>,
                classifications: [
                  {
                    attributes: Dictionary<string, AnyObject>,
                    typeName: string,
                    lastModifiedTS: string,
                    entityGuid: string,
                    entityStatus: "ACTIVE" | "DELETED",
                    removePropagationsOnEntityDelete: boolean,
                    validityPeriods: [
                      {
                        endTime: string,
                        startTime: string,
                        timeZone: string
                      }
                    ],
                    source: string,
                    sourceDetails: Dictionary<string, AnyObject>
                  }
                ],
                createTime: number,
                createdBy: string,
                customAttributes: Dictionary<string, string>,
                guid: string,
                homeId: string,
                isIncomplete: boolean,
                labels: [string],
                meanings: [
                  {
                    confidence: number,
                    createdBy: string,
                    description: string,
                    displayText: string,
                    expression: string,
                    relationGuid: string,
                    source: string,
                    status: "DISCOVERED" | "PROPOSED" | "IMPORTED" | "VALIDATED" | "DEPRECATED" | "OBSOLETE" | "OTHER",
                    steward: string,
                    termGuid: string
                  }
                ],
                provenanceType: number,
                proxy: boolean,
                relationshipAttributes: Dictionary<string, AnyObject>,
                status: "ACTIVE" | "DELETED",
                updateTime: number,
                updatedBy: string,
                version: number,
                source: string,
                sourceDetails: Dictionary<string, AnyObject>,
                contacts: Dictionary<string, ContactBasic[]>
              }
            }

Response Body架构:

{
              guidAssignments: Dictionary<string, string>,
              mutatedEntities: Dictionary<string, AtlasEntityHeader[]>,
              partialUpdatedEntities: [
                {
                  attributes: Dictionary<string, AnyObject>,
                  typeName: string,
                  lastModifiedTS: string,
                  classificationNames: [string],
                  classifications: [
                    {
                      attributes: Dictionary<string, AnyObject>,
                      typeName: string,
                      lastModifiedTS: string,
                      entityGuid: string,
                      entityStatus: "ACTIVE" | "DELETED",
                      removePropagationsOnEntityDelete: boolean,
                      validityPeriods: [
                        {
                          endTime: string,
                          startTime: string,
                          timeZone: string
                        }
                      ],
                      source: string,
                      sourceDetails: Dictionary<string, AnyObject>
                    }
                  ],
                  displayText: string,
                  guid: string,
                  isIncomplete: boolean,
                  labels: [string],
                  meaningNames: [string],
                  meanings: [
                    {
                      confidence: number,
                      createdBy: string,
                      description: string,
                      displayText: string,
                      expression: string,
                      relationGuid: string,
                      source: string,
                      status: "DISCOVERED" | "PROPOSED" | "IMPORTED" | "VALIDATED" | "DEPRECATED" | "OBSOLETE" | "OTHER",
                      steward: string,
                      termGuid: string
                    }
                  ],
                  status: "ACTIVE" | "DELETED"
                }
              ]
            }

Response Error架构:

{
              requestId: string,
              errorCode: string,
              errorMessage: string
            }

适用于