Udostępnij za pośrednictwem


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 kontenerach

Operacje na obiektach blob

Operacje na obiektach blob (hierarchiczne konta z obsługą przestrzeni nazw)

Zobacz też

Rest usług magazynu