Items - Update Logical Id

Servicio:
Core
Versión de la API:
v1

Actualiza el identificador lógico del elemento especificado.
Las instancias de elemento correspondientes comparten el mismo identificador lógico. Use esta operación para resolver conflictos de identificadores lógicos. Antes de cambiar el identificador lógico, revise las automatizaciones que dependen de su valor actual y actual las actualice según sea necesario. De lo contrario, es posible que esas automatizaciones no encuentren el elemento o se produzca un error debido a un nombre para mostrar duplicado. Para obtener más información, consulte Resolución de conflictos de identificadores lógicos en Microsoft Fabric.

Permissions

El autor de la llamada debe tener permisos de lectura y escritura para el elemento.

Ámbitos delegados necesarios

Para las API de elemento, use uno de los siguientes tipos de ámbito:

  • Ámbito genérico: Item.ReadWrite.All.
  • Ámbito específico: itemType. ReadWrite.All (por ejemplo, Notebook.ReadWrite.All).

Para obtener más información sobre los ámbitos, vea Ámbitos.

Limitations

  • El identificador lógico no puede ser un GUID vacío (00000000-0000-0000-0000-000000000000).
  • El identificador lógico debe ser único dentro del área de trabajo.
  • La operación no se admite mientras una operación de CI/CD está activa en el área de trabajo.

Identidades admitidas de Microsoft Entra

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

Identity Apoyo
User Sí
Entidad de servicio e Identidades administradas Sí

Interface

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/logicalId

Parámetros de identificador URI

Nombre En Requerido Tipo Description
itemId
 path True

string (uuid)

Identificador del elemento.
workspaceId
 path True

string (uuid)

El identificador del área de trabajo.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
logicalId True

string (uuid)

Identificador lógico que se va a actualizar para el elemento.

Respuestas

Nombre Tipo Description
200 OK

LogicalIdResponse

Solicitud completada correctamente.
429 Too Many Requests

ErrorResponse

Se superó el límite de frecuencia de servicio. El servidor devuelve un Retry-After encabezado que indica, en segundos, cuánto tiempo debe esperar el cliente antes de enviar solicitudes adicionales.

Encabezados

Retry-After: integer
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • ItemNotFound: no se encontró el elemento solicitado.

  • ActiveCiCdOperationInProgress: una operación de CI/CD está activa en el área de trabajo.

Ejemplos

Update logical ID example

Solicitud de ejemplo

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715/logicalId

{
  "logicalId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}

Respuesta de muestra

status code:
200 
{
  "logicalId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}

Definiciones

Nombre Description
ErrorParameter

Parámetro estructurado que proporciona contexto legible por máquina adicional sobre un error.
ErrorRelatedResource

Objeto de detalles del recurso relacionado con el error.
ErrorResponse

Respuesta de error.
ErrorResponseDetails

Detalles de la respuesta de error.
LogicalIdResponse

Respuesta de identificador lógico.
UpdateLogicalIdRequest

Actualice la carga de la solicitud de identificador lógico.

ErrorParameter

Objeto

Parámetro estructurado que proporciona contexto legible por máquina adicional sobre un error.

Nombre Tipo Description
message

string

Descripción legible del significado del parámetro.
name

string

El identificador de parámetros.
value

string

Es el valor del parámetro.

ErrorRelatedResource

Objeto

Objeto de detalles del recurso relacionado con el error.

Nombre Tipo Description
resourceId

string

ID de recurso que está involucrado en el error.
resourceType

string

Tipo del recurso implicado en el error.

ErrorResponse

Objeto

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.
isRetriable

boolean

Cuando es true, se puede reintentar la solicitud. Use el Retry-After encabezado de respuesta para determinar el retraso, si está disponible.
message

string

Representación comprensible para humanos del error.
moreDetails

ErrorResponseDetails[]

Lista de detalles de error adicionales.
parameters

ErrorParameter[]

Parámetros estructurados que proporcionan contexto legible por máquina adicional sobre el error.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.
requestId

string (uuid)

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Objeto

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 comprensible para humanos del error.
parameters

ErrorParameter[]

Parámetros estructurados que proporcionan contexto legible por máquina adicional sobre el error.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.

LogicalIdResponse

Objeto

Respuesta de identificador lógico.

Nombre Tipo Description
logicalId

string (uuid)

Identificador lógico del elemento.

UpdateLogicalIdRequest

Objeto

Actualice la carga de la solicitud de identificador lógico.

Nombre Tipo Description
logicalId

string (uuid)

Identificador lógico que se va a actualizar para el elemento.