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 na koncie magazynu, kontenerach i obiektach blob. Interfejs API zawiera operacje wymienione w poniższej tabeli.

Operacja Typ zasobu Opis
Wyświetlanie listy kontenerów Konto Wyświetla listę 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.
Żądanie wstępnego 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 dodatkowej, gdy jest włączona replikacja geograficznie nadmiarowa dostępu do odczytu dla konta magazynu.
Pobieranie 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ń usługi Azure Active Directory (Azure AD).
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 systemu kontenera.
Pobieranie metadanych kontenera Kontener Zwraca tylko metadane zdefiniowane przez użytkownika kontenera.
Ustawianie metadanych kontenera Kontener Ustawia metadane zdefiniowane przez użytkownika 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ę kontenera na potrzeby operacji usuwania i zarządza nim.
Usuwanie kontenera Kontener Usuwa kontener i wszystkie zawarte w nim obiekty blob.
Wyświetlanie listy obiektów blob Kontener Wyświetla listę 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 tagi zdefiniowane przez użytkownika istniejącego obiektu blob, który tworzy indeks pomocniczy.
Znajdowanie obiektów blob według tagów Blokowe, dołączane i stronicowe obiekty blob Wyświetla listę 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 usunięte nietrwale.
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ć zablokowany obiekt 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 Blokowe obiekty blob Tworzy nowy blok, który ma zostać zatwierdzony w ramach blokowego obiektu blob.
Umieść blok z adresu URL Blokowe obiekty blob Tworzy nowy blok, który ma zostać zatwierdzony w ramach blokowego obiektu blob, w którym zawartość jest odczytywana z adresu URL.
Umieść listę bloków Blokowe obiekty blob Zatwierdza obiekt blob, określając zestaw identyfikatorów bloków składających się na blokowy obiekt blob.
Pobieranie listy bloków Blokowe obiekty blob Pobiera listę bloków, które zostały przekazane w ramach blokowego obiektu blob.
Zawartość obiektu blob kwerendy Blokowe obiekty blob Stosuje prostą instrukcję języka SQL (Structured Query Language) w zawartości obiektu blob i zwraca tylko podzbiór zapytań dotyczących 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ę obiektu blob strony źródłowej do docelowego stronicowego obiektu blob. Transferowane są tylko różnicowe zmiany.
Blok dołączania Uzupełnialne obiekty blob Zapisuje blok danych na końcu dołączanego obiektu blob.

W tej sekcji

Pojęcia dotyczące usługi Blob Storage

Operacje na koncie (Blob Storage)

Operacje na kontenerach

Operacje na obiektach blob

Operacje na obiektach blob (hierarchicznych kontach z obsługą przestrzeni nazw)

Zobacz też

Rest usług magazynowania