Share via

Carregar parte do arquivo

  • Artigo

Carrega uma parte do arquivo no caminho relativo do repositório de imagens.

Carrega uma parte de arquivo no repositório de imagens com a ID de sessão de upload especificada e o caminho relativo do repositório de imagens. Essa API permite que o usuário retome a operação de carregamento de arquivos. o usuário não precisa reiniciar o upload de arquivo do zero sempre que houver uma interrupção de rede. Use essa opção se o tamanho do arquivo for grande.

Para executar um upload de arquivo retomável, o usuário precisa dividir o arquivo em várias partes e carregar essas partes no repositório de imagens um por um. Partes não precisam ser carregadas em ordem. Se o arquivo representado pelo caminho relativo do repositório de imagens já existir, ele será substituído quando a sessão de upload for confirmada.

Solicitação

Método URI da solicitação
PUT /ImageStore/{contentPath}/$/UploadChunk?api-version=6.0&session-id={session-id}&timeout={timeout}

Parâmetros

Nome Type Obrigatório Location
contentPath string Sim Caminho
Content-Range string Sim Cabeçalho
api-version string Sim Consulta
session-id string (uuid) Sim Consulta
timeout inteiro (int64) Não Consulta

contentPath

Tipo: string
Obrigatório: sim

Caminho relativo para o arquivo ou pasta no repositório de imagens de sua raiz.

Content-Range

Tipo: string
Obrigatório: sim

Ao carregar partes de arquivo no repositório de imagens, o campo de cabeçalho Intervalo de Conteúdo precisa ser configurado e enviado com uma solicitação. O formato deve ser semelhante a "bytes {First-Byte-Position}-{Last-Byte-Position}/{File-Length}". Por exemplo, Content-Range:bytes 300-5000/20000 indica que o usuário está enviando bytes de 300 a 5.000 e o comprimento total do arquivo é de 20.000 bytes.

api-version

Tipo: string
Obrigatório: sim
Padrão: 6.0

A versão da API. Esse parâmetro é necessário e seu valor deve ser '6.0'.

A versão da API REST do Service Fabric é baseada na versão de runtime na qual a API foi introduzida ou alterada. O runtime do Service Fabric dá suporte a mais de uma versão da API. Esta é a versão mais recente com suporte da API. Se uma versão inferior da API for passada, a resposta retornada poderá ser diferente daquela documentada nessa especificação.

Além disso, o runtime aceita qualquer versão maior do que a versão mais recente com suporte até a versão atual do runtime. Portanto, se a versão mais recente da API for 6.0, mas se o runtime for 6.1, para facilitar a gravação dos clientes, o runtime aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será de acordo com a versão documentada 6.0.

session-id

Tipo: cadeia de caracteres (uuid)
Obrigatório: sim

Um GUID gerado pelo usuário para um upload de arquivo. Ele identifica uma sessão de upload do repositório de imagens que controla todas as partes do arquivo até que ela seja confirmada.

timeout

Tipo: inteiro (int64)
Obrigatório: não
Padrão: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos.

Respostas

Código de status HTTP Descrição Esquema de Resposta
200 (OK) Uma operação bem-sucedida retornará o código status HTTP 200 OK.
Todos os outros códigos status A resposta de erro detalhada.
 FabricError