Path - Create

Utwórz plik | Tworzenie katalogu | Zmień nazwę pliku | Zmień nazwę katalogu
Tworzenie lub zmienianie nazwy pliku lub katalogu. Domyślnie miejsce docelowe jest zastępowane, a jeśli miejsce docelowe już istnieje i ma dzierżawę, dzierżawa jest przerwana. Ta operacja obsługuje warunkowe żądania HTTP. Aby uzyskać więcej informacji, zobacz Określanie nagłówków warunkowych dla operacji usługi obiektów blob. Aby zakończyć się niepowodzeniem, jeśli miejsce docelowe już istnieje, należy użyć żądania warunkowego z If-None-Match: "*".

PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}

Parametry identyfikatora URI

Name In Required Type Description
accountName
path True
  • string

Nazwa konta usługi Azure Storage.

dnsSuffix
path True
  • string

Sufiks DNS punktu końcowego usługi Azure Data Lake Storage.

filesystem
path True
  • string

Identyfikator systemu plików.

Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$

path
path True
  • string

Ścieżka pliku lub katalogu.

continuation
query
  • string

Element opcjonalny. Podczas zmiany nazwy katalogu liczba ścieżek, których nazwy są zmieniane przy każdym wywołaniu, jest ograniczona. Jeśli liczba ścieżek, które mają zostać zmienione przekracza ten limit, token kontynuacji jest zwracany w tym nagłówku odpowiedzi. Gdy token kontynuacji jest zwracany w odpowiedzi, musi być określony w kolejnym wywołaniu operacji zmiany nazwy, aby kontynuować zmianę nazwy katalogu.

mode
query

Element opcjonalny. Prawidłowe tylko wtedy, gdy obszar nazw jest włączony. Ten parametr określa zachowanie operacji zmiany nazwy. Wartość musi być "legacy" lub "posix", a wartość domyślna to "posix".

resource
query

Wymagane tylko dla tworzenia pliku i tworzenia katalogu. Wartość musi być "plik" lub "katalog".

timeout
query
  • integer
int32

Opcjonalna wartość limitu czasu operacji w sekundach. Okres rozpoczyna się, gdy żądanie jest odbierane przez usługę. Jeśli wartość limitu czasu upłynie przed zakończeniem operacji, operacja zakończy się niepowodzeniem.

Nagłówek żądania

Media Types: "application/octet-stream"

Name Required Type Description
Cache-Control
  • string

Element opcjonalny. Usługa przechowuje tę wartość i zawiera ją w nagłówku odpowiedzi "Kontrola pamięci podręcznej" dla operacji "Odczyt pliku" dla operacji "Odczyt pliku".

Content-Encoding
  • string

Element opcjonalny. Określa, które kodowanie zawartości zostało zastosowane do pliku. Ta wartość jest zwracana do klienta po wykonaniu operacji "Odczyt pliku".

Content-Language
  • string

Element opcjonalny. Określa język naturalny używany przez odbiorców przeznaczonych dla pliku.

Content-Disposition
  • string

Element opcjonalny. Usługa przechowuje tę wartość i zawiera ją w nagłówku odpowiedzi "Dyspozycja zawartości" dla operacji "Odczyt pliku".

x-ms-cache-control
  • string

Element opcjonalny. Usługa przechowuje tę wartość i zawiera ją w nagłówku odpowiedzi "Kontrola pamięci podręcznej" dla operacji "Odczyt pliku".

x-ms-content-type
  • string

Element opcjonalny. Usługa przechowuje tę wartość i zawiera ją w nagłówku odpowiedzi "Typ zawartości" dla operacji "Odczyt pliku".

x-ms-content-encoding
  • string

Element opcjonalny. Usługa przechowuje tę wartość i zawiera ją w nagłówku odpowiedzi "Kodowanie zawartości" dla operacji "Odczyt pliku".

x-ms-content-language
  • string

Element opcjonalny. Usługa przechowuje tę wartość i zawiera ją w nagłówku odpowiedzi "Język zawartości" dla operacji "Odczyt pliku".

x-ms-content-disposition
  • string

Element opcjonalny. Usługa przechowuje tę wartość i zawiera ją w nagłówku odpowiedzi "Dyspozycja zawartości" dla operacji "Odczyt pliku".

x-ms-rename-source
  • string

Opcjonalny plik lub katalog, który ma zostać zmieniony. Wartość musi mieć następujący format: "/{filesystem}/{path}". Jeśli określono "x-ms-properties", właściwości zastąpią istniejące właściwości; w przeciwnym razie istniejące właściwości zostaną zachowane. Ta wartość musi być ciągiem zakodowanym w procentach adresu URL. Należy zauważyć, że ciąg może zawierać tylko znaki ASCII w zestawie znaków ISO-8859-1.

x-ms-lease-id
  • string

Element opcjonalny. Identyfikator dzierżawy dla ścieżki określonej w identyfikatorze URI. Ścieżka, która ma zostać zastąpiona, musi mieć aktywną dzierżawę, a identyfikator dzierżawy musi być zgodny.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-source-lease-id
  • string

Opcjonalnie dla operacji zmiany nazwy. Identyfikator dzierżawy dla ścieżki źródłowej. Ścieżka źródłowsza musi mieć aktywną dzierżawę, a identyfikator dzierżawy musi być zgodny.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-properties
  • string

Element opcjonalny. Właściwości zdefiniowane przez użytkownika, które mają być przechowywane w pliku lub katalogu, w formacie listy par nazw i wartości oddzielonych przecinkami "n1=v1, n2=v2, ...", gdzie każda wartość jest ciągiem zakodowanym base64. Należy zauważyć, że ciąg może zawierać tylko znaki ASCII w zestawie znaków ISO-8859-1.

x-ms-permissions
  • string

Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczny obszar nazw jest włączony dla konta. Ustawia uprawnienia dostępu POSIX dla właściciela pliku, grupy właściciela pliku i innych. Każda klasa może mieć uprawnienia do odczytu, zapisu lub wykonywania. Lepki bit jest również obsługiwany. Obsługiwane są zarówno wartości symboliczne (rwxrw-rw-), jak i 4-cyfrowe notacji ósemkowej (np. 0766).

x-ms-umask
  • string

Opcjonalne i prawidłowe tylko wtedy, gdy hierarchiczny obszar nazw jest włączony dla konta. Podczas tworzenia pliku lub katalogu, a folder nadrzędny nie ma domyślnej listy ACL, maska ogranicza uprawnienia do utworzenia pliku lub katalogu. Wynikowe uprawnienie jest udzielane przez p & ^u, gdzie p jest uprawnieniem, a ty jest umask. Na przykład jeśli p jest 0777 i jest 0057, a następnie wynikowe uprawnienie jest 0720. Domyślne uprawnienie to 0777 dla katalogu i 0666 dla pliku. Domyślna maska umask to 0027. Maska musi być określona w 4-cyfrowej notacji ósemkowej (np. 0766).

If-Match
  • string

Element opcjonalny. Wartość ETag. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy etag zasobu jest zgodny z określoną wartością. ETag musi być określony w cudzysłowie.

If-None-Match
  • string

Element opcjonalny. Wartość ETag lub wartość symbolu wieloznacznego ("*"). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy etag zasobu nie jest zgodny z określoną wartością. ETag musi być określony w cudzysłowie.

If-Modified-Since
  • string

Element opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonej daty i godziny.

If-Unmodified-Since
  • string

Element opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty i godziny.

x-ms-source-if-match
  • string

Element opcjonalny. Wartość ETag. Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy etag źródła jest zgodny z określoną wartością. ETag musi być określony w cudzysłowie.

x-ms-source-if-none-match
  • string

Element opcjonalny. Wartość ETag lub wartość symbolu wieloznacznego ("*"). Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy etag źródła nie jest zgodny z określoną wartością. ETag musi być określony w cudzysłowie.

x-ms-source-if-modified-since
  • string

Element opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy źródło zostało zmodyfikowane od określonej daty i godziny.

x-ms-source-if-unmodified-since
  • string

Element opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy źródło nie zostało zmodyfikowane od określonej daty i godziny.

x-ms-client-request-id
  • string

UUID rejestrowane w dziennikach analizy do rozwiązywania problemów i korelacji.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-date
  • string

Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Jest to wymagane podczas korzystania z autoryzacji klucza udostępnionego.

x-ms-version
  • string

Określa wersję protokołu REST używanego do przetwarzania żądania. Jest to wymagane podczas korzystania z autoryzacji klucza udostępnionego.

Odpowiedzi

Name Type Description
201 Created

Plik lub katalog został utworzony.

Headers

  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-continuation: string
  • Content-Length: integer
Other Status Codes

Wystąpił błąd. Poniżej wymieniono możliwy stan, kod i ciągi komunikatów HTTP:

  • 400 Bad Request, ContentLengthMustBeZero, "Nagłówek żądania długości zawartości musi wynosić zero."
  • 400 Bad Request, InvalidAuthenticationInfo, "Informacje o uwierzytelnianiu nie są podane w poprawnym formacie. Sprawdź wartość nagłówka Autoryzacja."
  • 400 Bad Request, InvalidFlushPosition, "Przekazane dane nie są ciągłe lub wartość parametru kwerendy pozycji nie jest równa długości pliku po dołączeniu przekazanych danych."
  • 400 Bad Request, InvalidHeaderValue, "Wartość jednego z nagłówków HTTP nie jest w poprawnym formacie."
  • 400 Bad Request, InvalidHttpVerb, "Określony zlecenie HTTP jest nieprawidłowy — nie jest rozpoznawany przez serwer."
  • 400 Bad Request, InvalidInput, "Jedno z danych wejściowych żądania jest nieprawidłowe."
  • 400 Bad Request, InvalidPropertyName, "Nazwa właściwości nie może być pusta."
  • 400 Bad Request, InvalidPropertyName, "Nazwa właściwości zawiera nieprawidłowe znaki."
  • 400 Bad Request, InvalidQueryParameterValue, "Wartość dla jednego z parametrów kwerendy określonych w identyfikatorze URI żądania jest nieprawidłowa."
  • 400 Bad Request, InvalidResourceName, "Określona nazwa zasobu zawiera nieprawidłowe znaki."
  • 400 Bad Request, InvalidSourceUri, "Źródłowy identyfikator URI jest nieprawidłowy."
  • 400 Bad Request, InvalidUri, "Identyfikator URI żądania jest nieprawidłowy."
  • 400 Bad Request, MissingRequiredHeader, "Nagłówek HTTP, który jest obowiązkowy dla tego żądania, nie jest określony."
  • 400 Bad Request, MissingRequiredQueryParameter, "Parametr zapytania, który jest obowiązkowy dla tego żądania, nie jest określony."
  • 400 Złe żądanie, MultipleConditionHeadersNotSupportowane, "Wiele nagłówków warunek nie są obsługiwane."
  • 400 Bad Request, OutOfRangeInput, "Jedno z danych wejściowych żądania jest poza zakresem."
  • 400 Bad Request, OutOfRangeQueryParameterValue, "Jeden z parametrów kwerendy określonych w identyfikatorze URI żądania jest poza dopuszczalnym zakresem."
  • 400 Bad Request, UnsupportedHeader, "Jeden z nagłówków określonych w żądaniu nie jest obsługiwany."
  • 400 Bad Request, UnsupportedQueryParameter, "Jeden z parametrów kwerendy określonych w identyfikatorze URI żądania nie jest obsługiwany."
  • 400 Bad Request, UnsupportedRestVersion, "Określona wersja reszta jest nieobsługiwała."
  • 403 Zabronione, AccountIsDisabled, "Określone konto jest wyłączone."
  • 403 Zabronione, AuthorizationFailure, "To żądanie nie jest upoważnione do wykonania tej operacji."
  • 403 Zabronione, InsufficientAccountPermissions, "Konto, do które uzyskuje się dostęp, nie ma wystarczających uprawnień do wykonania tej operacji."
  • 404 Nie znaleziono, FilesystemNotFound, "Określony system plików nie istnieje."
  • 404 Nie znaleziono, PathNotFound, "Określona ścieżka nie istnieje."
  • 404 Nie znaleziono, RenameDestinationParentPathNotFound, "Katalog nadrzędny ścieżki docelowej nie istnieje."
  • 404 Nie znaleziono, ResourceNotFound, "Określony zasób nie istnieje."
  • 404 Nie znaleziono, SourcePathNotFound, "Ścieżka źródłowa dla operacji zmiany nazwy nie istnieje."
  • 405 Metoda niedozwolona, nieobsługiwyhttpVerb, "Zasób nie obsługuje określonego zlecenia HTTP."
  • 409 Konflikt, DestinationPathIsBeingDeleted, "Określona ścieżka docelowa jest oznaczona do usunięcia."
  • 409 Konflikt, DirectoryNotEmpty, "Wartość parametru kwerendy cyklicznej musi być prawdziwa, aby usunąć niepusty katalog."
  • 409 Konflikt, FilesystemAlreadyExists, "Określony system plików już istnieje."
  • 409 Konflikt, FilesystemBeingDeleted, "Określony system plików jest usuwany."
  • 409 Konflikt, InvalidDestinationPath, "Określona ścieżka lub element ścieżki istnieje, a jej typ zasobu jest nieprawidłowy dla tej operacji." * Konflikt, InvalidFlushOperation, "Zasób został utworzony lub zmodyfikowany przez interfejs API usługi blob i nie mogą być zapisywane przez interfejs API usługi przechowywania danych Lake."
  • 409 Konflikt, InvalidRenameSourcePath, "Katalog źródłowy nie może być taki sam jak katalog docelowy, ani nie może być podkatalogiem katalogu źródłowego."
  • 409 Konflikt, InvalidSourceOrDestinationResourceType, "Typ zasobu źródłowego i docelowego musi być identyczny."
  • 409 Konflikt, LeaseAlreadyPresent, "Jest już obecny dzierżawy."
  • 409 Konflikt, LeaseIdMismatchWithLeaseOperation, "Określony identyfikator dzierżawy nie odpowiada identyfikatorowi dzierżawy zasobu z określoną operacją dzierżawy."
  • 409 Konflikt, LeaseIsAlreadyBroken, "Dzierżawa została już złamana i nie może być ponownie przerwana."
  • 409 Konflikt, LeaseIsBreakingAndCannotBeAcquired, "Identyfikator dzierżawy dopasowane, ale dzierżawa jest obecnie w stanie złamania i nie mogą być nabyte, dopóki nie zostanie złamany."
  • 409 Konflikt, LeaseIsBreakingAndCannotBeChanged, "Identyfikator dzierżawy dopasowane, ale dzierżawa jest obecnie w stanie złamania i nie można zmienić."
  • 409 Konflikt, LeaseIsBrokenAndCannotBeRenewed, "Identyfikator dzierżawy dopasowane, ale dzierżawa została złamana jawnie i nie można odnowić."
  • 409 Konflikt, LeaseNameMismatch, "Określona nazwa dzierżawy nie pasuje do istniejącej nazwy dzierżawy."
  • 409 Konflikt, LeaseNotPresentWithLeaseOperation, "Identyfikator dzierżawy nie jest obecny z określoną operacją dzierżawy."
  • 409 Konflikt, PathAlreadyExists, "Określona ścieżka już istnieje."
  • 409 Konflikt, PathConflict, "Określona ścieżka lub element ścieżki istnieje, a jej typ zasobu jest nieprawidłowy dla tej operacji."
  • 409 Konflikt, SourcePathIsBeingDeleted, "Określona ścieżka źródłowa jest oznaczona do usunięcia."
  • 409 Konflikt, ResourceTypeMismatch, "Typ zasobu określony w żądaniu nie jest zgodny z typem zasobu."
  • 412 Warunek wstępny nie powiódł się, ConditionNotMet, "Warunek określony przy użyciu nagłówków warunkowych HTTP nie jest spełniony."
  • 412 Warunek wstępny nie powiódł się, LeaseIdMismatch, "Określony identyfikator dzierżawy nie odpowiadał identyfikatorowi dzierżawy zasobu".
  • 412 Warunek wstępny nie powiodło się, LeaseIdMissing, "Obecnie istnieje dzierżawa zasobu i nie określono identyfikatora dzierżawy w żądaniu."
  • 412 Warunek wstępny nie powiódł się, LeaseNotPresent, "Obecnie nie ma dzierżawy zasobu."
  • 412 Warunek wstępny nie powiódł się, LeaseLost, "Określono identyfikator dzierżawy, ale dzierżawa zasobu wygasła."
  • 412 Warunek wstępny nie powiódł się, SourceConditionNotMet, "Warunek źródła określony przy użyciu nagłówków warunkowych HTTP nie jest spełniony."
  • 413 Żądaj jednostki zbyt duże, RequestBodyTooLarge, "Treść żądania jest zbyt duży i przekracza maksymalny dopuszczalny limit."
  • 416 Żądany zakres nie jest sycony, InvalidRange, "Określony zakres jest nieprawidłowy dla bieżącego rozmiaru zasobu."
  • 500 Wewnętrzny błąd serwera, InternalError, "Serwer napotkał błąd wewnętrzny. Ponów próbę złożenia wniosku."
  • 500 Wewnętrzny błąd serwera, OperationTimedOut, "Nie można ukończyć operacji w dozwolonym czasie."
  • 503 Usługa niedostępna, ServerBusy, "Wyjście przekracza limit konta."
  • 503 Usługa niedostępna, ServerBusy, "Ruch przychodzący przekracza limit konta."
  • 503 Usługa niedostępna, ServerBusy, "Operacje na sekundę przekracza limit konta."
  • 503 Usługa niedostępna, ServerBusy, "Serwer nie może obecnie odbierać żądań. Ponów próbę złożenia wniosku."

Headers

  • x-ms-request-id: string
  • x-ms-version: string

Definicje

DataLakeStorageError
Error

Obiekt odpowiedzi na błąd usługi.

PathRenameMode

Element opcjonalny. Prawidłowe tylko wtedy, gdy obszar nazw jest włączony. Ten parametr określa zachowanie operacji zmiany nazwy. Wartość musi być "legacy" lub "posix", a wartość domyślna to "posix".

PathResourceType

Wymagane tylko dla tworzenia pliku i tworzenia katalogu. Wartość musi być "plik" lub "katalog".

DataLakeStorageError

Name Type Description
error

Obiekt odpowiedzi na błąd usługi.

Error

Obiekt odpowiedzi na błąd usługi.

Name Type Description
code
  • string

Kod błędu usługi.

message
  • string

Komunikat o błędzie usługi.

PathRenameMode

Element opcjonalny. Prawidłowe tylko wtedy, gdy obszar nazw jest włączony. Ten parametr określa zachowanie operacji zmiany nazwy. Wartość musi być "legacy" lub "posix", a wartość domyślna to "posix".

Name Type Description
legacy
  • string
posix
  • string

PathResourceType

Wymagane tylko dla tworzenia pliku i tworzenia katalogu. Wartość musi być "plik" lub "katalog".

Name Type Description
directory
  • string
file
  • string