Adresowanie zasobów usługi kolejki

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 usługi Queue. Wszystkie kolejki są skojarzone z kontem.

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

  • 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 odnosi się do samego zasobu.

W przypadku konta magazynu podstawowy identyfikator URI operacji w kolejce 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  

Pojedynczy komunikat może zostać zaktualizowany lub usunięty, 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 popreceipt 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ż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 identyfikatora 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 Kolejki.

Zobacz też

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