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.
Actualización más reciente 2023-02-03 GMT+08:00

Consulta de logs de flujo de VPC

Función

Esta API se utiliza para consultar todos los log de flujo de VPC del tenant que envía la solicitud. Los log de flujo de VPC se filtran basándose en la condición de filtrado.

URI

GET /v1/{project_id}/fl/flow_logs

Por ejemplo:

GET https://{Endpoint}/v1/b2782e6708b8475c993e6064bc456bf8/fl/flow_logs?name=flowlog

Tabla 1 describe los parámetros.

Tabla 1 Descripción del parámetro

Nombre

Obligatorio

Tipo

Descripción

project_id

String

id

No

String

  • ID de log de flujo

name

No

String

  • Nombre del log de flujo
  • El valor no puede contener más de 64 caracteres, incluidos letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).

resource_type

No

String

  • Tipo del recurso para el que se van a recopilar los logs.
  • El valor puede ser:
    • port: NIC
    • vpc: Todas las NIC en una VPC
    • network: Todas las NIC de una subred

resource_id

No

String

  • ID del recurso para el que se van a recopilar los logs.

traffic_type

No

String

  • Tipo del tráfico para el que se van a recopilar los logs.
  • El valor puede ser:
    • all: especifica que se registrará el tráfico aceptado y rechazado del recurso especificado.
    • accept: especifica que solo se registrará el tráfico entrante y saliente aceptado del recurso especificado.
    • reject: especifica que sólo se registrará el tráfico entrante y saliente rechazado del recurso especificado.

log_group_id

No

String

  • ID del grupo de log

log_topic_id

No

String

  • ID de tema de log

log_store_type

No

String

  • Servicio que se utiliza para almacenar logs de flujo
  • El valor puede ser:
    • lts: Log Tank Service (LTS)

status

No

String

Estado del log de flujo

  • ACTIVE: Habilitado
  • DOWN: Desactivado
  • ERROR: Anormal

limit

No

Integer

Especifica el número de registros que se devolverán en cada página. El valor es de 0 a intmax (2^31-1).

limit se puede utilizar junto con marker. Para obtener más información, consulte la descripción de parámetros de marker.

marker

No

String

Especifica un ID de recurso para la consulta de paginación, que indica que la consulta comienza en el siguiente registro del ID de recurso especificado.

Este parámetro puede funcionar junto con el parámetro limit.

  • Si no se pasan los parámetros marker y limit, se devolverán los registros de recursos de la primera página.
  • Si no se pasa el parámetro marker y el valor del parámetro limit se establece en 10 se devolverán los 10 primeros registros de recursos.
  • Si el valor del parámetro marker se establece en el ID de recurso del 10º registro y el valor del parámetro limit se establece en 10, se devolverán los registros de recursos del 11º al 20º.
  • Si el valor del parámetro marker se establece en el ID de recurso del 10º registro y no se pasa el parámetro limit, se devolverán los registros de recursos que comienzan desde el 11º registro (incluido el 11º).

Mensaje de solicitud

  • Parámetro de solicitud

    No hay

  • Ejemplo de la solicitud
    GET https://{Endpoint}/v1/b2782e6708b8475c993e6064bc456bf8/fl/flow_logs?name=flowlog

Mensaje de la respuesta

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

    Nombre

    Tipo

    Descripción

    flow_logs

    Array of FlowLog objects

    Lista de objetos FlowLog. Para obtener más información, véase Tabla 3.

    Tabla 3 Descripción del campo FlowLog

    Nombre

    Tipo

    Descripción

    id

    String

    • ID de log de flujo

    name

    String

    • Nombre del log de flujo
    • El valor no puede contener más de 64 caracteres, incluidos letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).

    tenant_id

    String

    • ID del proyecto

    description

    String

    • Descripción del log de flujo
    • El valor no puede contener más de 255 caracteres y no puede contener los corchetes angulares (< o >).

    resource_type

    String

    • Tipo del recurso para el que se van a recopilar los logs.
    • El valor puede ser:
      • port: NIC
      • vpc: Todas las NIC en una VPC
      • network: Todas las NIC de una subred

    resource_id

    String

    • ID del recurso para el que se van a recopilar los logs.

    traffic_type

    String

    • Tipo del tráfico para el que se van a recopilar los logs.
    • El valor puede ser:
      • all: especifica que se registrará el tráfico aceptado y rechazado del recurso especificado.
      • accept: especifica que solo se registrará el tráfico entrante y saliente aceptado del recurso especificado.
      • reject: especifica que sólo se registrará el tráfico entrante y saliente rechazado del recurso especificado.

    log_group_id

    String

    • ID del grupo de log

    log_topic_id

    String

    • ID de tema de log

    log_store_type

    String

    • Servicio que se utiliza para almacenar logs de flujo
    • El valor puede ser:
      • lts: Log Tank Service (LTS)

    admin_state

    Boolean

    • Si se debe habilitar la función de log de flujo

    status

    String

    • Estado del log de flujo
    • El valor puede ser:
      • ACTIVE: Habilitado
      • DOWN: Desactivado
      • ERROR: Anormal

    created_at

    String

    • Hora en la que se crea el log de flujo
    • Tiempo de UTC en el formato de aaaa-MM-ddTHH:mmss

    updated_at

    String

    • Hora en la que se actualiza el log de flujo
    • Tiempo de UTC en el formato de aaaa-MM-ddTHH:mmss
  • Ejemplo de la respuesta
    {
        "flow_logs": [
            {
                "id": "35868d55-443e-4d5c-90a4-ac618dc45c1a",
                "name": "flowlog",
                "description": "just a test",
                "tenant_id": "b2782e6708b8475c993e6064bc456bf8",
                "resource_type": "port",
                "resource_id": "05c4052d-8d14-488f-aa00-19fea5a25fde",
                "traffic_type": "reject",
                "log_group_id": "05c4052d-8d14-488f-aa00-19fea5a25fff",
                "log_topic_id": "a9d7dee7-37d2-4cba-a208-a016252aaa63",
                "log_store_type": "lts",
                "created_at": "2019-01-14T11:03:02",
                "updated_at": "2019-01-14T11:03:02",
                "status": "ACTIVE",
                "admin_state": true
            }
        ]
    }

Código de estado

Véase Códigos de estado.

Código de error

Véase Códigos de error.