yahoo-eng-team team mailing list archive

[Brandon Logan <brandon.logan@xxxxxxxxxxxxx>]

I'm not sure this should be in the help message as other filters are not
in the help message either.  However, I do recognize that it's a bit
different than regular filters as it's not an actual field, but
calculated based on other fields.  Since it's calculated server side,
and the API accepts it as a query parameter like a regular filter, I
don't think it should be in the help message and treated like a regular
filter.

** Changed in: neutron
       Status: New => Opinion

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to neutron.
https://bugs.launchpad.net/bugs/1603020

Title:
  There is no help info of the new filter "changed-since" added to
  Neutron resources list API

Status in neutron:
  Opinion

Bug description:
  In Mitaka,
  The spec of add-port-timestamp.rst introduces a new filter "changed-since",but in the help message of neutron resources list command.
  However,this filter can actually work.
  I think we should add the new filter "changed-since" to the help message of Neutron resources list API,
  so can guide users to use correctly

  
  The url add-port-timestamp.rst spec is as follows: 
  https://github.com/openstack/neutron-specs/blob/master/specs/mitaka/add-port-timestamp.rst

  
  [root@devstack218 devstack]# neutron port-list --changed-since 2016-07-14T03:46:37
  +--------------------------------------+------------+-------------------+--------------------------------------------------------+
  | id                                   | name       | mac_address       | fixed_ips                                              |
  +--------------------------------------+------------+-------------------+--------------------------------------------------------+
  | ea79eaef-d294-4527-b24c-5b9fe16a1f6c | port2_net1 | fa:16:3e:e7:38:a6 | {"subnet_id": "481cadf6-fa52-4739-80b2-331a3b90d7b6",  |
  |                                      |            |                   | "ip_address": "198.51.100.7"}                          |
  |                                      |            |                   | {"subnet_id": "60f56f75-ce94-498f-b4ad-0383db2796a8",  |
  |                                      |            |                   | "ip_address":                                          |
  |                                      |            |                   | "2001:db8:80d2:c4d3:f816:3eff:fee7:38a6"}              |
  +--------------------------------------+------------+-------------------+--------------------------------------------------------+
  [root@devstack218 devstack]# 

  [root@devstack218 devstack]# neutron help port-list  
  usage: neutron port-list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
                           [--max-width <integer>] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--request-format {json}] [-D] [-F FIELD] [-P SIZE]
                           [--sort-key FIELD] [--sort-dir {asc,desc}]

  List ports that belong to a given tenant.

  optional arguments:
    -h, --help            show this help message and exit
    --request-format {json}
                          DEPRECATED! Only JSON request format is supported.
    -D, --show-details    Show detailed information.
    -F FIELD, --field FIELD
                          Specify the field(s) to be returned by server. You can
                          repeat this option.
    -P SIZE, --page-size SIZE
                          Specify retrieve unit of each request, then split one
                          request to several requests.
    --sort-key FIELD      Sorts the list by the specified fields in the
                          specified directions. You can repeat this option, but
                          you must specify an equal number of sort_dir and
                          sort_key values. Extra sort_dir options are ignored.
                          Missing sort_dir options use the default asc value.
    --sort-dir {asc,desc}
                          Sorts the list in the specified direction. You can
                          repeat this option.

  output formatters:
    output formatter options

    -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}
                          the output format, defaults to table
    -c COLUMN, --column COLUMN
                          specify the column(s) to include, can be repeated

  table formatter:
    --max-width <integer>
                          Maximum display width, <1 to disable. You can also use
                          the CLIFF_MAX_TERM_WIDTH environment variable, but the
                          parameter takes precedence.

  json formatter:
    --noindent            whether to disable indenting the JSON

  CSV Formatter:
    --quote {all,minimal,none,nonnumeric}
                          when to include quotes, defaults to nonnumeric
  [root@devstack218 devstack]#

To manage notifications about this bug go to:
https://bugs.launchpad.net/neutron/+bug/1603020/+subscriptions