Správa vlastností kontejneru a metadat pomocí JavaScriptu
Kontejnery objektů blob podporují systémové vlastnosti a uživatelsky definovaná metadata kromě dat, která obsahují. Tento článek ukazuje, jak spravovat vlastnosti systému a uživatelsky definovaná metadata pomocí klientské knihovny služby Azure Storage pro JavaScript.
Předpoklady
- Příklady v tomto článku předpokládají, že už máte projekt nastavený tak, aby fungoval s klientskou knihovnou Azure Blob Storage pro JavaScript. Další informace o nastavení projektu, včetně instalace balíčku, importu modulů a vytvoření autorizovaného klientského objektu pro práci s datovými prostředky, najdete v tématu Začínáme se službou Azure Blob Storage a JavaScriptem.
- Autorizační mechanismus musí mít oprávnění pro práci s vlastnostmi kontejneru nebo metadaty. Další informace najdete v pokynech k autorizaci pro následující operace rozhraní REST API:
O vlastnostech a metadatech
Systémové vlastnosti: Systémové vlastnosti existují pro každý prostředek úložiště objektů blob. Některé z nich můžou být přečtené nebo nastavené, zatímco jiné jsou jen pro čtení. Pod popisky některé systémové vlastnosti odpovídají určitým standardním hlavičkám HTTP. Klientská knihovna Azure Storage pro JavaScript tyto vlastnosti udržuje za vás.
Uživatelsky definovaná metadata: Uživatelsky definovaná metadata se skládají z jednoho nebo více párů název-hodnota, které zadáte pro prostředek úložiště objektů blob. Metadata můžete použít k uložení dalších hodnot s prostředkem. Hodnoty metadat jsou určené jenom pro vaše vlastní účely a nemají vliv na chování prostředku.
Páry názvů a hodnot metadat jsou platné hlavičky HTTP a měly by dodržovat všechna omezení, která se řídí hlavičkami HTTP. Další informace opožadavch
Načtení vlastností kontejneru
Pokud chcete načíst vlastnosti kontejneru, vytvořte objekt ContainerClient a pak použijte následující metodu:
- ContainerClient.getProperties (vrátí containerProperties)
Následující příklad kódu načte vlastnosti kontejneru a zapíše hodnoty vlastnosti do okna konzoly:
async function getContainerProperties(containerClient) {
// Get Properties including existing metadata
const containerProperties = await containerClient.getProperties();
if(!containerProperties.errorCode){
console.log(containerProperties);
}
}
Nastavení a načtení metadat
Metadata můžete zadat jako jeden nebo více dvojic název-hodnota kontejneru. Pokud chcete nastavit metadata, vytvořte objekt ContainerClient a pak použijte následující metodu:
- ContainerClient.setMetadata
Následující příklad kódu nastaví metadata v kontejneru.
/*
const metadata = {
// values must be strings
lastFileReview: currentDate.toString(),
reviewer: `johnh`
}
*/
async function setContainerMetadata(containerClient, metadata) {
await containerClient.setMetadata(metadata);
}
Pokud chcete načíst metadata, získejte vlastnosti kontejneru a pak použijte vrácenou vlastnost metadat .
Zdroje informací
Další informace o nastavení a načítání vlastností kontejneru a metadat pomocí klientské knihovny služby Azure Blob Storage pro JavaScript najdete v následujících zdrojích informací.
Operace rozhraní REST API
Sada Azure SDK pro JavaScript obsahuje knihovny, které jsou postavené na rozhraní Azure REST API a umožňují interakci s operacemi rozhraní REST API prostřednictvím známých paradigmat JavaScriptu. Metody klientské knihovny pro nastavení a načítání vlastností a metadat používají následující operace rozhraní REST API:
- Získání vlastností kontejneru (REST API)
- Nastavení metadat kontejneru (REST API)
- Získání metadat kontejneru (REST API)
Metoda getProperties
načte vlastnosti kontejneru a metadata voláním operace Get Blob Properties a Get Blob Metadata operace.