Compartir a través de

Entity - Add Classification

Servicio:
Purview
Versión de la API:
2023-09-01

Asocie una clasificación a varias entidades de forma masiva.

POST {endpoint}/datamap/api/atlas/v2/entity/bulk/classification

Parámetros de identificador URI

Nombre En Requerido Tipo Description
endpoint
 path True

string (uri)

Cuerpo de la solicitud

Nombre Tipo Description
classification

AtlasClassification

Una instancia de una clasificación; no tiene una identidad, este objeto solo existe cuando está asociado a una entidad.
entityGuids

string[]

GUID de la entidad.

Respuestas

Nombre Tipo Description
204 No Content

No hay contenido que enviar para esta solicitud, pero los encabezados pueden ser útiles.
Other Status Codes

AtlasErrorResponse

Una respuesta de error inesperada.

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
https://purview.azure.net/.default

Ejemplos

Entity_AddClassificationToEntityByGuids

Solicitud de ejemplo

POST {endpoint}/datamap/api/atlas/v2/entity/bulk/classification

{
  "classification": {
    "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER",
    "attributes": {},
    "validityPeriods": []
  },
  "entityGuids": [
    "784c0f2f-afd2-e26b-f9cb-984f6c2c5021",
    "b4ebc8be-cef4-860a-bee9-28cc34cb5caa"
  ]
}

Respuesta de muestra

status code:
204

Definiciones

Nombre Description
AtlasClassification

Una instancia de una clasificación; no tiene una identidad, este objeto solo existe cuando está asociado a una entidad.
AtlasErrorResponse

Respuesta de error del servicio
ClassificationAssociateOptions

Carga de solicitud para la asociación de clasificación.
EntityStatus

Estado: se puede activar o eliminar.
TimeBoundary

Captura los detalles del límite de tiempo

AtlasClassification

Object

Una instancia de una clasificación; no tiene una identidad, este objeto solo existe cuando está asociado a una entidad.

Nombre Tipo Description
attributes

Atributos de la estructura.
entityGuid

string

GUID de la entidad.
entityStatus

EntityStatus

Estado de la entidad: se puede activar o eliminar. Las entidades eliminadas no se quitan.
lastModifiedTS

string

ETag para el control de simultaneidad.
removePropagationsOnEntityDelete

boolean

Determina si se quitarán las propagaciones en la eliminación de entidades.
typeName

string

Nombre del tipo.
validityPeriods

TimeBoundary[]

Matriz de límites de tiempo que indica períodos de validez.

AtlasErrorResponse

Object

Respuesta de error del servicio

Nombre Tipo Description
errorCode

string

Código de error.
errorMessage

string

Mensaje de error.
requestId

string (uuid)

Identificador de solicitud.

ClassificationAssociateOptions

Object

Carga de solicitud para la asociación de clasificación.

Nombre Tipo Description
classification

AtlasClassification

Una instancia de una clasificación; no tiene una identidad, este objeto solo existe cuando está asociado a una entidad.
entityGuids

string[]

GUID de la entidad.

EntityStatus

Enumeración

Estado: se puede activar o eliminar.

Valor Description
ACTIVE

El estado está activo.
DELETED

El estado se elimina.

TimeBoundary

Object

Captura los detalles del límite de tiempo

Nombre Tipo Description
endTime

string

Fin del límite de tiempo.
startTime

string

Inicio del límite de hora.
timeZone

string

Zona horaria del límite horario.