Eigenschappen en metagegevens voor Blob-serviceresources instellen en ophalen
Containers en blobs ondersteunen aangepaste metagegevens, weergegeven als HTTP-headers. Metagegevensheaders kunnen worden ingesteld voor een aanvraag waarmee een nieuwe container of blobresource wordt gemaakt, of voor een aanvraag die expliciet een eigenschap voor een bestaande resource maakt.
Dit onderwerp bevat de volgende subonderwerpen:
Standaard HTTP-eigenschappen voor containers en blobs
Blobs ondersteunen ook tags, een speciaal type aangepaste metagegevens dat automatisch wordt geïndexeerd door de Blob-service. Zie Gegevens beheren en zoeken op Azure Blob Storage met Blob Index voor meer informatie.
Indeling metagegevensheader
Metagegevensheaders zijn naam-waardeparen. De indeling voor de header is:
x-ms-meta-name:string-value
Vanaf versie 2009-09-19 moeten namen van metagegevens voldoen aan de naamgevingsregels voor C#-id's.
Namen zijn niet hoofdlettergevoelig. Houd er rekening mee dat metagegevensnamen de case behouden waarmee ze zijn gemaakt, maar niet hoofdlettergevoelig zijn wanneer ze worden ingesteld of gelezen. Als er twee of meer metagegevensheaders met dezelfde naam worden verzonden voor een resource, retourneert de Blob-service statuscode 400 (Ongeldige aanvraag).
De metagegevens bestaan uit naam/waardeparen. De totale grootte van alle metagegevensparen kan maximaal 8 kB groot zijn.
Metagegevensnaam-waardeparen zijn geldige HTTP-headers en voldoen dus aan alle beperkingen die van toepassing zijn op HTTP-headers.
Bewerkingen op metagegevens
Metagegevens voor een blob- of containerresource kunnen rechtstreeks worden opgehaald of ingesteld, zonder de inhoud van de resource te retourneren of te wijzigen.
Houd er rekening mee dat metagegevenswaarden alleen volledig kunnen worden gelezen of geschreven; gedeeltelijke updates worden niet ondersteund. Als u metagegevens instelt voor een resource, worden alle bestaande metagegevenswaarden voor die resource overschreven.
Eigenschappen en metagegevens ophalen
Met de bewerkingen GET en HEAD worden metagegevensheaders voor de opgegeven container of blob opgehaald. De HEAD-bewerking retourneert alleen headers; er wordt geen antwoordtekst geretourneerd.
De URI-syntaxis voor het ophalen van metagegevensheaders in een container is als volgt:
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container
De URI-syntaxis voor het ophalen van metagegevensheaders op een blob is als volgt:
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata
Metagegevensheaders instellen
Met de PUT-bewerking worden metagegevensheaders ingesteld voor de opgegeven container of blob, en worden alle bestaande metagegevens voor de resource overschreven. Als u PUT zonder headers voor de aanvraag aanroept, worden alle bestaande metagegevens voor de resource gewist.
De URI-syntaxis voor het instellen van metagegevensheaders voor een container is als volgt:
PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata?restype=container
De URI-syntaxis voor het instellen van metagegevensheaders op een blob is als volgt:
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata
Standaard HTTP-eigenschappen voor containers en blobs
Containers en blobs ondersteunen ook bepaalde standaard-HTTP-eigenschappen. Eigenschappen en metagegevens worden beide weergegeven als standaard HTTP-headers; het verschil tussen deze zit in de naamgeving van de headers. Metagegevensheaders hebben een naam met het koptekstvoorvoegsel x-ms-meta- en een aangepaste naam. Eigenschapheaders gebruiken standaard HTTP-headernamen, zoals opgegeven in sectie 14 headervelddefinities van de http/1.1-protocolspecificatie.
De standaard HTTP-headers die in containers worden ondersteund, zijn onder andere:
ETagLast-Modified
De standaard HTTP-headers die worden ondersteund op blobs zijn onder andere:
ETagLast-ModifiedContent-LengthContent-TypeContent-MD5Content-EncodingContent-LanguageCache-ControlOriginRange
Zie ook
Container maken
Containereigenschappen ophalen
Containermetagegevens instellen
Blob plaatsen
Blob kopiëren
Blob-eigenschappen ophalen
Blob-metagegevens ophalen
Blobmetagegevens instellen
Concepten van blob-service
Gegevens in Azure Blob Storage beheren en zoeken met blobindex