Bestandseigenschappen ophalen

Artikel
02/14/2024

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-stream`het 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-status`mislukt 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