Sdílet prostřednictvím


Path - Create

Vytvořit soubor | Vytvořit adresář | Přejmenovat soubor | Přejmenovat adresář
Vytvořte nebo přejmenujte soubor nebo adresář. Ve výchozím nastavení se cíl přepíše a pokud cíl již existuje a má zapůjčení, zapůjčení se přeruší. Upozorňujeme, že přejmenování souboru nebo adresáře do kontejneru s vynucenými zásadami šifrování kontejneru není povoleno, pokud zdrojový kontejner nemá také vynucené zásady šifrování kontejneru, které odpovídají. Tato operace podporuje podmíněné požadavky HTTP. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Service. Pokud cíl již existuje, použijte podmíněný požadavek s chybou If-None-Match: "*".

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
accountName
path True

string

Název účtu služby Azure Storage.

dnsSuffix
path True

string

Přípona DNS pro koncový bod služby Azure Data Lake Storage.

filesystem
path True

string

Identifikátor systému souborů.

Vzor regulárního výrazu: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$

path
path True

string

Cesta k souboru nebo adresáři.

continuation
query

string

Volitelný. Při přejmenování adresáře je omezený počet cest, které se přejmenují při každém vyvolání. Pokud počet cest, které se mají přejmenovat, tento limit překročí, vrátí se v této hlavičce odpovědi token pro pokračování. Pokud se v odpovědi vrátí token pro pokračování, musí být zadán v následném vyvolání operace přejmenování, aby bylo možné pokračovat v přejmenování adresáře.

mode
query

PathRenameMode

Volitelný. Platné pouze v případech, kdy je povolený obor názvů. Tento parametr určuje chování operace přejmenování. Hodnota musí být "legacy" nebo "posix" a výchozí hodnota bude "posix".

resource
query

PathResourceType

Vyžaduje se pouze pro vytvoření souboru a vytvoření adresáře. Hodnota musí být "file" nebo "directory".

timeout
query

integer

int32

Volitelná hodnota časového limitu operace v sekundách. Období začíná, když služba obdrží požadavek. Pokud hodnota časového limitu uplynula před dokončením operace, operace selže.

Hlavička požadavku

Media Types: "application/octet-stream"

Name Vyžadováno Typ Description
Cache-Control

string

Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Cache-Control pro operace Čtení souboru pro operace Čtení souboru.

Content-Encoding

string

Volitelný. Určuje, které kódování obsahu se na soubor použilo. Tato hodnota se vrátí klientovi při provedení operace Čtení souboru.

Content-Language

string

Volitelný. Určuje přirozený jazyk používaný zamýšlenou cílovou skupinou pro soubor.

Content-Disposition

string

Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Content-Disposition pro operace Čtení souboru.

x-ms-cache-control

string

Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Cache-Control pro operace Čtení souboru.

x-ms-content-type

string

Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Content-Type pro operace Čtení souboru.

x-ms-content-encoding

string

Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Content-Encoding pro operace Čtení souboru.

x-ms-content-language

string

Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Content-Language pro operace Čtení souboru.

x-ms-content-disposition

string

Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Content-Disposition pro operace Čtení souboru.

x-ms-rename-source

string

Volitelný soubor nebo adresář, který se má přejmenovat. Hodnota musí mít následující formát: /{filesystem}/{path} nebo /{filesystem}/{path}?sastoken při použití tokenu SAS. Pokud je zadán parametr x-ms-properties, vlastnosti přepíšou existující vlastnosti; v opačném případě se stávající vlastnosti zachovají. Tato hodnota musí být řetězec kódovaný v procentech adresy URL. Všimněte si, že řetězec může obsahovat pouze znaky ASCII ve znakové sadě ISO-8859-1.

x-ms-lease-id

string

Volitelný. ID zapůjčení pro cestu zadanou v identifikátoru URI. Cesta, která se má přepsat, musí mít aktivní zapůjčení a ID zapůjčení se musí shodovat.

Vzor regulárního výrazu: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-source-lease-id

string

Volitelné pro operace přejmenování. ID zapůjčení zdrojové cesty. Zdrojová cesta musí mít aktivní zapůjčení a ID zapůjčení se musí shodovat.

Vzor regulárního výrazu: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-properties

string

Volitelný. Uživatelem definované vlastnosti, které se mají uložit se souborem nebo adresářem, ve formátu čárkami oddělený seznam párů názvů a hodnot "n1=v1, n2=v2, ...", kde každá hodnota je řetězec kódovaný jako base64. Všimněte si, že řetězec může obsahovat pouze znaky ASCII ve znakové sadě ISO-8859-1.

x-ms-permissions

string

Nepovinný a platný pouze v případě, že je pro účet povolený hierarchický obor názvů. Nastaví přístupová oprávnění POSIX pro vlastníka souboru, skupinu vlastníka souboru a další. Každé třídě může být uděleno oprávnění ke čtení (4), zápisu (2) nebo provedení (1). Podporují se symbolické (rwxrw-rw-) i 4ciferné osmičkové notace (např. 0766). Bit sticky je také podporován a v symbolickém zápisu je reprezentován písmenem t nebo T v konečném znaku v závislosti na tom, jestli je spouštěcí bit pro ostatní kategorie nastavený nebo nenastavený (např. rwxrw-rw- with sticky bit je reprezentován jako rwxrw-rwT. Rwxrw-rwx s rychlým bitem je reprezentován jako rwxrw-rwt), absence t nebo T indikuje, že bit sticky není nastavený. Ve 4ciferném osmičkovém zápisu představuje 1. číslice (např. 1766 představuje rwxrw-rw- s sticky bitem a 0766 představuje rwxrw-rw- bez lepivé bity). Neplatné ve spojení s x-ms-acl.

x-ms-umask

string

Nepovinný a platný pouze v případě, že je pro účet povolený hierarchický obor názvů. Při vytváření souboru nebo adresáře a nadřazená složka nemá výchozí seznam ACL, umask omezuje oprávnění k vytvoření souboru nebo adresáře. Výsledné oprávnění udělí p & ^u, kde p je oprávnění a vy jste umask. Pokud je například p 0777 a vy je 0057, výsledné oprávnění je 0720. Výchozí oprávnění je 0777 pro adresář a 0666 pro soubor. Výchozí umask je 0027. umask musí být zadán v osmičkovém zápisu 4 číslic (např. 0766).

x-ms-owner

string

Nepovinný a platný pouze v případě, že je pro účet povolený hierarchický obor názvů. Nastaví vlastníka souboru nebo adresáře.

x-ms-group

string

Nepovinný a platný pouze v případě, že je pro účet povolený hierarchický obor názvů. Nastaví vlastnící skupinu souboru nebo adresáře.

x-ms-acl

string

Nepovinný a platný pouze v případě, že je pro účet povolený hierarchický obor názvů. Nastaví práva řízení přístupu POSIX u souborů a adresářů. Každá položka řízení přístupu (ACE) se skládá z oboru, typu, identifikátoru uživatele nebo skupiny a oprávnění ve formátu [scope:][type]:[id]:[permissions]". Obor musí být "výchozí", aby označí, že ACE patří do výchozího seznamu ACL pro adresář; jinak je obor implicitní a ACE patří do přístupového seznamu ACL. Existují čtyři typy ACE: "uživatel" uděluje práva vlastníkovi nebo pojmenovaného uživatele, "skupina" uděluje práva vlastnící skupině nebo pojmenované skupině, "maska" omezuje práva udělená pojmenovaným uživatelům a členům skupin a "ostatní" uděluje práva všem uživatelům, kteří se nenašli v žádné z ostatních položek. Identifikátor uživatele nebo skupiny je vynechán pro položky typu "maska" a "jiné". Identifikátor uživatele nebo skupiny je také vynechán pro vlastníka a vlastnící skupinu. Pole oprávnění je 3znaková sekvence, kde první znak je r pro udělení přístupu pro čtení, druhý znak je w pro udělení přístupu k zápisu a třetí znak je x pro udělení oprávnění ke spuštění. Pokud přístup není udělen, znak -se použije k označení, že oprávnění je odepřeno. Například následující seznam ACL uděluje oprávnění ke čtení, zápisu a provádění oprávnění pro vlastníka souboru a john.doe@contoso, oprávnění ke čtení vlastnící skupině a nic ostatním: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Neplatné ve spojení s x-ms-permissions.

x-ms-proposed-lease-id

string

Volitelný. Pokud chcete při vytváření souboru nebo adresáře získat zapůjčení, zadejte navrhované ID zapůjčení. Zapůjčení se získá s tímto ID zapůjčení, pokud bude vytvoření úspěšné.

Vzor regulárního výrazu: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-expiry-option

string

Nepovinný a platný pouze v případě, že je pro účet povolený hierarchický obor názvů a podporuje se jenom u souborů. Pokud chcete nastavit dobu vypršení platnosti souboru při vytváření, zadejte jednu z následujících možností vypršení platnosti. "RelativeToNow" Nastavte vypršení platnosti vzhledem k aktuálnímu času. Od této chvíle uživatel předá počet milisekund. Absolutní čas ve formátu RFC 1123 "Neverexpire" Nastavte soubor tak, aby nikdy nevypršela platnost, není nutné zadávat s touto možností.

x-ms-expiry-time

string

Nepovinný a platný pouze v případě, že je pro účet povolený hierarchický obor názvů a podporuje se jenom u souborů. Zadejte dobu vypršení platnosti souboru. Hodnota RFC 1123 HTTP Time String nebo počet milisekund podle možnosti vypršení platnosti.

If-Match

string

Volitelný. Hodnota ETag. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku odpovídají zadané hodnotě. ETag musí být zadán v uvozovkách.

If-None-Match

string

Volitelný. Hodnota značky ETag nebo speciální zástupný znak (*). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. ETag musí být zadán v uvozovkách.

If-Modified-Since

string

Volitelný. Hodnota data a času. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek změněn od zadaného data a času.

If-Unmodified-Since

string

Volitelný. Hodnota data a času. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že se prostředek od zadaného data a času nezměnil.

x-ms-source-if-match

string

Volitelný. Hodnota ETag. Tuto hlavičku zadejte, aby se operace přejmenování prováděla pouze v případě, že značky ETag zdroje odpovídají zadané hodnotě. ETag musí být zadán v uvozovkách.

x-ms-source-if-none-match

string

Volitelný. Hodnota značky ETag nebo speciální zástupný znak (*). Tuto hlavičku zadejte, aby se operace přejmenování prováděla pouze v případě, že značky ETag zdroje neodpovídají zadané hodnotě. ETag musí být zadán v uvozovkách.

x-ms-source-if-modified-since

string

Volitelný. Hodnota data a času. Tuto hlavičku zadejte, aby se operace přejmenování prováděla pouze v případě, že byl zdroj změněn od zadaného data a času.

x-ms-source-if-unmodified-since

string

Volitelný. Hodnota data a času. Tuto hlavičku zadejte, pokud chcete provést operaci přejmenování pouze v případě, že zdroj nebyl změněn od zadaného data a času.

x-ms-encryption-key

string

Volitelný. Šifrovací klíč AES-256 s kódováním Base64.

x-ms-encryption-key-sha256

string

Volitelný. Hodnota hash SHA256 s kódováním Base64 šifrovacího klíče.

x-ms-encryption-algorithm: AES256

string

Volitelný. Určuje algoritmus, který se má použít pro šifrování. Hodnota této hlavičky musí být AES256.

x-ms-encryption-context

string

Volitelný. Výchozí hodnota je Prázdná. Pokud je hodnota nastavená, nastaví se metadata systému objektů blob nebo systému souborů. Maximální délka- 1024. Platné pouze v případě, že je pro účet povolený hierarchický obor názvů.

x-ms-client-transaction-id

string

Volitelný. Výchozí hodnota je Prázdná. Pokud je hodnota nastavená, nastaví se metadata objektu blob při vytvoření nebo přejmenování souboru. Pokud vyprší časový limit požadavku pro klienta, můžete tuto hodnotu načíst pomocí volání Get Properties a ověřit, jestli vypršel časový limit požadavku na konci služby nebo ne. Maximální délka- 36. Platné pouze v případě, že je pro účet povolený hierarchický obor názvů.

x-ms-client-request-id

string

Identifikátor UUID zaznamenaný v analytických protokolech pro řešení potíží a korelaci.

Vzor regulárního výrazu: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-date

string

Určuje standard UTC (Coordinated Universal Time) pro požadavek. To se vyžaduje při použití autorizace sdíleného klíče.

x-ms-version

string

Určuje verzi protokolu REST, který se používá ke zpracování požadavku. To se vyžaduje při použití autorizace sdíleného klíče.

Odpovědi

Name Typ Description
201 Created

Soubor nebo adresář byl vytvořen.

Hlavičky

  • 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

Došlo k chybě. Možné řetězce stavu, kódu a zprávy HTTP jsou uvedené níže:

  • 400 Chybný požadavek, ContentLengthMustBeZero, "Hlavička požadavku Content-Length musí být nula."
  • 400 Chybný požadavek, InvalidAuthenticationInfo, "Ověřovací informace nejsou zadány ve správném formátu. Zkontrolujte hodnotu autorizační hlavičky.
  • 400 Chybný požadavek, InvalidFlushPosition, "Nahraná data nejsou souvislá nebo hodnota parametru dotazu pozice není rovna délce souboru po připojení nahraných dat."
  • 400 Chybný požadavek, InvalidHeaderValue, "Hodnota jedné z hlaviček HTTP není ve správném formátu."
  • 400 Chybný požadavek, InvalidHttpVerb, "Zadaný příkaz HTTP je neplatný – server ho nerozpozná."
  • 400 Chybný požadavek, InvalidInput, "Jeden ze vstupů požadavku není platný."
  • 400 Chybný požadavek, InvalidPropertyName, "Název vlastnosti nemůže být prázdný."
  • 400 Chybný požadavek, InvalidPropertyName, "Název vlastnosti obsahuje neplatné znaky."
  • 400 Chybný požadavek, InvalidQueryParameterValue, Hodnota pro jeden z parametrů dotazu zadaných v identifikátoru URI požadavku je neplatná.
  • 400 Chybný požadavek, InvalidResourceName, "Zadaný název prostředku obsahuje neplatné znaky."
  • 400 Chybný požadavek, InvalidSourceUri, "Zdrojový identifikátor URI je neplatný".
  • 400 Chybný požadavek, InvalidUri, "Identifikátor URI požadavku je neplatný".
  • 400 Chybný požadavek MissingRequiredHeader, hlavička HTTP povinná pro tento požadavek není zadána.
  • 400 Chybný požadavek, MissingRequiredQueryParameter, "Parametr dotazu, který je povinný pro tento požadavek, není zadán."
  • 400 – Chybný požadavek, MultipleConditionHeadersNotSupported, hlavičky více podmínek nejsou podporovány.
  • 400 Chybný požadavek OutOfRangeInput, "Jeden ze vstupů požadavku je mimo rozsah."
  • 400 Bad Request, OutOfRangeQueryParameterValue, "Jeden z parametrů dotazu zadaný v identifikátoru URI požadavku je mimo povolený rozsah."
  • 400 Chybný požadavek, nepodporovanýHeader, "Jedna z hlaviček zadaných v požadavku není podporována.".
  • 400 Chybný požadavek, NepodporovanýQueryParameter, "Jeden z parametrů dotazu zadaný v identifikátoru URI požadavku není podporován."
  • 400 Chybný požadavek, nepodporovanýRestVersion, "Zadaná verze rest není podporována."
  • 403 Zakázáno, AccountIsDisabled, "Zadaný účet je zakázán."
  • 403 Zakázáno, AuthorizationFailure, "Tento požadavek nemá oprávnění k provedení této operace."
  • 403 Zakázáno, InsufficientAccountPermissions, "Účet, ke kterým se přistupuje, nemá dostatečná oprávnění ke spuštění této operace."
  • 404 Nenalezeno, FilesystemNotFound, "Zadaný systém souborů neexistuje."
  • 404 Nenalezeno, PathNotFound, "Zadaná cesta neexistuje."
  • 404 Nenalezeno, RenameDestinationParentPathNotFound, "Nadřazený adresář cílové cesty neexistuje."
  • 404 Nenalezeno, ResourceNotFound, "Zadaný prostředek neexistuje."
  • 404 Nenalezeno, SourcePathNotFound, "Cesta ke zdroji operace přejmenování neexistuje."
  • 405 Metoda Není povolena, NepodporovanáHttpVerb, "Prostředek nepodporuje zadaný příkaz HTTP."
  • 409 Konflikt, DestinationPathIsBeingDeleted, "Zadaná cílová cesta je označena k odstranění."
  • 409 Konflikt, DirectoryNotEmpty, "Rekurzivní hodnota parametru dotazu musí být true pro odstranění neprázdného adresáře."
  • 409 Konflikt, FilesystemAlreadyExists, "Zadaný systém souborů již existuje."
  • 409 Konflikt, FilesystemBeingDeleted, "Zadaný systém souborů je odstraněn."
  • 409 Konflikt, InvalidDestinationPath, "Zadaná cesta nebo prvek cesty existuje a jeho typ prostředku je pro tuto operaci neplatný." * 409 Konflikt, InvalidFlushOperation, "Prostředek byl vytvořen nebo změněn rozhraním API služby Blob Service a nelze jej zapsat do rozhraní API služby Data Lake Storage."
  • 409 Konflikt, InvalidRenameSourcePath, "Zdrojový adresář nemůže být stejný jako cílový adresář, ani nemůže být cílem podadresář zdrojového adresáře."
  • 409 Konflikt, InvalidSourceOrDestinationResourceType, "Typ zdrojového a cílového prostředku musí být identický"
  • 409 Konflikt, LeaseAlreadyPresent, "Je již k dispozici zapůjčení."
  • 409 Konflikt, LeaseIdMismatchWithLeaseOperation, "Zadané ID zapůjčení neodpovídá ID zapůjčení prostředku se zadanou operací zapůjčení."
  • 409 Konflikt, LeaseIsAlreadyBroken, "Zapůjčení již bylo přerušeno a nelze ho znovu zlomit."
  • 409 Konflikt, LeaseIsBreakingAndCannotBeAcquired, "ID zapůjčení odpovídá, ale zapůjčení je momentálně v nefunkčním stavu a nelze jej získat, dokud nebude přerušen."
  • 409 Konflikt, LeaseIsBreakingAndCannotBeChanged, "ID zapůjčení odpovídá, ale zapůjčení je momentálně v způsobujícím stavu a nelze ho změnit."
  • 409 Konflikt, LeaseIsBrokenAndCannotBeRenewed, "ID zapůjčení odpovídá, ale zapůjčení bylo přerušeno explicitně a nelze ho obnovit."
  • 409 Konflikt, LeaseNameMismatch, "Zadaný název zapůjčení neodpovídá existujícímu názvu zapůjčení."
  • 409 Konflikt, LeaseNotPresentWithLeaseOperation, "ID zapůjčení není k dispozici se zadanou operací zapůjčení."
  • 409 Konflikt, PathAlreadyExists, "Zadaná cesta již existuje."
  • 409 Konflikt, PathConflict, "Zadaná cesta nebo prvek cesty existuje a jeho typ prostředku je pro tuto operaci neplatný."
  • 409 Konflikt, SourcePathIsBeingDeleted, "Zadaná zdrojová cesta je označena k odstranění."
  • 409 Konflikt, ResourceTypeMismatch, "Typ prostředku zadaný v požadavku neodpovídá typu prostředku."
  • 412 Předběžná podmínka selhala, ConditionNotMet, "Podmínka zadaná pomocí podmíněných hlaviček HTTP není splněna."
  • 412 Předběžná podmínka se nezdařila, LeaseIdMismatch, "Zadané ID zapůjčení neodpovídá ID zapůjčení prostředku."
  • 412 Předběžná podmínka selhala, LeaseIdMissing, "V současné době je pro prostředek zapůjčení a v žádosti nebyla zadána žádná ID zapůjčení."
  • 412 Předběžná podmínka selhala, LeaseNotPresent, "V současné době není pro prostředek žádné zapůjčení.".
  • 412 Předběžná podmínka se nezdařila, ZapůjčeníLost, "Bylo zadáno ID zapůjčení, ale vypršela platnost zapůjčení prostředku."
  • 412 Předběžná podmínka selhala, SourceConditionNotMet, "Zdrojová podmínka zadaná pomocí podmíněných hlaviček HTTP není splněna.".
  • 413 Request Entity Too Large, RequestBodyTooLarge, "Text požadavku je příliš velký a překračuje maximální povolený limit."
  • 416 Požadovaný rozsah není satisfiable, InvalidRange, "Zadaný rozsah je neplatný pro aktuální velikost prostředku."
  • 500 Vnitřní chyba serveru, InternalError, "Server zjistil vnitřní chybu. Zkuste žádost zopakovat."
  • 500 Vnitřní chyba serveru OperationTimedOut, "Operaci nelze dokončit v povoleném čase."
  • 503 Service Unavailable, ServerBusy, "Egress is over the account limit" (Výchozí přenos je nad limitem účtu).
  • 503 Service Unavailable, ServerBusy, "Ingress is over the account limit."
  • 503 Service Unavailable, ServerBusy, "Operations per second is over the account limit."
  • 503 Service Unavailable, ServerBusy, "Server is currently unable to receive requests. Zkuste prosím žádost zopakovat."

Hlavičky

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

Definice

Name Description
DataLakeStorageError
Error

Objekt odpovědi na chybu služby.

PathRenameMode

Volitelný. Platné pouze v případech, kdy je povolený obor názvů. Tento parametr určuje chování operace přejmenování. Hodnota musí být "legacy" nebo "posix" a výchozí hodnota bude "posix".

PathResourceType

Vyžaduje se pouze pro vytvoření souboru a vytvoření adresáře. Hodnota musí být "file" nebo "directory".

DataLakeStorageError

Name Typ Description
error

Error

Objekt odpovědi na chybu služby.

Error

Objekt odpovědi na chybu služby.

Name Typ Description
code

string

Kód chyby služby.

message

string

Chybová zpráva služby.

PathRenameMode

Volitelný. Platné pouze v případech, kdy je povolený obor názvů. Tento parametr určuje chování operace přejmenování. Hodnota musí být "legacy" nebo "posix" a výchozí hodnota bude "posix".

Name Typ Description
legacy

string

posix

string

PathResourceType

Vyžaduje se pouze pro vytvoření souboru a vytvoření adresáře. Hodnota musí být "file" nebo "directory".

Name Typ Description
directory

string

file

string