Path - Create
Bestand maken | Map maken | Naam van bestand wijzigen | Mapnaam wijzigen
Maak of wijzig de naam van een bestand of map. Standaard wordt de bestemming overschreven en als de bestemming al bestaat en een lease heeft, wordt de lease verbroken. Houd er rekening mee dat het wijzigen van de naam van een bestand of map in een container met een afgedwongen containerversleutelingsbeleid niet is toegestaan, tenzij de broncontainer ook een afgedwongen containerversleutelingsbeleid heeft dat overeenkomt. Deze bewerking ondersteunt voorwaardelijke HTTP-aanvragen. Zie Voorwaardelijke headers opgeven voor blobservicebewerkingenvoor meer informatie. Als de bestemming al bestaat, gebruikt u een voorwaardelijke aanvraag met If-None-Match: "*".
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
De naam van het Azure Storage-account. |
dns
|
path | True |
string |
Het DNS-achtervoegsel voor het Azure Data Lake Storage-eindpunt. |
filesystem
|
path | True |
string |
De bestandssysteem-id. Regex-patroon: |
path
|
path | True |
string |
Het pad naar het bestand of de map. |
continuation
|
query |
string |
Facultatief. Wanneer u de naam van een map wijzigt, is het aantal paden waarvan de naam wordt gewijzigd bij elke aanroep beperkt. Als het aantal paden waarvan de naam moet worden gewijzigd, deze limiet overschrijdt, wordt er een vervolgtoken geretourneerd in deze antwoordheader. Wanneer een vervolgtoken wordt geretourneerd in het antwoord, moet het worden opgegeven in een volgende aanroep van de naam van de naambewerking om door te gaan met het wijzigen van de naam van de map. |
|
mode
|
query |
Facultatief. Alleen geldig wanneer naamruimte is ingeschakeld. Deze parameter bepaalt het gedrag van de naamswijzigingsbewerking. De waarde moet 'verouderd' of 'posix' zijn en de standaardwaarde is 'posix'. |
||
resource
|
query |
Alleen vereist voor bestand maken en map maken. De waarde moet 'bestand' of 'map' zijn. |
||
timeout
|
query |
integer int32 |
Een optionele time-outwaarde voor bewerkingen in seconden. De periode begint wanneer de aanvraag door de service wordt ontvangen. Als de time-outwaarde is verstreken voordat de bewerking is voltooid, mislukt de bewerking. |
Aanvraagkoptekst
Media Types: "application/octet-stream"
Name | Vereist | Type | Description |
---|---|---|---|
Cache-Control |
string |
Facultatief. De service slaat deze waarde op en bevat deze in de antwoordheader 'Cache-Control' voor 'Bestand lezen'-bewerkingen voor 'Bestand lezen'- bewerkingen. |
|
Content-Encoding |
string |
Facultatief. Hiermee geeft u op welke inhoudscoderingen zijn toegepast op het bestand. Deze waarde wordt geretourneerd naar de client wanneer de bewerking Bestand lezen wordt uitgevoerd. |
|
Content-Language |
string |
Facultatief. Hiermee geeft u de natuurlijke taal op die wordt gebruikt door de beoogde doelgroep voor het bestand. |
|
Content-Disposition |
string |
Facultatief. De service slaat deze waarde op en bevat deze in de antwoordheader 'Content-Disposition' voor 'Bestand lezen'-bewerkingen. |
|
x-ms-cache-control |
string |
Facultatief. De service slaat deze waarde op en bevat deze in de antwoordheader 'Cache-Control' voor 'Bestand lezen'-bewerkingen. |
|
x-ms-content-type |
string |
Facultatief. De service slaat deze waarde op en bevat deze in de antwoordheader 'Inhoudstype' voor 'Bestand lezen'-bewerkingen. |
|
x-ms-content-encoding |
string |
Facultatief. De service slaat deze waarde op en bevat deze in de antwoordheader 'Content-Encoding' voor 'Bestand lezen'-bewerkingen. |
|
x-ms-content-language |
string |
Facultatief. De service slaat deze waarde op en bevat deze in de antwoordheader 'Content-Language' voor 'Bestand lezen'-bewerkingen. |
|
x-ms-content-disposition |
string |
Facultatief. De service slaat deze waarde op en bevat deze in de antwoordheader 'Content-Disposition' voor 'Bestand lezen'-bewerkingen. |
|
x-ms-rename-source |
string |
Een optioneel bestand of map dat de naam ervan moet worden gewijzigd. De waarde moet de volgende indeling hebben: '/{filesystem}/{path}' of '/{filesystem}/{path}?sastoken' wanneer u een SAS-token gebruikt. Als 'x-ms-properties' is opgegeven, worden de bestaande eigenschappen overschreven; anders blijven de bestaande eigenschappen behouden. Deze waarde moet een tekenreeks met een URL-procentcode zijn. Houd er rekening mee dat de tekenreeks alleen ASCII-tekens mag bevatten in de ISO-8859-1-tekenset. |
|
x-ms-lease-id |
string |
Facultatief. Een lease-id voor het pad dat is opgegeven in de URI. Het pad dat moet worden overschreven, moet een actieve lease hebben en de lease-id moet overeenkomen. Regex-patroon: |
|
x-ms-source-lease-id |
string |
Optioneel voor bewerkingen voor het wijzigen van de naam. Een lease-id voor het bronpad. Het bronpad moet een actieve lease hebben en de lease-id moet overeenkomen. Regex-patroon: |
|
x-ms-properties |
string |
Facultatief. Door de gebruiker gedefinieerde eigenschappen die moeten worden opgeslagen met het bestand of de map, in de indeling van een door komma's gescheiden lijst met naam- en waardeparen "n1=v1, n2=v2, ...", waarbij elke waarde een met base64 gecodeerde tekenreeks is. Houd er rekening mee dat de tekenreeks alleen ASCII-tekens mag bevatten in de ISO-8859-1-tekenset. |
|
x-ms-permissions |
string |
Optioneel en alleen geldig als hiërarchische naamruimte is ingeschakeld voor het account. Hiermee stelt u POSIX-toegangsmachtigingen in voor de bestandseigenaar, de groep die eigenaar is van het bestand en andere. Elke klasse kan een machtiging lezen (4), schrijven (2) of uitvoeren (1) krijgen. Zowel symbolische (rwxrw-rw-) als een octale notatie van 4 cijfers (bijvoorbeeld 0766) worden ondersteund. De plak-bit wordt ook ondersteund en in symbolische notatie, die wordt vertegenwoordigd door de letter t of T in de laatste tekenplaats, afhankelijk van of de uitvoeringsbit voor de andere categorie is ingesteld of uitgezet (bijvoorbeeld rwxrw-rw- met plakbit wordt weergegeven als rwxrw-rwT. Een rwxrw-rwx met plakbit wordt weergegeven als rwxrw-rwt), afwezigheid van t of T geeft aan dat plakbit niet is ingesteld. In een octale notatie van 4 cijfers wordt deze vertegenwoordigd door het 1e cijfer (bijvoorbeeld 1766 vertegenwoordigt rwxrw-rw- met plakbit en 0766 staat voor rwxrw-rw- zonder plakbit). Ongeldig in combinatie met x-ms-acl. |
|
x-ms-umask |
string |
Optioneel en alleen geldig als hiërarchische naamruimte is ingeschakeld voor het account. Wanneer u een bestand of map maakt en de bovenliggende map geen standaard-ACL heeft, beperkt de umask de machtigingen van het bestand of de map die moet worden gemaakt. De resulterende machtiging wordt gegeven door p & ^u, waarbij p de machtiging is en u de umask. Als p bijvoorbeeld 0777 is en u 0057 bent, is de resulterende machtiging 0720. De standaardmachtiging is 0777 voor een map en 0666 voor een bestand. De standaard-umask is 0027. De umask moet worden opgegeven in een octale notatie van 4 cijfers (bijvoorbeeld 0766). |
|
x-ms-owner |
string |
Optioneel en alleen geldig als hiërarchische naamruimte is ingeschakeld voor het account. Hiermee stelt u de eigenaar van het bestand of de map in. |
|
x-ms-group |
string |
Optioneel en alleen geldig als hiërarchische naamruimte is ingeschakeld voor het account. Hiermee stelt u de groep die eigenaar is van het bestand of de map in. |
|
x-ms-acl |
string |
Optioneel en alleen geldig als hiërarchische naamruimte is ingeschakeld voor het account. Hiermee stelt u POSIX-toegangsbeheerrechten in voor bestanden en mappen. Elke toegangsbeheervermelding (ACE) bestaat uit een bereik, een type, een gebruikers- of groeps-id en machtigingen in de indeling [scope:][type]:[id]:[machtigingen]". Het bereik moet 'standaard' zijn om aan te geven dat de ACE deel uitmaakt van de standaard-ACL voor een map; anders is het bereik impliciet en behoort de ACE tot de toegangs-ACL. Er zijn vier ACE-typen: "gebruiker" verleent rechten aan de eigenaar of een benoemde gebruiker, "groep" verleent rechten aan de groep die eigenaar is of een benoemde groep, "masker" beperkt rechten die zijn verleend aan benoemde gebruikers en de leden van groepen, en "andere" verleent rechten aan alle gebruikers die niet in een van de andere vermeldingen zijn gevonden. De gebruikers- of groeps-id wordt weggelaten voor vermeldingen van het type 'masker' en 'overige'. De gebruikers- of groeps-id wordt ook weggelaten voor de eigenaar en eigenaar van de groep. Het machtigingsveld is een reeks van drie tekens waarbij het eerste teken 'r' is om leestoegang te verlenen, het tweede teken w is om schrijftoegang te verlenen en het derde teken 'x' is om uitvoermachtigingen te verlenen. Als er geen toegang wordt verleend, wordt het teken '-' gebruikt om aan te geven dat de machtiging wordt geweigerd. De volgende ACL verleent bijvoorbeeld lees-, schrijf- en uitvoerrechten aan de bestandseigenaar en john.doe@contoso, het leesrecht voor de groep die eigenaar is en niets aan iedereen: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Ongeldig in combinatie met x-ms-machtigingen. |
|
x-ms-proposed-lease-id |
string |
Facultatief. Geef een voorgestelde lease-id op als u een lease wilt verkrijgen tijdens het maken van een bestand of map. Er wordt een lease verkregen met deze lease-id als het maken is geslaagd. Regex-patroon: |
|
x-ms-expiry-option |
string |
Optioneel en alleen geldig als hiërarchische naamruimte is ingeschakeld voor het account en alleen wordt ondersteund voor bestanden. Geef een van de volgende verloopoptie op als u de verlooptijd wilt instellen voor een bestand tijdens het maken. 'RelativeToNow' Stel de vervaldatum in ten opzichte van de huidige tijd. Gebruiker geeft het aantal milliseconden door dat vanaf nu is verstreken. Absolute tijd in RFC 1123-indeling. 'Neverexpire' Stel het bestand in om nooit te verlopen, de verlooptijd hoeft niet te worden opgegeven met deze optie. |
|
x-ms-expiry-time |
string |
Optioneel en alleen geldig als hiërarchische naamruimte is ingeschakeld voor het account en alleen wordt ondersteund voor bestanden. Geef de verlooptijd op wanneer het bestand verloopt. Opgegeven als RFC 1123 HTTP-tijdreeks of aantal milliseconden volgens de verloopoptie. |
|
If-Match |
string |
Facultatief. Een ETag-waarde. Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde. De ETag moet tussen aanhalingstekens worden opgegeven. |
|
If-None-Match |
string |
Facultatief. Een ETag-waarde of de speciale jokertekenwaarde ('*'). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. De ETag moet tussen aanhalingstekens worden opgegeven. |
|
If-Modified-Since |
string |
Facultatief. Een datum- en tijdwaarde. Geef deze header op om de bewerking alleen uit te voeren als de resource is gewijzigd sinds de opgegeven datum en tijd. |
|
If-Unmodified-Since |
string |
Facultatief. Een datum- en tijdwaarde. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum en tijd. |
|
x-ms-source-if-match |
string |
Facultatief. Een ETag-waarde. Geef deze header op om de naamswijziging alleen uit te voeren als de ETag van de bron overeenkomt met de opgegeven waarde. De ETag moet tussen aanhalingstekens worden opgegeven. |
|
x-ms-source-if-none-match |
string |
Facultatief. Een ETag-waarde of de speciale jokertekenwaarde ('*'). Geef deze header op om de naamswijziging alleen uit te voeren als de ETag van de bron niet overeenkomt met de opgegeven waarde. De ETag moet tussen aanhalingstekens worden opgegeven. |
|
x-ms-source-if-modified-since |
string |
Facultatief. Een datum- en tijdwaarde. Geef deze header op om de naamswijziging alleen uit te voeren als de bron is gewijzigd sinds de opgegeven datum en tijd. |
|
x-ms-source-if-unmodified-since |
string |
Facultatief. Een datum- en tijdwaarde. Geef deze header op om de naambewerking alleen uit te voeren als de bron niet is gewijzigd sinds de opgegeven datum en tijd. |
|
x-ms-encryption-key |
string |
Facultatief. De met Base64 gecodeerde AES-256-versleutelingssleutel. |
|
x-ms-encryption-key-sha256 |
string |
Facultatief. De met Base64 gecodeerde SHA256-hash van de versleutelingssleutel. |
|
x-ms-encryption-algorithm: AES256 |
string |
Facultatief. Hiermee geeft u het algoritme op dat moet worden gebruikt voor versleuteling. De waarde van deze header moet AES256 zijn. |
|
x-ms-encryption-context |
string |
Facultatief. De standaardwaarde is 'Leeg'. Als de waarde is ingesteld, worden de metagegevens van blob/bestandssysteem ingesteld. Maximale lengte- 1024. Alleen geldig wanneer hiërarchische naamruimte is ingeschakeld voor het account. |
|
x-ms-client-transaction-id |
string |
Facultatief. De standaardwaarde is 'Leeg'. Als de waarde is ingesteld, worden blobmetagegevens ingesteld bij het maken of hernoemen van bestanden. Als er een time-out optreedt voor de aanvraag voor de client, kan deze waarde worden opgehaald met behulp van de aanroep Eigenschappen ophalen om te bevestigen of de time-outaanvraag is geslaagd of niet aan het einde van de service. Maximale lengte- 36. Alleen geldig wanneer hiërarchische naamruimte is ingeschakeld voor het account. |
|
x-ms-client-request-id |
string |
Een UUID die is vastgelegd in de analyselogboeken voor probleemoplossing en correlatie. Regex-patroon: |
|
x-ms-date |
string |
Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Dit is vereist bij het gebruik van autorisatie van gedeelde sleutels. |
|
x-ms-version |
string |
Hiermee geeft u de versie op van het REST-protocol dat wordt gebruikt voor het verwerken van de aanvraag. Dit is vereist bij het gebruik van autorisatie van gedeelde sleutels. |
Antwoorden
Name | Type | Description |
---|---|---|
201 Created |
Het bestand of de map is gemaakt. Kopteksten
|
|
Other Status Codes |
Er is een fout opgetreden. Hieronder ziet u de mogelijke HTTP-status, code en berichttekenreeksen:
Kopteksten
|
Definities
Name | Description |
---|---|
Data |
|
Error |
Het antwoordobject voor de servicefout. |
Path |
Facultatief. Alleen geldig wanneer naamruimte is ingeschakeld. Deze parameter bepaalt het gedrag van de naamswijzigingsbewerking. De waarde moet 'verouderd' of 'posix' zijn en de standaardwaarde is 'posix'. |
Path |
Alleen vereist voor bestand maken en map maken. De waarde moet 'bestand' of 'map' zijn. |
DataLakeStorageError
Name | Type | Description |
---|---|---|
error |
Het antwoordobject voor de servicefout. |
Error
Het antwoordobject voor de servicefout.
Name | Type | Description |
---|---|---|
code |
string |
De servicefoutcode. |
message |
string |
Het servicefoutbericht. |
PathRenameMode
Facultatief. Alleen geldig wanneer naamruimte is ingeschakeld. Deze parameter bepaalt het gedrag van de naamswijzigingsbewerking. De waarde moet 'verouderd' of 'posix' zijn en de standaardwaarde is 'posix'.
Name | Type | Description |
---|---|---|
legacy |
string |
|
posix |
string |
PathResourceType
Alleen vereist voor bestand maken en map maken. De waarde moet 'bestand' of 'map' zijn.
Name | Type | Description |
---|---|---|
directory |
string |
|
file |
string |