From c07746af90fed05e7422141061ee65c13f79fce1 Mon Sep 17 00:00:00 2001 From: Matt Riedemann Date: Fri, 17 May 2019 15:30:13 -0400 Subject: [PATCH] api-ref: mention default project filtering when listing servers This removes the "all" wording from the List Servers API reference docs since it could be confused with actually returning all servers across all tenants (the all_tenants filters). It also mentions that by default only servers associated with the project making the request are returned, i.e. the project associated with the auth token on the request. This is probably fairly obvious and automatic to anyone that's worked with openstack for a long time but might not be for a new user and is not really documented anywhere in the API reference or API guide that I could find. Change-Id: Ie28164e4813a7a48addcd80d81c72c978ac9f395 --- api-ref/source/servers.inc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-ref/source/servers.inc b/api-ref/source/servers.inc index c31fbab6e87d..8fc3ce48ce13 100644 --- a/api-ref/source/servers.inc +++ b/api-ref/source/servers.inc @@ -99,8 +99,10 @@ List Servers .. rest_method:: GET /servers -Lists IDs, names, and links for all servers. +Lists IDs, names, and links for servers. +By default the servers are filtered using the project ID associated +with the authenticated request. Servers contain a status attribute that indicates the current server state. You can filter on the server status when you complete a list