Przekazywanie fragmentu pliku
Przekazuje fragment pliku do ścieżki względnej magazynu obrazów.
Przekazuje fragment pliku do magazynu obrazów z określonym identyfikatorem sesji przekazywania i ścieżką względną magazynu obrazów. Ten interfejs API umożliwia użytkownikowi wznowienie operacji przekazywania plików. użytkownik nie musi ponownie uruchamiać przekazywania pliku od podstaw, gdy wystąpi przerwa w działaniu sieci. Użyj tej opcji, jeśli rozmiar pliku jest duży.
Aby wykonać ponowne przekazywanie plików, użytkownik musi podzielić plik na wiele fragmentów i przekazać te fragmenty do magazynu obrazów jeden po jednym. Fragmenty nie muszą być przekazywane w kolejności. Jeśli plik reprezentowany przez ścieżkę względną magazynu obrazów już istnieje, zostanie zastąpiony po zatwierdzeniach sesji przekazywania.
Żądanie
| Metoda | Identyfikator URI żądania |
|---|---|
| PUT | /ImageStore/{contentPath}/$/UploadChunk?api-version=6.0&session-id={session-id}&timeout={timeout} |
Parametry
| Nazwa | Typ | Wymagane | Lokalizacja |
|---|---|---|---|
contentPath |
ciąg | Tak | Ścieżka |
Content-Range |
ciąg | Tak | Nagłówek |
api-version |
ciąg | Tak | Zapytanie |
session-id |
ciąg (uuid) | Tak | Zapytanie |
timeout |
liczba całkowita (int64) | Nie | Zapytanie |
contentPath
Typ: ciąg
Wymagane: Tak
Ścieżka względna do pliku lub folderu w magazynie obrazów z katalogu głównego.
Content-Range
Typ: ciąg
Wymagane: Tak
Podczas przekazywania fragmentów pliku do magazynu obrazów należy skonfigurować pole nagłówka Zakres zawartości i wysłać je za pomocą żądania. Format powinien wyglądać następująco: "bajty {First-Byte-Position}-{Last-Byte-Position}/{File-Length}". Na przykład Zakres zawartości:bajty 300-5000/20000 wskazuje, że użytkownik wysyła bajty od 300 do 5000, a łączna długość pliku wynosi 20 000 bajtów.
api-version
Typ: ciąg
Wymagane: Tak
Ustawienie domyślne: 6.0
Wersja interfejsu API. Ten parametr jest wymagany, a jego wartość musi mieć wartość "6.0".
Wersja interfejsu API REST usługi Service Fabric jest oparta na wersji środowiska uruchomieniowego, w której wprowadzono lub zmieniono interfejs API. Środowisko uruchomieniowe usługi Service Fabric obsługuje więcej niż jedną wersję interfejsu API. Jest to najnowsza obsługiwana wersja interfejsu API. Jeśli zostanie przekazana niższa wersja interfejsu API, zwrócona odpowiedź może być inna niż ta udokumentowana w tej specyfikacji.
Ponadto środowisko uruchomieniowe akceptuje każdą wersję, która jest wyższa niż najnowsza obsługiwana wersja do bieżącej wersji środowiska uruchomieniowego. Jeśli więc najnowsza wersja interfejsu API to 6.0, ale jeśli środowisko uruchomieniowe ma wartość 6.1, aby ułatwić pisanie klientów, środowisko uruchomieniowe zaakceptuje wersję 6.1 dla tego interfejsu API. Jednak zachowanie interfejsu API będzie zgodnie z udokumentowaną wersją 6.0.
session-id
Typ: ciąg (uuid)
Wymagane: Tak
Identyfikator GUID wygenerowany przez użytkownika na potrzeby przekazywania pliku. Identyfikuje sesję przekazywania magazynu obrazów, która śledzi wszystkie fragmenty plików do momentu jego zatwierdzenia.
timeout
Typ: liczba całkowita (int64)
Wymagane: Nie
Ustawienie domyślne: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund.
Odpowiedzi
| Kod stanu HTTP | Opis | Response Schema |
|---|---|---|
| 200 (OK) | Operacja zakończona powodzeniem zwróci kod stanu HTTP 200 OK. |
|
| Wszystkie inne kody stanu | Szczegółowa odpowiedź na błąd. |
FabricError |