Path - Create

Tjänst:

Storage Services

API-version:

2023-08-03

Skapa fil | Skapa katalog | Byt namn på fil | Byt namn på katalog
Skapa eller byt namn på en fil eller katalog. Som standard skrivs målet över och om målet redan finns och har ett lån bryts lånet. Observera att det inte är tillåtet att byta namn på en fil eller katalog till en container med en tillämpad krypteringsprincip för containrar om inte källcontainern också har en tillämpad krypteringsprincip för containrar som matchar. Den här åtgärden stöder villkorsstyrda HTTP-begäranden. Mer information finns i Ange villkorsstyrda rubriker för Blob Service-åtgärder. Om du vill misslyckas om målet redan finns använder du en villkorlig begäran med If-None-Match: "*".

PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string	Namnet på Azure Storage-kontot.
dnsSuffix	path	True	string	DNS-suffixet för Azure Data Lake Storage-slutpunkten.
filesystem	path	True	string	Filsystemidentifieraren. Reguljärt uttrycksmönster: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path	path	True	string	Fil- eller katalogsökvägen.
continuation	query		string	Valfri. När du byter namn på en katalog begränsas antalet sökvägar som byts namn till varje anrop. Om antalet sökvägar som ska byta namn överskrider den här gränsen returneras en fortsättningstoken i det här svarshuvudet. När en fortsättningstoken returneras i svaret måste den anges i ett efterföljande anrop av namnbytesåtgärden för att fortsätta byta namn på katalogen.
mode	query		PathRenameMode	Valfri. Gäller endast när namnområdet är aktiverat. Den här parametern bestämmer beteendet för åtgärden byt namn. Värdet måste vara "äldre" eller "posix", och standardvärdet är "posix".
resource	query		PathResourceType	Krävs endast för Skapa fil och Skapa katalog. Värdet måste vara "file" eller "directory".
timeout	query		integer int32	Ett valfritt timeout-värde för åtgärden i sekunder. Perioden börjar när begäran tas emot av tjänsten. Om tidsgränsvärdet förflutit innan åtgärden slutförs misslyckas åtgärden.

Begärandehuvud

Media Types: "application/octet-stream"

Name	Obligatorisk	Typ	Description
Cache-Control		string	Valfri. Tjänsten lagrar det här värdet och innehåller det i svarshuvudet "Cache-Control" för "Läs fil"-åtgärder för "Läs fil"-åtgärder.
Content-Encoding		string	Valfri. Anger vilka innehållskodningar som har tillämpats på filen. Det här värdet returneras till klienten när åtgärden "Läs fil" utförs.
Content-Language		string	Valfri. Anger det naturliga språk som används av den avsedda målgruppen för filen.
Content-Disposition		string	Valfri. Tjänsten lagrar det här värdet och innehåller det i svarshuvudet "Content-Disposition" för "Läs fil"-åtgärder.
x-ms-cache-control		string	Valfri. Tjänsten lagrar det här värdet och innehåller det i svarshuvudet "Cache-Control" för "Läs fil"-åtgärder.
x-ms-content-type		string	Valfri. Tjänsten lagrar det här värdet och inkluderar det i svarshuvudet "Innehållstyp" för "Läs fil"-åtgärder.
x-ms-content-encoding		string	Valfri. Tjänsten lagrar det här värdet och innehåller det i svarshuvudet "Content-Encoding" för "Läs fil"-åtgärder.
x-ms-content-language		string	Valfri. Tjänsten lagrar det här värdet och innehåller det i svarshuvudet "Content-Language" för "Läs fil"-åtgärder.
x-ms-content-disposition		string	Valfri. Tjänsten lagrar det här värdet och innehåller det i svarshuvudet "Content-Disposition" för "Läs fil"-åtgärder.
x-ms-rename-source		string	En valfri fil eller katalog som ska byta namn. Värdet måste ha följande format: "/{filesystem}/{path}", eller "/{filesystem}/{path}?sastoken" när du använder en SAS-token. Om "x-ms-properties" anges skriver egenskaperna över de befintliga egenskaperna. annars bevaras de befintliga egenskaperna. Det här värdet måste vara en URL-procentkodad sträng. Observera att strängen bara får innehålla ASCII-tecken i teckenuppsättningen ISO-8859-1.
x-ms-lease-id		string	Valfri. Ett låne-ID för sökvägen som anges i URI:n. Sökvägen som ska skrivas över måste ha ett aktivt lån och låne-ID:t måste matcha. Reguljärt uttrycksmönster: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-source-lease-id		string	Valfritt för att byta namn på åtgärder. Ett låne-ID för källsökvägen. Källsökvägen måste ha ett aktivt lån och låne-ID:t måste matcha. Reguljärt uttrycksmönster: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-properties		string	Valfri. Användardefinierade egenskaper som ska lagras med filen eller katalogen, i formatet för en kommaavgränsad lista med namn- och värdepar "n1=v1, n2=v2, ...", där varje värde är en base64-kodad sträng. Observera att strängen bara får innehålla ASCII-tecken i teckenuppsättningen ISO-8859-1.
x-ms-permissions		string	Valfritt och endast giltigt om hierarkiskt namnområde är aktiverat för kontot. Anger POSIX-åtkomstbehörigheter för filägaren, filägargruppen och andra. Varje klass kan beviljas läsbehörighet (4), skrivbehörighet (2) eller köra (1). Både symbolisk (rwxrw-rw-) och 4-siffrig oktal notation (t.ex. 0766) stöds. Den klibbiga biten stöds också och i symbolisk notation, representeras den antingen av bokstaven t eller T på den slutliga teckenplatsen beroende på om körningsbiten för den andra kategorin anges respektive tas bort (t.ex. rwxrw-rw- med fästbit representeras som rwxrw-rwT. En rwxrw-rwx med klibbig bit representeras som rwxrw-rwt), frånvaro av t eller T indikerar att klibbig bit inte har angetts. I 4-siffrig oktal notation representerar dess med en siffra (t.ex. 1766 representerar rwxrw-rw- med klibbig bit och 0766 representerar rwxrw-rw- utan klibbig bit). Ogiltigt tillsammans med x-ms-acl.
x-ms-umask		string	Valfritt och endast giltigt om hierarkiskt namnområde är aktiverat för kontot. När du skapar en fil eller katalog och den överordnade mappen inte har någon standard-ACL, begränsar umask behörigheterna för filen eller katalogen som ska skapas. Den resulterande behörigheten ges av p & ^u, där p är behörigheten och du är umask. Om p till exempel är 0777 och du är 0057 är den resulterande behörigheten 0720. Standardbehörigheten är 0777 för en katalog och 0666 för en fil. Standard-umask är 0027. Umasken måste anges i en 4-siffrig oktal notation (t.ex. 0766).
x-ms-owner		string	Valfritt och endast giltigt om hierarkiskt namnområde är aktiverat för kontot. Anger ägaren till filen eller katalogen.
x-ms-group		string	Valfritt och endast giltigt om hierarkiskt namnområde är aktiverat för kontot. Anger den ägande gruppen för filen eller katalogen.
x-ms-acl		string	Valfritt och endast giltigt om hierarkiskt namnområde är aktiverat för kontot. Anger behörigheter för POSIX-åtkomstkontroll för filer och kataloger. Varje åtkomstkontrollpost (ACE) består av ett omfång, en typ, en användare eller gruppidentifierare och behörigheter i formatet "[scope:][type]:[id]:[permissions]". Omfånget måste vara "standard" för att ange att ACE tillhör standard-ACL:en för en katalog. annars är omfånget implicit och ACE tillhör åtkomst-ACL:en. Det finns fyra ACE-typer: "användare" beviljar rättigheter till ägaren eller en namngiven användare, "grupp" beviljar rättigheter till den ägande gruppen eller en namngiven grupp, "mask" begränsar rättigheter som beviljas till namngivna användare och medlemmar i grupper, och "andra" ger rättigheter till alla användare som inte finns i någon av de andra posterna. Användaren eller gruppidentifieraren utelämnas för poster av typen "mask" och "other". Användaren eller gruppidentifieraren utelämnas också för ägaren och ägande gruppen. Behörighetsfältet är en sekvens på 3 tecken där det första tecknet är "r" för att bevilja läsåtkomst, det andra tecknet är "w" för att bevilja skrivåtkomst och det tredje tecknet är "x" för att bevilja körningsbehörighet. Om åtkomst inte beviljas används tecknet "-" för att ange att behörigheten nekas. Följande ACL beviljar till exempel läs-, skriv- och körningsrättigheter till filägaren och john.doe@contoso, läsbehörigheten till ägande gruppen och ingenting till alla andra: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Ogiltigt tillsammans med x-ms-permissions.
x-ms-proposed-lease-id		string	Valfri. Ange ett föreslaget låne-ID om du vill skaffa ett lån när du skapar en fil eller katalog. Ett lån hämtas med det här låne-ID:t om skapandet lyckas. Reguljärt uttrycksmönster: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-expiry-option		string	Valfritt och endast giltigt om hierarkiskt namnområde är aktiverat för kontot och endast stöds för filer. Ange något av följande utgångsalternativ om du vill ange förfallotid för en fil när du skapar den. "RelativeToNow" Ange förfallodatum i förhållande till den aktuella tiden. Användaren skickar antalet millisekunder som förflutit från och med nu. Absolut absolut tid i RFC 1123-format. "Neverexpire" Ange att filen aldrig ska upphöra att gälla, förfallotiden behöver inte anges med det här alternativet.
x-ms-expiry-time		string	Valfritt och endast giltigt om hierarkiskt namnområde är aktiverat för kontot och endast stöds för filer. Ange förfallotiden när filen ska upphöra att gälla. Anges som RFC 1123 HTTP-tidssträng eller antal millisekunder enligt alternativet för förfallodatum.
If-Match		string	Valfri. Ett ETag-värde. Ange det här huvudet för att utföra åtgärden endast om resursens ETag matchar det angivna värdet. ETag måste anges inom citattecken.
If-None-Match		string	Valfri. Ett ETag-värde eller ett särskilt jokerteckenvärde ("*"). Ange det här huvudet för att utföra åtgärden endast om resursens ETag inte matchar det angivna värdet. ETag måste anges inom citattecken.
If-Modified-Since		string	Valfri. Ett datum- och tidsvärde. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan det angivna datumet och tiden.
If-Unmodified-Since		string	Valfri. Ett datum- och tidsvärde. Ange det här huvudet för att utföra åtgärden endast om resursen inte har ändrats sedan det angivna datumet och tiden.
x-ms-source-if-match		string	Valfri. Ett ETag-värde. Ange den här rubriken för att endast utföra åtgärden byt namn om källans ETag matchar det angivna värdet. ETag måste anges inom citattecken.
x-ms-source-if-none-match		string	Valfri. Ett ETag-värde eller ett särskilt jokerteckenvärde ("*"). Ange den här rubriken för att endast utföra åtgärden byt namn om källans ETag inte matchar det angivna värdet. ETag måste anges inom citattecken.
x-ms-source-if-modified-since		string	Valfri. Ett datum- och tidsvärde. Ange det här huvudet för att endast utföra åtgärden byt namn om källan har ändrats sedan det angivna datumet och tiden.
x-ms-source-if-unmodified-since		string	Valfri. Ett datum- och tidsvärde. Ange den här rubriken för att endast utföra åtgärden byt namn om källan inte har ändrats sedan det angivna datumet och tiden.
x-ms-encryption-key		string	Valfri. Den Base64-kodade AES-256-krypteringsnyckeln.
x-ms-encryption-key-sha256		string	Valfri. Den Base64-kodade SHA256-hashen för krypteringsnyckeln.
x-ms-encryption-algorithm: AES256		string	Valfri. Anger den algoritm som ska användas för kryptering. Värdet för det här huvudet måste vara AES256.
x-ms-encryption-context		string	Valfri. Standardvärdet är "Tom". Om värdet anges anges blob-/filsystemmetadata. Max längd- 1024. Gäller endast när hierarkiskt namnområde är aktiverat för kontot.
x-ms-client-transaction-id		string	Valfri. Standardvärdet är "Tom". Om värdet anges kommer blobmetadata att anges för filskapande eller namnbyte. Om begäran överskrider tidsgränsen för klienten kan det här värdet hämtas med hjälp av anropet Hämta egenskaper för att bekräfta om tidsgränsbegäran hade lyckats eller inte i tjänstens slut. Max längd- 36. Gäller endast när hierarkiskt namnområde är aktiverat för kontot.
x-ms-client-request-id		string	Ett UUID som registrerats i analysloggarna för felsökning och korrelation. Reguljärt uttrycksmönster: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-date		string	Anger UTC (Coordinated Universal Time) för begäran. Detta krävs när du använder auktorisering av delad nyckel.
x-ms-version		string	Anger den version av REST-protokollet som används för bearbetning av begäran. Detta krävs när du använder auktorisering av delad nyckel.

Svar

Name	Typ	Description
201 Created		Filen eller katalogen skapades. Sidhuvuden Date: string ETag: string Last-Modified: string x-ms-request-id: string x-ms-version: string x-ms-continuation: string Content-Length: integer x-ms-request-server-encrypted: true/false: boolean x-ms-encryption-key-sha256: string x-ms-encryption-scope: string
Other Status Codes	DataLakeStorageError	Ett fel uppstod. De möjliga HTTP-status-, kod- och meddelandesträngarna visas nedan: 400 Felaktig begäran, ContentLengthMustBeZero, "Rubriken för innehållslängdsbegäran måste vara noll". 400 Felaktig begäran, InvalidAuthenticationInfo, "Autentiseringsinformation ges inte i rätt format. Kontrollera värdet för auktoriseringshuvud." 400 Felaktig begäran, InvalidFlushPosition, "De uppladdade data är inte sammanhängande eller värdet för frågeparametern position är inte lika med längden på filen efter att de uppladdade data har lagts till." 400 Felaktig begäran, InvalidHeaderValue, "Värdet för en av HTTP-huvudena är inte i rätt format." 400 Felaktig begäran, InvalidHttpVerb, "Det angivna HTTP-verbet är ogiltigt – det känns inte igen av servern." 400 Felaktig begäran, InvalidInput, "En av indata för begäran är inte giltig." 400 Felaktig begäran, InvalidPropertyName, "Ett egenskapsnamn får inte vara tomt". 400 Felaktig begäran, InvalidPropertyName, "Egenskapsnamnet innehåller ogiltiga tecken". 400 Felaktig begäran, InvalidQueryParameterValue, "Värdet för en av frågeparametrarna som anges i begärande-URI:n är ogiltigt". 400 Felaktig begäran, InvalidResourceName, "Det angivna resursnamnet innehåller ogiltiga tecken". 400 Felaktig begäran, InvalidSourceUri, "Käll-URI:n är ogiltig". 400 Felaktig begäran, InvalidUri, "Begärande-URI:n är ogiltig". 400 Felaktig begäran, MissingRequiredHeader, "Ett HTTP-huvud som är obligatoriskt för den här begäran har inte angetts." 400 Felaktig begäran, MissingRequiredQueryParameter, "En frågeparameter som är obligatorisk för den här begäran har inte angetts." 400 Felaktig begäran, MultipleConditionHeadersNotSupported, "Flera villkorsrubriker stöds inte." 400 Felaktig begäran, OutOfRangeInput, "En av indata för begäran är utom räckhåll." 400 Bad Request, OutOfRangeQueryParameterValue, "En av frågeparametrarna som anges i begärande-URI:n ligger utanför det tillåtna intervallet." 400 Felaktig begäran, UnsupportedHeader, "En av de huvuden som anges i begäran stöds inte." 400 Bad Request, UnsupportedQueryParameter, "En av frågeparametrarna som anges i begärande-URI:n stöds inte." 400 Bad Request, UnsupportedRestVersion, "Den angivna restversionen stöds inte.". 403 Förbjudet, AccountIsDisabled, "Det angivna kontot är inaktiverat". 403 Förbjudet, AuthorizationFailure, "Denna begäran har inte behörighet att utföra den här åtgärden." 403 Förbjudet, InsufficientAccountPermissions, "Kontot som används har inte tillräcklig behörighet för att köra den här åtgärden." 404 Hittades inte, FilesystemNotFound, "Det angivna filsystemet finns inte." 404 Hittades inte, PathNotFound, "Den angivna sökvägen finns inte." 404 Hittades inte, RenameDestinationParentPathNotFound, "Målsökvägens överordnade katalog finns inte." 404 Hittades inte, ResourceNotFound, "Den angivna resursen finns inte." 404 Hittades inte, SourcePathNotFound, "Källsökvägen för en namnbytesåtgärd finns inte." 405-metoden är inte tillåten, stöds inteHttpVerb, "Resursen stöder inte det angivna HTTP-verbet." 409 Conflict, DestinationPathIsBeingDeleted, "Den angivna målsökvägen har markerats som borttagen". 409 Conflict, DirectoryNotEmpty, "Det rekursiva frågeparametervärdet måste vara sant för att ta bort en icke-tom katalog." 409 Conflict, FilesystemAlreadyExists, "Det angivna filsystemet finns redan." 409 Conflict, FilesystemBeingDeleted, "Det angivna filsystemet tas bort". 409 Conflict, InvalidDestinationPath, "Den angivna sökvägen eller ett element i sökvägen finns och dess resurstyp är ogiltig för den här åtgärden." * 409 Conflict, InvalidFlushOperation, "Resursen skapades eller ändrades av Blob Service API och kan inte skrivas till av Data Lake Storage Service API." 409 Conflict, InvalidRenameSourcePath, "Källkatalogen får inte vara samma som målkatalogen och inte heller kan målet vara en underkatalog till källkatalogen." 409 Conflict, InvalidSourceOrDestinationResourceType, "Käll- och målresurstypen måste vara identisk." 409 Konflikt, LeaseAlreadyPresent, "Det finns redan ett lån finns." 409 Conflict, LeaseIdMismatchWithLeaseOperation, "Det angivna låne-ID:t matchade inte låne-ID:t för resursen med den angivna låneåtgärden." 409 Conflict, LeaseIsAlreadyBroken, "Lånet har redan brutits och kan inte brytas igen." 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "Låne-ID:t matchade, men lånet är för närvarande i ett icke-bakåtkompatibelt tillstånd och kan inte förvärvas förrän det har brutits." 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "Låne-ID:t matchade, men lånet är för närvarande i icke-bakåtkompatibelt tillstånd och kan inte ändras." 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "Låne-ID:t matchade, men lånet har brutits explicit och kan inte förnyas." 409 Konflikt, LeaseNameMismatch, "Det angivna lånenamnet matchade inte det befintliga lånenamnet." 409 Conflict, LeaseNotPresentWithLeaseOperation, "Låne-ID:t finns inte med den angivna låneåtgärden." 409 Conflict, PathAlreadyExists, "Den angivna sökvägen finns redan". 409 Konflikt, PathConflict, "Den angivna sökvägen eller ett element i sökvägen finns och dess resurstyp är ogiltig för den här åtgärden." 409 Conflict, SourcePathIsBeingDeleted, "Den angivna källsökvägen har markerats som borttagen". 409 Conflict, ResourceTypeMismatch, "Resurstypen som anges i begäran matchar inte resurstypen." 412 Förutsättningen misslyckades, ConditionNotMet, "Villkoret som anges med http-villkorliga huvuden är inte uppfyllt." 412 Förutsättningen misslyckades, LeaseIdMismatch, "Det angivna låne-ID:t matchade inte låne-ID:t för resursen." 412 Förutsättningen misslyckades, LeaseIdMissing, "Det finns för närvarande ett lån på resursen och inget låne-ID angavs i begäran." 412 Förutsättningen misslyckades, LeaseNotPresent, "Det finns för närvarande inget lån på resursen." 412 Förutsättningen misslyckades, LeaseLost, "Ett låne-ID har angetts, men lånet för resursen har upphört att gälla." 412 Förutsättningen misslyckades, SourceConditionNotMet, "Det källvillkor som anges med http-villkorshuvuden uppfylls inte." 413 Begärandeentiteten är för stor, RequestBodyTooLarge, "Begärandetexten är för stor och överskrider den maximala tillåtna gränsen." 416 Begärt intervall inte uppfyllt, InvalidRange, "Det angivna intervallet är ogiltigt för resursens aktuella storlek." 500 Internt serverfel, InternalError, "Servern påträffade ett internt fel. Försök igen." 500 Internt serverfel, OperationTimedOut, "Åtgärden kunde inte slutföras inom den tillåtna tiden." 503 Tjänsten är inte tillgänglig, ServerBusy, "Utgående trafik överskrider kontogränsen." 503 Tjänsten är inte tillgänglig, ServerBusy, "Ingress är över kontogränsen." 503 Tjänsten är inte tillgänglig, ServerBusy, "Åtgärder per sekund överskrider kontogränsen." 503 Tjänsten är inte tillgänglig, ServerBusy, "Servern kan för närvarande inte ta emot begäranden. Försök igen." Sidhuvuden x-ms-request-id: string x-ms-version: string

Definitioner

Name	Description
DataLakeStorageError
Error	Tjänstens felsvarsobjekt.
PathRenameMode	Valfri. Gäller endast när namnområdet är aktiverat. Den här parametern bestämmer beteendet för åtgärden byt namn. Värdet måste vara "äldre" eller "posix", och standardvärdet är "posix".
PathResourceType	Krävs endast för Skapa fil och Skapa katalog. Värdet måste vara "file" eller "directory".

DataLakeStorageError

Name	Typ	Description
error	Error	Tjänstens felsvarsobjekt.

Error

Tjänstens felsvarsobjekt.

Name	Typ	Description
code	string	Felkoden för tjänsten.
message	string	Tjänstens felmeddelande.

PathRenameMode

Valfri. Gäller endast när namnområdet är aktiverat. Den här parametern bestämmer beteendet för åtgärden byt namn. Värdet måste vara "äldre" eller "posix", och standardvärdet är "posix".

Name	Typ	Description
legacy	string
posix	string

PathResourceType

Krävs endast för Skapa fil och Skapa katalog. Värdet måste vara "file" eller "directory".

Name	Typ	Description
directory	string
file	string