BlockBlobService Klasa
Blokowe obiekty blob umożliwiają wydajne przekazywanie dużych obiektów blob. Blokowe obiekty blob składają się z bloków, z których każdy jest identyfikowany przez identyfikator bloku. Utworzysz lub zmodyfikujesz blokowy obiekt blob, pisząc zestaw bloków i zatwierdzając je przy użyciu identyfikatorów bloków. Każdy blok może mieć inny rozmiar, maksymalnie 100 MB, a blokowy obiekt blob może zawierać maksymalnie 50 000 bloków. Maksymalny rozmiar blokowego obiektu blob wynosi zatem około 4,75 TB (100 MB X 50 000 bloków). Jeśli piszesz blokowy obiekt blob o rozmiarze nie większym niż 64 MB, możesz przekazać go w całości za pomocą pojedynczej operacji zapisu; zobacz create_blob_from_bytes.
:type ~azure.storage.common.TokenCredential
- Dziedziczenie
-
BlockBlobService
Konstruktor
BlockBlobService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', custom_domain=None, request_session=None, connection_string=None, socket_timeout=None, token_credential=None)Parametry
- account_name
- str
Nazwa konta magazynu. Służy to do uwierzytelniania żądań podpisanych przy użyciu klucza konta i konstruowania punktu końcowego magazynu. Jest to wymagane, chyba że zostanie podana parametry połączenia lub jeśli domena niestandardowa jest używana z uwierzytelnianiem anonimowym.
- account_key
- str
Klucz konta magazynu. Jest to używane do uwierzytelniania za pomocą klucza współużytkowanego. Jeśli nie określono ani klucza konta, ani tokenu sygnatury dostępu współdzielonego, będzie używany dostęp anonimowy.
- sas_token
- str
Token sygnatury dostępu współdzielonego używany do uwierzytelniania żądań zamiast klucza konta. Jeśli określono zarówno klucz konta, jak i token sas, klucz konta zostanie użyty do podpisania. Jeśli żadna z nich nie zostanie określona, zostanie użyty dostęp anonimowy.
- is_emulated
- bool
Czy używać emulatora. Wartość domyślna to False. Jeśli zostanie określony, zastąpi wszystkie inne parametry oprócz parametry połączenia i sesji żądania.
- endpoint_suffix
- str
Składnik podstawowy hosta adresu URL, minus nazwa konta. Wartość domyślna to Azure (core.windows.net). Przesłoń tę metodę do korzystania z chmury w Chinach (core.chinacloudapi.cn).
- custom_domain
- str
Domena niestandardowa do użycia. Można to ustawić w witrynie Azure Portal. Na przykład "www.mydomain.com".
- request_session
- <xref:requests.Session>
Obiekt sesji do użycia dla żądań HTTP.
- connection_string
- str
Jeśli zostanie określony, spowoduje to zastąpienie wszystkich pozostałych parametrów oprócz sesji żądania. Zobaczhttp://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/, aby zapoznać się z formatem parametry połączenia.
- socket_timeout
- int
Jeśli zostanie określony, spowoduje to zastąpienie domyślnego limitu czasu gniazda. Określony limit czasu wynosi w sekundach. Aby uzyskać wartość domyślną, zobacz DEFAULT_SOCKET_TIMEOUT w _constants.py.
- token_credential
Poświadczenia tokenu używane do uwierzytelniania żądań HTTPS. Wartość tokenu powinna zostać zaktualizowana przed jego wygaśnięciem.
Zmienne
- MAX_SINGLE_PUT_SIZE
- int
Największy rozmiar przekazywania obsługiwany w jednym wywołaniu put. Jest to używane przez metody create_blob_from_*, jeśli długość zawartości jest znana i jest mniejsza niż ta wartość.
- MAX_BLOCK_SIZE
- int
Rozmiar bloków umieszczanych przez metody create_blob_from_*, jeśli długość zawartości jest nieznana lub jest większa niż MAX_SINGLE_PUT_SIZE. Mniejsze bloki można umieścić. Maksymalny rozmiar bloku obsługiwanego przez usługę to 100 MB.
- MIN_LARGE_BLOCK_UPLOAD_THRESHOLD
- int
Minimalny rozmiar bloku, w którym jest uwzględniany algorytm przekazywania bloków zoptymalizowany pod kątem pamięci. Ten algorytm ma zastosowanie tylko do metod create_blob_from_file i create_blob_from_stream i uniemożliwi pełne buforowanie bloków. Oprócz rozmiaru bloku walidacja i szyfrowanie ContentMD5 muszą być wyłączone, ponieważ te opcje wymagają buforowania bloków.
Metody
| abort_copy_blob |
Przerywa oczekującą operację copy_blob i pozostawia docelowy obiekt blob o zerowej długości i pełnych metadanych. |
| acquire_blob_lease |
Żąda nowej dzierżawy. Jeśli obiekt blob nie ma aktywnej dzierżawy, usługa Blob tworzy dzierżawę obiektu blob i zwraca nowy identyfikator dzierżawy. |
| acquire_container_lease |
Żąda nowej dzierżawy. Jeśli kontener nie ma aktywnej dzierżawy, usługa Blob service tworzy dzierżawę kontenera i zwraca nowy identyfikator dzierżawy. |
| batch_delete_blobs |
Wysyła partię wielu żądań usuwania obiektów blob. Metoda delete obiektu blob usuwa określony obiekt blob lub migawkę. Pamiętaj, że usunięcie obiektu blob powoduje również usunięcie wszystkich jego migawek. Aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/rest/api/storageservices/delete-blob. |
| batch_set_standard_blob_tier |
Wysyła partię wielu zestawów żądań warstw blokowych obiektów blob. Ten interfejs API jest obsługiwany tylko w przypadku blokowych obiektów blob na kontach magazynu w warstwie Standardowa. |
| break_blob_lease |
Przerywa dzierżawę, jeśli obiekt blob ma aktywną dzierżawę. Po przerwaniu dzierżawy nie można jej odnowić. Każde autoryzowane żądanie może przerwać dzierżawę; żądanie nie jest wymagane do określenia zgodnego identyfikatora dzierżawy. Po przerwaniu dzierżawy okres przerwania dzierżawy może upłynąć, w którym czasie nie można wykonać żadnej operacji dzierżawy z wyjątkiem przerwania i zwolnienia w obiekcie blob. Gdy dzierżawa zostanie pomyślnie przerwana, odpowiedź wskazuje interwał w sekundach do momentu uzyskania nowej dzierżawy. Dzierżawa, która została przerwana, można również zwolnić, w takim przypadku inny klient może natychmiast uzyskać dzierżawę obiektu blob. |
| break_container_lease |
Przerwij dzierżawę, jeśli kontener ma aktywną dzierżawę. Po przerwaniu dzierżawy nie można jej odnowić. Każde autoryzowane żądanie może przerwać dzierżawę; żądanie nie jest wymagane do określenia zgodnego identyfikatora dzierżawy. Gdy dzierżawa zostanie przerwana, okres przerwania dzierżawy może upłynąć, w którym czasie nie można wykonać operacji dzierżawy z wyjątkiem przerwania i zwolnienia w kontenerze. Gdy dzierżawa zostanie pomyślnie przerwana, odpowiedź wskazuje interwał w sekundach do momentu uzyskania nowej dzierżawy. |
| change_blob_lease |
Zmienia identyfikator dzierżawy aktywnej dzierżawy. Zmiana musi zawierać bieżący identyfikator dzierżawy i nowy identyfikator dzierżawy. |
| change_container_lease |
Zmień identyfikator dzierżawy aktywnej dzierżawy. Zmiana musi zawierać bieżący identyfikator dzierżawy i nowy identyfikator dzierżawy. |
| copy_blob |
Kopiuje obiekt blob. Ta operacja zwraca obiekt właściwości operacji kopiowania. Operacja kopiowania może być operacją asynchroniczną, najlepszą operacją lub operacją synchroniczną. Źródło musi być blokowym obiektem blob, jeśli requires_sync ma wartość true. Każdy istniejący docelowy obiekt blob zostanie zastąpiony. Nie można zmodyfikować docelowego obiektu blob, gdy operacja kopiowania jest w toku. Podczas kopiowania z blokowego obiektu blob wszystkie zatwierdzone bloki i ich identyfikatory bloków są kopiowane. Niezatwierdzone bloki nie są kopiowane. Na końcu operacji kopiowania docelowy obiekt blob będzie miał taką samą zatwierdzoną liczbę bloków co źródło. Możesz wywołać get_blob_properties w docelowym obiekcie blob, aby sprawdzić stan operacji kopiowania. Końcowy obiekt blob zostanie zatwierdzony po zakończeniu kopiowania. Nazwa kontenera docelowego. Kontener musi istnieć. blob_name str :p aram: nazwa docelowego obiektu blob. Jeśli docelowy obiekt blob istnieje, zostanie zastąpiony. W przeciwnym razie zostanie on utworzony. :p aram str copy_source: adres URL o długości do 2 KB określający plik lub obiekt blob platformy Azure. Wartość powinna być zakodowana w adresie URL, ponieważ jest wyświetlana w identyfikatorze URI żądania. Jeśli źródło znajduje się na innym koncie, źródło musi być publiczne lub musi być uwierzytelnione za pośrednictwem sygnatury dostępu współdzielonego. Jeśli źródło jest publiczne, nie jest wymagane uwierzytelnianie. Przykłady: ?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram metadata: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblobpary name-value skojarzone z obiektem blob jako metadanymi. Jeśli nie określono par name-value, operacja skopiuje metadane ze źródłowego obiektu blob lub pliku do docelowego obiektu blob. Jeśli określono co najmniej jedną parę nazwa-wartość, docelowy obiekt blob jest tworzony przy użyciu określonych metadanych, a metadane nie są kopiowane ze źródłowego obiektu blob lub pliku. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: Wartość daty/godziny. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy źródłowy obiekt blob został zmodyfikowany od określonej daty/godziny. :p aram datetime source_if_unmodified_since: wartość DateTime. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy źródłowy obiekt blob nie został zmodyfikowany od określonej daty/godziny. :p aram ETag source_if_match: wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek warunkowy, aby skopiować źródłowy obiekt blob tylko wtedy, gdy element ETag jest zgodny z określoną wartością. Jeśli wartości ETag nie są zgodne, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). Nie można określić tego nagłówka, jeśli źródłem jest plik platformy Azure. :p aram ETag source_if_none_match: wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy element ETag nie jest zgodny z określoną wartością. Jeśli wartości są identyczne, usługa Blob service zwraca kod stanu 412 (Warunek wstępny nie powiodło się). Nie można określić tego nagłówka, jeśli źródłem jest plik platformy Azure. :p aram datetime destination_if_modified_since: wartość DateTime. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy docelowy obiekt blob został zmodyfikowany od określonej daty/godziny. Jeśli docelowy obiekt blob nie został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). :p aram datetime destination_if_unmodified_since: wartość DateTime. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy docelowy obiekt blob nie został zmodyfikowany od określonej daty/godziny. Jeśli docelowy obiekt blob został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). :p aram ETag destination_if_match: wartość ETag lub symbol wieloznaczny (). Określ wartość ETag dla tego nagłówka warunkowego, aby skopiować obiekt blob tylko wtedy, gdy określona wartość ETag jest zgodna z wartością ETag dla istniejącego docelowego obiektu blob. Jeśli element ETag dla docelowego obiektu blob nie jest zgodny z elementem ETag określonym dla parametru If-Match, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). :p aram ETag destination_if_none_match: wartość ETag lub symbol wieloznaczny (). Określ wartość ETag dla tego nagłówka warunkowego, aby skopiować obiekt blob tylko wtedy, gdy określona wartość ETag nie jest zgodna z wartością ETag docelowego obiektu blob. Określ symbol wieloznaczny (*) do wykonania operacji tylko wtedy, gdy docelowy obiekt blob nie istnieje. Jeśli określony warunek nie zostanie spełniony, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). :p aram str destination_lease_id: Identyfikator dzierżawy określony dla tego nagłówka musi być zgodny z identyfikatorem dzierżawy docelowego obiektu blob. Jeśli żądanie nie zawiera identyfikatora dzierżawy lub jest nieprawidłowe, operacja kończy się niepowodzeniem z kodem stanu 412 (Warunek wstępny nie powiodło się). :p aram str source_lease_id: określ to, aby wykonać operację kopiowania obiektu blob tylko wtedy, gdy podany identyfikator dzierżawy jest zgodny z aktywnym identyfikatorem dzierżawy źródłowego obiektu blob. :p aram int limit czasu: parametr limitu czasu jest wyrażony w sekundach. :p aram bool requires_sync: wymusza, że usługa nie zwróci odpowiedzi, dopóki kopia nie zostanie ukończona. :p aram StandardBlobTier standard_blob_tier: Standardowa wartość warstwy obiektu blob w celu ustawienia obiektu blob na wartość . W przypadku tej wersji biblioteki ma to zastosowanie tylko do blokowych obiektów blob na kontach magazynu w warstwie Standardowa. :p aram RehydratePriority rehydrate_priority: wskazuje priorytet, z którym ma być ponownie wypełnianie zarchiwizowanego obiektu blob:return: Właściwości operacji kopiowania, takie jak stan, źródło i identyfikator. :rtype: CopyProperties |
| create_blob_from_bytes |
Tworzy nowy obiekt blob na podstawie tablicy bajtów lub aktualizuje zawartość istniejącego obiektu blob z automatycznymi powiadomieniami o fragmentowaniu i postępie. |
| create_blob_from_path |
Tworzy nowy obiekt blob na podstawie ścieżki pliku lub aktualizuje zawartość istniejącego obiektu blob z automatycznymi powiadomieniami o fragmentowaniu i postępie. |
| create_blob_from_stream |
Tworzy nowy obiekt blob na podstawie pliku/strumienia lub aktualizuje zawartość istniejącego obiektu blob z automatycznymi powiadomieniami o fragmentowaniu i postępie. |
| create_blob_from_text |
Tworzy nowy obiekt blob ze strony str/unicode lub aktualizuje zawartość istniejącego obiektu blob z automatycznymi powiadomieniami o fragmentowaniu i postępie. |
| create_container |
Tworzy nowy kontener na określonym koncie. Jeśli kontener o tej samej nazwie już istnieje, operacja zakończy się niepowodzeniem, jeśli fail_on_exist ma wartość True. |
| delete_blob |
Oznacza określony obiekt blob lub migawkę do usunięcia. Obiekt blob zostanie później usunięty podczas odzyskiwania pamięci. Należy pamiętać, że aby usunąć obiekt blob, należy usunąć wszystkie jego migawki. Oba te elementy można usunąć jednocześnie za pomocą operacji Usuń obiekt blob. Jeśli dla usługi włączono zasady przechowywania usuwania, ta operacja nietrwała usuwa obiekt blob lub migawkę i zachowuje obiekt blob lub migawkę przez określoną liczbę dni. Po określonej liczbie dni dane obiektu blob zostaną usunięte z usługi podczas odzyskiwania pamięci. Nietrwały usunięty obiekt blob lub migawka jest dostępny za pośrednictwem interfejsu API list obiektów blob określających opcję include.Deleted. Można przywrócić usunięty nietrwale obiekt blob lub migawkę przy użyciu interfejsu API cofania. |
| delete_container |
Oznacza określony kontener do usunięcia. Kontener i wszystkie zawarte w nim obiekty blob są później usuwane podczas odzyskiwania pamięci. |
| exists |
Zwraca wartość logiczną wskazującą, czy kontener istnieje (jeśli blob_name jest Brak), czy też wartość logiczna wskazująca, czy obiekt blob istnieje. |
| extract_date_and_request_id | |
| generate_account_shared_access_signature |
Generuje sygnaturę dostępu współdzielonego dla usługi blob. Użyj zwróconego podpisu z parametrem sas_token dowolnej usługi BlobService. |
| generate_blob_shared_access_signature |
Generuje sygnaturę dostępu współdzielonego dla obiektu blob lub jednej z jego migawek. Użyj zwróconego podpisu z parametrem sas_token dowolnej usługi BlobService. |
| generate_container_shared_access_signature |
Generuje sygnaturę dostępu współdzielonego dla kontenera. Użyj zwróconego podpisu z parametrem sas_token dowolnej usługi BlobService. |
| get_blob_account_information |
Pobiera informacje związane z kontem magazynu. Informacje te można również pobrać, jeśli użytkownik ma sygnaturę dostępu współdzielonego do kontenera lub obiektu blob. |
| get_blob_metadata |
Zwraca wszystkie metadane zdefiniowane przez użytkownika dla określonego obiektu blob lub migawki. |
| get_blob_properties |
Zwraca wszystkie metadane zdefiniowane przez użytkownika, standardowe właściwości PROTOKOŁU HTTP i właściwości systemu dla obiektu blob. Nie zwraca zawartości obiektu blob. Zwraca wartość Blob z BlobProperties dyktami metadanych i . |
| get_blob_service_properties |
Pobiera właściwości usługi Blob service konta magazynu, w tym usługi Azure analityka magazynu. |
| get_blob_service_stats |
Pobiera statystyki związane z replikacją dla usługi Blob Service. Jest ona dostępna tylko wtedy, gdy dla konta magazynu jest włączona replikacja geograficznie nadmiarowa z dostępem do odczytu. Dzięki replikacji geograficznie nadmiarowej usługa Azure Storage utrzymuje trwałość danych w dwóch lokalizacjach. W obu lokalizacjach usługa Azure Storage stale utrzymuje wiele replik w dobrej kondycji danych. Lokalizacja, w której odczytujesz, utworzysz, zaktualizujesz lub usuniesz dane, jest podstawową lokalizacją konta magazynu. Lokalizacja podstawowa istnieje w wybranym regionie podczas tworzenia konta za pośrednictwem klasycznego portalu Azure Management Azure, na przykład Północno-środkowe stany USA. Lokalizacja, do której są replikowane dane, to lokalizacja pomocnicza. Lokalizacja pomocnicza jest automatycznie określana na podstawie lokalizacji podstawowej; znajduje się w drugim centrum danych, które znajduje się w tym samym regionie co lokalizacja podstawowa. Dostęp tylko do odczytu jest dostępny z lokalizacji pomocniczej, jeśli dla konta magazynu włączono replikację geograficznie nadmiarową z dostępem do odczytu. |
| get_blob_to_bytes |
Pobiera obiekt blob jako tablicę bajtów z automatycznymi powiadomieniami o fragmentowaniu i postępie. Zwraca wystąpienie obiektu Blob z właściwościami, metadanymi i zawartością. |
| get_blob_to_path |
Pobiera obiekt blob do ścieżki pliku z automatycznymi powiadomieniami o fragmentowaniu i postępie. Zwraca wystąpienie właściwości Blob i metadanych. |
| get_blob_to_stream |
Pobiera obiekt blob do strumienia z automatycznymi powiadomieniami o fragmentowaniu i postępie. Zwraca wystąpienie właściwości Blob i metadanych. |
| get_blob_to_text |
Pobiera obiekt blob jako tekst unicode z automatycznymi powiadomieniami o fragmentowaniu i postępie. Zwraca wystąpienie właściwości Blob , metadanych i zawartości. |
| get_block_list |
Pobiera listę bloków, które zostały przekazane w ramach blokowego obiektu blob. Istnieją dwie listy blokowe obsługiwane dla obiektu blob: Zatwierdzona lista bloków: lista bloków, które zostały pomyślnie zatwierdzone do danego obiektu blob z umieszczaniem listy bloków. Niezatwierdzona lista bloków: lista bloków, które zostały przekazane dla obiektu blob przy użyciu funkcji Put Block, ale które nie zostały jeszcze zatwierdzone. Te bloki są przechowywane na platformie Azure w skojarzeniu z obiektem blob, ale nie stanowią jeszcze części obiektu blob. |
| get_container_acl |
Pobiera uprawnienia dla określonego kontenera. Uprawnienia wskazują, czy dane kontenera mogą być dostępne publicznie. |
| get_container_metadata |
Zwraca wszystkie metadane zdefiniowane przez użytkownika dla określonego kontenera. |
| get_container_properties |
Zwraca wszystkie metadane zdefiniowane przez użytkownika i właściwości systemu dla określonego kontenera. Zwrócone dane nie zawierają listy obiektów blob kontenera. |
| get_user_delegation_key |
Uzyskaj klucz delegowania użytkownika na potrzeby podpisywania tokenów SAS. Poświadczenie tokenu musi znajdować się w obiekcie usługi, aby to żądanie zakończyło się pomyślnie. |
| list_blob_names |
Zwraca generator, aby wyświetlić listę nazw obiektów blob w określonym kontenerze. Generator będzie lazily podążać za tokenami kontynuacji zwróconymi przez usługę i zatrzymać, gdy wszystkie obiekty blob zostały zwrócone lub num_results zostanie osiągnięty. Jeśli num_results zostanie określony, a konto ma więcej niż liczbę obiektów blob, generator będzie miał wypełnione next_marker pole po zakończeniu. Ten znacznik może służyć do utworzenia nowego generatora, jeśli wymagane są więcej wyników. |
| list_blobs |
Zwraca generator, aby wyświetlić listę obiektów blob w określonym kontenerze. Generator będzie z opóźnieniem śledzić tokeny kontynuacji zwracane przez usługę i zatrzymywać się po zwróceniu wszystkich obiektów blob lub osiągnięciu num_results. Jeśli określono num_results i konto ma więcej niż określoną liczbę obiektów blob, po zakończeniu generator będzie miał wypełnione pole next_marker. Ten znacznik może służyć do utworzenia nowego generatora w razie potrzeby uzyskania większej liczby wyników. |
| list_containers |
Zwraca generator, aby wyświetlić listę kontenerów w ramach określonego konta. Generator będzie z opóźnieniem śledzić tokeny kontynuacji zwracane przez usługę i zatrzymywać się po powrocie wszystkich kontenerów lub osiągnięciu num_results. Jeśli określono num_results i konto ma więcej niż określoną liczbę kontenerów, po zakończeniu generator będzie miał wypełnione pole next_marker. Ten znacznik może służyć do utworzenia nowego generatora w razie potrzeby uzyskania większej liczby wyników. |
| make_blob_url |
Tworzy adres URL w celu uzyskania dostępu do obiektu blob. |
| make_container_url |
Tworzy adres URL w celu uzyskania dostępu do kontenera. |
| put_block |
Tworzy nowy blok do zatwierdzenia w ramach obiektu blob. |
| put_block_from_url |
Tworzy nowy blok do zatwierdzenia w ramach obiektu blob. |
| put_block_list |
Zapisuje obiekt blob, określając listę identyfikatorów blokowych, które tworzą obiekt blob. Aby można je było zapisać w ramach obiektu blob, blok musi zostać pomyślnie zapisany na serwerze w poprzedniej operacji Put Block. Możesz wywołać funkcję Umieść listę bloków, aby zaktualizować obiekt blob, przekazując tylko te bloki, które uległy zmianie, a następnie zatwierdzając nowe i istniejące bloki razem. Można to zrobić, określając, czy zatwierdzić blokadę z zatwierdzonej listy zablokowanych, czy z niezatwierdzonej listy zablokowanych, lub zatwierdzić ostatnio przekazaną wersję bloku, niezależnie od listy, do której może należeć. |
| release_blob_lease |
Zwalnia dzierżawę. Dzierżawa może zostać zwolniona, jeśli identyfikator dzierżawy określony w żądaniu jest zgodny z elementem skojarzonym z obiektem blob. Zwolnienie dzierżawy umożliwia innemu klientowi natychmiastowe uzyskanie dzierżawy dla obiektu blob natychmiast po zakończeniu wydania. |
| release_container_lease |
Zwolnij dzierżawę. Dzierżawa może zostać zwolniona, jeśli określona lease_id pasuje do tej, która jest skojarzona z kontenerem. Zwolnienie dzierżawy umożliwia innemu klientowi natychmiastowe uzyskanie dzierżawy dla kontenera zaraz po zakończeniu wydania. |
| renew_blob_lease |
Odnawia dzierżawę. Dzierżawę można odnowić, jeśli identyfikator dzierżawy określony w żądaniu jest zgodny z elementem skojarzonym z obiektem blob. Należy pamiętać, że dzierżawa może zostać odnowiona nawet wtedy, gdy obiekt blob nie został zmodyfikowany lub dzierżawiony ponownie od czasu wygaśnięcia tej dzierżawy. Po odnowieniu dzierżawy czas trwania dzierżawy jest resetowany. |
| renew_container_lease |
Odnawia dzierżawę. Dzierżawę można odnowić, jeśli określony identyfikator dzierżawy jest zgodny z kontenerem skojarzonym z kontenerem. Należy pamiętać, że dzierżawa może zostać odnowiona, nawet jeśli wygasła, dopóki kontener nie został ponownie dzierżawiony od czasu wygaśnięcia tej dzierżawy. Po odnowieniu dzierżawy czas trwania dzierżawy jest resetowany. |
| set_blob_metadata |
Ustawia metadane zdefiniowane przez użytkownika dla określonego obiektu blob jako co najmniej jedną parę nazwa-wartość. |
| set_blob_properties |
Ustawia właściwości systemowe obiektu blob. Jeśli dla content_settings ustawiono jedną właściwość, wszystkie właściwości zostaną zastąpione. |
| set_blob_service_properties |
Ustawia właściwości usługi Blob service konta magazynu, w tym usługi Azure analityka magazynu. Jeśli element (np. rejestrowanie) jest pozostawiony jako Brak, istniejące ustawienia usługi dla tej funkcji zostaną zachowane. |
| set_container_acl |
Ustawia uprawnienia dla określonego kontenera lub przechowywanych zasad dostępu, które mogą być używane z sygnaturami dostępu współdzielonego. Uprawnienia wskazują, czy obiekty blob w kontenerze mogą być dostępne publicznie. |
| set_container_metadata |
Ustawia co najmniej jedną parę nazwa-wartość zdefiniowaną przez użytkownika dla określonego kontenera. Każde wywołanie tej operacji zastępuje wszystkie istniejące metadane dołączone do kontenera. Aby usunąć wszystkie metadane z kontenera, wywołaj tę operację bez dyktowania metadanych. |
| set_proxy |
Ustawia hosta i port serwera proxy dla tunelowania HTTP CONNECT. |
| set_standard_blob_tier |
Ustawia warstwy blokowych obiektów blob w obiekcie blob. Ten interfejs API jest obsługiwany tylko w przypadku blokowych obiektów blob na kontach magazynu w warstwie Standardowa. :p aram RehydratePriority rehydrate_priority: wskazuje priorytet, z którym ma być przywracany zarchiwizowany obiekt blob |
| snapshot_blob |
Tworzy migawkę obiektu blob tylko do odczytu. |
| undelete_blob |
Operacja cofania obiektu blob przywraca zawartość i metadane nietrwałego usuniętego obiektu blob lub migawki. Próba cofnięcia usunięcia obiektu blob lub migawki, która nie zostanie usunięta nietrwale, powiedzie się bez żadnych zmian. |
abort_copy_blob
Przerywa oczekującą operację copy_blob i pozostawia docelowy obiekt blob o zerowej długości i pełnych metadanych.
abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)Parametry
- lease_id
- str
Wymagane, jeśli docelowy obiekt blob ma aktywną nieskończoną dzierżawę.
acquire_blob_lease
Żąda nowej dzierżawy. Jeśli obiekt blob nie ma aktywnej dzierżawy, usługa Blob tworzy dzierżawę obiektu blob i zwraca nowy identyfikator dzierżawy.
acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametry
- lease_duration
- int
Określa czas trwania dzierżawy, w sekundach lub ujemny (-1) dla dzierżawy, która nigdy nie wygasa. Dzierżawa nieskończenie nieskończona może należeć do zakresu od 15 do 60 sekund. Nie można zmienić czasu trwania dzierżawy przy użyciu odnowienia lub zmiany. Wartość domyślna to -1 (nieskończona dzierżawa).
- proposed_lease_id
- str
Proponowany identyfikator dzierżawy w formacie ciągu identyfikatora GUID. Usługa Blob Service zwraca wartość 400 (nieprawidłowe żądanie), jeśli proponowany identyfikator dzierżawy nie ma poprawnego formatu.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
Zwraca
Str
acquire_container_lease
Żąda nowej dzierżawy. Jeśli kontener nie ma aktywnej dzierżawy, usługa Blob service tworzy dzierżawę kontenera i zwraca nowy identyfikator dzierżawy.
acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametry
- lease_duration
- int
Określa czas trwania dzierżawy, w sekundach lub ujemny (-1) dla dzierżawy, która nigdy nie wygasa. Dzierżawa nieskończenie nieskończona może należeć do zakresu od 15 do 60 sekund. Nie można zmienić czasu trwania dzierżawy przy użyciu odnowienia lub zmiany. Wartość domyślna to -1 (nieskończona dzierżawa).
- proposed_lease_id
- str
Proponowany identyfikator dzierżawy w formacie ciągu identyfikatora GUID. Usługa Blob Service zwraca wartość 400 (nieprawidłowe żądanie), jeśli proponowany identyfikator dzierżawy nie ma poprawnego formatu.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
Zwraca
Str
batch_delete_blobs
Wysyła partię wielu żądań usuwania obiektów blob.
Metoda delete obiektu blob usuwa określony obiekt blob lub migawkę. Pamiętaj, że usunięcie obiektu blob powoduje również usunięcie wszystkich jego migawek. Aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/rest/api/storageservices/delete-blob.
batch_delete_blobs(batch_delete_sub_requests, timeout=None)Parametry
- batch_delete_sub_requests
- list(BatchDeleteSubRequest)
Żądania usuwania obiektów blob do wysłania jako partia.
Zwraca
Przeanalizowano odpowiedź HTTP usuwania wsadowego
Typ zwracany
batch_set_standard_blob_tier
Wysyła partię wielu zestawów żądań warstw blokowych obiektów blob. Ten interfejs API jest obsługiwany tylko w przypadku blokowych obiektów blob na kontach magazynu w warstwie Standardowa.
batch_set_standard_blob_tier(batch_set_blob_tier_sub_requests, timeout=None)Parametry
- batch_set_blob_tier_sub_requests
- list(BatchSetBlobTierSubRequest)
Ustawione żądania warstwy blokowych obiektów blob do wysłania jako partia.
- timeout
- int
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania indywidualnie.
Zwraca
Przeanalizowano odpowiedź HTTP zestawu wsadowego w warstwie, która wskazuje, czy każde żądanie podrzędne zakończyło się pomyślnie.
Typ zwracany
break_blob_lease
Przerywa dzierżawę, jeśli obiekt blob ma aktywną dzierżawę. Po przerwaniu dzierżawy nie można jej odnowić. Każde autoryzowane żądanie może przerwać dzierżawę; żądanie nie jest wymagane do określenia zgodnego identyfikatora dzierżawy. Po przerwaniu dzierżawy okres przerwania dzierżawy może upłynąć, w którym czasie nie można wykonać żadnej operacji dzierżawy z wyjątkiem przerwania i zwolnienia w obiekcie blob. Gdy dzierżawa zostanie pomyślnie przerwana, odpowiedź wskazuje interwał w sekundach do momentu uzyskania nowej dzierżawy.
Dzierżawa, która została przerwana, można również zwolnić, w takim przypadku inny klient może natychmiast uzyskać dzierżawę obiektu blob.
break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametry
- lease_break_period
- int
W przypadku operacji przerwania jest to proponowany czas trwania sekund, który dzierżawa powinna być kontynuowana, zanim zostanie przerwana, z zakresu od 0 do 60 sekund. Ten okres przerwania jest używany tylko wtedy, gdy jest krótszy niż czas pozostały w dzierżawie. Jeśli czas pozostały w dzierżawie jest dłuższy. Nowa dzierżawa nie będzie dostępna przed wygaśnięciem okresu przerwania, ale dzierżawa może być przechowywana przez dłuższy niż okres przerwania. Jeśli ten nagłówek nie jest wyświetlany z operacją przerwania, przerwy dzierżawy o stałym czasie trwania po upływie pozostałego okresu dzierżawy i nieskończone przerwy dzierżawy natychmiast.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie powiedzie się operacji, jeśli istnieje.
Zwraca
int
break_container_lease
Przerwij dzierżawę, jeśli kontener ma aktywną dzierżawę. Po przerwaniu dzierżawy nie można jej odnowić. Każde autoryzowane żądanie może przerwać dzierżawę; żądanie nie jest wymagane do określenia zgodnego identyfikatora dzierżawy. Gdy dzierżawa zostanie przerwana, okres przerwania dzierżawy może upłynąć, w którym czasie nie można wykonać operacji dzierżawy z wyjątkiem przerwania i zwolnienia w kontenerze. Gdy dzierżawa zostanie pomyślnie przerwana, odpowiedź wskazuje interwał w sekundach do momentu uzyskania nowej dzierżawy.
break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametry
- lease_break_period
- int
Jest to proponowany czas trwania sekund, przez który dzierżawa powinna być kontynuowana przed jego uszkodzeniem( od 0 do 60 sekund). Ten okres przerwania jest używany tylko wtedy, gdy jest krótszy niż czas pozostały w dzierżawie. Jeśli czas pozostały w dzierżawie jest dłuższy. Nowa dzierżawa nie będzie dostępna przed wygaśnięciem okresu przerwania, ale dzierżawa może być przechowywana przez dłuższy niż okres przerwania. Jeśli ten nagłówek nie jest wyświetlany z operacją przerwania, przerwy dzierżawy o stałym czasie trwania po upływie pozostałego okresu dzierżawy i nieskończone przerwy dzierżawy natychmiast.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
Zwraca
int
change_blob_lease
Zmienia identyfikator dzierżawy aktywnej dzierżawy. Zmiana musi zawierać bieżący identyfikator dzierżawy i nowy identyfikator dzierżawy.
change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametry
- proposed_lease_id
- str
Proponowany identyfikator dzierżawy w formacie ciągu GUID. Usługa Blob Service zwraca wartość 400 (nieprawidłowe żądanie), jeśli proponowany identyfikator dzierżawy nie jest w poprawnym formacie.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie powiedzie się operacji, jeśli istnieje.
change_container_lease
Zmień identyfikator dzierżawy aktywnej dzierżawy. Zmiana musi zawierać bieżący identyfikator dzierżawy i nowy identyfikator dzierżawy.
change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametry
- proposed_lease_id
- str
Proponowany identyfikator dzierżawy w formacie ciągu GUID. Usługa Blob Service zwraca wartość 400 (nieprawidłowe żądanie), jeśli proponowany identyfikator dzierżawy nie jest w poprawnym formacie.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
copy_blob
Kopiuje obiekt blob. Ta operacja zwraca obiekt właściwości operacji kopiowania. Operacja kopiowania może być operacją asynchroniczną, najlepszą operacją lub operacją synchroniczną.
Źródło musi być blokowym obiektem blob, jeśli requires_sync ma wartość true. Każdy istniejący docelowy obiekt blob zostanie zastąpiony. Nie można zmodyfikować docelowego obiektu blob, gdy operacja kopiowania jest w toku.
Podczas kopiowania z blokowego obiektu blob wszystkie zatwierdzone bloki i ich identyfikatory bloków są kopiowane. Niezatwierdzone bloki nie są kopiowane. Na końcu operacji kopiowania docelowy obiekt blob będzie miał taką samą zatwierdzoną liczbę bloków co źródło.
Możesz wywołać get_blob_properties w docelowym obiekcie blob, aby sprawdzić stan operacji kopiowania. Końcowy obiekt blob zostanie zatwierdzony po zakończeniu kopiowania.
Nazwa kontenera docelowego. Kontener musi istnieć. blob_name str :p aram: nazwa docelowego obiektu blob. Jeśli docelowy obiekt blob istnieje, zostanie zastąpiony. W przeciwnym razie zostanie on utworzony. :p aram str copy_source: adres URL o długości do 2 KB określający plik lub obiekt blob platformy Azure. Wartość powinna być zakodowana w adresie URL, ponieważ jest wyświetlana w identyfikatorze URI żądania. Jeśli źródło znajduje się na innym koncie, źródło musi być publiczne lub musi być uwierzytelnione za pośrednictwem sygnatury dostępu współdzielonego. Jeśli źródło jest publiczne, nie jest wymagane uwierzytelnianie. Przykłady: ?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram metadata: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblobpary name-value skojarzone z obiektem blob jako metadanymi. Jeśli nie określono par name-value, operacja skopiuje metadane ze źródłowego obiektu blob lub pliku do docelowego obiektu blob. Jeśli określono co najmniej jedną parę nazwa-wartość, docelowy obiekt blob jest tworzony przy użyciu określonych metadanych, a metadane nie są kopiowane ze źródłowego obiektu blob lub pliku. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: Wartość daty/godziny. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy źródłowy obiekt blob został zmodyfikowany od określonej daty/godziny. :p aram datetime source_if_unmodified_since: wartość DateTime. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy źródłowy obiekt blob nie został zmodyfikowany od określonej daty/godziny. :p aram ETag source_if_match: wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek warunkowy, aby skopiować źródłowy obiekt blob tylko wtedy, gdy element ETag jest zgodny z określoną wartością. Jeśli wartości ETag nie są zgodne, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). Nie można określić tego nagłówka, jeśli źródłem jest plik platformy Azure. :p aram ETag source_if_none_match: wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy element ETag nie jest zgodny z określoną wartością. Jeśli wartości są identyczne, usługa Blob service zwraca kod stanu 412 (Warunek wstępny nie powiodło się). Nie można określić tego nagłówka, jeśli źródłem jest plik platformy Azure. :p aram datetime destination_if_modified_since: wartość DateTime. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy docelowy obiekt blob został zmodyfikowany od określonej daty/godziny. Jeśli docelowy obiekt blob nie został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). :p aram datetime destination_if_unmodified_since: wartość DateTime. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy docelowy obiekt blob nie został zmodyfikowany od określonej daty/godziny. Jeśli docelowy obiekt blob został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). :p aram ETag destination_if_match: wartość ETag lub symbol wieloznaczny (). Określ wartość ETag dla tego nagłówka warunkowego, aby skopiować obiekt blob tylko wtedy, gdy określona wartość ETag jest zgodna z wartością ETag dla istniejącego docelowego obiektu blob. Jeśli element ETag dla docelowego obiektu blob nie jest zgodny z elementem ETag określonym dla parametru If-Match, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). :p aram ETag destination_if_none_match: wartość ETag lub symbol wieloznaczny (). Określ wartość ETag dla tego nagłówka warunkowego, aby skopiować obiekt blob tylko wtedy, gdy określona wartość ETag nie jest zgodna z wartością ETag docelowego obiektu blob. Określ symbol wieloznaczny (*) do wykonania operacji tylko wtedy, gdy docelowy obiekt blob nie istnieje. Jeśli określony warunek nie zostanie spełniony, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). :p aram str destination_lease_id: Identyfikator dzierżawy określony dla tego nagłówka musi być zgodny z identyfikatorem dzierżawy docelowego obiektu blob. Jeśli żądanie nie zawiera identyfikatora dzierżawy lub jest nieprawidłowe, operacja kończy się niepowodzeniem z kodem stanu 412 (Warunek wstępny nie powiodło się). :p aram str source_lease_id: określ to, aby wykonać operację kopiowania obiektu blob tylko wtedy, gdy podany identyfikator dzierżawy jest zgodny z aktywnym identyfikatorem dzierżawy źródłowego obiektu blob. :p aram int limit czasu: parametr limitu czasu jest wyrażony w sekundach. :p aram bool requires_sync: wymusza, że usługa nie zwróci odpowiedzi, dopóki kopia nie zostanie ukończona. :p aram StandardBlobTier standard_blob_tier: Standardowa wartość warstwy obiektu blob w celu ustawienia obiektu blob na wartość . W przypadku tej wersji biblioteki ma to zastosowanie tylko do blokowych obiektów blob na kontach magazynu w warstwie Standardowa. :p aram RehydratePriority rehydrate_priority: wskazuje priorytet, z którym ma być ponownie wypełnianie zarchiwizowanego obiektu blob:return: Właściwości operacji kopiowania, takie jak stan, źródło i identyfikator. :rtype: CopyProperties
copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None, requires_sync=None, standard_blob_tier=None, rehydrate_priority=None)Parametry
- container_name
- str
- blob_name
- copy_source
- metadata
- source_if_modified_since
- source_if_unmodified_since
- source_if_match
- source_if_none_match
- destination_if_modified_since
- destination_if_unmodified_since
- destination_if_match
- destination_if_none_match
- destination_lease_id
- source_lease_id
- timeout
- requires_sync
- standard_blob_tier
- rehydrate_priority
create_blob_from_bytes
Tworzy nowy obiekt blob na podstawie tablicy bajtów lub aktualizuje zawartość istniejącego obiektu blob z automatycznymi powiadomieniami o fragmentowaniu i postępie.
create_blob_from_bytes(container_name, blob_name, blob, index=0, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)Parametry
- count
- int
Liczba bajtów do przekazania. Ustaw wartość Brak lub wartość ujemna, aby przekazać wszystkie bajty rozpoczynające się od indeksu.
- content_settings
- ContentSettings
Obiekt ContentSettings używany do ustawiania właściwości obiektu blob.
Pary name-value skojarzone z obiektem blob jako metadanymi.
- validate_content
- bool
Jeśli wartość true, oblicza skrót MD5 dla każdego fragmentu obiektu blob. Usługa magazynu sprawdza skrót zawartości, która dotarła do wysłanego skrótu. Jest to przede wszystkim przydatne do wykrywania bitflips w sieci, jeśli używasz protokołu HTTP zamiast https jako https (wartość domyślna) będzie już weryfikowane. Należy pamiętać, że ten skrót MD5 nie jest przechowywany w obiekcie blob.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Wywołanie zwrotne dla postępu z funkcją podpisu (bieżąca, całkowita), gdzie bieżąca jest liczbą bajtów przesłanych do tej pory, a suma jest rozmiarem obiektu blob lub Brak, jeśli całkowity rozmiar jest nieznany.
- max_connections
- int
Maksymalna liczba połączeń równoległych do użycia, gdy rozmiar obiektu blob przekracza 64 MB.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie powiedzie się operacji, jeśli istnieje.
Szyfruje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
- timeout
- int
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania indywidualnie.
- standard_blob_tier
- StandardBlobTier
Standardowa wartość warstwy obiektów blob w celu ustawienia obiektu blob na wartość. W przypadku tej wersji biblioteki ma to zastosowanie tylko do blokowych obiektów blob na kontach magazynu w warstwie Standardowa.
Zwraca
Właściwości ETag i ostatnio zmodyfikowane dla blokowego obiektu blob
Typ zwracany
create_blob_from_path
Tworzy nowy obiekt blob na podstawie ścieżki pliku lub aktualizuje zawartość istniejącego obiektu blob z automatycznymi powiadomieniami o fragmentowaniu i postępie.
create_blob_from_path(container_name, blob_name, file_path, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)Parametry
- content_settings
- ContentSettings
Obiekt ContentSettings używany do ustawiania właściwości obiektu blob.
Pary nazwa-wartość skojarzone z obiektem blob jako metadane.
- validate_content
- bool
Jeśli wartość true, oblicza skrót MD5 dla każdego fragmentu obiektu blob. Usługa magazynu sprawdza skrót zawartości, która dotarła do wysłanego skrótu. Jest to przydatne przede wszystkim w przypadku wykrywania bitflips w sieci, jeśli użycie protokołu HTTP zamiast https jako https (ustawienie domyślne) zostanie już zweryfikowane. Należy pamiętać, że ten skrót MD5 nie jest przechowywany w obiekcie blob. Należy również pamiętać, że w przypadku włączenia algorytmu przekazywania wydajnego w pamięci nie będzie używany, ponieważ obliczanie skrótu MD5 wymaga buforowania całych bloków i w ten sposób można pokonać cel algorytmu wydajnego pod względem pamięci.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Wywołanie zwrotne dla postępu z funkcją podpisu (bieżąca, całkowita), gdzie bieżąca jest liczba bajtów przesłanych do tej pory, a łączna wartość to rozmiar obiektu blob lub Brak, jeśli całkowity rozmiar jest nieznany.
- max_connections
- int
Maksymalna liczba połączeń równoległych do użycia, gdy rozmiar obiektu blob przekracza 64 MB.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
Szyfruje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
- timeout
- int
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania osobno.
- standard_blob_tier
- StandardBlobTier
Wartość warstwy standardowego obiektu blob do ustawienia obiektu blob na . W przypadku tej wersji biblioteki ma to zastosowanie tylko do blokowych obiektów blob na kontach magazynu w warstwie Standardowa.
Zwraca
ETag i właściwości ostatniej modyfikacji blokowego obiektu blob
Typ zwracany
create_blob_from_stream
Tworzy nowy obiekt blob na podstawie pliku/strumienia lub aktualizuje zawartość istniejącego obiektu blob z automatycznymi powiadomieniami o fragmentowaniu i postępie.
create_blob_from_stream(container_name, blob_name, stream, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, use_byte_buffer=False, standard_blob_tier=None, cpk=None)Parametry
- count
- int
Liczba bajtów do odczytania ze strumienia. Jest to opcjonalne, ale powinno zostać dostarczone w celu uzyskania optymalnej wydajności.
- content_settings
- ContentSettings
Obiekt ContentSettings używany do ustawiania właściwości obiektu blob.
Pary nazwa-wartość skojarzone z obiektem blob jako metadane.
- validate_content
- bool
Jeśli wartość true, oblicza skrót MD5 dla każdego fragmentu obiektu blob. Usługa magazynu sprawdza skrót zawartości, która dotarła do wysłanego skrótu. Jest to przydatne przede wszystkim w przypadku wykrywania bitflips w sieci, jeśli użycie protokołu HTTP zamiast https jako https (ustawienie domyślne) zostanie już zweryfikowane. Należy pamiętać, że ten skrót MD5 nie jest przechowywany w obiekcie blob. Należy również pamiętać, że w przypadku włączenia algorytmu przekazywania wydajnego w pamięci nie będzie używany, ponieważ obliczanie skrótu MD5 wymaga buforowania całych bloków i w ten sposób można pokonać cel algorytmu wydajnego pod względem pamięci.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Wywołanie zwrotne dla postępu z funkcją podpisu (bieżąca, całkowita), gdzie bieżąca jest liczba bajtów przesłanych do tej pory, a łączna wartość to rozmiar obiektu blob lub Brak, jeśli całkowity rozmiar jest nieznany.
- max_connections
- int
Maksymalna liczba połączeń równoległych do użycia, gdy rozmiar obiektu blob przekracza 64 MB. Należy pamiętać, że przekazywanie równoległe wymaga wyszukiwania strumienia.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
Szyfruje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
- timeout
- int
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania osobno.
- use_byte_buffer
- bool
W przypadku wartości True wymusi to użycie oryginalnej ścieżki przekazywania buforowania pełnego bloku. Domyślnie ta wartość to False i będzie używać wydajnego w pamięci algorytmu przekazywania przesyłania strumieniowego w następujących warunkach: podany strumień jest możliwy do wyszukiwania, "require_encryption" ma wartość False, a MAX_BLOCK_SIZE >= MIN_LARGE_BLOCK_UPLOAD_THRESHOLD. Należy wziąć pod uwagę wady korzystania z tego podejścia. Aby osiągnąć wydajność pamięci, strumień IOBase lub obiekt podobny do pliku jest podzielony na bloki logiczne przy użyciu otoki Podstream. Aby odczytać poprawne dane, każdy podstream musi uzyskać blokadę, aby można było bezpiecznie szukać właściwej pozycji na udostępnionym, bazowym strumieniu. Jeśli max_connections > 1, współbieżność spowoduje znaczną ilość wyszukiwania na bazowym strumieniu. W przypadku najbardziej typowych danych wejściowych, takich jak obiekt strumienia przypominającego plik, wyszukiwanie jest niedrogią operacją i nie jest to bardzo istotne. Jednak w przypadku innych wariantów strumieni może to nie być możliwe. Kompromis dotyczący wydajności pamięci musi być ważony kosztem poszukiwania przy użyciu strumienia wejściowego. Klasa SubStream podejmie próbę buforowania do 4 MB wewnętrznie, aby zmniejszyć ilość wywołań wyszukiwania i odczytu do bazowego strumienia. Jest to szczególnie korzystne podczas przekazywania większych bloków.
- standard_blob_tier
- StandardBlobTier
Wartość warstwy standardowego obiektu blob do ustawienia obiektu blob na . W przypadku tej wersji biblioteki ma to zastosowanie tylko do blokowych obiektów blob na kontach magazynu w warstwie Standardowa.
Zwraca
ETag i właściwości ostatniej modyfikacji blokowego obiektu blob
Typ zwracany
create_blob_from_text
Tworzy nowy obiekt blob ze strony str/unicode lub aktualizuje zawartość istniejącego obiektu blob z automatycznymi powiadomieniami o fragmentowaniu i postępie.
create_blob_from_text(container_name, blob_name, text, encoding='utf-8', content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)Parametry
- encoding
- str
Kodowanie języka Python używane do konwertowania tekstu na bajty.
- content_settings
- ContentSettings
Obiekt ContentSettings używany do ustawiania właściwości obiektu blob.
Pary nazwa-wartość skojarzone z obiektem blob jako metadane.
- validate_content
- bool
Jeśli wartość true, oblicza skrót MD5 dla każdego fragmentu obiektu blob. Usługa magazynu sprawdza skrót zawartości, która dotarła do wysłanego skrótu. Jest to przydatne przede wszystkim w przypadku wykrywania bitflips w sieci, jeśli użycie protokołu HTTP zamiast https jako https (ustawienie domyślne) zostanie już zweryfikowane. Należy pamiętać, że ten skrót MD5 nie jest przechowywany w obiekcie blob.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Wywołanie zwrotne dla postępu z funkcją podpisu (bieżąca, całkowita), gdzie bieżąca jest liczba bajtów przesłanych do tej pory, a łączna wartość to rozmiar obiektu blob lub Brak, jeśli całkowity rozmiar jest nieznany.
- max_connections
- int
Maksymalna liczba połączeń równoległych do użycia, gdy rozmiar obiektu blob przekracza 64 MB.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie powiedzie się operacji, jeśli istnieje.
Szyfruje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
- timeout
- int
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania indywidualnie.
- standard_blob_tier
- StandardBlobTier
Standardowa wartość warstwy obiektów blob w celu ustawienia obiektu blob na wartość. W przypadku tej wersji biblioteki ma to zastosowanie tylko do blokowych obiektów blob na kontach magazynu w warstwie Standardowa.
Zwraca
Właściwości ETag i ostatnio zmodyfikowane dla blokowego obiektu blob
Typ zwracany
create_container
Tworzy nowy kontener na określonym koncie. Jeśli kontener o tej samej nazwie już istnieje, operacja zakończy się niepowodzeniem, jeśli fail_on_exist ma wartość True.
create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)Parametry
- container_name
- str
Nazwa kontenera do utworzenia. Nazwa kontenera może zawierać tylko małe litery, cyfry i łączniki oraz musi zaczynać się literą lub cyfrą. Przed i za każdym łącznikiem musi znajdować się znak inny niż łącznik. Nazwa musi również mieć długość od 3 do 63 znaków.
Dykt z parami name_value do skojarzenia z kontenerem jako metadanymi. Przykład:{'Category':'test'}
Zwraca
Prawda, jeśli kontener został utworzony, wartość False, jeśli kontener już istnieje.
Typ zwracany
delete_blob
Oznacza określony obiekt blob lub migawkę do usunięcia. Obiekt blob zostanie później usunięty podczas odzyskiwania pamięci.
Należy pamiętać, że aby usunąć obiekt blob, należy usunąć wszystkie jego migawki. Oba te elementy można usunąć jednocześnie za pomocą operacji Usuń obiekt blob.
Jeśli dla usługi włączono zasady przechowywania usuwania, ta operacja nietrwała usuwa obiekt blob lub migawkę i zachowuje obiekt blob lub migawkę przez określoną liczbę dni. Po określonej liczbie dni dane obiektu blob zostaną usunięte z usługi podczas odzyskiwania pamięci. Nietrwały usunięty obiekt blob lub migawka jest dostępny za pośrednictwem interfejsu API list obiektów blob określających opcję include.Deleted. Można przywrócić usunięty nietrwale obiekt blob lub migawkę przy użyciu interfejsu API cofania.
delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametry
- snapshot
- str
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do usunięcia.
- delete_snapshots
- DeleteSnapshot
Wymagane, jeśli obiekt blob ma skojarzone migawki.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie powiedzie się operacji, jeśli istnieje.
delete_container
Oznacza określony kontener do usunięcia. Kontener i wszystkie zawarte w nim obiekty blob są później usuwane podczas odzyskiwania pamięci.
delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametry
- fail_not_exist
- bool
Określ, czy zgłaszać wyjątek, gdy kontener nie istnieje.
- lease_id
- str
Jeśli zostanie określony, delete_container powiedzie się tylko wtedy, gdy dzierżawa kontenera jest aktywna i jest zgodna z tym identyfikatorem. Wymagane, jeśli kontener ma aktywną dzierżawę.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
Zwraca
Prawda, jeśli kontener został usunięty, kontener False nie istnieje.
Typ zwracany
exists
Zwraca wartość logiczną wskazującą, czy kontener istnieje (jeśli blob_name jest Brak), czy też wartość logiczna wskazująca, czy obiekt blob istnieje.
exists(container_name, blob_name=None, snapshot=None, timeout=None)Parametry
- blob_name
- str
Nazwa obiektu blob. Jeśli brak, kontener zostanie sprawdzony pod kątem istnienia.
- snapshot
- str
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę.
Zwraca
Wartość logiczna wskazująca, czy zasób istnieje.
Typ zwracany
extract_date_and_request_id
static extract_date_and_request_id(retry_context)Parametry
- retry_context
generate_account_shared_access_signature
Generuje sygnaturę dostępu współdzielonego dla usługi blob. Użyj zwróconego podpisu z parametrem sas_token dowolnej usługi BlobService.
generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)Parametry
- resource_types
- <xref:ResourceTypes>
Określa typy zasobów, które są dostępne dla sygnatury dostępu współdzielonego konta.
- permission
- <xref:AccountPermissions>
Uprawnienia skojarzone z sygnaturą dostępu współdzielonego. Użytkownik jest ograniczony do operacji dozwolonych przez uprawnienia. Wymagane, chyba że podano identyfikator odwołujące się do przechowywanych zasad dostępu, które zawierają to pole. To pole musi zostać pominięte, jeśli zostało określone w skojarzonych zasadach dostępu przechowywanych.
Czas, w którym sygnatura dostępu współdzielonego staje się nieprawidłowa. Wymagane, chyba że podano identyfikator odwołujące się do przechowywanych zasad dostępu, które zawierają to pole. To pole musi zostać pominięte, jeśli zostało określone w skojarzonych zasadach dostępu przechowywanych. Platforma Azure zawsze konwertuje wartości na utc. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc.
Czas, w którym sygnatura dostępu współdzielonego staje się prawidłowa. Jeśli pominięto, zakłada się, że godzina rozpoczęcia tego wywołania będzie czasem odebrania żądania przez usługę magazynu. Platforma Azure zawsze konwertuje wartości na utc. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc.
- ip
- str
Określa adres IP lub zakres adresów IP, z których mają być akceptowane żądania. Jeśli adres IP, z którego pochodzi żądanie, nie jest zgodny z adresem IP lub zakresem adresów określonym w tokenie SAS, żądanie nie jest uwierzytelniane. Na przykład określenie sip=168.1.5.65 lub sip=168.1.5.60-168.1.5.70 w sygnaturze dostępu współdzielonego ogranicza żądanie do tych adresów IP.
- protocol
- str
Określa protokół dozwolony dla żądania. Wartość domyślna to https,http. Zobacz Protocol , aby uzyskać możliwe wartości.
Zwraca
Token sygnatury dostępu współdzielonego (sas).
Typ zwracany
generate_blob_shared_access_signature
Generuje sygnaturę dostępu współdzielonego dla obiektu blob lub jednej z jego migawek. Użyj zwróconego podpisu z parametrem sas_token dowolnej usługi BlobService.
generate_blob_shared_access_signature(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)Parametry
- snapshot
- str
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob w celu udzielenia uprawnień.
- permission
- BlobPermissions
Uprawnienia skojarzone z sygnaturą dostępu współdzielonego. Użytkownik jest ograniczony do operacji dozwolonych przez uprawnienia. Uprawnienia muszą być uporządkowane odczytu, zapisu, usuwania, listy. Wymagane, chyba że podano identyfikator odwołujące się do przechowywanych zasad dostępu, które zawierają to pole. To pole musi zostać pominięte, jeśli zostało określone w skojarzonych zapisanych zasadach dostępu.
Czas, w którym sygnatura dostępu współdzielonego staje się nieprawidłowa. Wymagane, chyba że podano identyfikator odwołujące się do przechowywanych zasad dostępu, które zawierają to pole. To pole musi zostać pominięte, jeśli zostało określone w skojarzonych zapisanych zasadach dostępu. Platforma Azure zawsze konwertuje wartości na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc.
Czas, w którym sygnatura dostępu współdzielonego staje się prawidłowa. W przypadku pominięcia zakłada się, że godzina rozpoczęcia tego wywołania to czas odebrania żądania przez usługę magazynu. Platforma Azure zawsze konwertuje wartości na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc.
- id
- str
Unikatowa wartość o długości do 64 znaków, która jest skorelowana z zapisanymi zasadami dostępu. Aby utworzyć przechowywane zasady dostępu, użyj polecenia set_container_acl.
- ip
- str
Określa adres IP lub zakres adresów IP, z których mają być akceptowane żądania. Jeśli adres IP, z którego pochodzi żądanie, nie jest zgodny z adresem IP lub zakresem adresów określonym w tokenie SAS, żądanie nie jest uwierzytelniane. Na przykład określenie sip=168.1.5.65 lub sip=168.1.5.60-168.1.5.70 w sygnaturze dostępu współdzielonego ogranicza żądanie do tych adresów IP.
- protocol
- str
Określa protokół dozwolony dla żądania. Wartość domyślna to https,http. Zobacz Protocol , aby uzyskać możliwe wartości.
- cache_control
- str
Wartość nagłówka odpowiedzi dla Cache-Control, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
- content_disposition
- str
Wartość nagłówka odpowiedzi dla właściwości Content-Disposition, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
- content_encoding
- str
Wartość nagłówka odpowiedzi dla kodowania zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
- content_language
- str
Wartość nagłówka odpowiedzi dla języka zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
- content_type
- str
Wartość nagłówka odpowiedzi dla typu zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
- user_delegation_key
- UserDelegationKey
Zamiast klucza konta użytkownik może przekazać klucz delegowania użytkownika. Klucz delegowania użytkownika można uzyskać z usługi, uwierzytelniając się przy użyciu tożsamości usługi AAD; Można to osiągnąć, wywołując get_user_delegation_key. Gdy jest obecny, sygnatura dostępu współdzielonego jest podpisana przy użyciu klucza delegowania użytkownika.
Zwraca
Token sygnatury dostępu współdzielonego (sas).
Typ zwracany
generate_container_shared_access_signature
Generuje sygnaturę dostępu współdzielonego dla kontenera. Użyj zwróconego podpisu z parametrem sas_token dowolnej usługi BlobService.
generate_container_shared_access_signature(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)Parametry
- permission
- ContainerPermissions
Uprawnienia skojarzone z sygnaturą dostępu współdzielonego. Użytkownik jest ograniczony do operacji dozwolonych przez uprawnienia. Uprawnienia muszą być uporządkowane odczytu, zapisu, usuwania, listy. Wymagane, chyba że podano identyfikator odwołujące się do przechowywanych zasad dostępu, które zawierają to pole. To pole musi zostać pominięte, jeśli zostało określone w skojarzonych zapisanych zasadach dostępu.
Czas, w którym sygnatura dostępu współdzielonego staje się nieprawidłowa. Wymagane, chyba że podano identyfikator odwołujące się do przechowywanych zasad dostępu, które zawierają to pole. To pole musi zostać pominięte, jeśli zostało określone w skojarzonych zapisanych zasadach dostępu. Platforma Azure zawsze konwertuje wartości na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc.
Czas, w którym sygnatura dostępu współdzielonego staje się prawidłowa. W przypadku pominięcia zakłada się, że godzina rozpoczęcia tego wywołania to czas odebrania żądania przez usługę magazynu. Platforma Azure zawsze konwertuje wartości na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc.
- id
- str
Unikatowa wartość o długości do 64 znaków, która jest skorelowana z zapisanymi zasadami dostępu. Aby utworzyć przechowywane zasady dostępu, użyj set_blob_service_properties.
- ip
- str
Określa adres IP lub zakres adresów IP, z których mają być akceptowane żądania. Jeśli adres IP, z którego pochodzi żądanie, nie jest zgodny z adresem IP lub zakresem adresów określonym w tokenie SAS, żądanie nie jest uwierzytelniane. Na przykład określenie sip=168.1.5.65 lub sip=168.1.5.60-168.1.5.70 w sygnaturze dostępu współdzielonego ogranicza żądanie do tych adresów IP.
- protocol
- str
Określa protokół dozwolony dla żądania. Wartość domyślna to https,http. Zobacz Protocol , aby uzyskać możliwe wartości.
- cache_control
- str
Wartość nagłówka odpowiedzi dla Cache-Control, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
- content_disposition
- str
Wartość nagłówka odpowiedzi dla właściwości Content-Disposition, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
- content_encoding
- str
Wartość nagłówka odpowiedzi dla kodowania zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
- content_language
- str
Wartość nagłówka odpowiedzi dla języka zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
- content_type
- str
Wartość nagłówka odpowiedzi dla typu zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
- user_delegation_key
- UserDelegationKey
Zamiast klucza konta użytkownik może przekazać klucz delegowania użytkownika. Klucz delegowania użytkownika można uzyskać z usługi, uwierzytelniając się przy użyciu tożsamości usługi AAD; Można to osiągnąć, wywołując get_user_delegation_key. Gdy jest obecny, sygnatura dostępu współdzielonego jest podpisana przy użyciu klucza delegowania użytkownika.
Zwraca
Token sygnatury dostępu współdzielonego (sas).
Typ zwracany
get_blob_account_information
Pobiera informacje związane z kontem magazynu. Informacje te można również pobrać, jeśli użytkownik ma sygnaturę dostępu współdzielonego do kontenera lub obiektu blob.
get_blob_account_information(container_name=None, blob_name=None, timeout=None)Parametry
- container_name
- str
Nazwa istniejącego kontenera. Opcjonalnie, chyba że używasz tokenu SYGNATURy dostępu współdzielonego do określonego kontenera lub obiektu blob, w tym przypadku jest to wymagane.
- blob_name
- str
Nazwa istniejącego obiektu blob. Opcjonalnie, chyba że do określonego obiektu blob jest używany token SYGNATURy dostępu współdzielonego, w tym przypadku jest to wymagane.
Zwraca
Element AccountInformation.
get_blob_metadata
Zwraca wszystkie metadane zdefiniowane przez użytkownika dla określonego obiektu blob lub migawki.
get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametry
- snapshot
- str
Parametr migawki jest nieprzezroczystą wartością, która w chwili obecnej określa migawkę obiektu blob do pobrania.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
Odszyfrowuje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
Zwraca
Słownik reprezentujący nazwę metadanych obiektu blob, pary wartości.
Typ zwracany
get_blob_properties
Zwraca wszystkie metadane zdefiniowane przez użytkownika, standardowe właściwości PROTOKOŁU HTTP i właściwości systemu dla obiektu blob. Nie zwraca zawartości obiektu blob. Zwraca wartość Blob z BlobProperties dyktami metadanych i .
get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametry
- snapshot
- str
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
Odszyfrowuje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
Zwraca
obiekt blob, w tym właściwości i metadane.
Typ zwracany
get_blob_service_properties
Pobiera właściwości usługi Blob service konta magazynu, w tym usługi Azure analityka magazynu.
get_blob_service_properties(timeout=None)Parametry
Zwraca
Obiekt blob ServiceProperties z dołączoną właściwością target_version.
get_blob_service_stats
Pobiera statystyki związane z replikacją dla usługi Blob Service. Jest ona dostępna tylko wtedy, gdy dla konta magazynu jest włączona replikacja geograficznie nadmiarowa z dostępem do odczytu.
Dzięki replikacji geograficznie nadmiarowej usługa Azure Storage utrzymuje trwałość danych w dwóch lokalizacjach. W obu lokalizacjach usługa Azure Storage stale utrzymuje wiele replik w dobrej kondycji danych. Lokalizacja, w której odczytujesz, utworzysz, zaktualizujesz lub usuniesz dane, jest podstawową lokalizacją konta magazynu. Lokalizacja podstawowa istnieje w wybranym regionie podczas tworzenia konta za pośrednictwem klasycznego portalu Azure Management Azure, na przykład Północno-środkowe stany USA. Lokalizacja, do której są replikowane dane, to lokalizacja pomocnicza. Lokalizacja pomocnicza jest automatycznie określana na podstawie lokalizacji podstawowej; znajduje się w drugim centrum danych, które znajduje się w tym samym regionie co lokalizacja podstawowa. Dostęp tylko do odczytu jest dostępny z lokalizacji pomocniczej, jeśli dla konta magazynu włączono replikację geograficznie nadmiarową z dostępem do odczytu.
get_blob_service_stats(timeout=None)Parametry
Zwraca
Statystyki usługi blob.
Typ zwracany
get_blob_to_bytes
Pobiera obiekt blob jako tablicę bajtów z automatycznymi powiadomieniami o fragmentowaniu i postępie. Zwraca wystąpienie obiektu Blob z właściwościami, metadanymi i zawartością.
get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametry
- snapshot
- str
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
- start_range
- int
Początek zakresu bajtów, który ma być używany do pobierania sekcji obiektu blob. Jeśli nie zostanie podana żadna end_range, wszystkie bajty po start_range zostaną pobrane. Parametry start_range i end_range są inkluzywne. Na przykład: start_range=0, end_range=511 pobierze pierwsze 512 bajtów obiektu blob.
- end_range
- int
Koniec zakresu bajtów, który ma być używany do pobierania sekcji obiektu blob. W przypadku podania end_range należy podać start_range. Parametry start_range i end_range są inkluzywne. Na przykład: start_range=0, end_range=511 pobierze pierwsze 512 bajtów obiektu blob.
- validate_content
- bool
Jeśli jest ustawiona wartość true, sprawdza poprawność skrótu MD5 dla każdej pobranej części obiektu blob. Jest to przydatne przede wszystkim w przypadku wykrywania bitflips w sieci, jeśli użycie protokołu HTTP zamiast https jako https (ustawienie domyślne) zostanie już zweryfikowane. Należy pamiętać, że usługa zwróci tylko transakcyjne md5 dla fragmentów 4 MB lub mniej, więc pierwsze żądanie get będzie mieć rozmiar własny. MAX_CHUNK_GET_SIZE zamiast siebie. MAX_SINGLE_GET_SIZE. Jeśli samodzielnie. MAX_CHUNK_GET_SIZE został ustawiony na większy niż 4 MB, zostanie zgłoszony błąd. Ponieważ przetwarzanie md5 zajmuje czas przetwarzania, a konieczne będzie wykonanie większej liczby żądań ze względu na zmniejszony rozmiar fragmentu, może wystąpić pewien wzrost opóźnienia.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Wywołanie zwrotne dla postępu z funkcją signature (current, total), gdzie bieżąca jest liczba bajtów przesłanych do tej pory, a łączny rozmiar obiektu blob, jeśli jest znany.
- max_connections
- int
Jeśli ustawiono wartość 2 lub większą, początkowe polecenie get zostanie wykonane dla pierwszego siebie. MAX_SINGLE_GET_SIZE bajtów obiektu blob. Jeśli jest to cały obiekt blob, metoda zwraca w tym momencie. Jeśli tak nie jest, pobierze pozostałe dane równoległe przy użyciu liczby wątków równych max_connections. Każdy fragment będzie mieć rozmiar własny. MAX_CHUNK_GET_SIZE. W przypadku ustawienia wartości 1 zostanie wykonane pojedyncze duże żądanie get. Nie jest to zwykle zalecane, ale jest dostępne, jeśli należy używać bardzo niewielu wątków, żądania sieciowe są bardzo kosztowne lub strumień nienależący do wyszukiwania uniemożliwia pobieranie równoległe. Może to być również przydatne, jeśli wiele obiektów blob ma być pustych, ponieważ dodatkowe żądanie jest wymagane w przypadku pustych obiektów blob, jeśli max_connections jest większa niż 1.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
Odszyfrowuje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
- timeout
- int
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania osobno.
Zwraca
Obiekt blob z właściwościami i metadanymi. Jeśli max_connections jest większa niż 1, content_md5 (jeśli jest ustawiona na obiekcie blob) nie zostanie zwrócona. Jeśli ta wartość jest wymagana, użyj get_blob_properties lub ustaw max_connections na 1.
Typ zwracany
get_blob_to_path
Pobiera obiekt blob do ścieżki pliku z automatycznymi powiadomieniami o fragmentowaniu i postępie. Zwraca wystąpienie właściwości Blob i metadanych.
get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametry
- open_mode
- str
Tryb do użycia podczas otwierania pliku. Należy pamiętać, że określanie dołączania tylko open_mode uniemożliwia pobieranie równoległe. Dlatego max_connections musi być ustawiona na 1, jeśli jest używana ta open_mode.
- snapshot
- str
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
- start_range
- int
Początek zakresu bajtów do użycia podczas pobierania sekcji obiektu blob. Jeśli nie zostanie podana żadna end_range, wszystkie bajty po start_range zostaną pobrane. Parametry start_range i end_range są inkluzywne. Na przykład: start_range=0, end_range=511 pobierze pierwsze 512 bajtów obiektu blob.
- end_range
- int
Koniec zakresu bajtów do użycia do pobierania sekcji obiektu blob. W przypadku podania end_range należy podać start_range. Parametry start_range i end_range są inkluzywne. Na przykład: start_range=0, end_range=511 pobierze pierwsze 512 bajtów obiektu blob.
- validate_content
- bool
Jeśli ustawiono wartość true, sprawdza wartość skrótu MD5 dla każdej pobranej części obiektu blob. Jest to przede wszystkim przydatne do wykrywania bitflips w sieci, jeśli używasz protokołu HTTP zamiast https jako https (wartość domyślna) będzie już weryfikowane. Należy pamiętać, że usługa zwróci tylko transakcyjne md5 dla fragmentów 4 MB lub mniej, więc pierwsze żądanie pobierania będzie mieć rozmiar samodzielnie. MAX_CHUNK_GET_SIZE zamiast siebie. MAX_SINGLE_GET_SIZE. Jeśli samodzielnie. MAX_CHUNK_GET_SIZE ustawiono wartość większą niż 4 MB, zostanie zgłoszony błąd. Ponieważ przetwarzanie rozwiązania MD5 zajmuje czas przetwarzania, a konieczne będzie wykonanie większej liczby żądań ze względu na zmniejszony rozmiar fragmentu, może wystąpić pewien wzrost opóźnienia.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Wywołanie zwrotne dla postępu z funkcją podpisu (bieżąca, całkowita), gdzie bieżąca liczba bajtów przesłanych do tej pory, a łączna jest rozmiarem obiektu blob, jeśli jest znany.
- max_connections
- int
Jeśli ustawiono wartość 2 lub większą, początkowe pobranie zostanie wykonane dla pierwszego siebie. MAX_SINGLE_GET_SIZE bajty obiektu blob. Jeśli jest to cały obiekt blob, metoda zwraca się w tym momencie. Jeśli tak nie jest, pobierze pozostałe dane równoległe przy użyciu liczby wątków równych max_connections. Każdy fragment będzie mieć rozmiar własny. MAX_CHUNK_GET_SIZE. Jeśli ustawiono wartość 1, zostanie wykonane jedno duże żądanie get. Nie jest to ogólnie zalecane, ale dostępne, jeśli należy używać bardzo kilku wątków, żądania sieciowe są bardzo kosztowne lub strumień niemożliwy do wyszukiwania uniemożliwia równoległe pobieranie. Może to być również przydatne, jeśli oczekuje się, że wiele obiektów blob będzie pustych, ponieważ dodatkowe żądanie jest wymagane dla pustych obiektów blob, jeśli max_connections jest większa niż 1.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie powiedzie się operacji, jeśli istnieje.
Odszyfrowuje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
- timeout
- int
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania indywidualnie.
Zwraca
Obiekt blob z właściwościami i metadanymi. Jeśli max_connections jest większa niż 1, content_md5 (jeśli jest ustawiona na obiekcie blob) nie zostanie zwrócona. Jeśli ta wartość jest wymagana, użyj get_blob_properties lub ustaw max_connections na 1.
Typ zwracany
get_blob_to_stream
Pobiera obiekt blob do strumienia z automatycznymi powiadomieniami o fragmentowaniu i postępie. Zwraca wystąpienie właściwości Blob i metadanych.
get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametry
- snapshot
- str
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
- start_range
- int
Początek zakresu bajtów do użycia podczas pobierania sekcji obiektu blob. Jeśli nie zostanie podana żadna end_range, wszystkie bajty po start_range zostaną pobrane. Parametry start_range i end_range są inkluzywne. Na przykład: start_range=0, end_range=511 pobierze pierwsze 512 bajtów obiektu blob.
- end_range
- int
Koniec zakresu bajtów do użycia do pobierania sekcji obiektu blob. W przypadku podania end_range należy podać start_range. Parametry start_range i end_range są inkluzywne. Na przykład: start_range=0, end_range=511 pobierze pierwsze 512 bajtów obiektu blob.
- validate_content
- bool
Jeśli ustawiono wartość true, sprawdza wartość skrótu MD5 dla każdej pobranej części obiektu blob. Jest to przede wszystkim przydatne do wykrywania bitflips w sieci, jeśli używasz protokołu HTTP zamiast https jako https (wartość domyślna) będzie już weryfikowane. Należy pamiętać, że usługa zwróci tylko transakcyjne md5 dla fragmentów 4 MB lub mniej, więc pierwsze żądanie pobierania będzie mieć rozmiar samodzielnie. MAX_CHUNK_GET_SIZE zamiast siebie. MAX_SINGLE_GET_SIZE. Jeśli samodzielnie. MAX_CHUNK_GET_SIZE ustawiono wartość większą niż 4 MB, zostanie zgłoszony błąd. Ponieważ przetwarzanie rozwiązania MD5 zajmuje czas przetwarzania, a konieczne będzie wykonanie większej liczby żądań ze względu na zmniejszony rozmiar fragmentu, może wystąpić pewien wzrost opóźnienia.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Wywołanie zwrotne dla postępu z funkcją podpisu (bieżąca, całkowita), gdzie bieżąca liczba bajtów przesłanych do tej pory, a łączna jest rozmiarem obiektu blob, jeśli jest znany.
- max_connections
- int
Jeśli ustawiono wartość 2 lub większą, początkowe pobranie zostanie wykonane dla pierwszego siebie. MAX_SINGLE_GET_SIZE bajty obiektu blob. Jeśli jest to cały obiekt blob, metoda zwraca się w tym momencie. Jeśli tak nie jest, pobierze pozostałe dane równoległe przy użyciu liczby wątków równych max_connections. Każdy fragment będzie mieć rozmiar własny. MAX_CHUNK_GET_SIZE. Jeśli ustawiono wartość 1, zostanie wykonane jedno duże żądanie get. Nie jest to ogólnie zalecane, ale dostępne, jeśli należy używać bardzo kilku wątków, żądania sieciowe są bardzo kosztowne lub strumień niemożliwy do wyszukiwania uniemożliwia równoległe pobieranie. Może to być również przydatne, jeśli oczekuje się, że wiele obiektów blob będzie pustych, ponieważ dodatkowe żądanie jest wymagane dla pustych obiektów blob, jeśli max_connections jest większa niż 1.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie powiedzie się operacji, jeśli istnieje.
Odszyfrowuje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
- timeout
- int
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania indywidualnie.
Zwraca
Obiekt blob z właściwościami i metadanymi. Jeśli max_connections jest większa niż 1, content_md5 (jeśli jest ustawiona na obiekcie blob) nie zostanie zwrócona. Jeśli ta wartość jest wymagana, użyj get_blob_properties lub ustaw max_connections na 1.
Typ zwracany
get_blob_to_text
Pobiera obiekt blob jako tekst unicode z automatycznymi powiadomieniami o fragmentowaniu i postępie. Zwraca wystąpienie właściwości Blob , metadanych i zawartości.
get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametry
- encoding
- str
Kodowanie języka Python do użycia podczas dekodowania danych obiektu blob.
- snapshot
- str
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
- start_range
- int
Początek zakresu bajtów do użycia podczas pobierania sekcji obiektu blob. Jeśli nie zostanie podana żadna end_range, wszystkie bajty po start_range zostaną pobrane. Parametry start_range i end_range są inkluzywne. Na przykład: start_range=0, end_range=511 pobierze pierwsze 512 bajtów obiektu blob.
- end_range
- int
Koniec zakresu bajtów do użycia do pobierania sekcji obiektu blob. W przypadku podania end_range należy podać start_range. Parametry start_range i end_range są inkluzywne. Na przykład: start_range=0, end_range=511 pobierze pierwsze 512 bajtów obiektu blob.
- validate_content
- bool
Jeśli ustawiono wartość true, sprawdza wartość skrótu MD5 dla każdej pobranej części obiektu blob. Jest to przede wszystkim przydatne do wykrywania bitflips w sieci, jeśli używasz protokołu HTTP zamiast https jako https (wartość domyślna) będzie już weryfikowane. Należy pamiętać, że usługa zwróci tylko transakcyjne md5 dla fragmentów 4 MB lub mniej, więc pierwsze żądanie pobierania będzie mieć rozmiar samodzielnie. MAX_CHUNK_GET_SIZE zamiast siebie. MAX_SINGLE_GET_SIZE. Jeśli samodzielnie. MAX_CHUNK_GET_SIZE ustawiono wartość większą niż 4 MB, zostanie zgłoszony błąd. Ponieważ przetwarzanie rozwiązania MD5 zajmuje czas przetwarzania, a konieczne będzie wykonanie większej liczby żądań ze względu na zmniejszony rozmiar fragmentu, może wystąpić pewien wzrost opóźnienia.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
Wywołanie zwrotne dla postępu z funkcją podpisu (bieżąca, całkowita), gdzie bieżąca liczba bajtów przesłanych do tej pory, a łączna jest rozmiarem obiektu blob, jeśli jest znany.
- max_connections
- int
Jeśli ustawiono wartość 2 lub większą, początkowe pobranie zostanie wykonane dla pierwszego siebie. MAX_SINGLE_GET_SIZE bajty obiektu blob. Jeśli jest to cały obiekt blob, metoda zwraca się w tym momencie. Jeśli tak nie jest, pobierze pozostałe dane równoległe przy użyciu liczby wątków równych max_connections. Każdy fragment będzie mieć rozmiar własny. MAX_CHUNK_GET_SIZE. Jeśli ustawiono wartość 1, zostanie wykonane jedno duże żądanie get. Nie jest to ogólnie zalecane, ale dostępne, jeśli należy używać bardzo kilku wątków, żądania sieciowe są bardzo kosztowne lub strumień niemożliwy do wyszukiwania uniemożliwia równoległe pobieranie. Może to być również przydatne, jeśli oczekuje się, że wiele obiektów blob będzie pustych, ponieważ dodatkowe żądanie jest wymagane dla pustych obiektów blob, jeśli max_connections jest większa niż 1.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie powiedzie się operacji, jeśli istnieje.
Odszyfrowuje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
- timeout
- int
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania indywidualnie.
Zwraca
Obiekt blob z właściwościami i metadanymi. Jeśli max_connections jest większa niż 1, content_md5 (jeśli jest ustawiona na obiekcie blob) nie zostanie zwrócona. Jeśli ta wartość jest wymagana, użyj get_blob_properties lub ustaw max_connections na 1.
Typ zwracany
get_block_list
Pobiera listę bloków, które zostały przekazane w ramach blokowego obiektu blob. Istnieją dwie listy blokowe obsługiwane dla obiektu blob:
Zatwierdzona lista bloków: lista bloków, które zostały pomyślnie zatwierdzone do danego obiektu blob z umieszczaniem listy bloków.
Niezatwierdzona lista bloków: lista bloków, które zostały przekazane dla obiektu blob przy użyciu funkcji Put Block, ale które nie zostały jeszcze zatwierdzone. Te bloki są przechowywane na platformie Azure w skojarzeniu z obiektem blob, ale nie stanowią jeszcze części obiektu blob.
get_block_list(container_name, blob_name, snapshot=None, block_list_type=None, lease_id=None, timeout=None)Parametry
- block_list_type
- str
Określa, czy należy zwrócić listę zatwierdzonych bloków, listę niezatwierdzonych bloków, czy obie listy razem. Prawidłowe wartości to: zatwierdzone, niezatwierdzone lub wszystkie.
Zwraca
lista zatwierdzonych i/lub niezatwierdzonych bloków dla blokowego obiektu blob
Typ zwracany
get_container_acl
Pobiera uprawnienia dla określonego kontenera. Uprawnienia wskazują, czy dane kontenera mogą być dostępne publicznie.
get_container_acl(container_name, lease_id=None, timeout=None)Parametry
- lease_id
Jeśli zostanie określony, get_container_acl powiedzie się tylko wtedy, gdy dzierżawa kontenera jest aktywna i jest zgodna z tym identyfikatorem.
Zwraca
Słownik zasad dostępu skojarzony z kontenerem. dict of str to AccessPolicy and a public_access property if public access is włączone
get_container_metadata
Zwraca wszystkie metadane zdefiniowane przez użytkownika dla określonego kontenera.
get_container_metadata(container_name, lease_id=None, timeout=None)Parametry
- lease_id
- str
Jeśli zostanie określony, get_container_metadata powiedzie się tylko wtedy, gdy dzierżawa kontenera jest aktywna i jest zgodna z tym identyfikatorem.
Zwraca
Słownik reprezentujący nazwę metadanych kontenera, pary wartości.
Typ zwracany
get_container_properties
Zwraca wszystkie metadane zdefiniowane przez użytkownika i właściwości systemu dla określonego kontenera. Zwrócone dane nie zawierają listy obiektów blob kontenera.
get_container_properties(container_name, lease_id=None, timeout=None)Parametry
- lease_id
- str
Jeśli zostanie określony, get_container_properties zakończy się powodzeniem tylko wtedy, gdy dzierżawa kontenera jest aktywna i jest zgodna z tym identyfikatorem.
Zwraca
właściwości określonego kontenera w obiekcie kontenera.
Typ zwracany
get_user_delegation_key
Uzyskaj klucz delegowania użytkownika na potrzeby podpisywania tokenów SAS. Poświadczenie tokenu musi znajdować się w obiekcie usługi, aby to żądanie zakończyło się pomyślnie.
get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)Parametry
- key_start_time
- datetime
Wartość typu Data/godzina. Wskazuje, kiedy klucz staje się prawidłowy.
- key_expiry_time
- datetime
Wartość typu Data/godzina. Wskazuje, kiedy klucz przestaje być prawidłowy.
Zwraca
Klucz delegowania użytkownika.
Typ zwracany
list_blob_names
Zwraca generator, aby wyświetlić listę nazw obiektów blob w określonym kontenerze. Generator będzie lazily podążać za tokenami kontynuacji zwróconymi przez usługę i zatrzymać, gdy wszystkie obiekty blob zostały zwrócone lub num_results zostanie osiągnięty.
Jeśli num_results zostanie określony, a konto ma więcej niż liczbę obiektów blob, generator będzie miał wypełnione next_marker pole po zakończeniu. Ten znacznik może służyć do utworzenia nowego generatora, jeśli wymagane są więcej wyników.
list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)Parametry
- prefix
- str
Filtruje wyniki, aby zwracać tylko obiekty blob, których nazwy zaczynają się od określonego prefiksu.
- num_results
- int
Określa maksymalną liczbę obiektów blob do zwrócenia, w tym wszystkie <xref:azure.storage.blob.blockblobservice.BlobPrefix> elementy. Jeśli żądanie nie określi num_results lub określa wartość większą niż 5000, serwer zwróci do 5000 elementów. Ustawienie num_results wartości mniejszej lub równej zero powoduje wyświetlenie kodu odpowiedzi błędu 400 (nieprawidłowe żądanie).
- include
- Include
Określa co najmniej jeden dodatkowy zestaw danych do uwzględnienia w odpowiedzi.
- delimiter
- str
Gdy żądanie zawiera ten parametr, operacja zwraca BlobPrefix element na liście wyników, który działa jako symbol zastępczy dla wszystkich obiektów blob, których nazwy zaczynają się od tego samego podciągu do wyglądu znaku ogranicznika. Ogranicznik może być pojedynczym znakiem lub ciągiem.
- marker
- str
Nieprzezroczysty token kontynuacji. Tę wartość można pobrać z pola next_marker poprzedniego obiektu generatora, jeśli określono num_results i że generator zakończył wyliczanie wyników. Jeśli zostanie określony, ten generator rozpocznie zwracanie wyników z punktu, w którym poprzedni generator zatrzymał się.
list_blobs
Zwraca generator, aby wyświetlić listę obiektów blob w określonym kontenerze. Generator będzie z opóźnieniem śledzić tokeny kontynuacji zwracane przez usługę i zatrzymywać się po zwróceniu wszystkich obiektów blob lub osiągnięciu num_results.
Jeśli określono num_results i konto ma więcej niż określoną liczbę obiektów blob, po zakończeniu generator będzie miał wypełnione pole next_marker. Ten znacznik może służyć do utworzenia nowego generatora w razie potrzeby uzyskania większej liczby wyników.
list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)Parametry
- prefix
- str
Filtruje wyniki, aby zwracać tylko obiekty blob, których nazwy zaczynają się od określonego prefiksu.
- num_results
- int
Określa maksymalną liczbę obiektów blob do zwrócenia, łącznie ze wszystkimi <xref:azure.storage.blob.blockblobservice.BlobPrefix> elementami. Jeśli żądanie nie określi num_results lub określa wartość większą niż 5000, serwer zwróci do 5000 elementów. Ustawienie num_results wartości mniejszej lub równej zero powoduje wyświetlenie kodu odpowiedzi błędu 400 (Nieprawidłowe żądanie).
- include
- Include
Określa co najmniej jeden dodatkowy zestaw danych do uwzględnienia w odpowiedzi.
- delimiter
- str
Gdy żądanie zawiera ten parametr, operacja zwraca BlobPrefix element na liście wyników, który działa jako symbol zastępczy dla wszystkich obiektów blob, których nazwy zaczynają się od tego samego podciągu aż do wyglądu znaku ogranicznika. Ogranicznik może być pojedynczym znakiem lub ciągiem.
- marker
- str
Nieprzezroczysty token kontynuacji. Tę wartość można pobrać z pola next_marker poprzedniego obiektu generatora, jeśli określono num_results i że generator zakończył wyliczanie wyników. Jeśli zostanie określony, ten generator rozpocznie zwracanie wyników z punktu, w którym poprzedni generator zatrzymał.
list_containers
Zwraca generator, aby wyświetlić listę kontenerów w ramach określonego konta. Generator będzie z opóźnieniem śledzić tokeny kontynuacji zwracane przez usługę i zatrzymywać się po powrocie wszystkich kontenerów lub osiągnięciu num_results.
Jeśli określono num_results i konto ma więcej niż określoną liczbę kontenerów, po zakończeniu generator będzie miał wypełnione pole next_marker. Ten znacznik może służyć do utworzenia nowego generatora w razie potrzeby uzyskania większej liczby wyników.
list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)Parametry
- prefix
- str
Filtruje wyniki, aby zwracać tylko kontenery, których nazwy zaczynają się od określonego prefiksu.
- num_results
- int
Określa maksymalną liczbę kontenerów do zwrócenia. Żądanie pojedynczej listy może zwrócić maksymalnie 1000 contianers i potencjalnie token kontynuacji, który należy wykonać w celu uzyskania dodatkowych ponownych zmian.
- include_metadata
- bool
Określa, że metadane kontenera mają być zwracane w odpowiedzi.
- marker
- str
Nieprzezroczysty token kontynuacji. Tę wartość można pobrać z pola next_marker poprzedniego obiektu generatora, jeśli określono num_results i że generator zakończył wyliczanie wyników. Jeśli zostanie określony, ten generator rozpocznie zwracanie wyników z punktu, w którym poprzedni generator zatrzymał.
make_blob_url
Tworzy adres URL w celu uzyskania dostępu do obiektu blob.
make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)Parametry
- protocol
- str
Protokół do użycia: "http" lub "https". Jeśli nie zostanie określony, użyje protokołu określonego podczas inicjowania usługi BaseBlobService.
- sas_token
- str
Token sygnatury dostępu współdzielonego utworzony za pomocą generate_shared_access_signature.
- snapshot
- str
Wartość ciągu, która unikatowo identyfikuje migawkę. Wartość tego parametru zapytania wskazuje wersję migawki.
Zwraca
Adres URL dostępu do obiektów blob.
Typ zwracany
make_container_url
Tworzy adres URL w celu uzyskania dostępu do kontenera.
make_container_url(container_name, protocol=None, sas_token=None)Parametry
- protocol
- str
Protokół do użycia: "http" lub "https". Jeśli nie zostanie określony, użyje protokołu określonego podczas inicjowania usługi BaseBlobService.
- sas_token
- str
Token sygnatury dostępu współdzielonego utworzony za pomocą generate_shared_access_signature.
Zwraca
adres URL dostępu do kontenera.
Typ zwracany
put_block
Tworzy nowy blok do zatwierdzenia w ramach obiektu blob.
put_block(container_name, blob_name, block, block_id, validate_content=False, lease_id=None, timeout=None, cpk=None)Parametry
- block_id
- str
Wartość ciągu identyfikującą blok. Ciąg powinien być mniejszy lub równy 64 bajtom w rozmiarze. W przypadku danego obiektu blob block_id musi mieć ten sam rozmiar dla każdego bloku.
- validate_content
- bool
Jeśli wartość true, oblicza skrót MD5 zawartości bloku. Usługa magazynu sprawdza skrót zawartości, która dotarła do wysłanego skrótu. Jest to przydatne przede wszystkim w przypadku wykrywania bitflips w sieci, jeśli użycie protokołu HTTP zamiast https jako https (ustawienie domyślne) zostanie już zweryfikowane. Należy pamiętać, że ten skrót MD5 nie jest przechowywany w obiekcie blob.
Szyfruje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
put_block_from_url
Tworzy nowy blok do zatwierdzenia w ramach obiektu blob.
put_block_from_url(container_name, blob_name, copy_source_url, block_id, source_range_start=None, source_range_end=None, source_content_md5=None, lease_id=None, timeout=None, cpk=None)Parametry
- copy_source_url
- str
Adres URL danych źródłowych. Może wskazywać dowolny obiekt blob lub plik platformy Azure, który jest publiczny lub ma dołączony sygnaturę dostępu współdzielonego.
- source_range_start
- int
Wskazuje to początek zakresu bajtów (włącznie), który musi zostać pobrany ze źródła kopii.
- source_range_end
- int
Wskazuje to koniec zakresu bajtów (włącznie), które muszą zostać pobrane ze źródła kopii.
- block_id
- str
Wartość ciągu identyfikującą blok. Ciąg powinien być mniejszy lub równy 64 bajtom w rozmiarze. W przypadku danego obiektu blob block_id musi mieć ten sam rozmiar dla każdego bloku.
- source_content_md5
- str
Jeśli zostanie podana, usługa obliczy skrót MD5 zawartości bloku i porówna je z tą wartością.
Szyfruje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
put_block_list
Zapisuje obiekt blob, określając listę identyfikatorów blokowych, które tworzą obiekt blob. Aby można je było zapisać w ramach obiektu blob, blok musi zostać pomyślnie zapisany na serwerze w poprzedniej operacji Put Block.
Możesz wywołać funkcję Umieść listę bloków, aby zaktualizować obiekt blob, przekazując tylko te bloki, które uległy zmianie, a następnie zatwierdzając nowe i istniejące bloki razem. Można to zrobić, określając, czy zatwierdzić blokadę z zatwierdzonej listy zablokowanych, czy z niezatwierdzonej listy zablokowanych, lub zatwierdzić ostatnio przekazaną wersję bloku, niezależnie od listy, do której może należeć.
put_block_list(container_name, blob_name, block_list, content_settings=None, metadata=None, validate_content=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)Parametry
- block_list
- list(BlobBlock)
Lista zawierająca <xref:azure.storeage.blob.models.BlobBlock> identyfikatory bloków i stan bloku.
- content_settings
- ContentSettings
Obiekt ContentSettings używany do ustawiania właściwości obiektu blob.
Pary nazwa-wartość skojarzone z obiektem blob jako metadane.
- validate_content
- bool
Jeśli wartość true, oblicza skrót MD5 zawartości listy zablokowanych. Usługa magazynu sprawdza skrót zawartości listy zablokowanych, która dotarła do wysłanego skrótu. Jest to przydatne przede wszystkim w przypadku wykrywania bitflips w sieci, jeśli użycie protokołu HTTP zamiast https jako https (ustawienie domyślne) zostanie już zweryfikowane. Należy pamiętać, że to sprawdzenie jest skojarzone z zawartością listy blokowej, a nie z zawartością samego obiektu blob.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
Szyfruje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
- standard_blob_tier
- StandardBlobTier
Wartość warstwy standardowego obiektu blob do ustawienia obiektu blob na . W przypadku tej wersji biblioteki ma to zastosowanie tylko do blokowych obiektów blob na kontach magazynu w warstwie Standardowa.
Zwraca
ETag i ostatnio zmodyfikowane właściwości zaktualizowanego obiektu blob blokowego
Typ zwracany
release_blob_lease
Zwalnia dzierżawę. Dzierżawa może zostać zwolniona, jeśli identyfikator dzierżawy określony w żądaniu jest zgodny z elementem skojarzonym z obiektem blob. Zwolnienie dzierżawy umożliwia innemu klientowi natychmiastowe uzyskanie dzierżawy dla obiektu blob natychmiast po zakończeniu wydania.
release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametry
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
release_container_lease
Zwolnij dzierżawę. Dzierżawa może zostać zwolniona, jeśli określona lease_id pasuje do tej, która jest skojarzona z kontenerem. Zwolnienie dzierżawy umożliwia innemu klientowi natychmiastowe uzyskanie dzierżawy dla kontenera zaraz po zakończeniu wydania.
release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametry
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
renew_blob_lease
Odnawia dzierżawę. Dzierżawę można odnowić, jeśli identyfikator dzierżawy określony w żądaniu jest zgodny z elementem skojarzonym z obiektem blob. Należy pamiętać, że dzierżawa może zostać odnowiona nawet wtedy, gdy obiekt blob nie został zmodyfikowany lub dzierżawiony ponownie od czasu wygaśnięcia tej dzierżawy. Po odnowieniu dzierżawy czas trwania dzierżawy jest resetowany.
renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametry
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
Zwraca
Str
renew_container_lease
Odnawia dzierżawę. Dzierżawę można odnowić, jeśli określony identyfikator dzierżawy jest zgodny z kontenerem skojarzonym z kontenerem. Należy pamiętać, że dzierżawa może zostać odnowiona, nawet jeśli wygasła, dopóki kontener nie został ponownie dzierżawiony od czasu wygaśnięcia tej dzierżawy. Po odnowieniu dzierżawy czas trwania dzierżawy jest resetowany.
renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametry
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
Zwraca
Str
set_blob_metadata
Ustawia metadane zdefiniowane przez użytkownika dla określonego obiektu blob jako co najmniej jedną parę nazwa-wartość.
set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametry
Dykt zawierający pary nazw i wartości. Każde wywołanie tej operacji zastępuje wszystkie istniejące metadane dołączone do obiektu blob. Aby usunąć wszystkie metadane z obiektu blob, wywołaj tę operację bez nagłówków metadanych.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
Szyfruje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
Zwraca
ETag i ostatnio zmodyfikowane właściwości zaktualizowanego obiektu blob
Typ zwracany
set_blob_properties
Ustawia właściwości systemowe obiektu blob. Jeśli dla content_settings ustawiono jedną właściwość, wszystkie właściwości zostaną zastąpione.
set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametry
- content_settings
- ContentSettings
Obiekt ContentSettings używany do ustawiania właściwości obiektu blob.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.
Szyfruje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
Zwraca
ETag i ostatnio zmodyfikowane właściwości zaktualizowanego obiektu blob
Typ zwracany
set_blob_service_properties
Ustawia właściwości usługi Blob service konta magazynu, w tym usługi Azure analityka magazynu. Jeśli element (np. rejestrowanie) jest pozostawiony jako Brak, istniejące ustawienia usługi dla tej funkcji zostaną zachowane.
set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)Parametry
- hour_metrics
- Metrics
Ustawienia metryk godzin zawierają podsumowanie statystyk żądań pogrupowanych według interfejsu API w agregacjach godzinowych dla obiektów blob.
- minute_metrics
- Metrics
Ustawienia metryk minut zapewniają statystyki żądań dla każdej minuty dla obiektów blob.
- cors
- list(CorsRule)
Na liście można uwzględnić maksymalnie pięć elementów CorsRule. Jeśli zostanie określona pusta lista, wszystkie reguły CORS zostaną usunięte, a mechanizm CORS zostanie wyłączony dla usługi.
- target_version
- str
Wskazuje domyślną wersję, która ma być używana dla żądań, jeśli nie określono wersji żądania przychodzącego.
- delete_retention_policy
- DeleteRetentionPolicy
Zasady przechowywania usuwania określają, czy zachować usunięte obiekty blob. Określa również liczbę dni i wersje obiektu blob, które mają być zachowywane.
- static_website
- StaticWebsite
Określa, czy funkcja statycznej witryny internetowej jest włączona, a jeśli tak, wskazuje dokument indeksu i dokument o błędzie 404 do użycia.
set_container_acl
Ustawia uprawnienia dla określonego kontenera lub przechowywanych zasad dostępu, które mogą być używane z sygnaturami dostępu współdzielonego. Uprawnienia wskazują, czy obiekty blob w kontenerze mogą być dostępne publicznie.
set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametry
- signed_identifiers
- dict(str, AccessPolicy)
Słownik zasad dostępu do skojarzenia z kontenerem. Słownik może zawierać maksymalnie 5 elementów. Pusty słownik wyczyści zasady dostępu ustawione w usłudze.
- lease_id
- str
Jeśli zostanie określony, set_container_acl powiedzie się tylko wtedy, gdy dzierżawa kontenera jest aktywna i jest zgodna z tym identyfikatorem.
- if_modified_since
- datetime
Wartość daty/godziny. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonej daty/godziny.
- if_unmodified_since
- datetime
Wartość daty/godziny. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
Zwraca
ETag i ostatnio zmodyfikowane właściwości zaktualizowanego kontenera
Typ zwracany
set_container_metadata
Ustawia co najmniej jedną parę nazwa-wartość zdefiniowaną przez użytkownika dla określonego kontenera. Każde wywołanie tej operacji zastępuje wszystkie istniejące metadane dołączone do kontenera. Aby usunąć wszystkie metadane z kontenera, wywołaj tę operację bez dyktowania metadanych.
set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)Parametry
Dykt zawierający pary name-value do skojarzenia z kontenerem jako metadane. Przykład: {'category':'test'}
- lease_id
- str
Jeśli zostanie określony, set_container_metadata powiedzie się tylko wtedy, gdy dzierżawa kontenera jest aktywna i jest zgodna z tym identyfikatorem.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
Zwraca
ETag i ostatnio zmodyfikowane właściwości zaktualizowanego kontenera
Typ zwracany
set_proxy
Ustawia hosta i port serwera proxy dla tunelowania HTTP CONNECT.
set_proxy(host, port, user=None, password=None)Parametry
set_standard_blob_tier
Ustawia warstwy blokowych obiektów blob w obiekcie blob. Ten interfejs API jest obsługiwany tylko w przypadku blokowych obiektów blob na kontach magazynu w warstwie Standardowa.
:p aram RehydratePriority rehydrate_priority: wskazuje priorytet, z którym ma być przywracany zarchiwizowany obiekt blob
set_standard_blob_tier(container_name, blob_name, standard_blob_tier, timeout=None, rehydrate_priority=None)Parametry
- standard_blob_tier
- StandardBlobTier
Wartość warstwy standardowego obiektu blob do ustawienia obiektu blob na . W przypadku tej wersji biblioteki ma to zastosowanie tylko do blokowych obiektów blob na kontach magazynu w warstwie Standardowa.
- timeout
- int
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania osobno.
- rehydrate_priority
snapshot_blob
Tworzy migawkę obiektu blob tylko do odczytu.
snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)Parametry
Określa parę nazwa-wartość zdefiniowaną przez użytkownika skojarzona z obiektem blob. Jeśli nie określono żadnych par name-value, operacja skopiuje podstawowe metadane obiektu blob do migawki. Jeśli zostanie określona co najmniej jedna para nazwa-wartość, migawka zostanie utworzona przy użyciu określonych metadanych, a metadane nie zostaną skopiowane z podstawowego obiektu blob.
- if_modified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób został zmodyfikowany od określonego czasu.
- if_unmodified_since
- datetime
Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy zasób nie został zmodyfikowany od określonej daty/godziny.
- if_match
- str
Wartość ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.
- if_none_match
- str
Wartość ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, i nie powiedzie się operacji, jeśli istnieje.
Szyfruje dane po stronie usługi przy użyciu danego klucza. Korzystanie z kluczy dostarczonych przez klienta musi odbywać się za pośrednictwem protokołu HTTPS. Ponieważ sam klucz szyfrowania jest udostępniany w żądaniu, należy ustanowić bezpieczne połączenie w celu przeniesienia klucza.
Zwraca
właściwości migawki
Typ zwracany
undelete_blob
Operacja cofania obiektu blob przywraca zawartość i metadane nietrwałego usuniętego obiektu blob lub migawki. Próba cofnięcia usunięcia obiektu blob lub migawki, która nie zostanie usunięta nietrwale, powiedzie się bez żadnych zmian.
undelete_blob(container_name, blob_name, timeout=None)Parametry
Atrybuty
protocol
request_session
socket_timeout
MAX_BLOCK_SIZE
MAX_BLOCK_SIZE = 4194304MAX_CHUNK_GET_SIZE
MAX_CHUNK_GET_SIZE = 4194304MAX_SINGLE_GET_SIZE
MAX_SINGLE_GET_SIZE = 33554432MAX_SINGLE_PUT_SIZE
MAX_SINGLE_PUT_SIZE = 67108864MIN_LARGE_BLOCK_UPLOAD_THRESHOLD
MIN_LARGE_BLOCK_UPLOAD_THRESHOLD = 4194305
Azure SDK for Python
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla