Bestand kopiëren
De Copy File bewerking kopieert een blob of bestand naar een doelbestand in het opslagaccount. Deze bewerking wordt ondersteund in versie 2015-02-21 en hoger voor bestandsshares waarvoor SMB-protocol is ingeschakeld en ondersteund in versie 2025-05-05 en hoger voor bestandsshares waarvoor het NFS-protocol is ingeschakeld.
Beschikbaarheid van protocol
| Protocol voor bestandsshare ingeschakeld | Beschikbaar |
|---|---|
| SMB |
|
| NFS |
|
Verzoek
De Copy File aanvraag wordt als volgt samengesteld. U wordt aangeraden HTTPS te gebruiken.
Vanaf versie 2013-08-15 kunt u een handtekening voor gedeelde toegang voor het doelbestand opgeven als het zich in hetzelfde account bevindt als het bronbestand. Vanaf versie 2015-04-05 kunt u ook een handtekening voor gedeelde toegang opgeven voor het doelbestand als het zich in een ander opslagaccount bevinden.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| ZETTEN | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
HTTP/1.1 |
Vervang de padonderdelen in de aanvraag-URI als volgt door uw eigen padonderdelen:
| Padonderdeel | Beschrijving |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van uw bestandsshare. |
mydirectorypath |
Facultatief. Het pad naar de bovenliggende map. |
myfile |
De naam van het bestand. |
Zie Naamgeving en verwijzingen naar shares, mappen, bestanden en metagegevensvoor meer informatie over padnaamgevingsbeperkingen.
URI-parameters
U kunt de volgende aanvullende parameters opgeven voor de aanvraag-URI:
| Parameter | Beschrijving |
|---|---|
timeout |
Facultatief. De parameter timeout wordt uitgedrukt in seconden. Zie Time-outs instellen voor Azure Files-bewerkingenvoor meer informatie. |
Aanvraagheaders
De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabellen:
Algemene aanvraagheaders
| Aanvraagheader | Beschrijving |
|---|---|
Authorization |
Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. |
Date of x-ms-date |
Vereist. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Deze bewerking wordt ondersteund in versie 2015-02-21 en hoger voor bestandsshares waarvoor SMB-protocol is ingeschakeld en ondersteund in versie 2025-05-05 en hoger voor bestandsshares waarvoor het NFS-protocol is ingeschakeld. Zie Versiebeheer voor de Azure Storage-servicesvoor meer informatie. |
x-ms-meta-name:value |
Facultatief. Hiermee geeft u naam/waardeparen die zijn gekoppeld aan het bestand als metagegevens. Als er geen naam-/waardeparen zijn opgegeven, kopieert de bewerking de metagegevens van de bron-blob of het bestand naar het doelbestand. Als een of meer naam-waardeparen zijn opgegeven, wordt het doelbestand gemaakt met de opgegeven metagegevens en worden de metagegevens niet gekopieerd uit de bron-blob of het bron-blobbestand. Namen van metagegevens moeten voldoen aan de naamgevingsregels voor C#-id's. Bestandsmetagegevens die zijn opgegeven via Azure Files, zijn niet toegankelijk vanuit een SMB-client. |
x-ms-copy-source:name |
Vereist. Hiermee geeft u de URL van het bronbestand of de blob, maximaal 2 kibibytes (KiB) in lengte. Als u een bestand naar een ander bestand in hetzelfde opslagaccount wilt kopiëren, kunt u een gedeelde sleutel gebruiken om het bronbestand te autoriseren. Als u een bestand kopieert vanuit een ander opslagaccount of als u een blob kopieert vanuit hetzelfde opslagaccount of een ander opslagaccount, moet u het bronbestand of de blob autoriseren met behulp van een handtekening voor gedeelde toegang. Als de bron een openbare blob is, is er geen autorisatie vereist om de kopieerbewerking uit te voeren. U kunt ook een bestand in een momentopname van een share opgeven als een kopiebron. Hier volgen enkele voorbeelden van URL's voor bronobjecten:
|
x-ms-lease-id:<ID> |
Vereist als het doelbestand een actieve lease heeft. Beschikbaar voor versie 2019-02-02 en hoger. De lease-id die voor deze header is opgegeven, moet overeenkomen met de lease-id van het doelbestand. Als de aanvraag de lease-id niet bevat of de id niet geldig is, mislukt de bewerking met statuscode 412 (Voorwaarde mislukt). Als deze header is opgegeven en het doelbestand momenteel geen actieve lease heeft, mislukt de bewerking met statuscode 412 (Voorwaarde mislukt). Deze header wordt genegeerd als het doelbestand zich op een bestandsshare bevindt waarvoor het NFS-protocol is ingeschakeld. Dit biedt geen ondersteuning voor bestandsleases. |
x-ms-file-creation-time |
Facultatief. Beschikbaar voor versie 2019-07-07 en hoger. Deze header geeft de eigenschap op voor de aanmaaktijd, in UTC, die moet worden ingesteld op het doelbestand. U kunt een waarde van source gebruiken om de aanmaaktijd van het bronbestand naar het doelbestand te kopiëren. |
x-ms-file-last-write-time |
Facultatief. Beschikbaar voor versie 2019-07-07 en hoger. Deze header geeft de eigenschap op voor de laatste schrijftijd, in UTC, die moet worden ingesteld op het doelbestand. U kunt een waarde van source gebruiken om de laatste schrijftijd van het bronbestand naar het doelbestand te kopiëren. |
x-ms-client-request-id |
Facultatief. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 KiB-tekens die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Blob Storage-bewaken voor meer informatie. |
x-ms-file-request-intent |
Vereist als Authorization header een OAuth-token opgeeft. Acceptabele waarde is backup. Deze header geeft aan dat de Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action of Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action moeten worden verleend als ze zijn opgenomen in het RBAC-beleid dat is toegewezen aan de identiteit die is geautoriseerd met behulp van de Authorization-header. Beschikbaar voor versie 2022-11-02 en hoger. |
x-ms-allow-trailing-dot: { <Boolean> } |
Facultatief. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een volgpunt aanwezig in de aanvraag-URL moet worden ingekort of niet. Deze header wordt genegeerd als het doel zich op een bestandsshare bevindt waarvoor het NFS-protocol is ingeschakeld. Dit biedt standaard ondersteuning voor een volgpunt. Zie Shares, mappen, bestanden en metagegevensvoor meer informatie. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Facultatief. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een volgpunt in de bron-URL moet worden ingekort of niet. Deze header moet alleen worden opgegeven als de kopieerbron zich op een Azure-bestandsshare bevindt. Deze header wordt niet ondersteund voor een ander type kopieerbron. Deze header wordt genegeerd als de kopieerbron zich op een bestandsshare bevindt waarvoor het NFS-protocol is ingeschakeld. Dit biedt standaard ondersteuning voor een volgpunt. Zie Shares, mappen, bestanden en metagegevensvoor meer informatie. |
Alleen aanvraagheaders voor SMB
| Aanvraagheader | Beschrijving |
|---|---|
x-ms-file-change-time: { <DateTime> ¦ source } |
Facultatief. Versie 2021-06-08 en hoger. De utc-wijzigingstijdeigenschap voor het bestand, opgemaakt in de ISO 8601-indeling. Een waarde van source kan worden gebruikt om de wijzigingstijd van het bronbestand naar het doelbestand te kopiëren. Het standaardtijdstempel is het tijdstip van de aanvraag. |
x-ms-file-permission-copy-mode: { source ¦ override } |
Facultatief. Beschikbaar voor versie 2019-07-07 en hoger. Bepaalt het kopieergedrag van de beveiligingsdescriptor van het bestand:
|
x-ms-file-permission: { <SDDL> ¦ <binary> } |
Vereist als x-ms-file-permission-copy-mode is opgegeven als override en x-ms-file-permission-key niet is opgegeven. Beschikbaar voor versie 2019-07-07 en hoger. Deze machtiging is de beveiligingsdescriptor voor het bestand dat is opgegeven in de Security Descriptor Definition Language (SDDL) of (versie 2025-01-05 of hoger) in base64-gecodeerde binaire beveiligingsdescriptorindeling. U kunt opgeven welke indeling moet worden gebruikt met de x-ms-file-permission-format-header. U kunt deze header gebruiken als de grootte van de machtigingen 8 kibibytes (KiB) of kleiner is. Anders kunt u x-ms-file-permission-keygebruiken. Indien opgegeven, moet deze een eigenaar, groep en discretionaire toegangsbeheerlijst (DACL)hebben. Er kan slechts één van x-ms-file-permission of x-ms-file-permission-key worden opgegeven. |
x-ms-file-permission-key |
Vereist als x-ms-file-permission-copy-mode is opgegeven als override en x-ms-file-permission niet is opgegeven. Beschikbaar voor versie 2019-07-07 en hoger. Deze header geeft de sleutel op van de machtiging die moet worden ingesteld voor het bestand. U kunt deze sleutel maken met behulp van de Create Permission bewerking.Er kan slechts één van x-ms-file-permission of x-ms-file-permission-key worden opgegeven. |
x-ms-file-permission-format: { sddl ¦ binary } |
Facultatief. Versie 2025-01-05 of hoger. Hiermee geeft u op of de waarde die is doorgegeven in x-ms-file-permission zich in SDDL of in binaire indeling bevindt. Als deze header niet is ingesteld, wordt de standaardwaarde van sddl gebruikt. |
x-ms-file-attributes |
Facultatief. Beschikbaar voor versie 2019-07-07 en hoger. Deze header geeft de kenmerken van het bestandssysteem op die moeten worden ingesteld op het doelbestand. Zie de lijst met beschikbare kenmerken. U kunt een waarde van source gebruiken om de kenmerken van het bronbestand naar het doelbestand te kopiëren. U kunt een waarde van none gebruiken om alle kenmerken in het doelbestand te wissen. |
x-ms-file-copy-ignore-readonly |
Facultatief. Beschikbaar voor versie 2019-07-07 en hoger. Deze Booleaanse waarde geeft aan of het kenmerk ReadOnly op een vooraf bestaande doelbestand moet worden gerespecteerd. Als het trueis, slaagt de kopieerbewerking. Anders zorgt een vorig bestand op de bestemming met de ReadOnly kenmerkset ervoor dat de kopieerbewerking mislukt. |
x-ms-file-copy-set-archive |
Facultatief. Beschikbaar voor versie 2019-07-07 en hoger. Deze Booleaanse waarde geeft aan of het kenmerk Archive moet worden ingesteld, ongeacht de x-ms-file-attributes headerwaarde. |
Alleen aanvraagheaders voor NFS
| Aanvraagheader | Beschrijving |
|---|---|
x-ms-file-mode-copy-mode: { source ¦ override } |
Facultatief. Versie 2025-05-05 en hoger. Alleen van toepassing wanneer de kopieerbron een bestand is dat zich op een bestandsshare bevindt met het NFS-protocol ingeschakeld. Bepaalt het kopieergedrag van de modus-bits van het bestand:
|
x-ms-mode |
Versie 2025-05-05 en hoger. Vereist als x-ms-file-mode-copy-mode is opgegeven als override. De modus-bits die moeten worden ingesteld op het bestand. De modus wordt weergegeven in de 12-bits octale notatie of de symbolische 'rwx'-indeling. Zie POSIX-bestandsmachtigingen (modus). |
x-ms-file-owner-copy-mode: { source ¦ override } |
Facultatief. Versie 2025-05-05 en hoger. Alleen van toepassing wanneer de kopieerbron een bestand is dat zich op een bestandsshare bevindt met het NFS-protocol ingeschakeld. Bepaalt het kopieergedrag van de gebruikers-id (UID) en groeps-id (GID) van het bestand:
|
x-ms-owner |
Versie 2025-05-05 en hoger. De gebruikers-id (UID) van de bestandseigenaar die moet worden ingesteld op het bestand. Vereist als x-ms-file-owner-copy-mode is opgegeven als override. |
x-ms-group |
Versie 2025-05-05 en hoger. De groeps-id (GID) van de bestandseigenaar die moet worden ingesteld op het bestand. Vereist als x-ms-file-owner-copy-mode is opgegeven als override. |
Aanvraagbody
Geen.
Antwoord
Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.
Statuscode
Een geslaagde bewerking retourneert statuscode 202 (Geaccepteerd). Zie Status en foutcodesvoor meer informatie over statuscodes.
Antwoordheaders
Het antwoord voor deze bewerking bevat de headers in de volgende tabellen. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
Algemene antwoordheaders
| Antwoordheader | Beschrijving |
|---|---|
ETag |
Als de kopieerbewerking is voltooid, bevat de ETag waarde van het doelbestand. Als de kopieerbewerking niet is voltooid, bevat de ETag waarde van het lege bestand dat aan het begin van de bewerking is gemaakt. |
Last-Modified |
Retourneert de datum/tijd waarop de kopieerbewerking naar het doelbestand is voltooid. |
x-ms-request-id |
Identificeer de aanvraag die is gedaan, uniek. U kunt deze header gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossenvoor meer informatie. |
x-ms-version |
Geeft de versie van Azure Files aan die wordt gebruikt om de aanvraag uit te voeren. |
Date |
Een UTC-datum/tijd-waarde die de tijd aangeeft waarop de service het antwoord heeft verzonden. |
x-ms-copy-id: <id> |
Biedt een tekenreeks-id voor deze kopieerbewerking. Gebruik met Get File of Get File Properties om de status van deze kopieerbewerking te controleren of geef Abort Copy File door om een in behandeling zijnde kopieerbewerking te annuleren. |
x-ms-copy-status: <success ¦ pending> |
Geeft de status van de kopieerbewerking aan met deze waarden: - success: de kopieerbewerking is voltooid.- pending: de kopieerbewerking wordt nog uitgevoerd. |
x-ms-client-request-id |
Kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde maximaal 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord. |
Alleen SMB-antwoordheaders
Geen.
Alleen antwoordheaders van NFS
Geen.
Hoofdtekst van antwoord
Geen
Voorbeeldantwoord
Response Status:
HTTP/1.1 202 Accepted
Response Headers:
Last-Modified: <date>
ETag: "0x8CEB669D794AFE2"
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402
x-ms-version: 2015-02-21
x-ms-copy-id: 1f812371-a41d-49e6-b123-f4b542e851c5
x-ms-copy-status: pending
Date: <date>
Machtiging
Deze bewerking kan worden aangeroepen door de accounteigenaar of door een client die beschikt over een handtekening voor gedeelde toegang die gemachtigd is om naar het doelbestand of de bijbehorende share te schrijven. Houd er rekening mee dat de handtekening voor gedeelde toegang die is opgegeven in de aanvraag alleen van toepassing is op het doelbestand.
Toegang tot het bronbestand of de blob wordt afzonderlijk geautoriseerd, zoals beschreven in de details voor de aanvraagheader x-ms-copy-source.
In de volgende tabel wordt beschreven hoe de doel- en bronobjecten voor een Copy File bewerking kunnen worden geautoriseerd:
| Bestand | Autorisatie met gedeelde sleutel of gedeelde sleutel lite | Autorisatie met Shared Access Signature | Openbaar object vereist geen autorisatie |
|---|---|---|---|
| Doelbestand | Ja | Ja | Niet van toepassing |
| Bronbestand in hetzelfde account | Ja | Ja | Niet van toepassing |
| Bronbestand in een ander account | Nee | Ja | Niet van toepassing |
| Bronblob in hetzelfde account of een ander account | Nee | Ja | Ja |
Bestandssysteemkenmerken
| Attribuut | Win32-bestandskenmerk | Definitie |
|---|---|---|
ReadOnly |
FILE_ATTRIBUTE_READONLY |
Het bestand heeft het kenmerk Alleen-lezen. Toepassingen kunnen het bestand lezen, maar kunnen er niet naar schrijven of verwijderen. |
Hidden |
FILE_ATTRIBUTE_HIDDEN |
Het bestand is verborgen. Deze is niet opgenomen in een gewone lijst met mappen. |
System |
FILE_ATTRIBUTE_SYSTEM |
Het besturingssysteem maakt gebruik van een deel van het bestand of maakt uitsluitend gebruik van het bestand. |
None |
FILE_ATTRIBUTE_NORMAL |
Er zijn geen andere kenmerken ingesteld voor het bestand. Dit kenmerk is alleen geldig wanneer het alleen wordt gebruikt. |
Archive |
FILE_ATTRIBUTE_ARCHIVE |
Het bestand is een archiefbestand. Toepassingen gebruiken dit kenmerk doorgaans om bestanden te markeren voor back-up of verwijdering. |
Temporary |
FILE_ATTRIBUTE_TEMPORARY |
Het bestand wordt gebruikt voor tijdelijke opslag. |
Offline |
FILE_ATTRIBUTE_OFFLINE |
De gegevens van het bestand zijn niet onmiddellijk beschikbaar. Dit bestandssysteemkenmerk biedt voornamelijk compatibiliteit met Windows. Azure Files biedt geen ondersteuning voor offlineopslagopties. |
NotContentIndexed |
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED |
De inhoudsindexeringsservice indexeert het bestand niet. |
NoScrubData |
FILE_ATTRIBUTE_NO_SCRUB_DATA |
De scanner voor de integriteit van achtergrondgegevens leest de gegevensstroom van de gebruiker niet. Dit bestandssysteemkenmerk biedt voornamelijk compatibiliteit met Windows. |
POSIX-bestandsmachtigingen (modus)
POSIX-bestandsmachtigingen kunnen numeriek worden opgegeven in een 12-bits numerieke octale indeling of in een symbolische 'rwx'-indeling. Voorbeelden:
- "0644" of "rw-r--r--": gebruiker (bestandseigenaar) heeft lees-, schrijfmachtigingen. De groep heeft leesmachtigingen. Anderen hebben leesmachtigingen.
- "0755" of "rwxr-xr-x": gebruiker (bestandseigenaar) heeft lees-, schrijf- en uitvoermachtigingen. Groep heeft lees- en uitvoermachtigingen. Anderen hebben lees- en uitvoermachtigingen.
Numerieke octale notatie
De drie laagste octale getallen vertegenwoordigen de machtigingen voor eigenaar/gebruiker, groep en andere en worden aangegeven met behulp van een octaal getal (0-7), gevormd met behulp van een bitsgewijze combinatie van '4' (Lezen), '2' (Schrijven), '1' (Uitvoeren). Het hoogste octale getal (0-7) wordt gebruikt om een combinatie van '4' (SetUID), '2' (SetGID), '1' (StickyBit)-machtigingen aan te geven.
| Formatteren | Toestemming |
|---|---|
| 0700 | Gebruiker (bestandseigenaar) heeft lees-, schrijf- en uitvoermachtigingen. |
| 0400 | Gebruiker heeft leesmachtigingen. |
| 0200 | Gebruiker heeft schrijfmachtigingen. |
| 0100 | De gebruiker heeft een machtiging voor uitvoeren. |
| 0070 | Groep heeft lees-, schrijf- en uitvoermachtigingen. |
| 0040 | De groep heeft leesmachtigingen. |
| 0020 | De groep heeft schrijfmachtigingen. |
| 0010 | De groep heeft een machtiging voor uitvoeren. |
| 0007 | Anderen hebben lees-, schrijf- en uitvoermachtigingen. |
| 0004 | Anderen hebben leesmachtigingen. |
| 0002 | Anderen hebben schrijfmachtigingen. |
| 0001 | Anderen hebben een machtiging voor uitvoeren. |
| 4000 | Stel de effectieve gebruikers-id in het bestand in. |
| 2000 | Stel de effectieve groeps-id in voor het bestand. |
| 1000 | Ingesteld om aan te geven dat het bestand alleen kan worden verwijderd of hernoemd door bestandseigenaar, mapeigenaar of hoofdgebruiker. |
Symbolische indeling 'rwx'
Machtigingen voor eigenaar/gebruiker, groep en andere worden aangegeven met behulp van een combinatie van 'r' (lezen), 'w' (schrijven) en 'x' (Uitvoeren).
| Formatteren | Toestemming |
|---|---|
| rwx------ | Gebruiker (bestandseigenaar) heeft lees-, schrijf- en uitvoermachtigingen. |
| r-------- | Gebruiker heeft leesmachtigingen. |
| -w------- | Gebruiker heeft schrijfmachtigingen. |
| --x------ | De gebruiker heeft een machtiging voor uitvoeren. |
| ---wx--- | Groep heeft lees-, schrijf- en uitvoermachtigingen. |
| ---r----- | De groep heeft leesmachtigingen. |
| ----w---- | De groep heeft schrijfmachtigingen. |
| -----x--- | De groep heeft een machtiging voor uitvoeren. |
| ------wx | Anderen hebben lees-, schrijf- en uitvoermachtigingen. |
| ------r- | Anderen hebben leesmachtigingen. |
| -------w- | Anderen hebben schrijfmachtigingen. |
| --------x | Anderen hebben een machtiging voor uitvoeren. |
Opmerkingen
De Copy File bewerking kan asynchroon worden voltooid. U kunt de kopieer-id gebruiken die de x-ms-copy-id antwoordheader retourneert om de status van de kopieerbewerking te controleren of deze te annuleren. Azure Files kopieert bestanden op basis van best effort.
Als het doelbestand bestaat, wordt het overschreven. U kunt het doelbestand niet wijzigen terwijl de kopieerbewerking wordt uitgevoerd.
De Copy File bewerking kopieert altijd de hele bron-blob of het hele bestand. Het kopiëren van een bereik van bytes of een set blokken wordt niet ondersteund.
De bron van een Copy File bewerking kan een bestand zijn dat zich in een momentopname van een share bevindt. Het doel van een Copy File bewerking kan geen bestand zijn dat zich in een momentopname van een share bevindt.
Wanneer de bron van een kopieerbewerking ETag waarden levert, mislukt deze als er wijzigingen in de bron zijn terwijl de bewerking wordt uitgevoerd. Een poging om het doelbestand te wijzigen terwijl er een kopieerbewerking wordt uitgevoerd, mislukt met statuscode 409 (Conflict).
De ETag waarde voor het doelbestand wordt gewijzigd wanneer de Copy File bewerking wordt gestart. Deze blijft regelmatig veranderen tijdens de kopieerbewerking.
Eigenschappen en metagegevens kopiëren
Wanneer een blob of bestand wordt gekopieerd, worden de volgende systeemeigenschappen met dezelfde waarden gekopieerd naar het doelbestand:
Content-TypeContent-EncodingContent-LanguageContent-LengthCache-ControlContent-MD5Content-Disposition
Het doelbestand heeft altijd dezelfde grootte als de bron-blob of het bronbestand. De waarde van de Content-Length-header voor het doelbestand komt overeen met de waarde van die header voor de bron-blob of het bestand.
Een geleasede blob of bestand kopiëren naar een bestand
De Copy File bewerking leest alleen uit de bron-blob of het bestand, dus een lease op het bronobject heeft geen invloed op de bewerking. Met de Copy File bewerking wordt de ETag waarde van de bron-blob of het bronbestand opgeslagen wanneer de bewerking wordt gestart. Als de ETag waarde verandert voordat de kopieerbewerking is voltooid, mislukt de bewerking. U kunt wijzigingen in de bronblob van het bestand voorkomen door het te leasen tijdens de kopieerbewerking.
Als het doelbestand een actieve oneindige lease heeft, moet u de lease-id opgeven in de aanroep van de Copy File bewerking. Terwijl de kopieerbewerking in behandeling is, mislukt elke leasebewerking in het doelbestand met statuscode 409 (Conflict). Een oneindige lease voor het doelbestand wordt op deze manier vergrendeld tijdens de kopieerbewerking, ongeacht of u kopieert naar een doelbestand met een andere naam dan de bron of het kopiëren naar een doelbestand met dezelfde naam als de bron. Als de client een lease-id opgeeft voor een bestand dat nog niet bestaat, retourneert Azure Files statuscode 412 (Voorwaarde mislukt).
Werken met een kopieerbewerking in behandeling
De Copy File bewerking kan het kopiëren van de bestanden asynchroon voltooien. Gebruik de volgende tabel om de volgende stap te bepalen op basis van de statuscode die Copy File retourneert:
| Statuscode | Betekenis |
|---|---|
| 202 (Geaccepteerd), x-ms-copy-status: geslaagd | De kopieerbewerking is voltooid. |
| 202 (Geaccepteerd), x-ms-copy-status: in behandeling | De kopieerbewerking is niet voltooid. Poll de doel-blob met behulp van Get File Properties om x-ms-copy-status te onderzoeken totdat de kopieerbewerking is voltooid of mislukt. |
| 4xx, 500 of 503 | De kopieerbewerking is mislukt. |
Tijdens en na een Copy File bewerking bevatten de eigenschappen van het doelbestand de kopieer-id van de Copy File-bewerking en de URL van de bron-blob of het bestand. Wanneer de bewerking is voltooid, schrijft Azure Files de waarde van de tijd en het resultaat (success, failedof aborted) naar de eigenschappen van het doelbestand. Als de bewerking een failed resultaat heeft, bevat de x-ms-copy-status-description header een foutdetailtekenreeks.
Een in behandeling zijnde Copy File bewerking heeft een time-out van twee weken. Een kopieerpoging die na twee weken nog niet is voltooid en een leeg bestand verlaat met het x-ms-copy-status veld ingesteld op failed en het x-ms-status-description veld is ingesteld op 500 (OperationCancelled). Onregelmatige, niet-fatale fouten die kunnen optreden tijdens een kopieerbewerking, kunnen de voortgang van de bewerking belemmeren, maar niet tot een storing leiden. In deze gevallen beschrijft x-ms-copy-status-description de onregelmatige fouten.
Pogingen om het doelbestand tijdens de kopieerbewerking te wijzigen, mislukken met statuscode 409 (Conflict), 'Bestand kopiëren wordt uitgevoerd'.
Als u een Abort Copy File-bewerking aanroept, ziet u een x-ms-copy-status:aborted header. Het doelbestand heeft intacte metagegevens en een bestandsgrootte van 0 bytes. U kunt de oorspronkelijke aanroep herhalen om Copy File om de bewerking opnieuw uit te voeren.
Facturering
Het doelaccount van een Copy File bewerking wordt in rekening gebracht voor één transactie om de bewerking te starten. Het doelaccount maakt ook één transactie voor elke aanvraag om de status van de kopieerbewerking te annuleren of aan te vragen.
Wanneer het bronbestand of de blob zich in een ander account bevindt, worden transactiekosten in rekening gebracht voor het bronaccount. Als de bron- en doelaccounts zich bovendien in verschillende regio's bevinden (bijvoorbeeld VS - noord en VS - zuid), wordt de bandbreedte die u gebruikt om de aanvraag over te dragen, in rekening gebracht voor het bronaccount als uitgaand verkeer. Uitgaand verkeer tussen accounts binnen dezelfde regio is gratis.