Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Para mover um driveItem para um novo item pai, seu aplicativo solicita a atualização do parentReference do DriveItem a ser movido.
É um caso especial do método Update . 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.
Não é possível mover itens entre Unidades usando esta solicitação.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| 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 acessar o conteúdo do contêiner. Essa permissão é diferente das mencionadas anteriormente. Além das permissões do Microsoft Graph, seu aplicativo deve ter as permissões de tipo de contêiner necessárias para chamar essa API. Para obter mais informações, consulte Autenticação e autorizaçã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 | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type | application/json. Obrigatório. |
| if-match | Cadeia de caracteres. Se esse cabeçalho de solicitação for incluído e a eTag (ou cTag) fornecida não corresponder à eTag atual na pasta, uma 412 Precondition Failed resposta será retornada. |
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 da solicitação mantêm seus valores anteriores ou são recalculadas com base nas alterações de outros valores de propriedade. Para obter um melhor desempenho, você não deve incluir valores existentes que não são alterados.
Observação: Ao mover itens para a raiz de uma unidade, seu aplicativo não pode usar a "id:" "root" sintaxe.
Seu aplicativo precisa fornecer a ID real da pasta raiz para referência do pai. Por exemplo, /drives/{drive-id}/root.
Resposta
Se for bem-sucedido, esse método retornará um código de resposta e o 200 OK recurso driveItem atualizado no corpo da resposta.
Exemplo
Este exemplo move um item especificado por {item-id} para uma pasta na unidade do usuário com a ID new-parent-folder-id.
PATCH https://graph.microsoft.com/v1.0/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"
}
}
Respostas de erros
Consulte Respostas de erro para obter mais informações sobre como os erros são retornados.