Items - Update Logical Id

Serviço:

Core

Versão da API:

v1

Atualiza o ID lógico do item especificado.
As instâncias correspondentes partilham o mesmo ID lógico. Use esta operação para resolver conflitos lógicos de ID. Antes de mudar o ID lógico, reveja quaisquer automações que dependam do seu valor atual e atualize-as conforme necessário. Caso contrário, essas automações podem falhar em localizar o item ou falhar devido a um nome de exibição duplicado. Para mais informações, consulte Resolver conflitos de identificação lógica no Microsoft Fabric.

Permissions

O chamador deve ter permissões de leitura e gravação para o item.

Escopos delegados necessários

Para APIs de items, utilize um dos seguintes tipos de escopo:

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

Para mais informações sobre telescópios, consulte Telescopes.

Limitations

• O ID lógico não pode ser um GUID vazio (00000000-0000-0000-0000-000000000000).
• O ID lógico deve ser único dentro do espaço de trabalho.
• A operação não é suportada enquanto uma operação CI/CD está ativa no espaço de trabalho.

Identidades suportadas pelo Entra da Microsoft

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identidade	Suporte
User	Sim
Entidade de serviço e identidades geridas	Sim

Interface

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

Parâmetros do URI

Nome	Em	Obrigatório	Tipo	Descrição
itemId	path	True	string (uuid)	O ID do item.
workspaceId	path	True	string (uuid)	O ID do espaço de trabalho.

Corpo do Pedido

Nome	Obrigatório	Tipo	Descrição
logicalId	True	string (uuid)	O ID lógico a atualizar para o item.

Respostas

Nome	Tipo	Descrição
200 OK	LogicalIdResponse	Pedido concluído com sucesso.
429 Too Many Requests	ErrorResponse	O limite de tarifa de serviço foi ultrapassado. O servidor devolve um Retry-After cabeçalho que indica, em segundos, quanto tempo o cliente deve esperar antes de enviar pedidos adicionais. Cabeçalhos Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de erro comuns: ItemNotFound - O item solicitado não foi encontrado. ActiveCiCdOperationInProgress - Uma operação CI/CD está ativa no espaço de trabalho.

Exemplos

Update logical ID example

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:

200

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

Definições

Nome	Descrição
ErrorParameter	Um parâmetro estruturado que fornece contexto adicional legível por máquina sobre um erro.
ErrorRelatedResource	Os detalhes do objeto de recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes do erro na resposta.
LogicalIdResponse	Resposta lógica do ID.
UpdateLogicalIdRequest	Atualizar a carga útil de pedido de ID lógico.

ErrorParameter

Object

Um parâmetro estruturado que fornece contexto adicional legível por máquina sobre um erro.

Nome	Tipo	Descrição
message	string	Uma descrição legível para humanos do significado do parâmetro.
name	string	O identificador de parâmetro.
value	string	O valor do parâmetro.

ErrorRelatedResource

Object

Os detalhes do objeto de recurso relacionado ao erro.

Nome	Tipo	Descrição
resourceId	string	O ID do recurso envolvido no erro.
resourceType	string	O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Nome	Tipo	Descrição
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
isRetriable	boolean	Quando confirmado, o pedido pode ser retentado. Use o Retry-After cabeçalho de resposta para determinar o atraso, se disponível.
message	string	Uma representação legível por humanos do erro.
moreDetails	ErrorResponseDetails[]	Lista de detalhes de erro adicionais.
parameters	ErrorParameter[]	Parâmetros estruturados que fornecem contexto adicional legível pela máquina sobre o erro.
relatedResource	ErrorRelatedResource	Detalhes do recurso relacionado ao erro.
requestId	string (uuid)	ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes do erro na resposta.

Nome	Tipo	Descrição
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
parameters	ErrorParameter[]	Parâmetros estruturados que fornecem contexto adicional legível pela máquina sobre o erro.
relatedResource	ErrorRelatedResource	Detalhes do recurso relacionado ao erro.

LogicalIdResponse

Object

Resposta lógica do ID.

Nome	Tipo	Descrição
logicalId	string (uuid)	A ID lógica do item.

UpdateLogicalIdRequest

Object

Atualizar a carga útil de pedido de ID lógico.

Nome	Tipo	Descrição
logicalId	string (uuid)	O ID lógico a atualizar para o item.