Recuperar as métricas de um plano

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Recupera as métricas do plano da data de início fornecida para a data de término fornecida.

Solicitação

Especifique a solicitação Obter Métricas do Plano da seguinte maneira: substitua <ServiceMgmt> pelo endereço do ponto de extremidade da API de Gerenciamento de Serviço. <PlanIdentifier> deve ser substituído pelo identificador de plano para o plano que está sendo recuperado.

Método	URI da solicitação	Versão HTTP
GET	<https:// ServiceMgmt>:30004/plans/<PlanIdentifier>	HTTP/1.1

Parâmetros de URI

Essa solicitação tem os seguintes parâmetros de URI.

Parâmetro do URI	Descrição
startTime	Obrigatórios. O DateTime do qual iniciar a coleta de métricas.
endTime	Obrigatórios. O DateTime para encerrar a coleta de métricas.

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
Autorização: Portador	Obrigatórios. O token de portador de autorização.
x-ms-principal-id	Obrigatórios. O identificador principal.
x-ms-client-request-id	Opcional. O identificador de solicitação do cliente.
x-ms-client-session-id	Opcional. O identificador da sessão do cliente.
x-ms-principal-liveid	Opcional. O identificador live principal.

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). Se os parâmetros de URI estiverem incorretos, essa solicitação retornará 404.

Para obter informações sobre códigos de status, consulte Status e Códigos de Erro (Windows Gerenciamento de Serviço do Azure Pack).

Cabeçalhos de resposta

A resposta contém cabeçalhos HTTP padrão. Todos os cabeçalhos padrão estão em conformidade com a especificação de protocolo HTTP/1.1.

Corpo da resposta

A tabela a seguir descreve os elementos do corpo da solicitação.

Nome

O nome da métrica. Os valores possíveis incluem DailySignupCount ou TotalSignupCount.

PrimaryAggregationType

O tipo de agregação primária de métrica. Os valores incluem Total.

Unidade

A unidade de métrica. Os valores possíveis são:

Bytes
BytesPerSec
Contagem
Megabytes
Milissegundos
Outro
Percentual
Segundos

TimeGrain

O intervalo de tempo da métrica.

StartTime

A hora de início do conjunto retornado de valores de métrica.

EndTime

A hora de término do conjunto retornado de valores de métrica.

Valores

Uma lista de valores de métrica. No caso do tipo de agregação Contagem , o seguinte formato é usado:

Nome do elemento	Descrição
Tempo Criado	O DateTime em que o valor da métrica foi registrado.
Total	DailySignUp – O número total de inscrições diárias registradas. TotalSignUp – O número total de inscrições.
Mínimo	O valor mínimo.
Máximo	O valor máximo.
Contagem	A contagem de valores.

Exemplo

O exemplo de código a seguir mostra uma solicitação Obter Métricas de Plano .

GET https://<Computer>:30004/plans/Svclvfrkussi3occcwh/metrics?startTime=2013-06-22T07%3a00%3a00.0000000Z&endTime=2013-06-29T07%3a00%3a00.0000000Z HTTP/1.1
Authorization: Bearer <Token>
x-ms-client-request-id: 3f9565a5-bdf6-41ac-a61e-d2de886f95df-2013-06-28 18:13:40Z
x-ms-client-session-id: d19ca528-d7bf-4a62-9d4d-03adbb4f6c74
x-ms-principal-id: <COMPUTER>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <COMPUTER>\Administrator
Host: <Computer>:30004

O exemplo de código a seguir mostra uma resposta obter métricas de plano .

[
  {
    "Name": "DailySignupCount",
    "PrimaryAggregationType": "Total",
    "Unit": "Count",
    "TimeGrain": "1.00:00:00",
    "StartTime": "2013-06-22T07:00:00Z",
    "EndTime": "2013-06-29T07:00:00Z",
    "Values": [
      {
        "TimeCreated": "2013-06-22T07:00:00Z",
        "Total": 0,
        "Minimum": null,
        "Maximum": null,
        "Count": 1
      }
    ]
  },
  {
    "Name": "TotalSignupCount",
    "PrimaryAggregationType": "Total",
    "Unit": "Count",
    "TimeGrain": "1.00:00:00",
    "StartTime": "2013-06-22T07:00:00Z",
    "EndTime": "2013-06-29T07:00:00Z",
    "Values": [
      {
        "TimeCreated": "2013-06-22T07:00:00Z",
        "Total": 0,
        "Minimum": null,
        "Maximum": null,
        "Count": 1
      },
      {
        "TimeCreated": "2013-06-28T07:00:00Z",
        "Total": 0,
        "Minimum": null,
        "Maximum": null,
        "Count": 1
      }
    ]
  }
]

Consulte Também

Interfaces de plano de administrador

Compartilhar via