Hämta resursmetadata
Åtgärden Get Share Metadata returnerar alla användardefinierade metadata för Azure-filresursen eller resursögonblicksbilden.
Även om det här API:et stöds fullt ut är det ett äldre hanterings-API. Därför rekommenderar vi att du använder Filresurser – Hämta, som tillhandahålls av lagringsresursprovidern (Microsoft.Storage) i stället.
Mer information om hur du interagerar programmatiskt med FileShare resurser med hjälp av lagringsresursprovidern finns i Åtgärder på Azure-filresurser.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgängligt |
|---|---|
| SMB |
|
| NFS |
|
Förfrågan
Begäran Get Share Metadata skapas på följande sätt. Vi rekommenderar att du använder HTTPS.
| Metod | URI för förfrågan | HTTP-version |
|---|---|---|
GET/HEAD |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata |
HTTP/1.1 |
GET/HEAD |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata&sharesnapshot=<DateTime> |
HTTP/1.1 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna, enligt följande:
| Sökvägskomponent | Description |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
Information om namngivningsbegränsningar för sökväg finns i Namn och referensresurser, kataloger, filer och metadata.
URI-parametrar
Följande ytterligare parametrar kan anges i begärande-URI:n:
| Parameter | Beskrivning |
|---|---|
sharesnapshot |
Valfritt. Version 2017-04-17 och senare. Parametern sharesnapshot är ett ogenomskinliga datum-/tidsvärde som när det finns anger resursögonblicksbilden som ska frågas för att hämta metadata |
timeout |
Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Azure Files åtgärder. |
Begärandehuvuden
| Begärandehuvud | Beskrivning |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-client-request-id |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Files. |
x-ms-lease-id:<ID> |
Valfritt. Version 2020-02-10 och senare. Om rubriken anges utförs åtgärden endast om filresursens lån för närvarande är aktivt och låne-ID:t som anges i begäran matchar filresursens låne-ID. Om det inte finns någon matchning misslyckas åtgärden med statuskoden 412 (förhandsvillkoret misslyckades). |
Begärandetext
Inga.
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskoden 200 (OK).
Mer information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
| Svarsrubrik | Description |
|---|---|
Last-Modified |
Returnerar datum och tid när resursen senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representera datum/tid-värden i rubriker. Alla åtgärder som ändrar resursen eller dess egenskaper uppdaterar den senaste ändrade tiden. Åtgärder på filer påverkar inte resursens senast ändrade tid. |
x-ms-meta-name:value |
En uppsättning namn/värde-par som innehåller användardefinierade metadata för resursen. |
ETag |
Innehåller ett värde som du kan använda för att utföra åtgärder villkorligt. Värdet omges av citattecken. |
x-ms-request-id |
Identifierar unikt den begäran som gjordes och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger den Azure Files version som användes för att köra begäran. |
Date eller x-ms-date |
Ett UTC-datum/tid-värde som genereras av tjänsten, vilket anger den tid då svaret initierades. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och deras motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken.
x-ms-client-request-id Om rubriken inte finns i begäran visas den inte i svaret. |
Själva svaret
Inga.
Exempelsvar
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
x-ms-meta-name: somemetadata
Date: Mon, 27 Jan 2014 22:49:18 GMT
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: Mon, 27 Jan 2014 22:48:29 GMT
x-ms-version: 2014-02-14
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Auktorisering
Endast kontoägaren kan anropa den här åtgärden.
Kommentarer
Den här åtgärden returnerar endast användardefinierade metadata på resursen. Om du även vill returnera systemegenskaper anropar du Hämta resursegenskaper.