Bestandseigenschappen ophalen
De Get File Properties bewerking retourneert alle door de gebruiker gedefinieerde metagegevens, standaard-HTTP-eigenschappen en systeemeigenschappen voor het bestand. De inhoud van het bestand wordt niet geretourneerd.
Protocol beschikbaarheid
| Bestandsshareprotocol ingeschakeld | Beschikbaar |
|---|---|
| SMB |
|
| NFS |
|
Aanvraag
De Get File Properties aanvraag kan als volgt worden samengesteld. U wordt aangeraden HTTPS te gebruiken.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
HEAD |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
HTTP/1.1 |
HEAD |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime> |
HTTP/1.1 |
Vervang als volgt de padonderdelen die worden weergegeven in de aanvraag-URI door uw eigen onderdelen:
| Padonderdeel | Description |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van de bestandsshare. |
mydirectorypath |
Optioneel. Het pad naar de bovenliggende map. |
myfile |
De naam van het bestand. |
Zie Naam- en verwijzingsshares, mappen, bestanden en metagegevens voor meer informatie over beperkingen voor padnamen.
URI-parameters
De volgende aanvullende parameters kunnen worden opgegeven voor de aanvraag-URI:
| Parameter | Beschrijving |
|---|---|
sharesnapshot |
Optioneel. Versie 2017-04-17 en hoger. De sharesnapshot parameter is een ondoorzichtige DateTime-waarde die, indien aanwezig, de momentopname van de share aangeeft waarop de bestandseigenschappen moeten worden opgevraagd. |
timeout |
Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor Azure Files bewerkingen voor meer informatie. |
Aanvraagheaders
De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:
| Aanvraagheader | Description |
|---|---|
| Autorisatie | Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie. |
Date of x-ms-date |
Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie. |
x-ms-lease-id:<ID> |
Optioneel. Versie 2019-02-02 en hoger. Als de header is opgegeven, wordt de bewerking alleen uitgevoerd als de lease van het bestand momenteel actief is en de lease-id die is opgegeven in de aanvraag overeenkomt met de lease-id van het bestand. Als deze niet overeenkomt, mislukt de bewerking met statuscode 412 (voorwaarde mislukt). |
x-ms-client-request-id |
Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB), die wordt vastgelegd in de analyselogboeken wanneer Logboekregistratie van Azure Opslaganalyse is ingeschakeld. We raden u ten zeerste aan deze header te gebruiken wanneer u activiteiten aan de clientzijde correleert met aanvragen die door de server worden ontvangen. Zie Azure Blob Storage bewaken voor meer informatie. |
x-ms-file-request-intent |
Vereist als Authorization de 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 moet worden verleend als deze 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> } |
Optioneel. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een volgpunt in de aanvraag-URL moet worden ingekort of niet. Zie Shares, mappen, bestanden en metagegevens een naam geven en hiernaar verwijzen voor meer informatie. |
Aanvraagbody
Geen.
Antwoord
Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.
Statuscode
Een geslaagde bewerking retourneert statuscode 200 (OK).
Zie Status- en foutcodes voor meer informatie over statuscodes.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Description |
|---|---|
Last-Modified |
Retourneert de datum en tijd waarop het bestand voor het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Datum-/tijdwaarden weergeven in kopteksten voor meer informatie. Elke bewerking die het bestand of de eigenschappen ervan wijzigt, wordt de laatste wijzigingstijd bijgewerkt. |
x-ms-meta-name:value |
Een set naam-waardeparen die als door de gebruiker gedefinieerde metagegevens aan dit bestand zijn gekoppeld. |
x-ms-type: <File> |
Retourneert het type File. Gereserveerd voor toekomstig gebruik. |
Content-Length |
De grootte van het bestand in bytes. Deze header retourneert de waarde van de x-ms-content-length header die bij het bestand is opgeslagen. |
Content-Type |
Het inhoudstype dat is opgegeven voor het bestand. Als er geen inhoudstype is opgegeven, is application/octet-streamhet standaardinhoudstype . |
ETag |
De ETag bevat een waarde die u kunt gebruiken om bewerkingen voorwaardelijk uit te voeren. De waarde staat tussen aanhalingstekens. |
Content-MD5 |
Als de Content-MD5 header voor het bestand is ingesteld, wordt de Content-MD5 antwoordheader geretourneerd, zodat de client de integriteit van de berichtinhoud kan controleren. |
Content-Encoding |
Als de Content-Encoding aanvraagheader eerder is ingesteld voor het bestand, wordt de Content-Encoding waarde in deze header geretourneerd. |
Content-Language |
Als de Content-Language aanvraagheader eerder is ingesteld voor het bestand, wordt de Content-Language waarde in deze header geretourneerd. |
Cache-Control |
Als de Cache-Control aanvraagheader eerder is ingesteld voor het bestand, wordt de Cache-Control waarde geretourneerd in deze header. |
Content-Disposition |
Retourneert de waarde die is opgegeven voor de x-ms-content-disposition header en geeft aan hoe het antwoord moet worden verwerkt.Het Content-Disposition veld antwoordheader bevat aanvullende informatie over het verwerken van de nettolading van het antwoord en u kunt deze gebruiken om aanvullende metagegevens toe te voegen. Als deze bijvoorbeeld is ingesteld op attachment, Content-Disposition geeft dit aan dat de gebruikersagent het antwoord niet mag weergeven, maar dat in plaats daarvan het venster Opslaan als moet worden weergegeven. |
x-ms-request-id |
Identificeert op unieke wijze de aanvraag die is gedaan en kan worden gebruikt om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie. |
x-ms-version |
Geeft de serviceversie aan die is gebruikt om de aanvraag uit te voeren. |
Date |
Een UTC-datum/tijd-waarde die wordt gegenereerd door de service, die de tijd aangeeft waarop het antwoord is geïnitieerd. |
x-ms-copy-completion-time:<datetime> |
Versie 21-02-2015 en hoger. De eindtijd van de laatste poging om bestand te kopiëren waarbij dit bestand het doelbestand was. Deze waarde kan het tijdstip opgeven van een voltooide, afgebroken of mislukte kopieerpoging. Deze koptekst wordt niet weergegeven als er een kopie in behandeling is, als dit bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking met behulp van Bestandseigenschappen instellen of Bestand maken. |
x-ms-copy-status-description: <error string> |
Versie 21-02-2015 en hoger. Wordt alleen weergegeven wanneer x-ms-copy-statusmislukt of in behandeling is. Hierin wordt de oorzaak beschreven van een fatale of niet-fatale kopieerbewerkingsfout. Deze koptekst wordt niet weergegeven als er een kopie in behandeling is, als dit bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking met behulp van Bestandseigenschappen instellen of Bestand maken. |
x-ms-copy-id: <id> |
Versie 21-02-2015 en hoger. De tekenreeks-id voor de laatste poging om bestand te kopiëren waarbij dit bestand het doelbestand was. Deze koptekst wordt niet weergegeven als dit bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking met behulp van Bestandseigenschappen instellen of Bestand maken. |
x-ms-copy-progress: <bytes copied/bytes total> |
Versie 21-02-2015 en hoger. Bevat het aantal bytes dat is gekopieerd en het totale aantal bytes in de bron in de laatste poging bestand kopiëren waarbij dit bestand het doelbestand was. Kan tussen 0 en het aantal Content-Length gekopieerde bytes weergeven. Deze koptekst wordt niet weergegeven als dit bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking met behulp van Bestandseigenschappen instellen of Bestand maken. |
x-ms-copy-source: url |
Versie 21-02-2015 en hoger. Een URL van maximaal 2 kB-tekens die het bronbestand aangeeft dat is gebruikt in de laatste poging bestand kopiëren waarbij dit bestand het doelbestand was. Deze koptekst wordt niet weergegeven als dit bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking met behulp van Bestandseigenschappen instellen of Bestand maken. |
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> |
Versie 21-02-2015 en hoger. De status van de kopieerbewerking die wordt geïdentificeerd door x-ms-copy-id, met deze waarden:- Succes: Het kopiëren is voltooid. - Hangende: Kopiëren wordt uitgevoerd. Controleer x-ms-copy-status-description of onregelmatige, niet-fatale fouten de kopieervoortgang belemmeren, maar geen fouten veroorzaken.- Afgebroken: Het kopiëren is beëindigd door Het kopieerbestand af te breken. - Mislukt: Kopiëren is mislukt. Zie x-ms-copy-status-description voor foutdetails.Deze koptekst wordt niet weergegeven als dit bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking met behulp van Bestandseigenschappen instellen of Bestand maken. |
x-ms-server-encrypted: true/false |
Versie 2017-04-17 en hoger. De waarde van deze header wordt ingesteld op true als de bestandsgegevens en metagegevens van de toepassing volledig zijn versleuteld met behulp van het opgegeven algoritme. De waarde wordt ingesteld op false als het bestand niet is versleuteld of als alleen delen van de metagegevens van het bestand of de toepassing zijn versleuteld. |
x-ms-file-permission-key |
Versie 2019-02-02 en hoger. De sleutel van de machtiging van het bestand. |
x-ms-file-attributes |
Versie 2019-02-02 en hoger. De bestandssysteemkenmerken van het bestand. Zie de lijst met beschikbare kenmerken voor meer informatie. |
x-ms-file-creation-time |
Versie 2019-02-02 en hoger. De UTC-datum/tijd-waarde die de eigenschap aanmaaktijd voor een bestand vertegenwoordigt. |
x-ms-file-last-write-time |
Versie 2019-02-02 en hoger. De UTC-datum/tijd-waarde die de eigenschap laatste schrijftijd voor het bestand vertegenwoordigt. |
x-ms-file-change-time |
Versie 2019-02-02 en hoger. De UTC-datum/tijd-waarde die de eigenschap wijzigingstijd voor het bestand vertegenwoordigt. |
x-ms-file-file-id |
Versie 2019-02-02 en hoger. De bestands-id van het bestand. |
x-ms-file-parent-id |
Versie 2019-02-02 en hoger. De bovenliggende bestands-id van het bestand. |
x-ms-lease-duration:infinite |
Versie 2019-02-02 en hoger. Wanneer een bestand wordt geleased, geeft u op dat de lease een oneindige duur heeft. |
x-ms-lease-state:<available;leased;broken> |
Versie 2019-02-02 en hoger. Wanneer een bestand wordt geleased, geeft u de leasestatus van het bestand op. |
x-ms-lease-status:<locked;unlocked> |
Versie 2019-02-02 en hoger. Wanneer een bestand wordt geleased, geeft u de leasestatus van het bestand op. |
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 niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord. |
Hoofdtekst van de reactie
Geen.
Voorbeeldantwoord
Response Status:
HTTP/1.1 200 OK
Response Headers:
x-ms-type: File
x-ms-meta-m1: v1
x-ms-meta-m2: v2
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: <date>
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: <date>
x-ms-version: 2019-02-02
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6
x-ms-copy-source: <url>
x-ms-copy-status: success
x-ms-copy-progress: 11/11
x-ms-copy-completion-time: <date>
x-ms-lease-duration: infinite
x-ms-lease-state: leased
x-ms-lease-status: locked
Autorisatie
Alleen de accounteigenaar kan deze bewerking aanroepen.