Obter status do serviço Blob

A operação Get Blob Service Stats recupera as estatísticas relacionadas à replicação para o serviço Blob. Ela está disponível apenas no ponto de extremidade de local secundário quando a replicação georredundante de acesso de leitura está habilitada para a conta de armazenamento.

Solicitação

A solicitação Get Blob Service Stats pode ser criada da seguinte maneira. HTTPS é recomendado. Substitua myaccount pelo nome da sua conta de armazenamento. Note que o sufixo -secondary é necessário:

Método URI da solicitação Versão de HTTP
GET https://myaccount-secondary.blob.core.windows.net/?restype=service&comp=stats HTTP/1.1

Observe que o URI sempre deve incluir a barra (/) para separar o nome do host do caminho e as partes de consulta do URI. No caso dessa operação, a parte do caminho do URI fica vazia.

Parâmetros do URI

Os seguintes parâmetros adicionais podem ser especificados no URI de solicitação.

Parâmetro Descrição
Timeout Opcional. O parâmetro timeout é expresso em segundos.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação Descrição
Authorization Obrigatórios. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, consulte autorizar solicitações ao armazenamento do Azure.
Date or x-ms-date Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para obter mais informações, consulte autorizar solicitações ao armazenamento do Azure.
x-ms-version Necessário para todas as solicitações autorizadas. Especifica a versão da operação a ser usada para esta solicitação. Para obter mais informações, consulte controle de versão para os serviços de armazenamento do Azure.
x-ms-client-request-id Opcional. O cliente gerou um valor opaco com o limite de caracteres de 1 KB que é registrado nos logs de análise quando análise de armazenamento log está habilitado. O uso deste cabeçalho é altamente recomendável para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte log do Azure: usando logs para rastrear solicitações de armazenamento.

Corpo da solicitação

Nenhum.

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta

Código de status

Uma operação bem-sucedida retorna o código de status 200 (OK). Quando a chamada ocorrer no ponto de extremidade do local secundário, que não está habilitado para a leitura secundária, isso retornará um código de status Http 403 com erro InsufficientAccountPermissions.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também inclui cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho de Resposta Descrição
x-ms-request-id Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação. Para obter mais informações, consulte Solucionando problemas de operações de API.
x-ms-version Especifica a versão da operação usada para a resposta. Para obter mais informações, consulte controle de versão para os serviços de armazenamento do Azure.
Date Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.
x-ms-client-request-id Esse cabeçalho pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente na solicitação e o valor for de no máximo 1024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente na solicitação, esse cabeçalho não estará presente na resposta.

Corpo da resposta

Formato do corpo da resposta:

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

A tabela a seguir descreve os elementos do corpo da resposta:

Cabeçalho de Resposta Descrição
Status O status do local secundário. Os valores possíveis são:

- live: Indica que o local secundário está ativo e operacional.
- bootstrap: Indica que a sincronização inicial do local primário para o local secundário está em andamento. Isso normalmente ocorre quando a replicação é habilitada pela primeira vez.
-indisponível: indica que o local secundário está temporariamente indisponível.
LastSyncTime Um valor de data/hora GMT, para o segundo. Todas as gravações primárias anteriores a esse valor estão certamente disponíveis para operações de leitura no local secundário. Gravações primárias após esse momento determinado podem ou não estar disponíveis para leituras.

O valor pode estar vazio se LastSyncTime não está disponível. Isso pode ocorrer se o status de replicação é bootstrap ou unavailable.

Embora a georreplicação esteja continuamente ativada, o resultado LastSyncTime pode refletir um valor armazenado em cache do serviço que é atualizado a cada intervalo de minutos.

Autorização

Somente o proprietário da conta pode chamar essa operação.

Comentários

Com a replicação georredundante, o Armazenamento do Azure mantém seus dados duráveis em dois locais. Em ambos os locais, o Armazenamento do Azure mantém constantemente várias réplicas íntegras de seus dados.

O local onde você lê, cria, atualiza ou exclui dados é o local da conta de armazenamento principal. O local principal existe na região que você escolhe no momento em que cria uma conta por meio do portal clássico do Azure de gerenciamento do Azure, por exemplo, EUA Central norte. O local no qual seus dados são replicados é o local secundário. O local secundário reside em uma região que é automaticamente emparelhada geograficamente com a região primária. O acesso somente leitura está disponível no local secundário se a replicação georredundante de acesso de leitura está habilitada para sua conta de armazenamento. Para obter mais detalhes sobre a replicação com redundância geográfica com acesso de leitura, consulte o blog da equipe de armazenamento do Azure.

Para construir uma solicitação para uma operação de leitura no ponto de extremidade secundário, acrescente -secondary como um sufixo ao nome da conta no URI que você usa para ler do armazenamento de Blob. Por exemplo, um URI secundário para a operação obter blob será semelhante a https://myaccount-secondary.blob.core.windows.net/mycontainer/myblob .

Exemplo de solicitação e resposta

Esta é uma solicitação de exemplo para a operação Get Blob Service Stats:

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

A solicitação é enviada com os seguintes cabeçalhos:

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

Os cabeçalhos de código de status e de resposta são retornados da seguinte forma:

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  

A resposta inclui o seguinte corpo 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>  

Confira também

Operações na conta (serviço Blob)