Path - Create
Créer un fichier | Créer un répertoire | Renommer un fichier | Renommer le répertoire
Créez ou renommez un fichier ou un répertoire. Par défaut, la destination est remplacée et, si la destination existe déjà et qu’elle a un bail, le bail est rompu. Notez que le changement de nom d’un fichier ou d’un répertoire dans un conteneur avec une stratégie de chiffrement de conteneur appliquée n’est pas autorisé, sauf si le conteneur source a également une stratégie de chiffrement de conteneur appliquée qui correspond. Cette opération prend en charge les requêtes HTTP conditionnelles. Pour plus d’informations, consultez Spécification d’en-têtes conditionnels pour les opérations de service Blob. Pour échouer si la destination existe déjà, utilisez une demande conditionnelle avec If-None-Match : « * ».
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nom du compte stockage Azure. |
dns
|
path | True |
string |
Suffixe DNS pour le point de terminaison Azure Data Lake Storage. |
filesystem
|
path | True |
string |
Identificateur du système de fichiers. Modèle d’expression régulière: |
path
|
path | True |
string |
Chemin du fichier ou du répertoire. |
continuation
|
query |
string |
Optionnel. Lors du changement de nom d’un répertoire, le nombre de chemins d’accès renommés avec chaque appel est limité. Si le nombre de chemins à renommer dépasse cette limite, un jeton de continuation est retourné dans cet en-tête de réponse. Lorsqu’un jeton de continuation est retourné dans la réponse, il doit être spécifié dans un appel ultérieur de l’opération de renommage pour continuer à renommer le répertoire. |
|
mode
|
query |
Optionnel. Valide uniquement lorsque l’espace de noms est activé. Ce paramètre détermine le comportement de l’opération de renommage. La valeur doit être « legacy » ou « posix », et la valeur par défaut est « posix ». |
||
resource
|
query |
Obligatoire uniquement pour créer un fichier et créer un répertoire. La valeur doit être « file » ou « directory ». |
||
timeout
|
query |
integer int32 |
Valeur de délai d’expiration d’opération facultative en secondes. La période commence lorsque la demande est reçue par le service. Si la valeur de délai d’expiration s’écoule avant la fin de l’opération, l’opération échoue. |
En-tête de la demande
Media Types: "application/octet-stream"
Nom | Obligatoire | Type | Description |
---|---|---|---|
Cache-Control |
string |
Optionnel. Le service stocke cette valeur et l’inclut dans l’en-tête de réponse « Cache-Control » pour les opérations « Read File » pour les opérations « Read File ». |
|
Content-Encoding |
string |
Optionnel. Spécifie les encodages de contenu qui ont été appliqués au fichier. Cette valeur est retournée au client lorsque l’opération « Lire le fichier » est effectuée. |
|
Content-Language |
string |
Optionnel. Spécifie le langage naturel utilisé par l’audience prévue pour le fichier. |
|
Content-Disposition |
string |
Optionnel. Le service stocke cette valeur et l’inclut dans l’en-tête de réponse « Content-Disposition » pour les opérations « Lire le fichier ». |
|
x-ms-cache-control |
string |
Optionnel. Le service stocke cette valeur et l’inclut dans l’en-tête de réponse « Cache-Control » pour les opérations « Lire le fichier ». |
|
x-ms-content-type |
string |
Optionnel. Le service stocke cette valeur et l’inclut dans l’en-tête de réponse « Content-Type » pour les opérations « Read File ». |
|
x-ms-content-encoding |
string |
Optionnel. Le service stocke cette valeur et l’inclut dans l’en-tête de réponse « Content-Encoding » pour les opérations « Lire le fichier ». |
|
x-ms-content-language |
string |
Optionnel. Le service stocke cette valeur et l’inclut dans l’en-tête de réponse « Content-Language » pour les opérations « Lire le fichier ». |
|
x-ms-content-disposition |
string |
Optionnel. Le service stocke cette valeur et l’inclut dans l’en-tête de réponse « Content-Disposition » pour les opérations « Lire le fichier ». |
|
x-ms-rename-source |
string |
Fichier ou répertoire facultatif à renommer. La valeur doit avoir le format suivant : « /{filesystem}/{path} » ou « /{filesystem}/{path} ?sastoken » lors de l’utilisation d’un jeton SAP. Si « x-ms-properties » est spécifié, les propriétés remplacent les propriétés existantes ; sinon, les propriétés existantes seront conservées. Cette valeur doit être une chaîne codée en pourcentage d’URL. Notez que la chaîne ne peut contenir que des caractères ASCII dans le jeu de caractères ISO-8859-1. |
|
x-ms-lease-id |
string |
Optionnel. ID de bail pour le chemin spécifié dans l’URI. Le chemin d’accès à remplacer doit avoir un bail actif et l’ID de bail doit correspondre. Modèle d’expression régulière: |
|
x-ms-source-lease-id |
string |
Facultatif pour les opérations de renommage. ID de bail pour le chemin source. Le chemin source doit avoir un bail actif et l’ID de bail doit correspondre. Modèle d’expression régulière: |
|
x-ms-properties |
string |
Optionnel. Propriétés définies par l’utilisateur à stocker avec le fichier ou le répertoire, au format d’une liste séparée par des virgules de paires nom et valeur « n1=v1, n2=v2, ... », où chaque valeur est une chaîne encodée en base64. Notez que la chaîne ne peut contenir que des caractères ASCII dans le jeu de caractères ISO-8859-1. |
|
x-ms-permissions |
string |
Facultatif et valide uniquement si l’espace de noms hiérarchique est activé pour le compte. Définit les autorisations d’accès POSIX pour le propriétaire du fichier, le groupe propriétaire de fichiers et d’autres utilisateurs. Chaque classe peut recevoir une autorisation de lecture (4), d’écriture (2) ou d’exécution (1). Les notations symboliques (rwxrw-rw-) et octal à 4 chiffres (par exemple, 0766) sont prises en charge. Le bit collant est également pris en charge et en notation symbolique, il est représenté par la lettre t ou T dans le caractère final, selon que le bit d’exécution pour les autres catégories est défini ou non défini (par exemple rwxrw-rw- avec un bit sticky est représenté en tant que rwxrw-rwT. Un rwxrw-rwx avec un bit sticky est représenté en tant que rwxrw-rwt), l’absence de t ou T indique que le bit collant n’est pas défini. En notation octale à 4 chiffres, elle est représentée par le 1er chiffre (par exemple, 1766 représente rwxrw-rw- avec un bit collant et 0766 représente rwxrw-rw- sans bit sticky). Non valide conjointement avec x-ms-acl. |
|
x-ms-umask |
string |
Facultatif et valide uniquement si l’espace de noms hiérarchique est activé pour le compte. Lors de la création d’un fichier ou d’un répertoire et que le dossier parent n’a pas de liste de contrôle d’accès par défaut, l’umask limite les autorisations du fichier ou du répertoire à créer. L’autorisation résultante est donnée par p & ^u, où p est l’autorisation et vous êtes l’umask. Par exemple, si p est 0777 et que vous êtes 0057, l’autorisation résultante est 0720. L’autorisation par défaut est 0777 pour un répertoire et 0666 pour un fichier. L’umask par défaut est 0027. L’umask doit être spécifié en notation octale à 4 chiffres (par exemple, 0766). |
|
x-ms-owner |
string |
Facultatif et valide uniquement si l’espace de noms hiérarchique est activé pour le compte. Définit le propriétaire du fichier ou du répertoire. |
|
x-ms-group |
string |
Facultatif et valide uniquement si l’espace de noms hiérarchique est activé pour le compte. Définit le groupe propriétaire du fichier ou du répertoire. |
|
x-ms-acl |
string |
Facultatif et valide uniquement si l’espace de noms hiérarchique est activé pour le compte. Définit les droits de contrôle d’accès POSIX sur les fichiers et les répertoires. Chaque entrée de contrôle d’accès (ACE) se compose d’une étendue, d’un type, d’un identificateur d’utilisateur ou de groupe et d’autorisations au format « [scope :][type] :[id] :[permissions] ». L’étendue doit être « par défaut » pour indiquer que l’ACE appartient à la liste de contrôle d’accès par défaut d’un répertoire ; sinon, l’étendue est implicite et l’ACE appartient à la liste de contrôle d’accès d’accès. Il existe quatre types ACE : « user » accorde des droits au propriétaire ou à un utilisateur nommé, « group » accorde des droits au groupe propriétaire ou à un groupe nommé, « mask » limite les droits accordés aux utilisateurs nommés et aux membres des groupes, et « other » accorde des droits à tous les utilisateurs introuvables dans l’une des autres entrées. L’identificateur d’utilisateur ou de groupe est omis pour les entrées de type « mask » et « other ». L’identificateur d’utilisateur ou de groupe est également omis pour le propriétaire et le groupe propriétaire. Le champ d’autorisation est une séquence de 3 caractères où le premier caractère est « r » pour accorder l’accès en lecture, le deuxième caractère est « w » pour accorder l’accès en écriture et le troisième caractère est « x » pour accorder l’autorisation d’exécution. Si l’accès n’est pas accordé, le caractère « - » est utilisé pour indiquer que l’autorisation est refusée. Par exemple, la liste de contrôle d’accès suivante accorde des droits de lecture, d’écriture et d’exécution au propriétaire du fichier et john.doe@contoso, le droit de lecture au groupe propriétaire, et rien à tous les autres : « user ::rwx, user :john.doe@contoso :rwx,group ::r--,other ::---,mask=rwx ». Non valide conjointement avec x-ms-permissions. |
|
x-ms-proposed-lease-id |
string |
Optionnel. Spécifiez un ID de bail proposé si vous souhaitez acquérir un bail lors de la création d’un fichier ou d’un répertoire. Un bail sera acquis avec cet ID de bail si la création réussit. Modèle d’expression régulière: |
|
x-ms-expiry-option |
string |
Facultatif et valide uniquement si l’espace de noms hiérarchique est activé pour le compte et uniquement pris en charge sur les fichiers. Spécifiez l’une des options d’expiration suivantes si vous souhaitez définir l’heure d’expiration sur un fichier lors de la création. « RelativeToNow » Définissez l’expiration par rapport à l’heure actuelle. L’utilisateur passe le nombre de millisecondes écoulées à partir de maintenant. Temps absolu dans le format RFC 1123. « Neverexpire » Définissez le fichier pour ne jamais expirer, le délai d’expiration n’a pas besoin d’être spécifié avec cette option. |
|
x-ms-expiry-time |
string |
Facultatif et valide uniquement si l’espace de noms hiérarchique est activé pour le compte et uniquement pris en charge sur les fichiers. Spécifiez l’heure d’expiration à laquelle expirer le fichier. Donné en tant que chaîne de temps HTTP 1123 RFC ou nombre de millisecondes en fonction de l’option d’expiration. |
|
If-Match |
string |
Optionnel. Valeur ETag. Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource correspond à la valeur spécifiée. L’ETag doit être spécifié entre guillemets. |
|
If-None-Match |
string |
Optionnel. Valeur ETag ou valeur générique spéciale (« * »). Spécifiez cet en-tête pour effectuer l’opération uniquement si l’ETag de la ressource ne correspond pas à la valeur spécifiée. L’ETag doit être spécifié entre guillemets. |
|
If-Modified-Since |
string |
Optionnel. Valeur de date et d’heure. Spécifiez cet en-tête pour effectuer l’opération uniquement si la ressource a été modifiée depuis la date et l’heure spécifiées. |
|
If-Unmodified-Since |
string |
Optionnel. Valeur de date et d’heure. Spécifiez cet en-tête pour effectuer l’opération uniquement si la ressource n’a pas été modifiée depuis la date et l’heure spécifiées. |
|
x-ms-source-if-match |
string |
Optionnel. Valeur ETag. Spécifiez cet en-tête pour effectuer l’opération de renommage uniquement si l’ETag de la source correspond à la valeur spécifiée. L’ETag doit être spécifié entre guillemets. |
|
x-ms-source-if-none-match |
string |
Optionnel. Valeur ETag ou valeur générique spéciale (« * »). Spécifiez cet en-tête pour effectuer l’opération de renommage uniquement si l’ETag de la source ne correspond pas à la valeur spécifiée. L’ETag doit être spécifié entre guillemets. |
|
x-ms-source-if-modified-since |
string |
Optionnel. Valeur de date et d’heure. Spécifiez cet en-tête pour effectuer l’opération de renommage uniquement si la source a été modifiée depuis la date et l’heure spécifiées. |
|
x-ms-source-if-unmodified-since |
string |
Optionnel. Valeur de date et d’heure. Spécifiez cet en-tête pour effectuer l’opération de renommage uniquement si la source n’a pas été modifiée depuis la date et l’heure spécifiées. |
|
x-ms-encryption-key |
string |
Optionnel. Clé de chiffrement AES-256 codée en base64. |
|
x-ms-encryption-key-sha256 |
string |
Optionnel. Hachage SHA256 codé en Base64 de la clé de chiffrement. |
|
x-ms-encryption-algorithm: AES256 |
string |
Optionnel. Spécifie l’algorithme à utiliser pour le chiffrement. La valeur de cet en-tête doit être AES256. |
|
x-ms-encryption-context |
string |
Optionnel. La valeur par défaut est « Vide ». Si la valeur est définie, elle définit les métadonnées du système de fichiers/blob. Longueur maximale : 1024. Valide uniquement lorsque l’espace de noms hiérarchique est activé pour le compte. |
|
x-ms-client-transaction-id |
string |
Optionnel. La valeur par défaut est « Vide ». Si la valeur est définie, elle définit les métadonnées d’objet blob sur la création ou le renommage du fichier. Si la requête expire pour le client, cette valeur peut être extraite à l’aide de l’appel Get Properties pour confirmer si la demande de délai d’attente a réussi ou non à la fin du service. Longueur maximale : 36. Valide uniquement lorsque l’espace de noms hiérarchique est activé pour le compte. |
|
x-ms-client-request-id |
string |
Un UUID enregistré dans les journaux d’activité d’analytique pour la résolution des problèmes et la corrélation. Modèle d’expression régulière: |
|
x-ms-date |
string |
Spécifie le temps universel coordonné (UTC) de la requête. Cela est nécessaire lors de l’utilisation de l’autorisation de clé partagée. |
|
x-ms-version |
string |
Spécifie la version du protocole REST utilisée pour le traitement de la requête. Cela est nécessaire lors de l’utilisation de l’autorisation de clé partagée. |
Réponses
Nom | Type | Description |
---|---|---|
201 Created |
Le fichier ou le répertoire a été créé. En-têtes
|
|
Other Status Codes |
Une erreur s’est produite. L’état HTTP, le code et les chaînes de message possibles sont répertoriés ci-dessous :
En-têtes
|
Définitions
Nom | Description |
---|---|
Data |
|
Error |
Objet de réponse d’erreur de service. |
Path |
Optionnel. Valide uniquement lorsque l’espace de noms est activé. Ce paramètre détermine le comportement de l’opération de renommage. La valeur doit être « legacy » ou « posix », et la valeur par défaut est « posix ». |
Path |
Obligatoire uniquement pour créer un fichier et créer un répertoire. La valeur doit être « file » ou « directory ». |
DataLakeStorageError
Nom | Type | Description |
---|---|---|
error |
Objet de réponse d’erreur de service. |
Error
Objet de réponse d’erreur de service.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur du service. |
message |
string |
Message d’erreur du service. |
PathRenameMode
Optionnel. Valide uniquement lorsque l’espace de noms est activé. Ce paramètre détermine le comportement de l’opération de renommage. La valeur doit être « legacy » ou « posix », et la valeur par défaut est « posix ».
Nom | Type | Description |
---|---|---|
legacy |
string |
|
posix |
string |
PathResourceType
Obligatoire uniquement pour créer un fichier et créer un répertoire. La valeur doit être « file » ou « directory ».
Nom | Type | Description |
---|---|---|
directory |
string |
|
file |
string |