Todos os produtos
Search
Central de documentação

Drive and Photo Service:ListUploadedParts

Última atualização: Jul 04, 2026

Lista as partes que foram carregadas com sucesso para um upload multipart específico.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST /v2/file/list_uploaded_parts HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

domain_id

string

Sim

body

object

Não

O corpo da solicitação.

part_number_marker

integer

Não

O marcador que especifica a posição após a qual começar a listar as partes. Obtenha este valor do campo next_part_number_marker em uma resposta anterior. Se este parâmetro for omitido, a listagem começará a partir da primeira parte.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

limit

integer

Não

O número máximo de partes a serem retornadas. O valor não pode exceder 100. O valor padrão é 100.

100

upload_id

string

Sim

O ID do upload.

00166D06127B413BA1EC8ABB1144D101

file_id

string

Sim

O ID do arquivo.

322fb07b975f4b0ae1b543fe8475eee4c19eb2b2

drive_id

string

Não

O ID da unidade. Obrigatório para todos os cenários, exceto para uploads a partir de um compartilhamento.

1

share_id

string

Não

O ID do compartilhamento. Obrigatório ao fazer upload a partir de um compartilhamento.

7JQX1FswpQ8

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O objeto de resposta.

file_id

string

O ID do arquivo.

322fb07b975f4b0ae1b543fe8475eee4c19eb2b2

upload_id

string

O ID do upload.

00166D06127B413BA1EC8ABB1144D101

uploaded_parts

array

Uma lista de partes carregadas.

UploadPartInfo

Informações sobre uma única parte.

next_part_number_marker

string

O marcador para a próxima página de resultados. Este valor estará vazio quando não houver mais resultados a serem retornados.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

parallel_upload

boolean

Indica se o upload paralelo está ativado.

false

Exemplos

Resposta de sucesso

JSON formato

{
  "file_id": "322fb07b975f4b0ae1b543fe8475eee4c19eb2b2",
  "upload_id": "00166D06127B413BA1EC8ABB1144D101",
  "uploaded_parts": [
    {
      "part_number": 1,
      "part_size": 1024,
      "upload_url": "https://data.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661",
      "internal_upload_url": "https://data-vpc.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\n",
      "etag": "\"0CC175B9C0F1B6A831C399E269772661\"",
      "parallel_sha1_ctx": {
        "h": [
          0
        ],
        "part_offset": 10240
      },
      "upload_form_info": {
        "endpoint": "",
        "form_data": {
          "key": ""
        }
      },
      "parallel_sha256_ctx": {
        "h": [
          0
        ],
        "part_offset": 0
      }
    }
  ],
  "next_part_number_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg",
  "parallel_upload": false
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.