External Data Shares Provider - Delete External Data Share
Exclui o compartilhamento de dados externos especificado.
Permissões
O chamador deve ter permissões de leitura e recompartilhamento no item.
Escopos delegados necessários
As APIs de item podem ter um destes escopos em seu token:
- Escopo genérico: Item.ExternalDataShare.All
- Âmbito específico: itemType. ExternalDataShare.All, por exemplo: Lakehouse.ExternalDataShare.All
Para obter mais informações sobre escopos, consulte o artigo escopos.
Configurações de locatário necessárias
Para usar essa API, habilite a opção Administrador de compartilhamento de dados externo para a entidade de chamada.
Limitações
Máximo de 10 pedidos por minuto.
Identidades suportadas pelo Entra da Microsoft
Esta API suporta as identidades do Microsoft listadas nesta secção.
| Identidade | Apoio |
|---|---|
| Utilizador | Sim |
| Entidade de serviço e identidades geridas | Sim |
Interfaz
DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/externalDataShares/{externalDataShareId}
Parâmetros do URI
| Name | Em | Necessário | Tipo | Description |
|---|---|---|---|---|
|
external
|
path | True |
string (uuid) |
O ID de compartilhamento de dados externos. |
|
item
|
path | True |
string (uuid) |
O ID do item. |
|
workspace
|
path | True |
string (uuid) |
O ID do espaço de trabalho. |
Respostas
| Name | Tipo | Description |
|---|---|---|
| 200 OK |
Pedido concluído com sucesso. |
|
| Other Status Codes |
Códigos de erro comuns:
|
Exemplos
Delete external data share example
Pedido de amostra
DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715/externalDataShares/dccc162f-7a41-4720-83c3-5c7e81187959
Resposta da amostra
Definições
| Name | Description |
|---|---|
|
Error |
O objeto de detalhes do recurso relacionado ao erro. |
|
Error |
A resposta de erro. |
|
Error |
Os detalhes da resposta de erro. |
ErrorRelatedResource
O objeto de detalhes do recurso relacionado ao erro.
| Name | Tipo | Description |
|---|---|---|
| resourceId |
string |
A ID do recurso envolvida no erro. |
| resourceType |
string |
O tipo de recurso envolvido no erro. |
ErrorResponse
A resposta de erro.
| Name | Tipo | Description |
|---|---|---|
| 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. |
| moreDetails |
Lista de detalhes de erro adicionais. |
|
| relatedResource |
Os detalhes do recurso relacionados ao erro. |
|
| requestId |
string |
ID da solicitação associada ao erro. |
ErrorResponseDetails
Os detalhes da resposta de erro.
| Name | Tipo | Description |
|---|---|---|
| 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. |
| relatedResource |
Os detalhes do recurso relacionados ao erro. |