Compartir a través de

Items - Update Mounted Data Factory Definition

Servicio:
MountedDataFactory
Versión de la API:
v1

Invalida la definición de la factoría de datos montada especificada.
Esta API admite operaciones de larga duración (LRO).

La actualización de la definición mountedDataFactory no afecta a su etiqueta de confidencialidad.

Permisos

El autor de la llamada debe tener permisos de lectura y escritura para la factoría de datos montada.

Ámbitos delegados necesarios

MountedDataFactory.ReadWrite.All o Item.ReadWrite.All

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

identidad Apoyo
Usuario Sí
Entidad de servicio e Identidades administradas Sí

Interfaz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mountedDataFactories/{mountedDataFactoryId}/updateDefinition
Con parámetros opcionales: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mountedDataFactories/{mountedDataFactoryId}/updateDefinition?updateMetadata={updateMetadata}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
mountedDataFactoryId
 path True

string (uuid)

Identificador MountedDataFactory.
workspaceId
 path True

string (uuid)

El identificador del área de trabajo.
updateMetadata
 query

boolean

Cuando se establece en true y el archivo .platform se proporciona como parte de la definición, los metadatos del elemento se actualizan mediante los metadatos del archivo .platform.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
definition True

MountedDataFactoryDefinition

Objeto de definición pública MountedDataFactory. Consulte este artículo de para obtener más información sobre cómo crear una definición pública MountedDataFactory.

Respuestas

Nombre Tipo Description
200 OK

Solicitud completada correctamente.
202 Accepted

Solicitud aceptada. La definición de actualización está en curso.

Encabezados

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • OperationNotSupportedForItem: no se admite la operación para el elemento solicitado.

  • CorruptedPayload: la carga proporcionada está dañada.

Ejemplos

Update a MountedDataFactory public definition example

Solicitud de ejemplo

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/mountedDataFactories/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "mountedDataFactory-content.json",
        "payload": "ewogICJkYXRhRmFjdG9yeVJlc291cmNlSWQiOiAiL3N1YnNjcmlwdGlvbnMvPHN1YnNjcmlwdGlvbklkPi9yZXNvdXJjZUdyb3Vwcy88cmVzb3VyY2VHcm91cD4vcHJvdmlkZXJzL01pY3Jvc29mdC5EYXRhRmFjdG9yeS9mYWN0b3JpZXMvPGZhY3RvcnlOYW1lPiIKfQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Respuesta de muestra

status code:
200
status code:
202 
Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

Definiciones

Nombre Description
ErrorRelatedResource

Objeto de detalles del recurso relacionado con el error.
ErrorResponse

Respuesta de error.
ErrorResponseDetails

Detalles de la respuesta de error.
MountedDataFactoryDefinition

Objeto de definición pública MountedDataFactory. Consulte este artículo de para obtener más información sobre cómo crear una definición pública MountedDataFactory.
MountedDataFactoryDefinitionPart

Objeto de parte de definición MountedDataFactory.
PayloadType

Tipo de la carga de la parte de definición. Se pueden agregar tipos de carga adicionales a lo largo del tiempo.
UpdateMountedDataFactoryDefinitionRequest

Actualice la carga de solicitud de definición pública MountedDataFactory.

ErrorRelatedResource

Object

Objeto de detalles del recurso relacionado con el error.

Nombre Tipo Description
resourceId

string

Identificador de recurso implicado en el error.
resourceType

string

Tipo del recurso implicado en el error.

ErrorResponse

Object

Respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
moreDetails

ErrorResponseDetails[]

Lista de detalles de error adicionales.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.
requestId

string

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

Detalles de la respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.

MountedDataFactoryDefinition

Object

Objeto de definición pública MountedDataFactory. Consulte este artículo de para obtener más información sobre cómo crear una definición pública MountedDataFactory.

Nombre Tipo Description
format

string

Formato de la definición de elemento. Formato admitido: MountedDataFactoryV1.
parts

MountedDataFactoryDefinitionPart[]

Lista de elementos de definición.

MountedDataFactoryDefinitionPart

Object

Objeto de parte de definición MountedDataFactory.

Nombre Tipo Description
path

string

Ruta de acceso de elemento de definición pública MountedDataFactory.
payload

string

Carga del elemento de definición pública MountedDataFactory.
payloadType

PayloadType

Tipo de carga.

PayloadType

Enumeración

Tipo de la carga de la parte de definición. Se pueden agregar tipos de carga adicionales a lo largo del tiempo.

Valor Description
InlineBase64

Base 64 insertada.

UpdateMountedDataFactoryDefinitionRequest

Object

Actualice la carga de solicitud de definición pública MountedDataFactory.

Nombre Tipo Description
definition

MountedDataFactoryDefinition

Objeto de definición pública MountedDataFactory. Consulte este artículo de para obtener más información sobre cómo crear una definición pública MountedDataFactory.