Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Mover um driveItem para um novo elemento principal.
Para mover um driveItem para um novo item principal, a sua aplicação pede uma atualização para o parentReference do driveItem para mover. A movimentação é um tipo especial de Operação de atualização . O aplicativo pode combinar a movimentação de um item para um novo contêiner e a atualização de outras propriedades do item em uma única solicitação.
Quando um driveItem é movido dentro do mesmo site ou contentor, todas as ligações de partilha existentes continuam a funcionar. Se o driveItem for movido para um site ou contentor diferente, as ligações de partilha existentes deixarão de funcionar.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Files.ReadWrite | Files.ReadWrite.All, Sites.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Files.ReadWrite | Files.ReadWrite.All |
| Aplicativo | Files.ReadWrite.All | Sites.ReadWrite.All |
Observação
O SharePoint Embedded requer a FileStorageContainer.Selected permissão para aceder ao conteúdo do contentor. Esta permissão é diferente das mencionadas anteriormente. Além das permissões do Microsoft Graph, a sua aplicação tem de ter as permissões de tipo de contentor necessárias para chamar esta API. Para obter mais informações, veja Autorização e autenticação do SharePoint Embedded.
Solicitação HTTP
PATCH /drives/{drive-id}/items/{item-id}
PATCH /groups/{group-id}/drive/items/{item-id}
PATCH /me/drive/items/{item-id}
PATCH /sites/{site-id}/drive/items/{item-id}
PATCH /users/{user-id}/drive/items/{item-id}
Cabeçalhos de solicitação
| Nome | Tipo | Descrição |
|---|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. | |
| if-match | String | Se este cabeçalho de pedido estiver incluído e a eTag (ou cTag) fornecida não corresponder à eTag atual na pasta, é devolvida uma 412 Precondition Failed resposta. Opcional. |
Corpo da solicitação
No corpo da solicitação, forneça o novo valor para a propriedade parentReference. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou as propriedades são recalculadas com base em alterações a outros valores de propriedade. Para um desempenho ideal, inclua apenas os valores que mudam e omitem os inalterados.
Observação
Quando os itens são movidos para a raiz de uma unidade, a aplicação tem de utilizar o ID real da pasta raiz como referência principal em vez da "id: root" sintaxe.
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e um recurso driveItem atualizado no corpo da resposta.
Para obter informações sobre como os erros são devolvidos, veja Respostas de erros.
Exemplos
Solicitação
O exemplo seguinte move um item especificado por {item-id} para uma pasta na unidade do utilizador com o ID new-parent-folder-id.
PATCH https://graph.microsoft.com/beta/me/drive/items/{item-id}
Content-type: application/json
{
"parentReference": {
"id": "new-parent-folder-id"
},
"name": "new-item-name.txt"
}
Resposta
O exemplo a seguir mostra a resposta para este pedido de movimentação.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "0123456789abc",
"name": "new-item-name.txt",
"parentReference":
{
"driveId": "11231001",
"path": "/drive/root:/Documents",
"id": "1231203102!1011"
}
}