osc network port list

Lists ports to which the user has access.

Default policy settings return only those ports that are owned by the project of the user who submits the request, unless the request is submitted by a user with administrative rights.

Standard query parameters are supported on the URI. For more information, see Filtering and Column Selection.

Use the fields query parameter to control which fields are returned in the response body. For more information, see Fields.

Pagination query parameters are supported if Neutron configuration supports it by overriding allow_pagination=false. For more information, see Pagination.

Sorting query parameters are supported if Neutron configuration supports it with allow_sorting=true. For more information, see Sorting.

If the ip-substring-filtering extension is enabled, the Neutron API supports IP address substring filtering on the fixed_ips attribute. If you specify an IP address substring (ip_address_substr) in an entry of the fixed_ips attribute, the Neutron API will list all ports that have an IP address matching the substring.

Normal response codes: 200

Error response codes: 401

Usage: osc network port list [OPTIONS]

Options:

  • --admin-state-up <ADMIN_STATE_UP> — admin_state_up query parameter for /v2.0/ports API

    Possible values: true, false

  • --binding-host-id <BINDING_HOST_ID> — binding:host_id query parameter for /v2.0/ports API

  • --description <DESCRIPTION> — description query parameter for /v2.0/ports API

  • --device-id <DEVICE_ID> — device_id query parameter for /v2.0/ports API

  • --device-owner <DEVICE_OWNER> — device_owner query parameter for /v2.0/ports API

  • --fixed-ips <FIXED_IPS> — fixed_ips query parameter for /v2.0/ports API

  • --id <ID> — id query parameter for /v2.0/ports API

  • --ip-allocation <IP_ALLOCATION> — ip_allocation query parameter for /v2.0/ports API

  • --limit <LIMIT> — Requests a page size of items. Returns a number of items up to a limit value. Use the limit parameter to make an initial limited request and use the ID of the last-seen item from the response as the marker parameter value in a subsequent limited request

  • --mac-address <MAC_ADDRESS> — mac_address query parameter for /v2.0/ports API

  • --marker <MARKER> — The ID of the last-seen item. Use the limit parameter to make an initial limited request and use the ID of the last-seen item from the response as the marker parameter value in a subsequent limited request

  • --name <NAME> — name query parameter for /v2.0/ports API

  • --network-id <NETWORK_ID> — network_id query parameter for /v2.0/ports API

  • --not-tags <NOT_TAGS> — not-tags query parameter for /v2.0/ports API

  • --not-tags-any <NOT_TAGS_ANY> — not-tags-any query parameter for /v2.0/ports API

  • --page-reverse <PAGE_REVERSE> — Reverse the page direction

    Possible values: true, false

  • --revision-number <REVISION_NUMBER> — revision_number query parameter for /v2.0/ports API

  • --security-groups <SECURITY_GROUPS> — security_groups query parameter for /v2.0/ports API

  • --sort-dir <SORT_DIR> — Sort direction. This is an optional feature and may be silently ignored by the server

  • --sort-key <SORT_KEY> — Sort results by the attribute. This is an optional feature and may be silently ignored by the server

  • --status <STATUS> — status query parameter for /v2.0/ports API

  • --tags <TAGS> — tags query parameter for /v2.0/ports API

  • --tags-any <TAGS_ANY> — tags-any query parameter for /v2.0/ports API

  • --tenant-id <TENANT_ID> — tenant_id query parameter for /v2.0/ports API

  • --max-items <MAX_ITEMS> — Total limit of entities count to return. Use this when there are too many entries

    Default value: 10000