큐 서비스 리소스 주소 지정
큐 서비스는 REST API를 통해 다음과 같은 리소스를 제공합니다.
계정). 저장소 계정은 저장소 시스템 내에서 고유하게 식별되는 엔터티입니다. 계정은 큐 서비스의 부모 네임스페이스입니다. 모든 큐는 계정과 연결되어 있습니다.
큐. 큐에는 클라이언트 응용 프로그램 또는 서비스가 검색할 수 있는 메시지가 저장됩니다.
메시지. 메시지는 XML 요소의 값일 수 있는 UTF-8 인코딩 텍스트입니다. 메시지 크기는 64KiB일 수 있습니다.
리소스 URI 구문
각 리소스에 해당하는 기본 URL을 통해 리소스를 참조하게 됩니다.
저장소 계정의 경우 큐 작업에 대한 기본 URI에는 계정의 이름만 포함됩니다.
https://myaccount.queue.core.windows.net
큐의 기본 URI에는 계정 이름과 큐 이름이 포함됩니다.
https://myaccount.queue.core.windows.net/myqueue
큐의 메시지에 대한 기본 URI에는 계정 이름, 큐 이름 및 해당 큐에 있는 메시지 집합이 포함됩니다.
https://myaccount.queue.core.windows.net/myqueue/messages
개별 메시지는 메시지 ID를 참조하여 업데이트 또는 삭제할 수 있습니다. 이 구문은 메시지 업데이트 및 메시지 삭제 작업에만 사용할 수 있으며 확인을 위해 매개 변수가 popreceipt 필요합니다.
https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value
각 리소스에는 또한 기본 URI에서 쿼리 문자열의 일부로 표현되는 구성 요소가 포함될 수 있습니다. 쿼리 문자열의 구문은 ?comp=<component_name>입니다. 현재까지는 큐 리소스에 대해 URI의 매개 변수로 다음 리소스 구성 요소를 사용할 수 있습니다.
| 구성 요소 | 지원되는 리소스 | Description |
|---|---|---|
list |
계정 | 이 리소스 아래의 엔터티를 열거합니다. 계정에서 큐 목록을 반환합니다. |
metadata |
큐 | 사용자 정의 메타데이터를 포함하여 큐 속성을 설정 또는 반환합니다. |
쿼리 매개 변수의 모든 값을 Azure 저장소 서비스로 전송할 수 있으려면 먼저 URL로 인코딩되어 있어야 합니다.
지원되는 HTTP 작업
각 리소스에서는 HTTP 동사 GET, PUT, HEAD 및 DELETE 기반의 작업이 지원됩니다. 각 작업에 대한 동사, 구문 및 지원되는 HTTP 버전은 각 작업의 참조 페이지에 나와 있습니다. 작업 참조 페이지의 전체 목록은 Queue Service REST API를 참조하세요.