interfejs API REST Azure Blob Storage
Azure Blob Storage przechowuje dane tekstowe i binarne jako obiekty w chmurze. Usługa Blob Storage oferuje następujące zasoby: konto magazynu, kontenery i obiekty blob. Na koncie magazynu kontenery umożliwiają organizowanie zestawów obiektów blob.
Dane tekstowe i binarne można przechowywać w jednym z następujących typów obiektów blob:
Blokowe obiekty blob zoptymalizowane pod kątem przesyłania strumieniowego.
Uzupełnialne obiekty blob zoptymalizowane pod kątem operacji dołączania.
Stronicowe obiekty blob zoptymalizowane pod kątem losowych operacji odczytu/zapisu, które zapewniają możliwość zapisu w zakresie bajtów w obiekcie blob.
Aby uzyskać więcej informacji, zobacz Opis blokowych obiektów blob, uzupełnialnych obiektów blob i stronicowych obiektów blob.
Interfejs API REST dla usługi Blob Storage definiuje operacje HTTP względem konta magazynu, kontenerów i obiektów blob. Interfejs API zawiera operacje wymienione w poniższej tabeli.
| Operacja | Typ zasobu | Opis |
|---|---|---|
| Wyświetlanie listy kontenerów | Konto | Listy wszystkich kontenerów na koncie magazynu. |
| Ustawianie właściwości usługi Blob Storage | Konto | Ustawia właściwości usługi Blob Storage, w tym ustawienia rejestrowania i metryk oraz domyślną wersję usługi. |
| Pobieranie właściwości usługi Blob Storage | Konto | Pobiera właściwości usługi Blob Storage, w tym ustawienia rejestrowania i metryk oraz domyślną wersję usługi. |
| Wstępne żądanie obiektu blob | Konto | Wysyła zapytania do reguł współużytkowania zasobów między źródłami (CORS) dla usługi Blob Storage przed wysłaniem rzeczywistego żądania. |
| Pobieranie statystyk usługi Blob Storage | Konto | Pobiera statystyki związane z replikacją dla usługi Blob Storage. Ta operacja jest dostępna tylko w punkcie końcowym lokalizacji pomocniczej, gdy dla konta magazynu jest włączona replikacja geograficznie nadmiarowa z dostępem do odczytu. |
| Uzyskiwanie informacji o koncie | Konto | Zwraca nazwę jednostki SKU i rodzaj konta dla określonego konta. |
| Uzyskiwanie klucza delegowania użytkownika | Konto | Pobiera klucz, który może służyć do podpisywania sygnatury dostępu współdzielonego delegowania użytkownika. Ten podpis udziela dostępu do zasobów w usłudze Blob Storage przy użyciu poświadczeń Microsoft Entra. |
| Tworzenie kontenera | Kontener | Tworzy nowy kontener na koncie magazynu. |
| Pobieranie właściwości kontenera | Kontener | Zwraca wszystkie metadane zdefiniowane przez użytkownika i właściwości systemowe kontenera. |
| Pobieranie metadanych kontenera | Kontener | Zwraca tylko metadane zdefiniowane przez użytkownika dla kontenera. |
| Ustawianie metadanych kontenera | Kontener | Ustawia metadane zdefiniowane przez użytkownika dla kontenera. |
| Uzyskiwanie listy ACL kontenerów | Kontener | Pobiera zasady dostępu publicznego i wszystkie przechowywane zasady dostępu dla kontenera. |
| Ustawianie listy ACL kontenerów | Kontener | Ustawia zasady dostępu publicznego i wszystkie przechowywane zasady dostępu dla kontenera. |
| Kontener dzierżawy | Kontener | Ustanawia blokadę w kontenerze i zarządza nią na potrzeby operacji usuwania. |
| Usuwanie kontenera | Kontener | Usuwa kontener i wszystkie zawarte w nim obiekty blob. |
| Wyświetlanie listy obiektów blob | Kontener | Listy wszystkich obiektów blob w kontenerze. |
| Wstawianie obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Tworzy nowy obiekt blob lub zastępuje istniejący obiekt blob w kontenerze. |
| Uzyskiwanie obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Odczytuje lub pobiera obiekt blob z usługi Blob Storage, w tym jego metadane zdefiniowane przez użytkownika i właściwości systemu. |
| Pobieranie właściwości obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Zwraca wszystkie właściwości systemu i metadane zdefiniowane przez użytkownika w obiekcie blob. |
| Ustawianie właściwości obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Ustawia właściwości systemowe zdefiniowane dla istniejącego obiektu blob. |
| Ustawianie wygaśnięcia obiektu blob | Blokowe obiekty blob | Ustawia czas wygaśnięcia istniejącego obiektu blob. |
| Pobieranie metadanych obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Pobiera wszystkie metadane zdefiniowane przez użytkownika istniejącego obiektu blob lub migawki. |
| Ustawianie metadanych obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Ustawia metadane zdefiniowane przez użytkownika istniejącego obiektu blob. |
| Pobieranie tagów obiektów blob | Blokowe, dołączane i stronicowe obiekty blob | Pobiera tagi zdefiniowane przez użytkownika istniejącego obiektu blob. |
| Ustawianie tagów obiektów blob | Blokowe, dołączane i stronicowe obiekty blob | Ustawia zdefiniowane przez użytkownika tagi istniejącego obiektu blob, który tworzy indeks pomocniczy. |
| Znajdowanie obiektów blob według tagów | Blokowe, dołączane i stronicowe obiekty blob | Listy obiektów blob według tagów zdefiniowanych przez użytkownika. |
| Usuwanie obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Oznacza obiekt blob do usunięcia. |
| Cofanie usunięcia obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Przywraca zawartość i metadane nietrwałego obiektu blob lub wszystkie skojarzone migawki nietrwałe. |
| Dzierżawienie obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Ustanawia blokadę operacji zapisu i usuwania oraz zarządza nią. Aby usunąć lub zapisać w zablokowanym obiekcie blob, klient musi podać identyfikator dzierżawy. |
| Wykonywanie migawki obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Tworzy migawkę obiektu blob tylko do odczytu. |
| Kopiowanie obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Kopiuje źródłowy obiekt blob do docelowego obiektu blob na tym koncie magazynu lub na innym koncie magazynu. |
| Przerwanie kopiowania obiektu blob | Blokowe, dołączane i stronicowe obiekty blob | Zatrzymuje oczekującą Copy Blob operację i pozostawia docelowy obiekt blob o zerowej długości i pełnych metadanych. |
| Umieść blok | Tylko blokowe obiekty blob | Tworzy nowy blok do zatwierdzenia w ramach blokowego obiektu blob. |
| Umieść blok z adresu URL | Tylko blokowe obiekty blob | Tworzy nowy blok do zatwierdzenia w ramach blokowego obiektu blob, w którym zawartość jest odczytywana z adresu URL. |
| Wdrażanie listy zablokowanych | Tylko blokowe obiekty blob | Zatwierdza obiekt blob, określając zestaw identyfikatorów bloków składających się na blokowy obiekt blob. |
| Pobieranie listy zablokowanych | Tylko blokowe obiekty blob | Pobiera listę bloków, które zostały przekazane w ramach blokowego obiektu blob. |
| Wykonywanie zapytań o zawartość obiektu blob | Tylko blokowe obiekty blob | Stosuje prostą instrukcję Structured Query Language (SQL) w zawartości obiektu blob i zwraca tylko badany podzbiór danych. |
| Ustawianie warstwy obiektu blob | Blokowe i stronicowe obiekty blob | Ustawia warstwę obiektu blob. |
| Umieść stronę | Tylko stronicowe obiekty blob | Zapisuje zakres stron w stronicowym obiekcie blob. |
| Pobieranie zakresów stron | Tylko stronicowe obiekty blob | Zwraca listę prawidłowych zakresów stron dla stronicowego obiektu blob lub migawki stronicowego obiektu blob. |
| Przyrostowe kopiowanie obiektu blob | Tylko stronicowe obiekty blob | Kopiuje migawkę źródłowego stronicowego obiektu blob do docelowego stronicowego obiektu blob. Transferowane są tylko zmiany różnicowe. |
| Blok dołączania | Tylko uzupełnialne obiekty blob | Zapisuje blok danych na końcu uzupełnialnych obiektów blob. |
W tej sekcji
Pojęcia dotyczące usługi Blob Storage
Operacje na koncie (Blob Storage)
Operacje na obiektach blob (hierarchiczne konta z obsługą przestrzeni nazw)