doc-exports/docs/vpc/api-ref/vpc_flow_0003.html
gtema 4cfecba474 VPC api from PR#278
Reviewed-by: Kucerak, Kristian <kristian.kucerak@t-systems.com>
Co-authored-by: gtema <artem.goncharov@gmail.com>
Co-committed-by: gtema <artem.goncharov@gmail.com>
2022-10-17 12:39:05 +00:00

16 KiB

Querying a VPC Flow Log

Function

This API is used to query a VPC flow log.

URI

GET /v1/{project_id}/fl/flow_logs/{flowlog_id}

Table 1 describes the parameters.

Table 1 Parameter description

Name

Mandatory

Type

Description

project_id

Yes

String

Specifies the project ID.

flowlog_id

Yes

String

Specifies the VPC flow log ID, which uniquely identifies the VPC flow log.

Request Message

  • Request parameter

    None

  • Example request
    GET https://{Endpoint}/v1/b2782e6708b8475c993e6064bc456bf8/fl/flow_logs/1e10cd9d-742a-4d36-a9fd-aee9784336ff

Response Message

  • Response parameter
    Table 2 Response parameter

    Name

    Type

    Description

    flow_log

    flow_log object

    Specifies the FlowLog objects. For details, see Table 3.

    Table 3 Description of the FlowLog field

    Name

    Type

    Description

    id

    String

    Specifies the VPC flow log UUID.

    name

    String

    Specifies the VPC flow log name.

    tenant_id

    String

    Specifies the project ID.

    description

    String

    Provides supplementary information about the VPC flow log.

    resource_type

    String

    Specifies the type of resource on which to create the VPC flow log.

    resource_id

    String

    Specifies the unique resource ID.

    traffic_type

    String

    Specifies the type of traffic to log.

    log_group_id

    String

    Specifies the log group ID.

    log_topic_id

    String

    Specifies the log topic ID.

    admin_state

    Boolean

    Specifies whether to enable the VPC flow log function.

    status

    String

    Specifies the VPC flow log status.

    • ACTIVE: Enabled
    • DOWN: Disabled
    • ERROR: Abnormal fault

    created_at

    String

    Specifies the time when the VPC flow log was created.

    updated_at

    String

    Specifies the time when the VPC flow log was updated.

  • Example response
    {
        "flow_log": {
            "id": "35868d55-443e-4d5c-90a4-ac618dc45c1a",
            "name": "flow",
            "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",
            "created_at": "2019-01-14T11:03:02",
            "updated_at": "2019-01-14T11:03:02"
            "status": "ACTIVE",
            "admin_state": true
        }
    }

Status Code

See Status Codes.

Error Code

See Error Codes.