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> Virtual Private Cloud> Referencia de la API> API> Dirección IP privada> Consulta de detalles de direcciones IP privadas
Actualización más reciente 2023-02-03 GMT+08:00

Consulta de detalles de direcciones IP privadas

Función

Esta API se utiliza para consultar detalles sobre una dirección IP privada utilizando el ID especificado.

URI

GET /v1/{project_id}/privateips/{privateip_id}

Tabla 1 describe los parámetros.
Tabla 1 Descripción del parámetro

Nombre

Obligatorio

Descripción

project_id

Especifica el ID del proyecto. Para obtener más información sobre cómo obtener un ID de proyecto, consulte Obtención de un ID de proyecto.

privateip_id

Especifica el ID de la dirección IP privada, que identifica de forma exclusiva la dirección IP privada.

Mensaje de solicitud

  • Parámetro de solicitud

    No hay

  • Ejemplo de la solicitud
    GET https://{Endpoint}/v1/{project_id}/privateips/d600542a-b231-45ed-af05-e9930cb14f78

Respuesta

  • Parámetro de respuesta
    Tabla 2 Parámetro de respuesta

    Nombre

    Tipo

    Descripción

    privateip

    privateip object

    Especifica los objetos de dirección IP privada. Para obtener más información, véase Tabla 3.

    Tabla 3 Descripción del campo privateip

    Nombre

    Tipo

    Descripción

    status

    String

    • Especifica el estado de la dirección IP privada.
    • Los valores posibles son los siguientes:
      • ACTIVE
      • DOWN

    id

    String

    Especifica el ID de la dirección IP privada, que identifica de forma exclusiva la dirección IP privada.

    subnet_id

    String

    Especifica el ID de la subred desde la que se asignan las direcciones IP.

    Si utiliza la consola de gestión, el valor de este parámetro es el valor Network ID.

    tenant_id

    String

    Especifica el ID del proyecto.

    device_owner

    String

    • Especifica el recurso que utiliza la dirección IP privada. El parámetro se deja en blanco si no se utiliza.
    • El valor puede ser network:dhcp, network:router_interface_distributed, compute:xxx o neutron:VIP_PORT. (En el valor compute:xxx, xxx especifica el nombre de la AZ, por ejemplo, compute:aa-bb-cc indica que la dirección IP privada es utilizada por un ECS en la AZ aa-bb-cc).
    • El intervalo de valores especifica solo el tipo de direcciones IP privadas admitidas por el servicio actual.

    ip_address

    String

    Especifica la dirección IP privada asignada.

  • Ejemplo de la respuesta
    {
        "privateip": 
            {
                "status": "DOWN",
                "id": "d600542a-b231-45ed-af05-e9930cb14f78",
                "subnet_id": "531dec0f-3116-411b-a21b-e612e42349fd",
                "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
                "device_owner": "",
                "ip_address": "192.168.1.11"
            }
    }

Código de estado

Véase Códigos de estado.

Código de error

Véase Códigos de error.