Obter a Sessão de Carregamento do Arquivo de Imagens por ID

  • Artigo

Obtenha a sessão de carregamento do arquivo de imagens por ID.

Obtém a sessão de carregamento do arquivo de imagens identificada pelo ID especificado. O utilizador pode consultar a sessão de carregamento em qualquer altura durante o carregamento.

Pedir

Método URI do pedido
GET /ImageStore/$/GetUploadSession?api-version=6.0&session-id={session-id}&timeout={timeout}

Parâmetros

Nome Tipo Necessário Localização
api-version string Yes Consulta
session-id cadeia (uuid) Sim Consulta
timeout número inteiro (int64) No Consulta

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 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 inferior da API, 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. Por isso, se a versão mais recente da API for a 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á de acordo com a versão 6.0 documentada.

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 consolidada.

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 que a operação pedida seja concluída. 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 200 e as informações de sessão de carregamento do arquivo de imagens pedidas.
 UploadSession
Todos os outros códigos de estado A resposta detalhada ao erro.
 FabricError

Exemplos

Obter informações sobre a sessão de carregamento do arquivo de imagens por um determinado ID

Este exemplo mostra como obter a sessão de carregamento do arquivo de imagens por um determinado ID.

Pedir

GET http://localhost:19080/ImageStore/$/GetUploadSession?api-version=6.0&session-id=4a2340e8-d8d8-497c-95fe-cdaa1052f33b

Resposta 200

Corpo
{
  "UploadSessions": [
    {
      "StoreRelativePath": "SwaggerTest\\Common.dll",
      "SessionId": "4a2340e8-d8d8-497c-95fe-cdaa1052f33b",
      "FileSize": "2097152",
      "ModifiedDate": "2017-09-28T17:06:37.26Z",
      "ExpectedRanges": [
        {
          "StartPosition": "0",
          "EndPosition": "402128"
        },
        {
          "StartPosition": "730105",
          "EndPosition": "2097151"
        }
      ]
    }
  ]
}