Blob 서비스 통계 가져오기Get Blob Service Stats

Get Blob Service Stats 작업은 Blob 서비스에 대한 복제와 관련된 통계를 검색합니다.The Get Blob Service Stats operation retrieves statistics related to replication for the Blob service. 이 작업은 저장소 계정에 대해 읽기 액세스 지리적 중복 복제가 설정되어 있는 경우 보조 위치 엔드포인트에서만 사용할 수 있습니다.It is only available on the secondary location endpoint when read-access geo-redundant replication is enabled for the storage account.

요청Request

다음과 같이 Get Blob Service Stats 요청을 생성할 수 있습니다.The Get Blob Service Stats request may be constructed as follows. HTTPS를 사용하는 것이 좋습니다.HTTPS is recommended. myaccount를 사용자의 저장소 이름으로 바꾸십시오. -secondary 접미사는 필수라는 사실에 유의하십시오.Replace myaccount with the name of your storage account, and note that the -secondary suffix is required:

방법Method 요청 URIRequest URI HTTP 버전HTTP Version
GETGET https://myaccount-secondary.blob.core.windows.net/?restype=service&comp=stats HTTP/1.1HTTP/1.1

경로의 호스트 이름과 URI의 쿼리 부분을 구분하기 위해 URI에는 항상 슬래시(/)가 포함되어야 합니다.Note that the URI must always include the forward slash (/) to separate the host name from the path and query portions of the URI. 이 작업의 경우 URI의 경로 부분은 비어 있습니다.In the case of this operation, the path portion of the URI is empty.

URI 매개 변수URI parameters

요청 URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.The following additional parameters may be specified on the request URI.

매개 변수Parameter 설명Description
Timeout 선택 사항입니다.Optional. timeout 매개 변수는 초 단위로 표시됩니다.The timeout parameter is expressed in seconds.

요청 헤더Request Headers

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.The following table describes required and optional request headers.

요청 헤더Request Header 설명Description
Authorization 필수 요소.Required. 인증 체계, 계정 이름 및 서명을 지정 합니다.Specifies the authorization scheme, account name, and signature. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.For more information, see Authorize requests to Azure Storage.
Date or x-ms-date 필수 요소.Required. 요청에 대한 UTC(협정 세계시)를 지정합니다.Specifies the Coordinated Universal Time (UTC) for the request. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.For more information, see Authorize requests to Azure Storage.
x-ms-version 모든 권한이 부여 된 요청에 필요 합니다.Required for all authorized requests. 이 요청에 사용할 작업의 버전을 지정합니다.Specifies the version of the operation to use for this request. 자세한 내용은 Azure Storage services에 대 한 버전 관리를 참조 하세요.For more information, see Versioning for the Azure Storage services.
x-ms-client-request-id 선택 사항입니다.Optional. 스토리지 분석 로깅을 사용 하는 경우 분석 로그에 기록 되는 1KB 문자 제한이 있는 클라이언트 생성 된 불투명 값입니다.Client generated opaque value with 1KB character limit that is recorded in the analytics logs when Storage Analytics Logging is enabled. 클라이언트 쪽 작업과 서버가 받은 요청의 상관 관계를 지정하는 데 이 헤더를 사용하는 것이 좋습니다.The use of this header is highly recommended for correlating client side activities with requests received by the server. 자세한 내용은 Azure 로깅: 로그를 사용 하 여 저장소 요청 추적을참조 하세요.For more information see Azure Logging: Using Logs to Track Storage Requests.

요청 본문Request Body

없음None.

응답Response

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.The response includes an HTTP status code, a set of response headers, and a response body

상태 코드Status Code

작업에 성공하면 상태 코드 200(정상)이 반환됩니다.A successful operation returns status code 200 (OK). 보조 읽기에 대해 설정되지 않은 보조 위치 엔드포인트에서 호출하면 InsufficientAccountPermissions 오류와 함께 Http 상태 코드 403이 반환됩니다.When called on secondary location endpoint which is not enabled for secondary read, it will return Http status code of 403 with InsufficientAccountPermissions error.

응답 헤더Response Headers

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다.The response for this operation includes the following headers. 응답 헤더에는 또한 추가 표준 HTTP 헤더가 포함됩니다.The response also includes additional standard HTTP headers. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을따릅니다.All standard headers conform to the HTTP/1.1 protocol specification.

응답 헤더Response Header 설명Description
x-ms-request-id 이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다.This header uniquely identifies the request that was made and can be used for troubleshooting the request. 자세한 내용은 API 작업 문제 해결을 참조 하세요.For more information, see Troubleshooting API Operations.
x-ms-version 응답에 사용된 작업의 버전을 지정합니다.Specifies the version of the operation used for the response. 자세한 내용은 Azure Storage services에 대 한 버전 관리를 참조 하세요.For more information, see Versioning for the Azure Storage services.
Date 응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
x-ms-client-request-id 이 헤더를 사용 하 여 요청 및 해당 응답의 문제를 해결할 수 있습니다.This header can be used to troubleshoot requests and corresponding responses. 이 헤더의 값은 요청에 있는 경우 헤더의 값과 같으며 x-ms-client-request-id , 값은 최대 1024 표시 ASCII 문자입니다.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. x-ms-client-request-id요청에 헤더가 없는 경우이 헤더는 응답에 표시 되지 않습니다.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

응답 본문Response Body

응답 본문의 형식은 다음과 같습니다.The format of the response body is as follows:

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

다음 표에서는 응답 본문의 요소에 대해 설명합니다.The following table describes the elements of the response body:

응답 헤더Response Header 설명Description
Status 보조 위치의 상태입니다.The status of the secondary location. 가능한 값은Possible values are:

- live: 보조 위치가 활성 및 작동 상태임을 나타냅니다.- live: Indicates that the secondary location is active and operational.
- bootstrap: 기본 위치에서 보조 위치로의 초기 동기화가 진행 중임을 나타냅니다.- bootstrap: Indicates initial synchronization from the primary location to the secondary location is in progress. 일반적으로 복제가 처음 설정되었을 때 발생합니다.This typically occurs when replication is first enabled.
-사용할 수 없음: 보조 위치를 일시적으로 사용할 수 없음을 나타냅니다.- unavailable: Indicates that the secondary location is temporarily unavailable.
LastSyncTime 보조 위치에 대한 GMT 날짜/시간 값입니다.A GMT date/time value, to the second. 이 값 이전의 모든 주 쓰기는 보조 위치의 읽기 작업에 사용할 수 있습니다.All primary writes preceding this value are guaranteed to be available for read operations at the secondary. 이 지점 이후의 주 쓰기는 읽기에 사용할 수도 있고 사용하지 못할 수도 있습니다.Primary writes after this point in time may or may not be available for reads.

LastSyncTime을 사용할 수 없는 경우 값이 비어 있을 수 있습니다.The value may be empty if LastSyncTime is not available. 복제 상태가 bootstrap 또는 unavailable인 경우 이러한 상황이 발생할 수 있습니다.This can happen if the replication status is bootstrap or unavailable.

지리적 복제가 계속 설정되어 있는 경우에도 LastSyncTime 결과는 몇 분마다 새로 고쳐지는 서비스에서 캐시된 값을 반영할 수 있습니다.Although geo-replication is continuously enabled, the LastSyncTime result may reflect a cached value from the service that is refreshed every few minutes.

권한 부여Authorization

계정 소유자만 이 작업을 호출할 수 있습니다.Only the account owner may call this operation.

설명Remarks

지리적 중복 복제를 사용하여 Azure 저장소는 데이터를 두 위치에서 영구 유지 관리합니다.With geo-redundant replication, Azure Storage maintains your data durable in two locations. 두 위치 모두에서 Azure 저장소는 데이터에 대한 여러 정상 복제를 지속적으로 유지 관리합니다.In both locations, Azure Storage constantly maintains multiple healthy replicas of your data.

데이터를 읽거나 만들거나 업데이트하거나 삭제하는 위치는 저장소 계정 위치입니다.The location where you read, create, update, or delete data is the primary storage account location. 기본 위치는 Azure 관리 Azure 클래식 포털을 통해 계정을 만들 때 선택 하는 지역 (예: 미국 중 북부)에 있습니다.The primary location exists in the region you choose at the time you create an account via the Azure Management Azure classic portal, for example, North Central US. 데이터가 복제되는 위치는 보조 위치입니다.The location to which your data is replicated is the secondary location. 보조 위치는 자동으로 주 지역과 쌍을 이루는 지역에 상주 합니다.The secondary location resides in a region that is automatically geographically paired with the primary region. 저장소 계정에 대해 읽기 액세스 지리적 중복 복제 가 설정되어 있는 경우, 보조 위치에서 읽기 전용 액세스가 가능합니다.Read-only access is available from the secondary location, if read-access geo-redundant replication is enabled for your storage account. 읽기 액세스 지리적 중복 복제에 대 한 자세한 내용은 Azure Storage 팀 블로그를 참조 하세요.For more details about read-access geo-redundant replication, see the Azure Storage Team Blog.

보조 엔드포인트에 대한 읽기 작업 요청을 생성하려면 Blob 저장소에서 읽는 데 사용하는 URI의 계정 이름에 접미사로 -secondary를 추가하세요.To construct a request for a read operation against the secondary endpoint, append -secondary as a suffix to the account name in the URI that you use to read from Blob storage. 예를 들어 Blob 가져오기 작업의 보조 URI는와 유사 https://myaccount-secondary.blob.core.windows.net/mycontainer/myblob 합니다.For example, a secondary URI for the Get Blob operation will be similar to https://myaccount-secondary.blob.core.windows.net/mycontainer/myblob.

예제 요청 및 응답Sample Request and Response

다음은 Get Blob Service Stats 작업에 대한 예제 요청입니다.The following is a sample request for the Get Blob Service Stats operation:

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

요청이 다음 헤더와 함께 보내집니다.The request is sent with following headers:

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

상태 코드 및 응답 헤더는 다음과 같이 반환됩니다.The status code and response headers are returned as follows:

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-Blob/1.0 Microsoft-HTTPAPI/2.0  

응답에는 다음 XML 본문이 포함됩니다.The response includes the following XML body:

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

추가 정보See also

계정에 대한 작업(Blob 서비스)Operations on the Account (Blob Service)