Dokumentacja interfejsu API REST usługi Azure Storage

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. Storage są dostępne z poziomu usługi działającej na platformie Azure lub bezpośrednio przez Internet z dowolnej aplikacji, która może wysyłać żądania HTTP/HTTPS i odbierać odpowiedzi HTTP/HTTPS.

Ważne

Usługi magazynu platformy Azure obsługują zarówno protokół HTTP, jak i HTTPS; Jednak zdecydowanie zaleca się korzystanie z protokołu HTTPS.

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 do uzyskiwania dostępu do każdej z podstawowych usług. Jest to również podstawa autoryzacji.

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

Usługa Blob

Ta Blob service magazyn dla jednostek, takich jak pliki binarne i pliki tekstowe. Interfejs API REST dla Blob service uwidacznia dwa zasoby: kontenery i obiekty blob. Kontener przypomina folder zawierający zestaw obiektów blob. Każdy obiekt blob musi znajdować się w kontenerze. Ten 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, które są zoptymalizowane pod kątem losowych operacji odczytu/zapisu i które zapewniają możliwość zapisu w zakresie bajtów w obiekcie blob. Stronicowe obiekty blob są dostępne w wersji 2009-09-19 i nowszych. Są one używane głównie w przypadku plików VHD, które znajdują się na platformie 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 i nowszych.

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

Korzystając z interfejsu API REST dla Blob service, 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 hierarchii wirtualnej w sposób podobny do operacji systemu plików, dzięki czemu można zwrócić zestaw obiektów blob, które są zorganizowane poniżej grupy. Można na przykład wyliczyć wszystkie obiekty blob zorganizowane w obszarze MyGroup/.

Blokowy obiekt blob można utworzyć na jeden z dwóch sposobów. Możesz przekazać obiekt blob za pomocą jednej 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 Put Block List.

Stronicowe obiekty blob są tworzone i inicjowane z maksymalnym rozmiarem za pomocą wywołania put obiektu blob. Aby zapisać zawartość do stronicowego obiektu blob, należy wywołać operację Umieść stronę.

Uzupełnialne obiekty blob można tworzyć przez wywołanie funkcji Put Blob. Uzupełniany obiekt blob utworzony za pomocą operacji Put Blob nie zawiera żadnej zawartości. Aby zapisać zawartość do uzupełnianego obiektu blob, dodaj bloki na końcu obiektu blob, wywołując operację Dołącz blok. 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łnianego obiektu blob to 195 GiB, a uzupełniany obiekt blob może zawierać maksymalnie 50 000 bloków.

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

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

Aby uzyskać informacje Blob service API, zobacz Blob interfejs API REST usługi.

Usługa kolejki

Usługa usługa kolejki niezawodną, trwałą komunikaty w ramach usług i między nimi. Interfejs API REST dla usługa kolejki uwidacznia dwa zasoby: kolejki i komunikaty.

Kolejki obsługują metadane zdefiniowane przez użytkownika w postaci par nazwa-wartość określonych jako nagłówki w 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 dla wersji 2011-08-18 i 8 KiB dla poprzednich wersji.

Gdy komunikat jest odczytywany z kolejki, konsument powinien go przetworzyć, a następnie usunąć. Po odczytaniu komunikatu staje się on niewidoczny dla innych odbiorców przez określony czas. 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ługa kolejki, zobacz Queue interfejs API REST usługi.

Usługa tabel

Usługa Table Service zapewnia magazyn ze strukturą w postaci tabel. Usługa Table Service obsługuje interfejs API REST, który implementuje protokół OData.

W ramach konta 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ść klucz partycji określający partycję, do której należy jednostka. Druga właściwość to klucz wiersza, który identyfikuje jednostkę w danej partycji. Kombinacja klucza partycji i klucza wiersza stanowi klucz podstawowy, który identyfikuje każdą jednostkę w sposób unikatowy w tabeli.

Usługa Table Service nie wymusza żadnego schematu. Deweloper może wdrożyć i wymusić schemat po stronie klienta. Aby uzyskać więcej informacji na temat usługi Table Service, zobacz temat Table interfejs API REST usługi.

Usługa plików

Protokół bloku komunikatów serwera (SMB) jest preferowanym protokołem udziału plików używanym obecnie lokalnie. Usługa Microsoft Azure File umożliwia klientom korzystanie z dostępności i skalowalności funkcji SMB infrastruktury chmurowej (IaaS) platformy Azure bez konieczności ponownego pisali aplikacje klienckie SMB.

Usługa Plików Azure oferuje również atrakcyjną alternatywę dla tradycyjnych rozwiązań w sieciach SAN (Direct Attached Storage) i Storage Area Network (SAN), które są często skomplikowane i kosztowne do zainstalowania, skonfigurowania i obsługi.

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

Zobacz też

Obiekty blob interfejs API REST usługi Kolejki interfejs API REST usługi Tabela interfejs API REST usługi Plik interfejs API REST usługi