Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Elastic Cloud Server/ Referência de API/ Exemplos de aplicação/ Consulta dos ECS
Atualizado em 2022-11-16 GMT+08:00
Compartilhar

Consulta dos ECS

Cenários

Esta seção descreve como usar a API para consultar detalhes sobre os ECS para obter todos os ECS de um locatário por página.

As operações descritas nesta seção incluem consulta de informações por página e filtragem e classificação de dados. Para obter detalhes sobre os parâmetros, consulte Consulta de detalhes sobre os ECS.

As API envolvidas

A consulta dos ECS envolve as seguintes API:

Procedimento

  1. Consulte detalhes sobre os ECS especificando o número máximo de ECSs exibidos em uma página.

    • Exemplo de solicitação

      GET: https://{endpoint}/v2.1/743b4c0428d945316666666666666666/servers/detail?limit=100

      Obtenha {endpoint} do Regiões e Endpoints.

      O valor limit pode ser ajustado com base nos dados do ECS.

    • Exemplo de resposta 
      {
    "servers": [
        ......
        {
            "tenant_id": "743b4c0428d945316666666666666666",
            "metadata": {
            },
            "addresses": {
                "140fd038-c4ae-4c32-ac07-34b525eb6b95": [
                    {
                        "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:e9:91:50",
                        "addr": "192.168.0.178",
                        "OS-EXT-IPS:type": "fixed",
                        "version": 4
                    }
                ]
            },
            "OS-EXT-STS:task_state": null,
            "OS-DCF:diskConfig": "MANUAL",
            "OS-EXT-AZ:availability_zone": "xxx",
            "links": [
                {
                    "rel": "self",
                    "href": "https://ecs.xxx/v2.1/743b4c0428d945316666666666666666/servers/f215afe8-b0c2-41cc-9191-585638166812"
                },
                {
                    "rel": "bookmark",
                    "href": "https://ecs.xxx/743b4c0428d945316666666666666666/servers/f215afe8-b0c2-41cc-9191-585638166812"
                }
            ],
            "OS-EXT-STS:power_state": 4,
            "id": "f215afe8-b0c2-41cc-9191-585638166812",
            "os-extended-volumes:volumes_attached": [
                {
                    "id": "546cf622-b9e5-4784-b659-6881e711f283"
                }
            ],
            "OS-EXT-SRV-ATTR:host": "pod01.xxx",
            "accessIPv4": "",
            "image": {
                "links": [
                    {
                        "rel": "bookmark",
                        "href": "https://ecs.xxx/743b4c0428d945316666666666666666/images/5c13381a-4a54-4ea5-a3b5-e7f7069f19a4"
                    }
                ],
                "id": "5c13381a-4a54-4ea5-a3b5-e7f7069f19a4"
            },
            "OS-SRV-USG:terminated_at": null,
            "accessIPv6": "",
            "created": "2019-08-09T02:35:04Z",
            "hostId": "31397656d6b318d01431f60c481d8425dc58eb421d237a385ceb80ee",
            "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova022@36",
            "flavor": {
                "links": [
                    {
                        "rel": "bookmark",
                        "href": "https://ecs.xxx/743b4c0428d945316666666666666666/flavors/s3.large.4"
                    }
                ],
                "id": "s3.large.4"
            },
            "key_name": null,
            "security_groups": [
                {
                    "name": "sg-1e22"
                }
            ],
            "config_drive": "",
            "OS-EXT-STS:vm_state": "stopped",
            "user_id": "a8c20feabb5245e0bae4ef27618f932b",
            "OS-EXT-SRV-ATTR:instance_name": "instance-004bf55f",
            "name": "ecs-f090",
            "OS-SRV-USG:launched_at": "2019-08-09T02:35:23.000000",
            "updated": "2019-08-13T03:12:39Z",
            "status": "SHUTOFF"
        }
     ],
    "servers_links": [
        {
            "rel": "next",
            "href": "https://ecs.xxx/v2.1/743b4c0428d945316666666666666666/servers/detail?limit=100&marker=f215afe8-b0c2-41cc-9191-585638166812"
        }
    ]
}

  2. Consulte detalhes sobre os ECS especificando o número máximo de ECSs exibidos em uma página e o ID do último sabor em uma página.

    • API

      Formato URI: GET /v2.1/{project_id}/servers/detail

      A API utilizada é a mesma que a fornecida em 1.

    • Exemplo de solicitação

      GET: https://{endpoint}/v2.1/743b4c0428d945316666666666666666/servers/detail?limit=100&marker=f215afe8-b0c2-41cc-9191-585638166812

      O URI da próxima página é retornado. Para obter detalhes, consulte o campo href em servers_links do corpo retornado. Se este campo não estiver disponível, não haverá mais páginas.

    • Exemplo de resposta 
      {
    "servers": [
        .....
        {
            "tenant_id": "743b4c0428d945316666666666666666",
            "metadata": {
            },
            "addresses": {
                "140fd038-c4ae-4c32-ac07-34b525eb6b95": [
                    {
                        "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:a5:2b:f8",
                        "addr": "192.168.0.169",
                        "OS-EXT-IPS:type": "fixed",
                        "version": 4
                    }
                ]
            },
            "OS-EXT-STS:task_state": null,
            "OS-DCF:diskConfig": "MANUAL",
            "OS-EXT-AZ:availability_zone": "xxxc",
            "links": [
                {
                    "rel": "self",
                    "href": "https://xxx/v2.1/743b4c0428d945316666666666666666/servers/62348919-0188-43ec-aae6-82c1e96c49eb"
                },
                {
                    "rel": "bookmark",
                    "href": "https://ecs.xxx/743b4c0428d945316666666666666666/servers/62348919-0188-43ec-aae6-82c1e96c49eb"
                }
            ],
            "OS-EXT-STS:power_state": 4,
            "id": "62348919-0188-43ec-aae6-82c1e96c49eb",
            "os-extended-volumes:volumes_attached": [
                {
                    "id": "f0bb068a-61c1-4dc8-8455-09857773c3ff"
                }
            ],
            "OS-EXT-SRV-ATTR:host": "pod01.xxx",
            "accessIPv4": "",
            "image": {
                "links": [
                    {
                        "rel": "bookmark",
                        "href": "https://ecs.xxx/743b4c0428d945316666666666666666/images/3a64bd37-955e-40cd-ab9e-129db56bc05d"
                    }
                ],
                "id": "3a64bd37-955e-40cd-ab9e-129db56bc05d"
            },
            "OS-SRV-USG:terminated_at": null,
            "accessIPv6": "",
            "created": "2019-07-27T03:06:48Z",
            "hostId": "31397656d6b318d01431f60c481d8425dc58eb421d237a385ceb80ee",
            "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova022@36",
            "flavor": {
                "links": [
                    {
                        "rel": "bookmark",
                        "href": "https://ecs.xxx/743b4c0428d945316666666666666666/flavors/s3.medium.4"
                    }
                ],
                "id": "s3.medium.4"
            },
            "key_name": null,
            "security_groups": [
                {
                    "name": "sg-1e22"
                }
            ],
            "config_drive": "",
            "OS-EXT-STS:vm_state": "stopped",
            "user_id": "f7e10ccf7abc4757b483895c3e06964a",
            "OS-EXT-SRV-ATTR:instance_name": "instance-004a0eea",
            "name": "test-dx",
            "OS-SRV-USG:launched_at": "2019-07-27T03:07:05.000000",
            "updated": "2019-08-13T03:12:38Z",
            "status": "SHUTOFF"
        }
    ],
    "servers_links": [
        {
            "rel": "next",
            "href": "https://ecs.xxx/v2.1/743b4c0428d945316666666666666666/servers/detail?limit=100&marker=62348919-0188-43ec-aae6-82c1e96c49eb"
        }
    ]
}

  3. Coletar resultados da consulta.

    Repita a etapa 1 até que o resultado da consulta retornado esteja vazio ou o corpo retornado não contenha o campo servers_links. Isso indica que todos os ECS foram consultados.

    Os ECSs coletados são os resultados de consulta desejados.

Tópico principal: Exemplos de aplicação