영업: 1-800-867-1380

큐 서비스 통계 가져오기

업데이트 날짜: 2014년 11월

Get Queue Service Stats 작업은 큐 서비스에 대한 복제와 관련된 통계를 검색합니다. 이 작업은 저장소 계정에 대해 읽기 액세스 지리적 중복 복제가 설정되어 있는 경우 보조 위치 끝점에서만 사용할 수 있습니다.

다음과 같이 Get Queue Service Stats 요청을 생성할 수 있습니다. HTTPS를 사용하는 것이 좋습니다. myaccount를 사용자의 저장소 이름으로 바꾸십시오. -secondary 접미사는 필수라는 사실에 유의하십시오.

 

방법 요청 URI HTTP 버전

GET

https://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats

HTTP/1.1

경로의 호스트 이름과 URI의 쿼리 부분을 구분하기 위해 URI에는 항상 슬래시(/)가 포함되어야 합니다. 이 작업의 경우 URI의 경로 부분은 비어 있습니다.

요청 URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.

 

매개 변수 설명

Timeout

선택적 요소입니다. timeout 매개 변수는 초 단위로 표시됩니다.

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

 

요청 헤더 설명

Authorization

필수 사항입니다. 인증 체계, 계정 이름 및 서명을 지정합니다. 자세한 내용은 Azure 저장소 서비스에 대한 인증을 참조하십시오.

Date or x-ms-date

필수 사항입니다. 요청의 UCT(협정 세계시)를 지정합니다. 자세한 내용은 Azure 저장소 서비스에 대한 인증을 참조하십시오.

x-ms-version

인증된 모든 요청의 경우 필수입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 자세한 내용은 Azure에서 파일, Blob, 큐 및 테이블 서비스의 버전 관리를 참조하십시오.

x-ms-client-request-id

선택적 요소입니다. 저장소 분석 로깅이 설정되어 있는 경우 분석 로그에 기록된 1KB 문자 제한의 클라이언트에서 생성한 불투명 값입니다. 클라이언트 쪽 작업과 서버가 받은 요청의 상관 관계를 지정하는 데 이 헤더를 사용하는 것이 좋습니다. 자세한 내용은 Azure 로깅: 로그를 사용하여 저장소 요청 추적을 참조하세요.

없음.

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

작업에 성공하면 상태 코드 200(정상)이 반환됩니다. 보조 읽기에 대해 설정되지 않은 보조 위치 끝점에서 호출하면 InsufficientAccountPermissions 오류와 함께 Http 상태 코드 403이 반환됩니다.

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

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답 헤더에는 또한 추가 표준 HTTP 헤더가 포함됩니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.

 

응답 헤더

설명

x-ms-request-id

이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다. 자세한 내용은 API 작업 문제 해결을 참조하십시오.

x-ms-version

응답에 사용된 작업의 버전을 지정합니다. 자세한 내용은 Azure에서 Blob, 큐 및 테이블 서비스의 버전 관리를 참조하십시오.

Date

응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.

응답 본문의 형식은 다음과 같습니다.

<?xml version="1.0" encoding="utf-8"?> <StorageServiceStats>   <GeoReplication>             <Status>live|bootstrap|unavailable</Status>       <LastSyncTime>sync-time|<empty></LastSyncTime>   </GeoReplication> </StorageServiceStats>

다음 표에서는 응답 본문의 요소에 대해 설명합니다.

 

응답 헤더

설명

Status

보조 위치의 상태입니다. 가능한 값은 다음과 같습니다.

  • live: 보조 위치가 활성 및 작동 상태임을 나타냅니다.

  • bootstrap: 기본 위치에서 보조 위치로 초기 동기화가 진행 중임을 나타냅니다. 일반적으로 복제가 처음 설정되었을 때 발생합니다.

  • unavailable: 보조 위치를 일시적으로 사용할 수 없음을 나타냅니다.

LastSyncTime

보조 위치에 대한 GMT 날짜/시간 값입니다. 이 값 이전의 모든 주 쓰기는 보조 위치의 읽기 작업에 사용할 수 있습니다. 이 지점 이후의 주 쓰기는 읽기에 사용할 수도 있고 사용하지 못할 수도 있습니다.

LastSyncTime을 사용할 수 없는 경우 값이 비어 있을 수 있습니다. 복제 상태가 bootstrap 또는 unavailable인 경우 이러한 상황이 발생할 수 있습니다.

지리적 복제가 계속 설정되어 있는 경우에도 LastSyncTime 결과는 몇 분마다 새로 고쳐지는 서비스에서 캐시된 값을 반영할 수 있습니다.

계정 소유자만 이 작업을 호출할 수 있습니다.

지리적 중복 복제를 사용하여 Azure 저장소는 데이터를 두 위치에서 영구 유지 관리합니다. 두 위치 모두에서 Azure 저장소는 데이터에 대한 여러 정상 복제를 지속적으로 유지 관리합니다.

데이터를 읽거나 만들거나 업데이트하거나 삭제하는 위치는 저장소 계정 위치입니다. 기본 위치는 Azure 관리 포털을 통해 계정을 만들 때 선택하는 지역(예: 미국 중북부에 있습니다. 데이터가 복제되는 위치는 보조 위치입니다. 보조 위치는 기본 위치에 따라 자동으로 결정되며, 기본 위치와 동일한 지역에 있는 보조 데이터 센터입니다. 저장소 계정에 대해 읽기 액세스 지리적 중복 복제가 설정되어 있는 경우, 보조 위치에서 읽기 전용 액세스가 가능합니다. 읽기 액세스 지리적 중복 복제에 대한 자세한 내용은 Azure 저장소 팀 블로그를 참조하세요.

보조 끝점에 대한 읽기 작업 요청을 생성하려면 큐 저장소에서 읽는 데 사용하는 URI의 계정 이름에 접미사로 -secondary를 추가하십시오. 예를 들어 메시지 엿보기(REST API) 작업의 보조 URI는 https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true와 비슷합니다.

다음은 Get Queue Service Stats 작업에 대한 예제 요청입니다.

GET http://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats HTTP/1.1

요청이 다음 헤더와 함께 보내집니다.

x-ms-version: 2013-08-15 x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=

상태 코드 및 응답 헤더는 다음과 같이 반환됩니다.

HTTP/1.1 200 OK Content-Type: application/xml Date: Wed, 23 Oct 2013 22:08:54 GMT x-ms-version: 2013-08-15 x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30 Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0

응답에는 다음 XML 본문이 포함됩니다.

<?xml version="1.0" encoding="utf-8"?> <StorageServiceStats>   <GeoReplication>       <Status>live</Status>       <LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>         </GeoReplication> </StorageServiceStats>

참고 항목

이 정보가 도움이 되었습니까?
(1500자 남음)
의견을 주셔서 감사합니다.
표시:
© 2015 Microsoft