Udostępnij za pośrednictwem

Rozwiązywanie problemów z zasobami usługi Kolejki

  • Artykuł

Usługa Queue udostępnia następujące zasoby za pośrednictwem interfejsu API REST:

  • Konto. Konto magazynu jest unikatowo zidentyfikowaną jednostką w systemie magazynu. Konto jest nadrzędną przestrzenią nazw dla usługi Kolejki. Wszystkie kolejki są skojarzone z kontem.

  • Kolejki. Kolejka przechowuje komunikaty, które mogą być pobierane przez aplikację kliencką lub usługę.

  • Wiadomości. Komunikaty to tekst zakodowany w formacie UTF-8, który może być wartością elementu XML. Komunikat może mieć rozmiar 64 KiB.

Składnia identyfikatora URI zasobu

Każdy zasób ma odpowiedni podstawowy identyfikator URI, który odwołuje się do samego zasobu.

W przypadku konta magazynu podstawowy identyfikator URI operacji kolejki zawiera tylko nazwę konta:

https://myaccount.queue.core.windows.net

W przypadku kolejki podstawowy identyfikator URI zawiera nazwę konta i nazwę kolejki:

https://myaccount.queue.core.windows.net/myqueue

W przypadku komunikatów w kolejce podstawowy identyfikator URI zawiera nazwę konta, nazwę kolejki i zestaw komunikatów w tej kolejce:

https://myaccount.queue.core.windows.net/myqueue/messages

Pojedyncza wiadomość może zostać zaktualizowana lub usunięta, odwołując się do identyfikatora wiadomości. Należy pamiętać, że ta składnia jest dostępna tylko dla operacji Aktualizuj komunikat i Usuń komunikat i wymaga parametru popreceipt do weryfikacji:

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value

Każdy zasób może również zawierać składniki, które są wyrażone jako część ciągu zapytania w podstawowym identyfikatorze URI. Składnia ciągu zapytania to ?comp=<component_name>. Obecnie następujące składniki zasobów są dostępne dla zasobów kolejki jako parametry w identyfikatorze URI.

Składnik Obsługiwane zasoby Opis
list Konto Wylicza jednostki poniżej tego zasobu. Na koncie zwraca listę kolejek.
metadata Kolejka Ustawia lub zwraca właściwości kolejki, w tym metadane zdefiniowane przez użytkownika.

Należy pamiętać, że wszystkie wartości parametrów zapytania muszą być zakodowane pod adresem URL przed wysłaniem ich do usług Azure Storage.

Obsługiwane operacje HTTP

Każdy zasób obsługuje operacje na podstawie czasowników HTTP GET, PUT, HEAD i DELETE. Czasownik, składnia i obsługiwane wersje HTTP dla każdej operacji są wyświetlane na stronie referencyjnej dla każdej operacji. Aby uzyskać pełną listę stron referencyjnych operacji, zobacz Interfejs API REST usługi Queue Service.

Zobacz też

Nazewnictwo kolejek i metadanych
Operacje w kolejkach
Operacje na komunikatach
Interfejs API REST usługi Queue (Kolejka)