Obter status do serviço Fila

Artigo
06/27/2023

A operação recupera estatísticas relacionadas à replicação para o Armazenamento de Filas do Get Queue Service Stats Azure. Ele está disponível somente no ponto de extremidade de localização secundário quando a replicação com redundância geográfica de acesso de leitura está habilitada para a conta de armazenamento.

Solicitação

A solicitação Get Queue Service Stats pode ser criada da seguinte maneira. Recomendamos que você use HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento e observe que o sufixo -secondary é necessário:

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

Observação

O URI sempre deve incluir um caractere de barra (/) para separar o nome do host do caminho e das partes de 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 de solicitação:

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

Cabeçalhos da 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 saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
`Date or x-ms-date`	Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para saber mais, confira Autorizar solicitações para o 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. Fornece um valor opaco gerado pelo cliente com um limite de caracteres kib (1 kibibyte) que é registrado nos logs quando o registro em log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Monitorar o Armazenamento de Filas do Azure.

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 ele é chamado em um ponto de extremidade de local secundário que não está habilitado para uma leitura secundária, ele retorna HTTP status código 403 (Permissões de Conta Insuficientes).

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`	Identifica exclusivamente a solicitação que foi feita e pode ser usada para solucionar problemas da solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API.
`x-ms-version`	Especifica a versão da operação que foi 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 será igual ao valor do `x-ms-client-request-id` cabeçalho se ele estiver presente na solicitação e o valor não contiver mais de 1.024 caracteres ASCII visíveis. Se o `x-ms-client-request-id` cabeçalho não estiver presente na solicitação, ele 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>

Os elementos do corpo da resposta estão descritos na seguinte tabela:

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. Normalmente, isso 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 UTC, em segundos. Todas as gravações primárias que precedem esse valor têm a garantia de estarem disponíveis para operações de leitura na gravação secundária. As gravações primárias após esse ponto no tempo podem ou não estar disponíveis para leituras.

O valor poderá estar vazio se LastSyncTime não estiver disponível. Isso pode acontecer se o status de replicação estiver inicializado ou indisponível.

Embora a replicação geográfica esteja continuamente habilitada, o LastSyncTime resultado pode refletir um valor armazenado em cache do serviço que é atualizado a cada poucos minutos.

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. Normalmente, isso 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 UTC, em segundos. Todas as gravações primárias que precedem esse valor têm a garantia de estarem disponíveis para operações de leitura na gravação secundária. As gravações primárias após esse ponto no tempo podem ou não estar disponíveis para leituras. O valor poderá estar vazio se `LastSyncTime` não estiver disponível. Isso pode acontecer se o status de replicação estiver inicializado ou indisponível. Embora a replicação geográfica esteja continuamente habilitada, o `LastSyncTime` resultado pode refletir um valor armazenado em cache do serviço que é atualizado a cada poucos minutos.

Autorização

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

Comentários

Com a replicação com redundância geográfica, o Armazenamento do Azure mantém seus dados de forma durável 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 ao criar uma conta por meio do portal clássico do Azure Management Azure (por exemplo, Centro-Norte dos EUA).

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 informações sobre a replicação com redundância geográfica de acesso de leitura, consulte Redundância de dados.

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 Filas. Por exemplo, um URI secundário para a operação Inspecionar Mensagens é semelhante a https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true.

Exemplo de solicitação e resposta

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

GET http://myaccount-secondary.queue.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-Queue/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 Fila)