Consulta de uma política de AS (V2)

Função

Esta API é usada para consultar detalhes sobre uma política de AS especificada por ID de política.

A diferença entre as APIs V2 e V1 para consultar detalhes de uma política de AS é que a V2 contém tipos de recursos de dimensionamento em mensagens de resposta.

URI

GET /autoscaling-api/v2/{project_id}/scaling_policy/{scaling_policy_id}

Mensagem de solicitação

• Parâmetros de solicitação

  Nenhum

• Exemplo de solicitação

  Este exemplo mostra como consultar detalhes sobre a política de AS com ID 906f73ff-56e8-41b2-a005-8157d0c60361.

  GET https://{Endpoint}/autoscaling-api/v2/{project_id}/scaling_policy/906f73ff-56e8-41b2-a005-8157d0c60361

Mensagem de resposta

• Parâmetros de resposta

  Tabela 2 Parâmetros de resposta

  Parâmetro	Tipo	Descrição
  scaling_policy	scaling_policy object	Especifica detalhes sobre a política de AS. Para mais detalhes, consulte Tabela 3.

  Tabela 3 Descrição do campo scaling_policy

  Parâmetro	Tipo	Descrição
  scaling_resource_id	String	Especifica o ID do recurso de dimensionamento.
  scaling_resource_type	String	Especifica o tipo de recurso de dimensionamento. Grupo de AS: SCALING_GROUP Largura de banda: BANDWIDTH
  scaling_policy_name	String	Especifica o nome da política de AS. Suporta pesquisa difusa.
  scaling_policy_id	String	Especifica o ID da política de AS.
  policy_status	String	Especifica o status da política de AS. INSERVICE: a política de AS está ativada. PAUSED: a política de AS está desativada. EXECUTING: a política de AS está sendo executada.
  scaling_policy_type	String	Especifica o tipo de política de AS. ALARM: indica que a ação de dimensionamento é acionada por um alarme. Um valor é retornado para alarm_id e nenhum valor é retornado para scheduled_policy. SCHEDULED: indica que a ação de dimensionamento é acionada conforme programado. Um valor é retornado para a scheduled_policy e nenhum valor é retornado para alarm_id, recurrence_type, recurrence_value, start_time ou end_time. RECURRENCE: indica que a ação de dimensionamento é acionada periodicamente. Os valores são retornados para scheduled_policy, recurrence_type, recurrence_value, start_time e end_time, e nenhum valor é retornado para alarm_id. INTERVAL_ALARM: indica que a ação de dimensionamento é acionada por uma política de dimensionamento refinada. Um valor é retornado para alarm_id e nenhum valor é retornado para scheduled_policy.
  alarm_id	String	Especifica o ID do alarme.
  scheduled_policy	scheduled_policy object	Especifica a política de AS periódica ou agendada. Para mais detalhes, consulte Tabela 4.
  scaling_policy_action	scaling_policy_action object	Especifica a ação de dimensionamento da política de AS. Para mais detalhes, consulte Tabela 5.
  interval_alarm_actions	Array of interval_alarm_actions objects	Especifica a ação de dimensionamento aplicada quando scaling_policy_type é definida como INTERVAL_ALARM. Para mais detalhes, consulte Tabela 6.
  cool_down_time	Integer	Especifica o(s) período(s) de resfriamento.
  create_time	String	Especifica a hora em que uma política de AS foi criada. O formato de tempo está em conformidade com o UTC.
  meta_data	meta_data object	Fornece informações adicionais. Para mais detalhes, consulte Tabela 7.
  description	String	Especifica a descrição da política de AS.

  Tabela 4 Descrição do campo scheduled_policy

  Parâmetro	Tipo	Descrição
  launch_time	String	Especifica a hora em que a ação de dimensionamento é acionada. O formato de tempo está em conformidade com o UTC. Se scaling_policy_type estiver definido como SCHEDULED, o formato de hora será YYYY-MM-DDThh:mmZ. Se scaling_policy_type for definido como RECURRENCE, o formato de hora será hh:mm.
  recurrence_type	String	Especifica o tipo de uma ação de dimensionamento acionada periodicamente. Daily: indica que a ação de dimensionamento é acionada uma vez por dia. Weekly: indica que a ação de dimensionamento é acionada uma vez por semana. Monthly: indica que a ação de dimensionamento é acionada uma vez por mês.
  recurrence_value	String	Especifica a frequência na qual as ações de dimensionamento são acionadas. Se recurrence_type estiver definido como Daily, o valor será null, indicando que a ação de dimensionamento é acionada uma vez por dia. Se recurrence_type for definido como Weekly, o valor varia de 1 (domingo) a 7 (sábado). Os dígitos referem-se a datas em cada semana e separados por uma vírgula, como 1,3,5. Se recurrence_type for definido como Monthly, o valor varia de 1 a 31. Os dígitos referem-se às datas em cada mês e separados por uma vírgula, como 1,10,13,28.
  start_time	String	Especifica a hora de início da ação de dimensionamento acionada periodicamente. O formato de tempo está em conformidade com o UTC. O formato da hora é YYYY-MM-DDThh:mmZ.
  end_time	String	Especifica a hora de término da ação de dimensionamento acionada periodicamente. O formato de tempo está em conformidade com o UTC. O formato da hora é YYYY-MM-DDThh:mmZ.

  Tabela 5 Descrição do campo scaling_policy_action

  Parâmetro	Tipo	Descrição
  operation	String	Especifica a ação de dimensionamento. ADD: indica a adição de instâncias. REDUCE: indica a redução de instâncias. SET: indica a configuração do número de instâncias para um valor especificado.
  size	Integer	Especifica o tamanho da operação.
  percentage	Integer	Especifica a porcentagem de instâncias a serem operadas.
  limits	Integer	Especifica as restrições de operação.

  Tabela 6 Descrição do campo interval_alarm_actions

  Parâmetro	Obrigatório	Tipo	Descrição
  lower_bound	Não	Double	Especifica o limite inferior do intervalo de valores.
  upper_bound	Não	Double	Especifica o limite superior do intervalo de valores.
  operation	Não	String	Especifica a operação a ser executada. ADD: indica a adição de instâncias. REDUCE: indica instâncias de redução. SET: indica definir o número de instâncias para um valor especificado.
  size	Não	Integer	Especifica o tamanho da operação.
  percentage	Não	Integer	Especifica a porcentagem de instâncias a serem operadas.
  limits	Não	Integer	Especifica as restrições de operação.

  Tabela 7 Descrição do campo meta_data

  Parâmetro	Tipo	Descrição
  metadata_bandwidth_share_type	String	Especifica o tipo de compartilhamento de largura de banda na política de dimensionamento de largura de banda.
  metadata_eip_id	String	Especifica o ID de EIP para a largura de banda na política de dimensionamento de largura de banda.
  metadata_eip_address	String	Especifica o EIP para a largura de banda na política de dimensionamento de largura de banda.

• Exemplo de resposta

  {
      "scaling_policy": {
             "scaling_policy_id": "906f73ff-56e8-41b2-a005-8157d0c60361",
             "scaling_policy_name": "hth_aspolicy_1",
             "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
             "scaling_resource_type": "BANDWIDTH",
             "scaling_policy_type": "ALARM",
             "alarm_id": "al1513822380493GvlJKZwA8",
             "scheduled_policy": {
             },
             "cool_down_time": 900,
             "scaling_policy_action": {
                    "operation": "ADD",
                    "size": 1,
                    "limits": 111
             },
             "policy_status": "INSERVICE",
             "create_time": "2018-03-21T08:03:35Z",
             "meta_data": {
                 "metadata_eip_id": "263f0886-de6a-4e21-ad83-814ca9f3844e",
                 "metadata_eip_address": "255.255.255.255"
             }
      }
  }

Valores retornados

• Normal

  200

• Anormal

  Valores retornados	Descrição
  400 Bad Request	O servidor falhou ao processar a solicitação.
  401 Unauthorized	Você deve digitar o nome de usuário e a senha para acessar a página solicitada.
  403 Forbidden	Você está proibido de acessar a página solicitada.
  404 Not Found	O servidor não conseguiu encontrar a página solicitada.
  405 Method Not Allowed	Você não tem permissão para usar o método especificado na solicitação.
  406 Not Acceptable	A resposta gerada pelo servidor não poderia ser aceita pelo cliente.
  407 Proxy Authentication Required	Você deve usar o servidor proxy para autenticação para que a solicitação possa ser processada.
  408 Request Timeout	A solicitação expirou o tempo limite.
  409 Conflict	A solicitação não pôde ser processada devido a um conflito.
  500 Internal Server Error	Falhou ao concluir a solicitação porque ocorre um erro de serviço interno.
  501 Not Implemented	Falhou ao concluir a solicitação porque o servidor não suporta a função solicitada.
  502 Bad Gateway	Falhou ao concluir a solicitação porque a solicitação é inválida.
  503 Service Unavailable	Falhou ao concluir a solicitação porque o sistema não está disponível.
  504 Gateway Timeout	Ocorreu um erro de tempo limite de gateway.

Códigos de erro

Consulte Códigos de erro.