From 8b62bf6479e411de6d13e49656acf908b9a3e220 Mon Sep 17 00:00:00 2001
From: Matt Riedemann <mriedem.os@gmail.com>
Date: Wed, 4 Oct 2017 17:34:21 -0400
Subject: [PATCH] api-ref: note that project_id filter only works with
 all_tenants

The project_id / tenant_id filter parameters when
listing servers is only applied when the all_tenants
filter is used.

Otherwise if an admin is listing servers and specifies
project_id but not all_tenants, they only get back
instances for the admin's project (in the request context).

Change-Id: I9e8fae8fb86604d7394d0dba4d7c75c3fc93033e
Related-Bug: #1185290
---
 api-ref/source/parameters.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index cc97ca96cb..9eadf94192 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -4623,6 +4623,8 @@ project_id_query_server:
   description: |
     Filter the list of servers by the given project ID.
 
+    This filter only works when the ``all_tenants=1`` filter is also specified.
+
     .. note::
 
        'tenant_id' can also be requested which is alias of 'project_id'