다음을 통해 공유

채널의 모든 등록 읽기

  • 아티클

 

ChannelURI, 장치 토큰, GCM registrationId와 같은 채널의 모든 등록을 검색합니다.

요청

방법 요청 URI HTTP 버전
GET https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/?$filter=ChannelUri eq '{channelUri}' 및 api 버전 = 2015 01

또는

https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/?$filter=DeviceToken eq '{deviceToken}' 및 api 버전 = 2015 01

또는

https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/?$filter=GcmRegistrationId eq '{gcmRegistrationId}' 및 api 버전 = 2015 01		 HTTP/1.1

유의 사항은 다음과 같습니다.

  • 이 호출은 OData에 지정된 $top 쿼리 문자열 매개 변수를 지원합니다.

  • 이 호출은 지원는 ContinuationToken 쿼리 문자열 매개 변수를 열거를 계속 합니다.

  • ChannelUri 는 url로 인코딩됩니다.

  • DeviceToken 대문자의 16 진수 형식 이어야 합니다.

요청 헤더

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

요청 헤더 설명
권한 부여 공유 액세스 서명 인증 된에 지정된대로 생성 한 토큰 서비스 버스, 또는 서비스 버스 인증 및 권한 부여와 Microsoft Azure Active Directory 액세스 제어(액세스 제어 서비스 또는 ACS라고도 함)합니다.
x-ms-version 2015-01

요청 본문

없음.

응답

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

응답 코드

코드 설명
200 등록이 검색되었습니다.
400 잘못된 요청. 알림 허브에서 이 쿼리를 지원하지 않습니다.
401 인증 실패 액세스 키가 잘못되었습니다.
403 할당량을 초과했습니다. 등록 작업 속도가 너무 빨라 요청이 거부되었습니다.

상태 코드에 대 한 정보를 참조 하십시오. 상태 및 오류 코드.

응답 헤더

응답 헤더 설명
Content-type application/atom+xml;type=entry;charset=utf-8
X-MS-ContinuationToken 등록이 더 있는 경우 등록을 계속 열거하기 위한 토큰을 포함합니다.

응답 본문

에 지정 된 xml 형식으로 등록 목록을 래핑하는 atom 피드 Create Registration합니다. 예를 들면 다음과 같습니다.

<?xml version="1.0" encoding="utf-8" ?> <feed xmlns="http://www.w3.org/2005/Atom"> <title type="/{NotificationTopic}/channels/{channel hash}" /> <id> https://{tenant}.windows.net/{NotificationTopic}/channels/{channel hash}</id> <updated>2012-08-17T17:32:00Z</updated> <entry xmlns:m=”https://schemas.microsoft.com/ado/2007/08/dataservices/metadata” m:etag=”W/"1234567890"”> <id>https://{tenant}.windows.net/{NotificationTopic}/registrations/{registrationId}</id> <title type="text"> /{NotificationTopic}/registrations/{registrationId}</title> <updated>2012-08-17T17:32:00Z</updated> <content type="application/xml"> <WindowsRegistrationDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://schemas.microsoft.com/netservices/2010/10/servicebus/connect"> <ETag>{ETag}</ETag> <ExpirationTime>2012-07-16T19:20+01:00</ExpirationTime> <RegistrationId>{RegistrationId}</RegistrationId> <Tags>myTag, myOtherTag</Tags> <ChannelUri>{ChannelUri}</ChannelUri> </WindowsRegistrationDescription> </content> </entry> <entry> … </entry> </feed>