Umieść zakres od adresu URL
Operacja Put Range From URL tworzy nowy zakres, który ma zostać zatwierdzony w ramach pliku, w którym zawartość jest odczytywana z adresu URL. Ta operacja jest obsługiwana w wersji 2019-02-02 i nowszych dla udziałów plików z włączonym protokołem SMB i obsługiwana w wersji 2025-05-05 i nowszych dla udziałów plików z włączonym protokołem NFS.
Dostępność protokołu
| Włączony protokół udziału plików | Dostępny |
|---|---|
| SMB |
|
| NFS |
|
Prosić
Żądanie Put Range From URL jest konstruowane w następujący sposób. Zalecamy używanie protokołu HTTPS.
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
| KŁAŚĆ | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=range |
HTTP/1.1 |
Zastąp składniki ścieżki wyświetlane we własnym identyfikatorze URI żądania, w następujący sposób:
| Składnik ścieżki | Opis |
|---|---|
myaccount |
Nazwa konta magazynu. |
myshare |
Nazwa udziału plików. |
mydirectorypath |
Fakultatywny. Ścieżka do katalogu nadrzędnego. |
myfile |
Nazwa pliku. |
Aby uzyskać informacje o ograniczeniach nazewnictwa ścieżek, zobacz Nazwa i odwołania udziały, katalogi, pliki i metadane.
Parametry identyfikatora URI
| Parametr | Opis |
|---|---|
timeout |
Fakultatywny. Parametr timeout jest wyrażony w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi Azure Files. |
Nagłówki żądań
Wymagane i opcjonalne nagłówki żądań są opisane w następujących tabelach:
Typowe nagłówki żądań
| Nagłówek żądania | Opis |
|---|---|
Authorization |
Wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage. |
Date lub x-ms-date |
Wymagane. Określa uniwersalny czas koordynowany (UTC) dla żądania. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage. |
x-ms-version |
Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Ta operacja jest obsługiwana w wersji 2019-02-02 i nowszych dla udziałów plików z włączonym protokołem SMB i obsługiwana w wersji 2025-05-05 i nowszych dla udziałów plików z włączonym protokołem NFS. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji dla usług Azure Storage. |
x-ms-copy-source:name |
Wymagane. Określa adres URL pliku źródłowego. Wartość może być adresem URL o długości do 2 KiB, który określa plik. Wartość powinna być zakodowana w adresie URL, tak jak w identyfikatorze URI żądania. Plik źródłowy musi być publiczny lub musi być autoryzowany za pośrednictwem sygnatury dostępu współdzielonego. Jeśli plik źródłowy jest publiczny, nie jest wymagana autoryzacja do wykonania operacji. Oto kilka przykładów adresów URL obiektów źródłowych:
|
x-ms-copy-source-authorization: <scheme> <signature> |
Fakultatywny. Określa schemat autoryzacji i podpis dla źródła kopii. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage. Tylko element nośny schematu jest obsługiwany dla firmy Microsoft Entra. Ten nagłówek jest obsługiwany w wersji 2020-10-02 lub nowszej. |
x-ms-write: { update } |
Wymagane. Musisz określić tylko update. Żądanie kończy się niepowodzeniem, jeśli jest wywoływane z clear. Wartość update zapisuje bajty określone przez treść żądania do określonych zakresów. |
Range lub x-ms-range |
Wymagane. Wymagana jest Range lub x-ms-range.Określa zakres bajtów do zapisania. Należy określić zarówno początek, jak i koniec zakresu. Ten nagłówek jest definiowany przez specyfikację protokołu HTTP/1.1 . W przypadku operacji aktualizacji zakres może mieć rozmiar do 4 miB. Usługa Azure Files akceptuje tylko jeden zakres bajtów dla nagłówków Range i x-ms-range, a zakres bajtów musi być określony w następującym formacie: bytes=startByte-endByte.Jeśli określono zarówno Range, jak i x-ms-range, usługa używa wartości x-ms-range. Aby uzyskać więcej informacji, zobacz Określanie nagłówka zakresu dla operacji usługi Azure Files. |
x-ms-source-range |
Wymagane. Określa zakres bajtów do odczytu ze źródła. Należy określić zarówno początek, jak i koniec zakresu. Usługa Azure Files akceptuje tylko jeden zakres bajtów dla nagłówków Range i x-ms-range, a zakres bajtów musi być określony w następującym formacie: bytes=startByte-endByte.Zakres źródłowy może mieć rozmiar do 4 MiB. Jeśli rozmiar zakresu źródłowego przekracza 4 MiB, usługa Azure Files zwraca kod stanu 413 (Jednostka żądania jest zbyt duża). Jeśli rozmiar zakresu źródłowego nie jest zgodny z rozmiarem zakresu (zakres docelowy), usługa zwraca kod stanu 400 (nieprawidłowe żądanie). |
Content-Length |
Wymagane. Określa liczbę bajtów przesyłanych w treści żądania. Wartość tego nagłówka musi być ustawiona na wartość 0. Jeśli długość nie jest 0, operacja kończy się niepowodzeniem z kodem stanu 400 (Nieprawidłowe żądanie). |
x-ms-client-request-id |
Fakultatywny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitor Azure Files. |
x-ms-source-content-crc64 |
Fakultatywny. Skrót CRC64 określonego zakresu z identyfikatora URI. Ten skrót służy do weryfikowania integralności zakresu podczas transportu danych z identyfikatora URI. Po określeniu tego nagłówka usługa Azure Files porównuje skrót zawartości pochodzącej ze źródła kopiowania z tą wartością nagłówka. Uwaga: ten skrót CRC64 nie jest przechowywany w pliku. Jeśli dwa skróty nie są zgodne, operacja kończy się niepowodzeniem z kodem błędu 400 (Nieprawidłowe żądanie). |
x-ms-source-if-match-crc64 |
Fakultatywny. Wartość sumy kontrolnej CRC64. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy suma kontrolna danego zakresu odczytanego ze źródła jest zgodna z podaną sumą kontrolną. Jeśli określony warunek nie zostanie spełniony, usługa Azure Files zwróci kod stanu 412 (Niepowodzenie warunku wstępnego). |
x-ms-source-if-none-match-crc64 |
Fakultatywny. Wartość sumy kontrolnej CRC64. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy suma kontrolna danego zakresu odczytanego ze źródła różni się od podanej sumy kontrolnej. Jeśli określony warunek nie zostanie spełniony, usługa Azure Files zwróci kod stanu 412 (Niepowodzenie warunku wstępnego). |
x-ms-lease-id: <ID> |
Wymagane, jeśli plik ma aktywną dzierżawę. Dostępne dla wersji 2019-02-02 lub nowszej. Ten nagłówek jest ignorowany, jeśli plik znajduje się w udziale plików z włączonym protokołem NFS, który nie obsługuje dzierżaw plików. |
x-ms-client-request-id |
Fakultatywny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach analitycznych po włączeniu rejestrowania usługi Azure Storage Analytics. Zdecydowanie zalecamy używanie tego nagłówka podczas korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitor Blob Storage. |
x-ms-file-last-write-time: { now ¦ preserve } |
Fakultatywny. Wersja 2021-06-08 lub nowsza. Możesz określić jedną z następujących opcji:
|
x-ms-file-request-intent |
Wymagane, jeśli nagłówek Authorization określa token OAuth. Akceptowalna wartość to backup. Ten nagłówek określa, że Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action lub Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action należy przyznać, jeśli są one uwzględnione w zasadach RBAC przypisanych do tożsamości autoryzowanej przy użyciu nagłówka Authorization. Dostępne dla wersji 2022-11-02 lub nowszej. |
x-ms-allow-trailing-dot: { <Boolean> } |
Fakultatywny. Wersja 2022-11-02 lub nowsza. Wartość logiczna określa, czy końcowa kropka obecna w adresie URL żądania powinna zostać przycięta, czy nie. Ten nagłówek jest ignorowany, jeśli element docelowy znajduje się w udziale plików z włączonym protokołem NFS, który domyślnie obsługuje kropkę końcową. Aby uzyskać więcej informacji, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Fakultatywny. Wersja 2022-11-02 lub nowsza. Wartość logiczna określa, czy końcowa kropka obecna w źródłowym adresie URL powinna być przycinana, czy nie. Ten nagłówek powinien być określony tylko wtedy, gdy źródło kopiowania znajduje się w udziale plików platformy Azure. Ten nagłówek nie jest obsługiwany dla żadnego innego typu źródła kopiowania. Ten nagłówek jest ignorowany, jeśli źródło kopiowania znajduje się w udziale plików z włączonym protokołem NFS, który domyślnie obsługuje kropkę końcową. Aby uzyskać więcej informacji, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych. |
Tylko nagłówki żądań protokołu SMB
Żaden.
Nagłówki żądań NFS
Żaden.
Treść żądania
Brak treści żądania.
Przykładowe żądanie
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/mydir/myfile?comp=range HTTP/1.1
Request Headers:
x-ms-page-write: update
x-ms-copy-source: http://myaccount2.file.core.windows.net/myshare2/mydirectory2/myfile2?sv=2018-11-09&sp=r&sr=s&se=2018-08-22T09%3A59%3A28.2185790Z&sig=Qn6QEET3Gn%2FhCEVcXuwG7ssatIYiYRM5pNIy4Q3N0cQ%3D
x-ms-date: Fri, 22 Aug 2018 01:15:50 GMT
x-ms-version: 2019-02-02
x-ms-range: bytes=100-1023
x-ms-source-range: bytes=200-1123
x-ms-source-content-crc64: 3bedb8b3730fc205
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=
Content-Length: 0
Odpowiedź
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kod stanu
Pomyślna operacja zwraca kod stanu 201 (Utworzono). Aby uzyskać więcej informacji na temat kodów stanu, zobacz Stan i kody błędów.
Nagłówki odpowiedzi
Odpowiedź dla tej operacji zawiera nagłówki w poniższych tabelach. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1 .
Typowe nagłówki odpowiedzi
| Nagłówek odpowiedzi | Opis |
|---|---|
ETag |
Zawiera wartość, której można użyć do warunkowego wykonywania operacji. Wartość jest ujęta w cudzysłów. |
Last-Modified |
Data i godzina ostatniej modyfikacji pliku. Format daty jest zgodny z RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości daty/godziny w nagłówkach. Każda operacja zapisu w pliku, w tym aktualizacje metadanych lub właściwości pliku, zmienia czas ostatniej modyfikacji pliku. |
x-ms-request-id |
Unikatowo identyfikuje żądanie, które zostało wykonane, i można go użyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API. |
x-ms-version |
Wskazuje wersję interfejsu API FileREST, która została użyta do wykonania żądania. |
Date |
Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi. |
x-ms-content-crc64 |
Zwrócone w taki sposób, aby klient mógł sprawdzić integralność zawartości komunikatu. Wartość tego nagłówka jest obliczana przez usługę Azure Files. Nie musi być taka sama jak wartość określona w nagłówkach żądania. |
x-ms-client-request-id |
Może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka x-ms-client-request-id, jeśli znajduje się w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków ASCII. Jeśli nagłówek x-ms-client-request-id nie znajduje się w żądaniu, nie będzie on obecny w odpowiedzi. |
x-ms-file-last-write-time |
Wersja 2021-06-08 lub nowsza. Czas ostatniego zapisu dla pliku w formacie ISO 8601 (na przykład 2017-05-10T17:52:33.9551861Z). |
Tylko nagłówki odpowiedzi protokołu SMB
Żaden.
Nagłówki odpowiedzi tylko systemu plików NFS
Żaden.
Treść odpowiedzi
Żaden.
Przykładowa odpowiedź
Response Status:
HTTP/1.1 201 Created
Response Headers:
Date: Sun, 22 Aug 2020 01:33:35 GMT
ETag: "0x8CB171BA9E94B0B"
Last-Modified: Wed, 22 Aug 2020 01:13:31 GMT
x-ms-version: 2019-02-02
x-ms-content-crc64: 3bedb8b3730fc205
Content-Length: 0
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autoryzacja
Tylko właściciel konta może wywołać tę operację.
Uwagi
Operacja Put Range From URL zapisuje zakres danych w pliku i jest podobny do działania operacji Put Range. Używa Get File operacji na określonym źródle do odczytywania danych, metadanych i innych właściwości pliku źródłowego. W wersji 2020-10-02 lub nowszej autoryzacja firmy Microsoft Entra jest obsługiwana dla źródła operacji kopiowania.
Operacja Put Range From URL zwraca powodzenie 201 (Utworzono) tylko wtedy, gdy określony zakres jest zapisywany w pliku.
Zobacz też
Operacje na plikach