Ange resursmetadata
Åtgärden Set Share Metadata anger ett eller flera användardefinierade namn/värdepar för den angivna resursen. Även om den här åtgärden stöds fullt ut är det en äldre hanteringsåtgärd. Vi rekommenderar att du använder åtgärden Filresurser – Uppdatering som tillhandahålls av lagringsresursprovidern (Microsoft.Storage) i stället. Mer information om hur du interagerar programmatiskt med resurser med FileShare hjälp av lagringsresursprovidern finns i Åtgärder för FileShare-resurser.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgängligt |
|---|---|
| SMB |
|
| NFS |
|
Förfrågan
Du skapar begäran enligt Set Share Metadata följande. Vi rekommenderar HTTPS. Ersätt myaccount med namnet på ditt lagringskonto.
| Metod | URI för förfrågan | HTTP-version |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata |
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. |
Mer information om namngivningsbegränsningar för sökvägar finns i Namnge och referera till resurser, kataloger, filer och metadata.
URI-parametrar
Du kan ange följande ytterligare parametrar för begärande-URI:n:
| Parameter | Beskrivning |
|---|---|
timeout |
Valfritt. Uttryckt i sekunder. Mer information finns i Ange tidsgränser för Azure Files åtgärder. |
Begärandehuvuden
I följande tabell beskrivs obligatoriska och valfria 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-meta-name:value |
Valfritt. Innehåller ett namn/värde-par som innehåller metadata för resursen. Varje anrop till den här åtgärden ersätter alla befintliga metadata som är kopplade till resursen. Om du vill ta bort alla metadata från resursen anropar du den här åtgärden utan metadatahuvuden. Metadatanamn måste följa namngivningsreglerna för C#-identifierare. |
x-ms-client-request-id |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en kibibyte-teckengräns (KiB) som registreras i Lagringsanalys loggarna när loggning 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 Blob Storage. |
x-ms-lease-id:<ID> |
Krävs om målfilresursen har ett aktivt lån. Tillgänglig för version 2020-02-10 och senare. Om begäran inte innehåller låne-ID:t eller om det inte är giltigt misslyckas åtgärden med statuskoden 412 (villkoret misslyckades). Om det här huvudet har angetts och målfilresursen för närvarande inte har ett aktivt lån misslyckas åtgärden med statuskoden 412 (villkoret misslyckades). |
Begärandetext
Inga.
Exempelbegäran
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata HTTP/1.1
Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskoden 200 (OK).
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 då resursen senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representation of date/time values in headers (Representation av datum/tid-värden i sidhuvuden). 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. |
ETag |
Innehåller ett värde som representerar resursens version inom citattecken. |
x-ms-request-id |
Identifierar unikt den begäran som gjordes. Du kan använda den för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger vilken version av Azure Files som användes för att köra begäran. |
Date eller x-ms-date |
Ett UTC-datum/tid-värde som anger den tid då tjänsten skickade svaret. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och 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 är högst 1 024 synliga ASCII-tecken.
x-ms-client-request-id Om rubriken inte finns i begäran visas inte det här huvudet i svaret. |
Själva svaret
Inga.
Auktorisering
Endast kontoägaren kan anropa den här åtgärden.
Kommentarer
Anropet Set Share Metadata skriver över alla befintliga metadata som är associerade med resursen. Det går inte att ändra ett enskilt namn/värde-par.
Du kan också ange metadata för en resurs när den skapas som en del av åtgärden Skapa resurs .
När du anropar Set Share Metadata uppdateras ETag egenskaperna och Last-Modified-Time för resursen.
Set Share Metadata stöds inte för en resursögonblicksbild. Ett försök att utföra den här åtgärden på en resursögonblicksbild misslyckas med statuskoden 400 (InvalidQueryParameterValue). Du kan ange metadata för en resursögonblicksbild när den skapas som en del av Snapshot Share åtgärden.