Consulta das configurações do AS

Função

Essa API é usada para consultar configurações de AS com base em critérios de pesquisa. Os resultados são exibidos por página.

• Os critérios de pesquisa podem ser o nome da configuração do AS, o ID da imagem, o número da linha inicial e o número de registros.
• Se nenhum critério de pesquisa for especificado, um máximo de 20 configurações de AS podem ser consultadas para um locatário por padrão.

URI

GET /autoscaling-api/v1/{project_id}/scaling_configuration

Você pode digitar o ponto de interrogação (?) e o e comercial (&) no final do URI para definir vários critérios de pesquisa. As configurações do AS podem ser pesquisadas por todos os parâmetros opcionais na tabela a seguir. Para obter detalhes, consulte a solicitação de exemplo.

Mensagem de solicitação

• Parâmetros de solicitação

  Nenhum

• Exemplo de solicitação

  Este exemplo mostra como consultar as configurações de AS com ID de imagem 37ca2b35-6fc7-47ab-93c7-900324809c5c.

  GET https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_configuration?image_id=37ca2b35-6fc7-47ab-93c7-900324809c5c

Mensagem de resposta

• Parâmetros de resposta

  Tabela 2 Parâmetros de resposta

  Parâmetro	Tipo	Descrição
  total_number	Integer	Especifica o número total de registros de consulta.
  start_number	Integer	Especifica o número da linha inicial.
  limit	Integer	Especifica o número de registros de consulta.
  scaling_configurations	Array of scaling_configurations objects	Especifica a lista de configuração do AS.

  Tabela 3 Descrição do campo scaling_configurations

  Parâmetro	Tipo	Descrição
  scaling_configuration_id	String	Especifica o ID de configuração de AS. Este parâmetro é globalmente exclusivo.
  tenant	String	Especifica o ID do locatário.
  scaling_configuration_name	String	Especifica o nome da configuração de AS. Suporta pesquisa difusa.
  instance_config	instance_config object	Especifica as informações sobre configurações de instância.
  create_time	String	Especifica a hora em que as configurações de AS são criadas. O formato de tempo está em conformidade com o UTC.
  scaling_group_id	String	Especifica o ID do grupo de AS ao qual a configuração de AS está vinculada.

  Tabela 4 Descrição do campo instance_config

  Parâmetro	Tipo	Descrição
  flavorRef	String	Especifica o ID de flavor do ECS.
  imageRef	String	Especifica o ID da imagem. É o mesmo que image_id.
  disk	Array of disk objects	Especifica as informações do grupo de discos.
  key_name	String	Especifica o nome do par de chaves SSH usado para efetuar logon no ECS.
  key_fingerprint	String	Especifica a impressão digital do par de chaves SSH usado para efetuar logon no ECS.
  instance_name	String	Este parâmetro é reservado.
  instance_id	String	Este parâmetro é reservado.
  adminPass	String	Este parâmetro é reservado.
  personality	Array of personality objects	Especifica informações sobre o arquivo injetado.
  public_ip	public_ip object	Especifica o EIP do ECS.
  user_data	String	Especifica os dados do usuário Cloud-Init, que são codificados usando Base64.
  metadata	metadata object	Especifica os metadados do ECS. Para mais detalhes, consulte Tabela 11.
  security_groups	Array of security_groups objects	Especifica as informações do grupo de segurança.
  server_group_id	String	Especifica o ID do grupo de ECS.
  tenancy	String	Especifica que os ECSs são criados no DeHs.
  dedicated_host_id	String	Especifica o ID de um DeH.
  market_type	String	Especifica um modo de cobrança para um ECS, que pode ser preço à vista ou pagamento por uso.
  multi_flavor_priority_policy	String	Especifica a política de prioridade usada quando há vários flavors e instâncias a serem criados usando uma configuração de AS.

  Tabela 5 Descrição do campo disk

  Parâmetro	Tipo	Descrição
  size	Integer	Especifica o tamanho do disco. A unidade é GB.
  volume_type	String	Especifica o tipo de disco.
  disk_type	String	Especifica se o disco é um disco do sistema ou um disco de dados. DATA indica um disco de dados. SYS indica um disco do sistema.
  dedicated_storage_id	String	Especifica o ID do dispositivo DSS para o disco.
  data_disk_image_id	String	Especifica o ID da imagem do disco de dados para criar um disco de dados.
  snapshot_id	String	Especifica o ID do snapshot de backup em disco.
  metadata	metadata object	Especifica os metadados para a criação de discos. Para mais detalhes, consulte Tabela 6.

  Tabela 6 Descrição do campo metadata para a criação de discos

  Parâmetro	Tipo	Descrição
  __system__encrypted	String	Especifica a criptografia em metadata. O valor pode ser 0 (criptografia desativada) ou 1 (criptografia ativada). Se este parâmetro não existir, o disco não será criptografado por padrão.
  __system__cmkid	String	Especifica o ID de CMK, que indica criptografia nos metadata. Este parâmetro é usado com __system__encrypted. NOTA: Para obter detalhes sobre como obter o ID de CMK, consulte Consulta da lista de CMKs.

  Tabela 7 Descrição do campo personality

  Parâmetro	Tipo	Descrição
  path	String	Especifica o caminho do arquivo injetado.
  content	String	Especifica o conteúdo do arquivo a ser injetado. O conteúdo do arquivo é codificado usando Base64.

  Tabela 8 Descrição do campo public_ip

  Parâmetro	Tipo	Descrição
  eip	eip object	Especifica o EIP atribuído automaticamente.

  Tabela 9 Descrição do campo eip

  Parâmetro	Tipo	Descrição
  ip_type	String	Especifica o tipo de endereço IP.
  bandwidth	bandwidth object	Especifica a largura de banda de um endereço IP.

  Tabela 10 Descrição do campo bandwidth

  Parâmetro	Tipo	Descrição
  size	Integer	Especifica a largura de banda (Mbit/s).
  share_type	String	Especifica o tipo de compartilhamento de largura de banda. Valores enumerados do tipo de compartilhamento: PER: dedicado WHOLE: partilhado
  charging_mode	String	Especifica o modo de faturamento da largura de banda. bandwidth: cobrado pela largura de banda. traffic: cobrado pelo tráfego.
  id	String	Especifica o ID da largura de banda. Você pode especificar uma largura de banda compartilhada ao solicitar um EIP com a largura de banda cujo tipo está definido como WHOLE.

  Tabela 11 Descrição do campo metadata

  Parâmetro	Tipo	Descrição
  admin_pass	String	Especifica a senha da conta de Administrator de um ECS de Windows.

  Tabela 12 Descrição do campo security_groups

  Parâmetro	Tipo	Descrição
  id	String	Especifica o ID do grupo de segurança.

• Exemplo de resposta

  {
      "limit": 20,
      "total_number": 2,
      "start_number": 0,
      "scaling_configurations": [
          {
              "tenant": "ce061903a53545dcaddb300093b477d2",
              "scaling_configuration_id": "6afe46f9-7d3d-4046-8748-3b2a1085ad86",
              "scaling_configuration_name": " config_name_1",
              "instance_config": {
                  "disk": [
                      {
                          "size": 40,
                          "volume_type": "SATA",
                          "disk_type": "SYS"
                      },
                      {
                          "size": 100,
                          "volume_type": "SATA",
                          "disk_type": "DATA"
                      }
                  ],
                  "personality": null,
                  "instance_name": null,
                  "instance_id": null,
                  "flavorRef": "103",
                  "imageRef": "37ca2b35-6fc7-47ab-93c7-900324809c5c",
                  "key_name": "keypair01",
                  "public_ip": null,
                  "user_data": null,
                  "metadate": {},
                  "security_groups": [{
                       "id": "6c22a6c0-b5d2-4a84-ac56-51090dcc33be"
                  }],
              },
              "create_time": "2015-07-23T01:04:07Z"
          },
          {
              "tenant": "ce061903a53545dcaddb300093b477d2",
              "scaling_configuration_id": "24a8c5f3-c713-4aba-ac29-c17101009e5d",
              "scaling_configuration_name": "config_name_2",
              "instance_config": {
                  "disk": [
                      {
                          "size": 40,
                          "volume_type": "SATA",
                          "disk_type": "SYS"
                      }
                  ],
                  "personality": null,
                  "instance_name": null,
                  "instance_id": null,
                  "flavorRef": "103",
                  "imageRef": "37ca2b35-6fc7-47ab-93c7-900324809c5c",
                  "key_name": "keypair01",
                  "public_ip": null,
                  "user_data": null,
                  "metadata": {},
                  "security_groups": [{
                       "id": "6c22a6c0-b5d2-4a84-ac56-51090dcc33be"
                  }],
                  "multi_flavor_priority_policy": "PICK_FIRST"
              },
              "create_time": "2015-07-22T01:08:41Z"
          }
      ]
  }

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.