열거형

아티클
08/05/2023

Discovery 작업에서는 계층적 네임스페이스를 탐색하는 반면 Enumeration 작업에서는 특정 종류의 모든 엔터티를 기본 뷰에 나열할 수 있습니다. 열거형은 서비스 네임스페이스의 루트에 있는 특수 예약 리소스 컬렉션($Resources)에 대해 수행됩니다. 기능의 경우에는 컬렉션 주소에 대해 Enumeration이 수행됩니다. 예를 들어 항목의 규칙과 구독에서는 "/subscriptions" 또는 "/rules"에 대해 Enumeration을 수행할 수 있습니다.

요청

다음과 같이 Enumeration 요청을 생성할 수 있습니다.

메서드	요청 URI	HTTP 버전
GET	https://{serviceNamespace}.servicebus.windows.net/$Resources/{resourceCollection} 또는 https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions 또는 https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions/{subscription-name}/rules	HTTP/1.1

쿼리 매개 변수 $skip 및 $top

열거형은 페이징을 지원합니다. 서비스 네임스페이스에서 다양한 엔터티를 검색할 수 있습니다. 쿼리 매개 변수 $skip 열거형을 반환할 때 요청이 건너뛰어야 하는 항목 수와 반환할 항목 수를 $top 나타냅니다.

요청 헤더

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

요청 헤더	Description
권한 부여	"관리" 권한이 있는 SAS(공유 액세스 서명) 토큰을 지정합니다. 자세한 내용은 공유 액세스 서명을 사용한 Service Bus 인증을 참조하세요 .

요청 본문

없음

응답

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.

응답 코드

코드	Description
200	OK.
401	권한이 없습니다. 요청에 권한이 없습니다.

참고

엔터티가 없으면 빈 피드가 반환됩니다.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.

응답 헤더

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 준수합니다.

응답 헤더	Description
콘텐츠 형식	Content-Type: application/atom+xml; type=entry

응답 본문

요청이 성공하면 여러 Atom 항목이 포함된 Atom 피드가 반환됩니다. 이 피드에는 지정된 네임스페이스에서 사용 가능한 지정된 유형의 모든 리소스가 나열됩니다. 예를 들면 다음과 같습니다.

<?xml version="1.0" encoding="utf-8" ?>  
<feed xmlns='http://www.w3.org/2005/Atom'>  
  <entry>  
    <id>https://{serviceNamespace}.Windows.net/{path}</id>  
    <published>{createdTime}</published>  
    <updated>{lastUpdatedTime}</updated>  
    <link rel='self'>https://{serviceNamespace}.servicebus.Windows.net/{path}</link>  
    <content type='application/xml'>  
      {description}
    </content>  
  </entry>  
</feed>

{description} 요소의 가능한 내용은 개요를 참조 하세요.

열거형

요청