Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Dedicated Host/ Referencia de la API/ API/ Consulta de ECS en un DeH

Actualización más reciente 2023-03-02 GMT+08:00

Ver PDF

Consulta de ECS en un DeH

Función

Esta API se utiliza para consultar información sobre los ECS desplegados en un DeH.

URI

GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}/servers

Tabla 1 describe los parámetros.

**Tabla 1** Descripción de parámetros
Parámetro	Tipo	Obligatorio	Descripción
project_id	String	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
dedicated_host_id	String	Sí	Especifica el ID de DeH. Puede obtener el ID de DeH desde la consola de DeH o usando la API de Consulta de DeHs.

Solicitud

Parámetros de solicitud

**Tabla 2** Parámetros de solicitud
Parámetro	In	Tipo	Obligatorio	Descripción
limit	query	String	No	Especifica el número de registros mostrados por página.
marker	query	String	No	Especifica el identificador del último registro de la página anterior. Si el valor marker no es válido, se devuelve el código de estado 400.

Solicitud de ejemplo

GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts/ab910cf0daebca90c4001/servers

Respuesta

Parámetros de respuesta

**Tabla 3** Parámetros de respuesta
Parámetro	In	Tipo	Descripción
servers	body	Array of objects	Especifica el objeto de servidor. Para obtener más información, véase Tabla 4.

**Tabla 4** Descripción del campo **servers**
Parámetro	Tipo	Descripción
addresses	Object	Especifica el atributo de red del ECS. Para obtener más información, véase Tabla 5.
created	String	Especifica la hora a la que se creó el ECS.
flavor	Object	Especifica la variante de ECS. Para obtener más información, véase Tabla 7.
id	String	Especifica el ID de ECS en formato UUID.
name	String	Especifica el nombre de ECS.
status	String	Especifica el estado de ECS. Opciones: ACTIVE, BUILD, DELETED, ERROR, HARD_REBOOT, MIGRATING, PASSWORD, PAUSED, REBOOT, REBUILD, RESIZE, REVERT_RESIZE, SHUTOFF, SHELVED, SHELVED_OFFLOADED, SOFT_DELETED, SUSPENDED, and VERIFY_RESIZE
tenant_id	String	Especifica el ID de inquilino de ECS en formato UUID.
updated	String	Especifica la hora a la que se actualizó el ECS la última vez.
user_id	String	Especifica el ID del usuario que ha creado el ECS. El valor está en formato UUID.
task_state	String	Especifica el estado de la tarea ECS.
image	Object	Especifica la imagen de ECS. Para obtener más información, véase Tabla 8.
metadata	Object	Especifica los metadatos de ECS. Para obtener más información, véase Tabla 9.

**Tabla 5** Descripción del campo **addresses**
Parámetro	Tipo	Descripción
vpc_id	Array of objects	Especifica el UUID de VPC. Para obtener más información, véase Tabla 6.

**Tabla 6** Descripción del campo **vpc_id**
Parámetro	Tipo	Descripción
addr	String	Dirección de IP específica.
version	String	Especifica el tipo de dirección IP.

**Tabla 7** Descripción del campo **flavor**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de variante.

**Tabla 8** Descripción del campo **image**
Parámetro	Tipo	Descripción
id	String	Especifica el UUID de la imagen.

**Tabla 9** Descripción del campo **metadata**
Parámetro	Tipo	Descripción
os_type	String	Especifica el tipo de sistema operativo.

Ejemplo de respuesta

{
    "servers": [
        {
            "addresses": {
                "68269e6e-4a27-441b-8029-35373ad50bd9": [
                    {
                        "addr": "192.168.0.3", 
                        "version": 4
                    }
                ]
            }, 
            "created": "2012-09-07T16:56:37Z", 
            "flavor": {
                "id": "1"
            },
            "id": "05184ba3-00ba-4fbc-b7a2-03b62b884931",
            "metadata": {
                "os_type": "Linux"
            }, 
            "name": "new-server-test", 
            "status": "ACTIVE", 
            "tenant_id": "openstack", 
            "updated": "2012-09-07T16:56:37Z", 
            "user_id": "fake",
            "task_state": "",
            "image": {
                "id": "1ce5800a-e487-4c1b-b264-3353a39e2b4b"
            }
        }
    ]
}