Adresowanie zasobów usługi kolejki

Interfejs usługa kolejki uwidacznia następujące zasoby za pośrednictwem interfejsu API REST:

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

  • Kolejki. Kolejka przechowuje komunikaty, które mogą być pobierane przez aplikację klienta 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 URI zasobu

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

W przypadku konta magazynu podstawowy adres URI operacji w kolejce zawiera tylko nazwę konta:

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

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

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

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

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

Pojedynczy komunikat może zostać zaktualizowany lub usunięty, odwołując się do identyfikatora komunikatu. Należy pamiętać, że ta składnia jest dostępna tylko dla operacji Zaktualizuj komunikat i Usuń komunikat i popreceipt wymaga parametru 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żane jako część ciągu zapytania w bazowym 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 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 w adresie URL przed ich wysłaniem do usług Azure Storage.

Obsługiwane operacje HTTP

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

Zobacz też

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