Dokumentacja interfejsu API REST usługi Azure Storage

Artykuł
08/05/2023

Interfejsy API REST dla usług Microsoft Azure Storage Services oferują programistyczny dostęp do usług Blob, Queue, Table i File na platformie Azure lub w środowisku programistycznym za pośrednictwem emulatora magazynu.

Wszystkie usługi magazynu są dostępne za pośrednictwem interfejsów API REST. Dostęp do usług magazynu można uzyskać z poziomu usługi działającej na platformie Azure lub bezpośrednio za pośrednictwem Internetu z dowolnej aplikacji, która może wysyłać żądanie HTTP/HTTPS i odbierać odpowiedź HTTP/HTTPS.

Ważne

Usługi magazynu platformy Azure obsługują protokół HTTP i HTTPS; jednak korzystanie z protokołu HTTPS jest zdecydowanie zalecane.

Konto magazynu

Cały dostęp do usług magazynu odbywa się za pośrednictwem konta magazynu. Konto magazynu jest najwyższym poziomem przestrzeni nazw na potrzeby uzyskiwania dostępu do każdej z podstawowych usług. Jest to również podstawa autoryzacji.

Interfejsy API REST dla usług magazynu uwidaczniają konto magazynu jako zasób.

Usługa Blob

Usługa Blob Service udostępnia magazyn dla jednostek, takich jak pliki binarne i pliki tekstowe. Interfejs API REST dla usługi Blob service uwidacznia dwa zasoby: kontenery i obiekty blob. Kontener jest jak folder zawierający zestaw obiektów blob; każdy obiekt blob musi znajdować się w kontenerze. Usługa Blob Service definiuje trzy typy obiektów blob:

Blokowe obiekty blob zoptymalizowane pod kątem przesyłania strumieniowego. Ten typ obiektu blob jest jedynym typem obiektu blob dostępnym w wersjach wcześniejszych niż 2009-09-19.
Stronicowe obiekty blob zoptymalizowane pod kątem losowych operacji odczytu/zapisu, które zapewniają możliwość zapisu w zakresie bajtów w obiekcie blob. Stronicowe obiekty blob są dostępne w wersji 2009-09-19 lub nowszej. Są one używane głównie w przypadku plików VHD, które są używane do tworzenia kopii zapasowych maszyn wirtualnych platformy Azure.
Uzupełnialne obiekty blob, które są zoptymalizowane tylko pod kątem operacji dołączania. Uzupełnialne obiekty blob są dostępne tylko w wersji 2015-02-21 lub nowszej.

Kontenery i obiekty blob obsługują metadane zdefiniowane przez użytkownika w postaci par name-value określonych jako nagłówki operacji żądania.

Za pomocą interfejsu API REST dla usługi Blob deweloperzy mogą utworzyć hierarchiczną przestrzeń nazw podobną do systemu plików. Nazwy obiektów blob mogą kodować hierarchię przy użyciu konfigurowalnego separatora ścieżek. Na przykład nazwy obiektów blob MyGroup/MyBlob1 i MyGroup/MyBlob2 oznaczają wirtualny poziom organizacji dla obiektów blob. Operacja wyliczania dla obiektów blob obsługuje przechodzenie przez hierarchię wirtualną w sposób podobny do tej w systemie plików, dzięki czemu można zwrócić zestaw obiektów blob zorganizowanych pod grupą. Na przykład można wyliczyć wszystkie obiekty blob zorganizowane w obszarze MyGroup/.

Blokowy obiekt blob można utworzyć na jeden z dwóch sposobów. Obiekt blob można przekazać za pomocą pojedynczej operacji Put Blob lub przekazać obiekt blob jako zestaw bloków za pomocą operacji Put Block i zatwierdzić bloki do obiektu blob za pomocą operacji Umieszczanie listy blokowej .

Stronicowe obiekty blob są tworzone i inicjowane przy użyciu maksymalnego rozmiaru z wywołaniem put blob. Aby zapisać zawartość w stronicowym obiekcie blob, należy wywołać operację Umieszczanie strony .

Uzupełnialne obiekty blob można tworzyć przez wywołanie put blob. Uzupełnialne obiekty blob utworzone za pomocą operacji Put Blob nie zawierają żadnej zawartości. Aby zapisać zawartość w uzupełnialnych obiektach blob, należy dodać bloki na końcu obiektu blob, wywołując operację Dołączanie bloku . Aktualizowanie lub usuwanie istniejących bloków nie jest obsługiwane. Każdy blok może mieć inny rozmiar, maksymalnie 4 miB. Maksymalny rozmiar uzupełnialnych obiektów blob to 195 GiB, a uzupełnialne obiekty blob mogą zawierać nie więcej niż 50 000 bloków.

Obiekty blob obsługują operacje aktualizacji warunkowej, które mogą być przydatne w przypadku kontroli współbieżności i wydajnego przekazywania.

Obiekty blob można odczytać, wywołując operację Pobierz obiekt blob . Klient może odczytać cały obiekt blob lub dowolny zakres bajtów.

Aby zapoznać się z dokumentacją interfejsu API usługi Blob Service, zobacz Interfejs API REST usługi Blob Service.

Usługa kolejki

Usługa Kolejki zapewnia niezawodną, trwałą obsługę komunikatów w ramach usług i między nimi. Interfejs API REST dla usługi Kolejki udostępnia dwa zasoby: kolejki i komunikaty.

Kolejki obsługują metadane zdefiniowane przez użytkownika w postaci par name-value określonych jako nagłówki operacji żądania.

Każde konto magazynu może mieć nieograniczoną liczbę kolejek komunikatów, które są nazwane unikatowo w ramach konta. Każda kolejka komunikatów może zawierać nieograniczoną liczbę komunikatów. Maksymalny rozmiar komunikatu jest ograniczony do 64 KiB w wersji 2011-08-18 i 8 KiB dla poprzednich wersji.

Gdy komunikat jest odczytywany z kolejki, odbiorca ma przetworzyć komunikat, a następnie go usunąć. Po odczytaniu komunikatu jest niewidoczny dla innych użytkowników dla określonego interwału. Jeśli komunikat nie został jeszcze usunięty w momencie wygaśnięcia interwału, jego widoczność zostanie przywrócona, aby inny użytkownik mógł go przetworzyć.

Aby uzyskać więcej informacji na temat usługi Queue Service, zobacz Interfejs API REST usługi Queue Service.

Usługa tabel

Usługa Table Service udostępnia magazyn ustrukturyzowany w formie tabel. Usługa Table Service obsługuje interfejs API REST, który implementuje protokół OData.

Na koncie magazynu deweloper może tworzyć tabele. Tabele przechowują dane jako jednostki. Jednostka jest kolekcją nazwanych właściwości i ich wartości, podobnie jak wiersz. Tabele są partycjonowane w celu obsługi równoważenia obciążenia między węzłami magazynu. Każda tabela ma jako pierwszą właściwość klucza partycji, który określa partycję, do której należy jednostka. Druga właściwość to klucz wiersza, który identyfikuje jednostkę w ramach danej partycji. Kombinacja klucza partycji i klucza wiersza stanowi klucz podstawowy, który identyfikuje każdą jednostkę unikatowo w tabeli.

Usługa Table Service nie wymusza żadnego schematu. Deweloper może zdecydować się na zaimplementowanie i wymuszenie schematu po stronie klienta. Aby uzyskać więcej informacji na temat usługi Table Service, zobacz Interfejs API REST usługi Table Service.

Usługa plików

Protokół SMB (Server Message Block) jest obecnie preferowanym protokołem udziału plików używanym lokalnie. Usługa Microsoft Azure File umożliwia klientom korzystanie z dostępności i skalowalności protokołu SMB infrastruktury chmurowej platformy Azure (IaaS) bez konieczności ponownego zapisywania aplikacji klienckich SMB.

Usługa Azure File Service oferuje również atrakcyjną alternatywę dla tradycyjnych rozwiązań direct attached Storage (DAS) i Storage Area Network (SAN), które są często złożone i kosztowne do instalowania, konfigurowania i obsługi.

Pliki przechowywane w udziałach usługi Azure File są dostępne za pośrednictwem protokołu SMB, a także za pośrednictwem interfejsów API REST. Usługa plików oferuje następujące cztery zasoby: konto magazynu, udziały, katalogi i pliki. Udziały zapewniają sposób organizowania zestawów plików, a także można je instalować jako udział plików SMB hostowany w chmurze.

Zobacz też

Interfejs API REST interfejsu API REST usługi Blob Service Queue Service — interfejs API REST interfejsu API REST usługi plików