CreateFile - Drive and Photo Service: Central de Documentação do Alibaba Cloud

Cria um arquivo ou pasta.

Descrição da operação

Para o método de criação de arquivo, consulte as Melhores Práticas: Upload de arquivo.

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/create HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
domain_id	string	Sim
body	object	Não	Os parâmetros do corpo da solicitação.
name	string	Sim	O nome do arquivo. O nome pode ter até 1024 bytes na codificação UTF-8 e não pode conter barras (/).	a.txt.
type	string	Sim	O tipo de arquivo. Valores válidos:	file.
parent_file_id	string	Sim	O ID da pasta pai. Defina este parâmetro como root para fazer upload no diretório raiz.	fileid1
drive_id	string	Não	O ID do drive. Este parâmetro é obrigatório, a menos que o upload seja realizado por meio de um link de compartilhamento.	1
share_id	string	Não	O ID do compartilhamento. Este parâmetro é obrigatório ao fazer upload por meio de um link de compartilhamento.	7JQX1FswpQ8
size	integer	Não	O tamanho do arquivo, em bytes.	1024
content_type	string	Não	O tipo de conteúdo do arquivo. Valor padrão: application/oct-stream.	application/json.
part_info_list	array<object>	Não	A lista de informações das partes. São suportadas no máximo 10000 partes. Se este parâmetro não for especificado, uma parte será retornada por padrão.
	array<object>	Não	As informações da parte.
part_number	integer	Não	O número de sequência da parte, começando em 1.	1
parallel_sha1_ctx	object	Não	O contexto SHA1 de todos os dados anteriores a esta parte. Este campo é válido apenas no modo de upload multipartes simultâneo.
h	array	Não	As variáveis de 32 bits da primeira à quinta do SHA1 contextual de todos os dados anteriores a esta parte. Este campo é válido apenas no padrão de upload multipartes concorrente.
	integer	Não	As variáveis de 32 bits da primeira à quinta do SHA1 contextual de todos os dados anteriores a esta parte.	1
part_offset	integer	Não	O comprimento total em bytes até o bloco de dados anterior. O valor deve ser um múltiplo de 64. Este campo é válido apenas no modo de upload multipartes concorrente.	10240
content_md5	string	Não	O valor MD5 da parte. Especifique este parâmetro quando precisar verificar o MD5 da parte durante o upload.	ASKJDJSKDJJSJDJS.
content_type	string	Não	O valor de Content-Type que o cliente deve definir ao fazer upload de uma parte usando PUT. Se o Content-Type especificado pelo cliente durante o upload não corresponder a este valor, ocorrerá um erro de assinatura. Valor padrão: vazio. O cliente não precisa especificar Content-Type durante o PUT.	application/json.
user_tags	array	Não	As tags de usuário personalizadas. São suportadas no máximo 1000 tags.
	UserTag	Não	A tag de usuário personalizada.
hidden	boolean	Não	Especifica se o arquivo está oculto. Valor padrão: não oculto.	false.
description	string	Não	A descrição do arquivo. A descrição pode ter até 1024 caracteres. Valor padrão: vazio.	Arquivo da equipe.
content_hash	string	Não	O valor de hash do conteúdo do arquivo. O valor é calculado com base no algoritmo especificado por content_hash_name.	7C4A8D09CA3762AF61E59520943DC26494F8941B
content_hash_name	string	Não	O nome do algoritmo de hash para o conteúdo do arquivo. Atualmente, apenas sha1 é suportado.	sha1
pre_hash	string	Não	O valor SHA1 dos primeiros 1 KB do arquivo. Especifique este parâmetro ao usar o recurso de pré-upload rápido. Se nenhuma correspondência for encontrada no servidor, o cliente não precisará calcular o SHA1 completo do arquivo para o upload rápido.	7C4A8D09CA3762AF61E59520943DC26494F89411
check_name_mode	string	Não	O modo para lidar com arquivos com nomes duplicados. Valores válidos: Valores válidos: refuse : refuse. auto_rename : auto_rename. ignore : ignore.	ignore.
file_id	string	Não	O ID do arquivo. Este parâmetro é obrigatório para operações de substituição.	9520943DC264
local_created_at	string	Não	A hora de criação local do arquivo. Valor padrão: vazio. Formato: yyyy-MM-ddTHH:mm:ssZ, no fuso horário UTC+0.	2023-10-04T14:30:00Z
local_modified_at	string	Não	A hora de modificação local do arquivo. Valor padrão: vazio. Formato: yyyy-MM-ddTHH:mm:ssZ, no fuso horário UTC+0.	2023-10-04T14:30:00Z
parallel_upload	boolean	Não	Especifica se o recurso de upload paralelo de partes deve ser ativado.	true.
upload_type	string	Não	O tipo de upload. Valores válidos: multipart e form. Valor padrão: multipart.	multipart.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	As informações da resposta.
parent_file_id	string	O ID da pasta pai.	fileid5
part_info_list	array	A lista de informações das partes.
	UploadPartInfo	As informações da parte.
upload_id	string	O ID do upload.	uploadid1
rapid_upload	boolean	Indica se o arquivo foi carregado rapidamente.	true.
type	string	O tipo de arquivo.	file.
file_id	string	O ID do arquivo.	fileid1
domain_id	string	O ID do domínio.	bj1
drive_id	string	O ID do drive.	1
file_name	string	O nome do arquivo.	a.txt.
status	string	O status do arquivo.	uploading.
exist	boolean	Indica se o arquivo existe.	false.

Exemplos

Resposta de sucesso

JSON formato

{
  "parent_file_id": "fileid5",
  "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
      }
    }
  ],
  "upload_id": "uploadid1",
  "rapid_upload": true,
  "type": "file",
  "file_id": "fileid1",
  "domain_id": "bj1",
  "drive_id": "1",
  "file_name": "a.txt",
  "status": "uploading",
  "exist": 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.