az storage message
Ta grupa poleceń jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Zarządzanie komunikatami magazynu kolejek.
Określ jeden z następujących parametrów uwierzytelniania dla poleceń: --auth-mode, --account-key, --connection-string, --sas-token. Możesz również użyć odpowiednich zmiennych środowiskowych do przechowywania poświadczeń uwierzytelniania, np. AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING i AZURE_STORAGE_SAS_TOKEN.
Polecenia
Nazwa | Opis | Typ | Stan |
---|---|---|---|
az storage message clear |
Usuń wszystkie komunikaty z określonej kolejki. |
Podstawowe funkcje | Wersja zapoznawcza |
az storage message delete |
Usuń określony komunikat. |
Podstawowe funkcje | Wersja zapoznawcza |
az storage message get |
Pobierz co najmniej jeden komunikat z przodu kolejki. |
Podstawowe funkcje | Wersja zapoznawcza |
az storage message peek |
Pobierz co najmniej jeden komunikat z przodu kolejki, ale nie zmieniaj widoczności komunikatu. |
Podstawowe funkcje | Wersja zapoznawcza |
az storage message put |
Dodaj nowy komunikat z tyłu kolejki komunikatów. |
Podstawowe funkcje | Wersja zapoznawcza |
az storage message update |
Zaktualizuj limit czasu widoczności komunikatu. |
Podstawowe funkcje | Wersja zapoznawcza |
az storage message clear
Grupa poleceń "komunikat magazynu" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Usuń wszystkie komunikaty z określonej kolejki.
az storage message clear --queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--queue-endpoint]
[--sas-token]
[--timeout]
Przykłady
Usuń wszystkie komunikaty z określonej kolejki.
az storage message clear -q myqueue --account-name mystorageaccount
Parametry wymagane
Nazwa kolejki.
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.
Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.
Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show
. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage message delete
Grupa poleceń "komunikat magazynu" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Usuń określony komunikat.
az storage message delete --id
--pop-receipt
--queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--queue-endpoint]
[--sas-token]
[--timeout]
Przykłady
Usuń określony komunikat.
az storage message delete --id messageid --pop-receipt popreceiptreturned -q myqueue --account-name mystorageaccount
Parametry wymagane
Identyfikator komunikatu identyfikujący komunikat do usunięcia.
Prawidłowa wartość potwierdzenia pop zwrócona z wcześniejszego wywołania do operacji :func:~get_messages
lub :func:~update_message
.
Nazwa kolejki.
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.
Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.
Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show
. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage message get
Grupa poleceń "komunikat magazynu" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Pobierz co najmniej jeden komunikat z przodu kolejki.
az storage message get --queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--num-messages]
[--queue-endpoint]
[--sas-token]
[--timeout]
[--visibility-timeout]
Przykłady
Pobierz jeden komunikat z przodu kolejki i zresetuj limit czasu widoczności do 5 minut później.
az storage message get -q myqueue --visibility-timeout 300 --account-name mystorageaccount
Parametry wymagane
Nazwa kolejki.
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.
Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.
Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Niezerowa wartość całkowita określająca liczbę komunikatów do pobrania z kolejki, maksymalnie 32. Jeśli mniej jest widocznych, zwracane są widoczne komunikaty. Domyślnie pojedynczy komunikat jest pobierany z kolejki z tą operacją.
Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show
. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Określ nową wartość limitu czasu widoczności w sekundach względem czasu serwera. Nowa wartość musi być większa lub równa 1 sekundy i nie może być większa niż 7 dni. Limit czasu widoczności komunikatu można ustawić na wartość później niż czas wygaśnięcia.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage message peek
Grupa poleceń "komunikat magazynu" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Pobierz co najmniej jeden komunikat z przodu kolejki, ale nie zmieniaj widoczności komunikatu.
az storage message peek --queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--num-messages]
[--queue-endpoint]
[--sas-token]
[--timeout]
Przykłady
Pobierz 5 komunikatów z przodu kolejki (nie zmieniaj widoczności komunikatu).
az storage message peek -q myqueue --num-messages 5 --account-name mystorageaccount
Parametry wymagane
Nazwa kolejki.
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.
Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.
Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Niezerowa wartość całkowita określająca liczbę komunikatów do wglądu w kolejkę, maksymalnie 32. Domyślnie pojedynczy komunikat jest zaglądany z kolejki za pomocą tej operacji.
Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show
. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage message put
Grupa poleceń "komunikat magazynu" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Dodaj nowy komunikat z tyłu kolejki komunikatów.
az storage message put --content
--queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--queue-endpoint]
[--sas-token]
[--time-to-live]
[--timeout]
[--visibility-timeout]
Przykłady
Dodaj nową wiadomość, która będzie żywa pewnego dnia.
az storage message put -q myqueue --content mymessagecontent --time-to-live 86400 --account-name mystorageaccount
Parametry wymagane
Zawartość wiadomości o rozmiarze do 64 KB.
Nazwa kolejki.
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.
Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.
Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show
. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Określ interwał czasu wygaśnięcia komunikatu w sekundach. Czas wygaśnięcia może być dowolną liczbą dodatnią lub -1 dla nieskończoności. Jeśli ten parametr zostanie pominięty, domyślny czas wygaśnięcia to 7 dni.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Jeśli nie zostanie określony, wartość domyślna to 0. Określ nową wartość limitu czasu widoczności w sekundach względem czasu serwera. Wartość musi być większa lub równa 0 i nie może być większa niż 7 dni. Limit czasu widoczności komunikatu nie może być ustawiony na wartość późniejszą niż czas wygaśnięcia. visibility_timeout należy ustawić wartość mniejszą niż wartość time_to_live.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage message update
Grupa poleceń "komunikat magazynu" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Zaktualizuj limit czasu widoczności komunikatu.
az storage message update --id
--pop-receipt
--queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--content]
[--queue-endpoint]
[--sas-token]
[--timeout]
[--visibility-timeout]
Przykłady
Zaktualizuj limit czasu widoczności i zawartość komunikatu.
az storage message update --id messageid --pop-receipt popreceiptreturned -q myqueue
--visibility-timeout 3600 --content newmessagecontent --account-name mystorageaccount
Parametry wymagane
Identyfikator komunikatu identyfikujący komunikat do usunięcia.
Prawidłowa wartość potwierdzenia pop zwrócona z wcześniejszego wywołania do operacji :func:~get_messages
lub :func:~update_message
.
Nazwa kolejki.
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.
Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.
Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Zawartość wiadomości o rozmiarze do 64 KB.
Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show
. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Jeśli nie zostanie określony, wartość domyślna to 0. Określ nową wartość limitu czasu widoczności w sekundach względem czasu serwera. Nowa wartość musi być większa lub równa 0 i nie może być większa niż 7 dni. Limit czasu widoczności komunikatu nie może być ustawiony na wartość późniejszą niż czas wygaśnięcia. Wiadomość można zaktualizować do momentu usunięcia lub wygaśnięcia.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.