Items - Update Logical Id

Service:
Core
Version d’API:
v1

Met à jour l’ID logique de l’élément spécifié.
Les instances d’élément correspondantes partagent le même ID logique. Utilisez cette opération pour résoudre les conflits d’ID logiques. Avant de modifier l’ID logique, passez en revue toutes les automatisations qui s’appuient sur sa valeur actuelle et mettez-les à jour si nécessaire. Sinon, ces automatisations peuvent échouer pour localiser l’élément ou échouer en raison d’un nom d’affichage en double. Pour plus d’informations, consultez Résoudre les conflits d’ID logiques dans Microsoft Fabric.

Permissions

L’appelant doit disposer d’autorisations de lecture et d’écriture pour l’élément.

Étendues déléguées requises

Pour les API d’élément, utilisez l’un des types d’étendue suivants :

  • Étendue générique : Item.ReadWrite.All.
  • Étendue spécifique : itemType. ReadWrite.All (par exemple, Notebook.ReadWrite.All).

Pour plus d’informations sur les étendues, consultez Étendues.

Limitations

  • L’ID logique ne peut pas être un GUID vide (00000000-0000-0000-0000-000000000000).
  • L’ID logique doit être unique dans l’espace de travail.
  • L’opération n’est pas prise en charge alors qu’une opération CI/CD est active dans l’espace de travail.

Identités prises en charge par Microsoft Entra

Cette API prend en charge les identités Microsoft répertoriées dans cette section.

Identité Support
User Oui
Service principal et identités gérées Oui

Interface

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

Paramètres URI

Nom Dans Obligatoire Type Description
itemId
 path True

string (uuid)

ID d’élément.
workspaceId
 path True

string (uuid)

Identifiant de l’espace de travail.

Corps de la demande

Nom Obligatoire Type Description
logicalId True

string (uuid)

ID logique à mettre à jour pour l’élément.

Réponses

Nom Type Description
200 OK

LogicalIdResponse

La demande s’est terminée avec succès.
429 Too Many Requests

ErrorResponse

La limite de débit de service a été dépassée. Le serveur retourne un Retry-After en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires.

En-têtes

Retry-After: integer
Other Status Codes

ErrorResponse

Codes d’erreur courants :

  • ItemNotFound : l’élément demandé n’a pas été trouvé.

  • ActiveCiCdOperationInProgress : une opération CI/CD est active dans l’espace de travail.

Exemples

Update logical ID example

Exemple de requête

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"
}

Exemple de réponse

Code d’état:
200 
{
  "logicalId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}

Définitions

Nom Description
ErrorParameter

Paramètre structuré fournissant un contexte lisible par l’ordinateur supplémentaire à propos d’une erreur.
ErrorRelatedResource

Objet de détails de ressource associé à l’erreur.
ErrorResponse

Réponse d’erreur.
ErrorResponseDetails

Détails de la réponse d’erreur.
LogicalIdResponse

Réponse d’ID logique.
UpdateLogicalIdRequest

Mettez à jour la charge utile de la demande d’ID logique.

ErrorParameter

Objet

Paramètre structuré fournissant un contexte lisible par l’ordinateur supplémentaire à propos d’une erreur.

Nom Type Description
message

string

Description lisible par l’homme de la signification du paramètre.
name

string

L’identifiant de paramètre.
value

string

Représente la valeur du paramètre.

ErrorRelatedResource

Objet

Objet de détails de ressource associé à l’erreur.

Nom Type Description
resourceId

string

ID de ressource impliqué dans l’erreur.
resourceType

string

Type de la ressource impliquée dans l’erreur.

ErrorResponse

Objet

Réponse d’erreur.

Nom Type Description
errorCode

string

Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
isRetriable

boolean

Lorsque la valeur est true, la requête peut être retentée. Utilisez l’en-tête Retry-After de réponse pour déterminer le délai, le cas échéant.
message

string

Représentation lisible humaine de l’erreur.
moreDetails

ErrorResponseDetails[]

Liste des détails d’erreur supplémentaires.
parameters

ErrorParameter[]

Paramètres structurés fournissant un contexte lisible par l’ordinateur supplémentaire sur l’erreur.
relatedResource

ErrorRelatedResource

Détails de la ressource associée à l’erreur.
requestId

string (uuid)

ID de la demande associée à l’erreur.

ErrorResponseDetails

Objet

Détails de la réponse d’erreur.

Nom Type Description
errorCode

string

Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message

string

Représentation lisible humaine de l’erreur.
parameters

ErrorParameter[]

Paramètres structurés fournissant un contexte lisible par l’ordinateur supplémentaire sur l’erreur.
relatedResource

ErrorRelatedResource

Détails de la ressource associée à l’erreur.

LogicalIdResponse

Objet

Réponse d’ID logique.

Nom Type Description
logicalId

string (uuid)

ID logique de l’élément.

UpdateLogicalIdRequest

Objet

Mettez à jour la charge utile de la demande d’ID logique.

Nom Type Description
logicalId

string (uuid)

ID logique à mettre à jour pour l’élément.