Placer une plage à partir de l’URL
L’opération Put Range From URL crée une plage à commiter dans le cadre d’un fichier dans lequel le contenu est lu à partir d’une URL. Cette opération est prise en charge dans la version 2019-02-02 et ultérieure pour les partages de fichiers avec le protocole SMB activé et prise en charge dans la version 2025-05-05 et versions ultérieures pour les partages de fichiers avec le protocole NFS activé.
| Protocole de partage de fichiers activé | Disponible |
|---|---|
| SMB |
|
| NFS |
|
La requête Put Range From URL est construite comme suit. Nous vous recommandons d’utiliser HTTPS.
| Méthode | URI de requête | Version HTTP |
|---|---|---|
| METTRE | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=range |
HTTP/1.1 |
Remplacez les composants de chemin d’accès indiqués dans l’URI de requête par vos propres composants, comme suit :
| Composant Path | Description |
|---|---|
myaccount |
Nom de votre compte de stockage. |
myshare |
Nom de votre partage de fichiers. |
mydirectorypath |
Optionnel. Chemin d’accès au répertoire parent. |
myfile |
Nom du fichier. |
Pour plus d’informations sur les restrictions de nommage de chemin d’accès, consultez partages de noms et de références, répertoires, fichiers et métadonnées.
| Paramètre | Description |
|---|---|
timeout |
Optionnel. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez Définir des délais d’attente pour les opérations Azure Files. |
Les en-têtes de requête obligatoires et facultatifs sont décrits dans les tableaux suivants :
| En-tête de requête | Description |
|---|---|
Authorization |
Obligatoire. Spécifie le schéma d’autorisation, le nom du compte et la signature. Pour plus d’informations, consultez Autoriser les demandes vers stockage Azure. |
Date ou x-ms-date |
Obligatoire. Spécifie le temps universel coordonné (UTC) de la requête. Pour plus d’informations, consultez Autoriser les demandes vers le stockage Azure. |
x-ms-version |
Obligatoire pour toutes les demandes autorisées. Spécifie la version de l’opération à utiliser pour cette requête. Cette opération est prise en charge dans la version 2019-02-02 et ultérieure pour les partages de fichiers avec le protocole SMB activé et prise en charge dans la version 2025-05-05 et versions ultérieures pour les partages de fichiers avec le protocole NFS activé. Pour plus d’informations, consultez Contrôle de version pour les services stockage Azure. |
x-ms-copy-source:name |
Obligatoire. Spécifie l’URL du fichier source. La valeur peut être une URL d’une longueur maximale de 2 Kio qui spécifie un fichier. La valeur doit être encodée en URL, car elle apparaît dans un URI de requête. Le fichier source doit être public ou doit être autorisé via une signature d’accès partagé. Si le fichier source est public, aucune autorisation n’est requise pour effectuer l’opération. Voici quelques exemples d’URL d’objet source :
|
x-ms-copy-source-authorization: <scheme> <signature> |
Optionnel. Spécifie le schéma d’autorisation et la signature de la source de copie. Pour plus d’informations, consultez Autoriser les demandes vers le stockage Azure. Seul le porteur de schéma est pris en charge pour Microsoft Entra. Cet en-tête est pris en charge dans la version 2020-10-02 et ultérieure. |
x-ms-write: { update } |
Obligatoire. Vous devez spécifier uniquement update. La requête échoue si elle est appelée avec clear. La valeur update écrit les octets spécifiés par le corps de la requête dans les plages spécifiées. |
Range ou x-ms-range |
Obligatoire.
Range ou x-ms-range est nécessaire.Spécifie la plage d’octets à écrire. Le début et la fin de la plage doivent être spécifiés. Cet en-tête est défini par la spécification de protocole HTTP/1.1 . Pour une opération de mise à jour, la plage peut atteindre jusqu’à 4 Mio de taille. Azure Files accepte uniquement une plage d’octets pour les en-têtes Range et x-ms-range, et la plage d’octets doit être spécifiée au format suivant : bytes=startByte-endByte.Si Range et x-ms-range sont spécifiés, le service utilise la valeur de x-ms-range. Pour plus d’informations, consultez Spécifier l’en-tête de plage pour les opérations Azure Files. |
x-ms-source-range |
Obligatoire. Spécifie la plage d’octets à lire à partir de la source. Le début et la fin de la plage doivent être spécifiés. Azure Files accepte uniquement une plage d’octets pour les en-têtes Range et x-ms-range, et la plage d’octets doit être spécifiée au format suivant : bytes=startByte-endByte.La plage source peut atteindre jusqu’à 4 Mio de taille. Si la taille de la plage source dépasse 4 Mio, Azure Files retourne le code d’état 413 (Entité de requête trop grande). Si la taille de plage source ne correspond pas à la taille de plage (plage cible), le service retourne le code d’état 400 (Requête incorrecte). |
Content-Length |
Obligatoire. Spécifie le nombre d’octets transmis dans le corps de la requête. La valeur de cet en-tête doit être définie sur 0. Lorsque la longueur n’est pas 0, l’opération échoue avec le code d’état 400 (demande incorrecte). |
x-ms-client-request-id |
Optionnel. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kibioctet (KiB) enregistrée dans les journaux lors de la configuration de la journalisation. Nous vous recommandons vivement d’utiliser cet en-tête pour mettre en corrélation les activités côté client avec les demandes reçues par le serveur. Pour plus d’informations, consultez Monitor Azure Files. |
x-ms-source-content-crc64 |
Optionnel. Hachage CRC64 de la plage spécifiée à partir de l’URI. Ce hachage est utilisé pour vérifier l’intégrité de la plage pendant le transport des données à partir de l’URI. Lorsque cet en-tête est spécifié, Azure Files compare le hachage du contenu arrivé à partir de la source de copie avec cette valeur d’en-tête. Remarque: ce hachage CRC64 n’est pas stocké avec le fichier. Si les deux hachages ne correspondent pas, l’opération échoue avec le code d’erreur 400 (requête incorrecte). |
x-ms-source-if-match-crc64 |
Optionnel. Valeur de somme de contrôle CRC64. Spécifiez cet en-tête pour effectuer l’opération uniquement si la somme de contrôle de la plage donnée est lue à partir des correspondances sources à partir de la somme de contrôle fournie. Si la condition spécifiée n’est pas remplie, Azure Files retourne le code d’état 412 (Échec de la condition préalable). |
x-ms-source-if-none-match-crc64 |
Optionnel. Valeur de somme de contrôle CRC64. Spécifiez cet en-tête pour effectuer l’opération uniquement si la somme de contrôle de la plage donnée lue à partir de la source est différente de la somme de contrôle fournie. Si la condition spécifiée n’est pas remplie, Azure Files retourne le code d’état 412 (Échec de la condition préalable). |
x-ms-lease-id: <ID> |
Obligatoire si le fichier a un bail actif. Disponible pour la version 2019-02-02 et ultérieure. Cet en-tête est ignoré si le fichier se trouve sur un partage de fichiers avec le protocole NFS activé, ce qui ne prend pas en charge les baux de fichiers. |
x-ms-client-request-id |
Optionnel. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kibioctet (KiB), qui est enregistrée dans les journaux d’activité d’analytique lorsque la journalisation Azure Storage Analytics est activée. Nous vous recommandons vivement d’utiliser cet en-tête lorsque vous associez des activités côté client aux demandes reçues par le serveur. Pour plus d’informations, consultez Monitor Blob Storage. |
x-ms-file-last-write-time: { now ¦ preserve } |
Optionnel. Version 2021-06-08 et ultérieure. Vous pouvez spécifier l’une des options suivantes :
|
x-ms-file-request-intent |
Obligatoire si Authorization en-tête spécifie un jeton OAuth. La valeur acceptable est backup. Cet en-tête spécifie que les Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action ou Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action doivent être accordés s’ils sont inclus dans la stratégie RBAC affectée à l’identité autorisée à l’aide de l’en-tête Authorization. Disponible pour la version 2022-11-02 et ultérieure. |
x-ms-allow-trailing-dot: { <Boolean> } |
Optionnel. Version 2022-11-02 et ultérieure. La valeur booléenne spécifie si un point de fin présent dans l’URL de requête doit être supprimé ou non. Cet en-tête est ignoré si la cible se trouve sur un partage de fichiers avec le protocole NFS activé, qui prend en charge le point de fin par défaut. Pour plus d’informations, consultez nommage et référencement de partages, répertoires, fichiers et métadonnées. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Optionnel. Version 2022-11-02 et ultérieure. La valeur booléenne spécifie si un point de fin présent dans l’URL source doit être supprimé ou non. Cet en-tête doit être spécifié uniquement si la source de copie se trouve sur un partage de fichiers Azure. Cet en-tête n’est pas pris en charge pour un autre type de source de copie. Cet en-tête est ignoré si la source de copie se trouve sur un partage de fichiers avec le protocole NFS activé, qui prend en charge le point de fin par défaut. Pour plus d’informations, consultez nommage et référencement de partages, répertoires, fichiers et métadonnées. |
Aucun.
Aucun.
Aucun corps de requête.
HTTP
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/mydir/myfile?comp=range HTTP/1.1
Request Headers:
x-ms-page-write: update
x-ms-copy-source: http://myaccount2.file.core.windows.net/myshare2/mydirectory2/myfile2?sv=2018-11-09&sp=r&sr=s&se=2018-08-22T09%3A59%3A28.2185790Z&sig=Qn6QEET3Gn%2FhCEVcXuwG7ssatIYiYRM5pNIy4Q3N0cQ%3D
x-ms-date: Fri, 22 Aug 2018 01:15:50 GMT
x-ms-version: 2019-02-02
x-ms-range: bytes=100-1023
x-ms-source-range: bytes=200-1123
x-ms-source-content-crc64: 3bedb8b3730fc205
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=
Content-Length: 0
La réponse inclut un code d’état HTTP et un ensemble d’en-têtes de réponse.
Une opération réussie retourne le code d’état 201 (créé). Pour plus d’informations sur les codes d’état, consultez Les codes d’état et d’erreur.
La réponse de cette opération inclut les en-têtes dans les tableaux suivants. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification de protocole HTTP/1.1 .
| En-tête de réponse | Description |
|---|---|
ETag |
Contient une valeur que vous pouvez utiliser pour effectuer des opérations de manière conditionnelle. La valeur est placée entre guillemets. |
Last-Modified |
Date et heure de la dernière modification du fichier. Le format de date suit RFC 1123. Pour plus d’informations, consultez Représentation des valeurs date/heure dans les en-têtes. Toute opération d’écriture sur le fichier, y compris les mises à jour des métadonnées ou des propriétés du fichier, modifie l’heure de dernière modification du fichier. |
x-ms-request-id |
Identifie de manière unique la demande qui a été effectuée et vous pouvez l’utiliser pour résoudre la demande. Pour plus d’informations, consultez Résoudre les problèmes d’opérations d’API. |
x-ms-version |
Indique la version de l’API FileREST utilisée pour exécuter la requête. |
Date |
Valeur de date/heure UTC générée par le service, qui indique l’heure à laquelle la réponse a été lancée. |
x-ms-content-crc64 |
Retourné afin que le client puisse vérifier l’intégrité du contenu du message. La valeur de cet en-tête est calculée par Azure Files. Il n’est pas nécessairement identique à la valeur spécifiée dans les en-têtes de requête. |
x-ms-client-request-id |
Peut être utilisé pour résoudre les demandes et les réponses correspondantes. La valeur de cet en-tête est égale à la valeur de l’en-tête x-ms-client-request-id s’il est présent dans la requête et que la valeur ne contient pas plus de 1 024 caractères ASCII visibles. Si l’en-tête x-ms-client-request-id n’est pas présent dans la requête, il ne sera pas présent dans la réponse. |
x-ms-file-last-write-time |
Version 2021-06-08 et ultérieure. Dernière heure d’écriture du fichier, au format ISO 8601 (par exemple, 2017-05-10T17:52:33.9551861Z). |
Aucun.
Aucun.
Aucun.
HTTP
Response Status:
HTTP/1.1 201 Created
Response Headers:
Date: Sun, 22 Aug 2020 01:33:35 GMT
ETag: "0x8CB171BA9E94B0B"
Last-Modified: Wed, 22 Aug 2020 01:13:31 GMT
x-ms-version: 2019-02-02
x-ms-content-crc64: 3bedb8b3730fc205
Content-Length: 0
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Seul le propriétaire du compte peut appeler cette opération.
L’opération Put Range From URL écrit une plage de données dans un fichier et est similaire au comportement de l’opération de Put Range. Il utilise l’opération de Get File sur la source spécifiée pour lire les données, les métadonnées et d’autres propriétés du fichier source. Dans la version 2020-10-02 et ultérieure, l’autorisation Microsoft Entra est prise en charge pour la source de l’opération de copie.
L’opération Put Range From URL retourne la réussite 201 (Créée) uniquement si la plage spécifiée est écrite dans le fichier.
opérations sur les fichiers