Todos os produtos
Search
Central de documentação

Drive and Photo Service:GetUploadUrl

Última atualização: Jul 04, 2026

Obtém o endereço de upload.

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/get_upload_url 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.

drive_id

string

Sim

O ID da unidade.

1

share_id

string

Não

O ID do compartilhamento.

7JQX1FswpQ8

file_id

string

Sim

O ID do arquivo.

5d5b846942cf94fa72324c14a4bda34e81da635d

upload_id

string

Sim

O ID do upload.

10166D06127B413BA1EC8ABB1144D111

part_info_list

array<object>

Sim

Uma lista de partes do arquivo.

array<object>

Não

Informações sobre uma única parte do arquivo.

part_number

integer

Não

O número da parte.

1

parallel_sha1_ctx

object

Não

O contexto SHA1 para todos os dados que precedem esta parte. Este parâmetro se aplica apenas a uploads paralelos.

h

array

Não

The five 32-bit state variables of the SHA1 context for all data preceding this part. This parameter applies only to parallel uploads.

integer

Não

One of the five 32-bit variables of the SHA1 context.

1

part_offset

integer

Não

The total size in bytes of all preceding parts. The value must be a multiple of 64. This parameter applies only to parallel uploads.

10240

content_md5

string

Não

content_type

string

Não

parallel_sha256_ctx

object

Não

h

array

Não

integer

Não

part_offset

integer

Não

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O objeto de resposta.

domain_id

string

O ID do domínio.

bj1

drive_id

string

O ID da unidade.

1

file_id

string

O ID do arquivo.

5d5b846942cf94fa72324c14a4bda34e81da635d

upload_id

string

O ID do upload.

10166D06127B413BA1EC8ABB1144D111

create_at

string

O horário de criação.

2019-09-11T16:34:36.977Z

part_info_list

array

A lista de partes do upload.

UploadPartInfo

Informações sobre uma única parte.

Exemplos

Resposta de sucesso

JSON formato

{
  "domain_id": "bj1",
  "drive_id": "1",
  "file_id": "5d5b846942cf94fa72324c14a4bda34e81da635d",
  "upload_id": "10166D06127B413BA1EC8ABB1144D111",
  "create_at": "2019-09-11T16:34:36.977Z",
  "part_info_list": [
    {
      "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
      }
    }
  ]
}

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.