Obter Estatísticas do Serviço tabela
A Get Table Service Stats operação obtém estatísticas relacionadas com a replicação do Armazenamento de Tabelas do Azure. Só está disponível no ponto final de localização secundária quando a replicação georredundante de acesso de leitura está ativada para a conta de armazenamento.
Pedir
O Get Table Service Stats pedido pode ser construído da seguinte forma. Recomendamos que utilize HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento e tenha em atenção que é necessário o sufixo -secundário :
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| GET | https://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats |
HTTP/1.1 |
Nota
O URI tem de incluir sempre um caráter de barra (/) para separar o nome do anfitrião das partes do caminho e da consulta do URI. Nesta operação, a parte do caminho do URI está vazia.
Parâmetros do URI
Os seguintes parâmetros adicionais podem ser especificados no URI do pedido:
| Parâmetro | Description |
|---|---|
Timeout |
Opcional. O timeout parâmetro é expresso em segundos. |
Cabeçalhos do pedido
Os cabeçalhos de pedido obrigatórios e opcionais estão descritos na tabela seguinte:
| Cabeçalho do pedido | Description |
|---|---|
Authorization |
Obrigatório. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure. |
Date or x-ms-date |
Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure. |
x-ms-version |
Necessário para todos os pedidos autorizados. Especifica a versão da operação a utilizar para este pedido. Para obter mais informações, veja Controlo de versões dos serviços de Armazenamento do Azure. |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de carateres de 1 kibibyte (KiB) que é registado nos registos quando o registo é configurado. Recomendamos vivamente que utilize este cabeçalho para correlacionar as atividades do lado do cliente com os pedidos que o servidor recebe. Para obter mais informações, veja [Monitorizar o Armazenamento de Tabelas do Azure. |
Corpo do pedido
Nenhum.
Resposta
A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta
Código de estado
Uma operação bem-sucedida devolve o código de estado 200 (OK). Quando é chamado num ponto final de localização secundária que não está ativado para uma leitura secundária, devolve o código de estado HTTP 403 (Permissões de Conta Insuficientes).
Cabeçalhos de resposta
A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também inclui cabeçalhos HTTP padrão 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 |
Identifica exclusivamente o pedido que foi feito e pode ser utilizado para resolver o pedido. Para obter mais informações, veja Resolver problemas de operações da API. |
x-ms-version |
Especifica a versão da operação que foi utilizada para a resposta. Para obter mais informações, veja Controlo de versões dos 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 |
Pode ser utilizado para resolver problemas de pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente no pedido e o valor não contiver mais de 1024 carateres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, não estará presente na resposta. |
Corpo da resposta
O formato do corpo da resposta é o seguinte:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceStats>
<GeoReplication>
<Status>live|bootstrap|unavailable</Status>
<LastSyncTime>sync-time|<empty></LastSyncTime>
</GeoReplication>
</StorageServiceStats>
Os elementos do corpo da resposta estão descritos na tabela seguinte:
| Cabeçalho de resposta | Descrição |
|---|---|
Status |
O estado da localização secundária. Os valores possíveis são: - live: indica que a localização secundária está ativa e operacional. - bootstrap: indica que a sincronização inicial da localização primária para a localização secundária está em curso. Normalmente, isto ocorre quando a replicação é ativada pela primeira vez. - indisponível: indica que a localização secundária está temporariamente indisponível. |
LastSyncTime |
Um valor de data/hora UTC, para o segundo. Todas as escritas primárias que precedem este valor têm a garantia de estarem disponíveis para operações de leitura na escrita secundária. As escritas primárias após este ponto no tempo podem ou não estar disponíveis para leituras. O valor poderá estar vazio se LastSyncTime não estiver disponível. Isto pode acontecer se o estado de replicação for bootstrap ou indisponível.Embora a georreplicação esteja continuamente ativada, o LastSyncTime resultado pode refletir um valor em cache do serviço que é atualizado a cada poucos minutos. |
Autorização
Apenas o proprietário da conta pode chamar esta operação.
Observações
Com a replicação georredundante, o Armazenamento do Azure mantém os seus dados de forma duradoura em duas localizações. Em ambas as localizações, o Armazenamento do Azure mantém constantemente várias réplicas em bom estado de funcionamento dos dados.
A localização onde lê, cria, atualiza ou elimina dados é a localização principal da conta de armazenamento. A localização primária existe na região que escolher quando cria uma conta através do portal clássico do Azure Management Azure (por exemplo, E.U.A. Centro-Norte).
A localização para a qual os seus dados são replicados é a localização secundária . A localização secundária reside numa região que é automaticamente emparelhada geograficamente com a região primária. O acesso só de leitura está disponível a partir da localização secundária, se a replicação georredundante com acesso de leitura estiver ativada para a sua conta de armazenamento.
Para obter mais informações sobre a replicação georredundante com acesso de leitura, veja Redundância de dados.
Para construir um pedido para uma operação de leitura no ponto final secundário, acrescente -secondary ao nome da conta no URI que utiliza para ler a partir do Armazenamento de Tabelas. Por exemplo, um URI secundário para a operação Entidades de Consulta será semelhante a https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>').
Pedido e resposta de exemplo
Segue-se um pedido de exemplo para a Get Table Service Stats operação:
GET http://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats HTTP/1.1
O pedido é enviado 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=
O código de estado e os cabeçalhos de resposta são devolvidos 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-Table/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>