Carregar Segmento de Ficheiro
Carrega um segmento de ficheiro para o caminho relativo do arquivo de imagens.
Carrega um segmento de ficheiro para o arquivo de imagens com o ID de sessão de carregamento especificado e o caminho relativo do arquivo de imagens. Esta API permite que o utilizador retome a operação de carregamento de ficheiros. O utilizador não tem de reiniciar o carregamento do ficheiro do zero sempre que existir uma interrupção de rede. Utilize esta opção se o tamanho do ficheiro for grande.
Para executar um carregamento de ficheiros resumível, o utilizador tem de dividir o ficheiro em vários segmentos e carregar estes segmentos para o arquivo de imagens um a um. Os segmentos não têm de ser carregados por ordem. Se o ficheiro representado pelo caminho relativo do arquivo de imagens já existir, será substituído quando a sessão de carregamento for consolidada.
Pedir
Método | URI do pedido |
---|---|
PUT | /ImageStore/{contentPath}/$/UploadChunk?api-version=6.0&session-id={session-id}&timeout={timeout} |
Parâmetros
Nome | Tipo | Necessário | Localização |
---|---|---|---|
contentPath |
string | Yes | Caminho |
Content-Range |
string | Yes | Cabeçalho |
api-version |
string | Yes | Consulta |
session-id |
cadeia (uuid) | Sim | Consulta |
timeout |
número inteiro (int64) | No | Consulta |
contentPath
Tipo: cadeia
Obrigatório: Sim
Caminho relativo para o ficheiro ou pasta no arquivo de imagens a partir da sua raiz.
Content-Range
Tipo: cadeia
Obrigatório: Sim
Ao carregar segmentos de ficheiros para o arquivo de imagens, o campo de cabeçalho Intervalo de Conteúdos tem de ser configurado e enviado com um pedido. O formato deve ter o aspeto "bytes {First-Byte-Position}-{Last-Byte-Position}/{File-Length}". Por exemplo, Intervalo de Conteúdos:bytes 300-5000/20000 indica que o utilizador está a enviar bytes 300 a 5000 e o comprimento total do ficheiro é de 20 000 bytes.
api-version
Tipo: cadeia
Obrigatório: Sim
Predefinição: 6.0
A versão da API. Este parâmetro é obrigatório e o respetivo valor tem de ser "6.0".
A versão da API REST do Service Fabric baseia-se na versão de runtime na qual a API foi introduzida ou foi alterada. O runtime do Service Fabric suporta mais do que uma versão da API. Esta é a versão suportada mais recente da API. Se for transmitida uma versão da API inferior, a resposta devolvida poderá ser diferente da documentada nesta especificação.
Além disso, o runtime aceita qualquer versão superior à versão suportada mais recente até à 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 escrita dos clientes, o runtime aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será conforme a versão documentada 6.0.
session-id
Tipo: cadeia (uuid)
Obrigatório: Sim
Um GUID gerado pelo utilizador para um carregamento de ficheiros. Identifica uma sessão de carregamento do arquivo de imagens que controla todos os segmentos de ficheiros até que seja consolidado.
timeout
Tipo: número inteiro (int64)
Obrigatório: Não
Predefinição: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos.
Respostas
Código de Estado HTTP | Description | Esquema de Resposta |
---|---|---|
200 (OK) | Uma operação bem-sucedida devolverá o código de estado HTTP 200 OK. |
|
Todos os outros códigos de estado | A resposta detalhada ao erro. |
FabricError |