Class ProjectsResource.ListRequest
Lists Projects that the caller has the resourcemanager.projects.get
permission on and satisfy the
specified filter. This method returns Projects in an unspecified order. This method is eventually consistent
with project mutations; this means that a newly created project may not appear in the results or recent
updates to an existing project may not be reflected in the results. To retrieve the latest state of a
project, use the GetProject method. NOTE: If the request filter contains a parent.type
and parent.id
and
the caller has the resourcemanager.projects.list
permission on the parent, the results will be drawn from
an alternate index which provides more consistent results. In future versions of this API, this List method
will be split into List and Search to properly capture the behavioral difference.
Inheritance
Inherited Members
Namespace: Google.Apis.CloudResourceManager.v1
Assembly: Google.Apis.CloudResourceManager.v1.dll
Syntax
public class ProjectsResource.ListRequest : CloudResourceManagerBaseServiceRequest<ListProjectsResponse>, IClientServiceRequest<ListProjectsResponse>, IClientServiceRequest
Constructors
ListRequest(IClientService)
Constructs a new List request.
Declaration
public ListRequest(IClientService service)
Parameters
Type | Name | Description |
---|---|---|
IClientService | service |
Properties
Filter
Optional. An expression for filtering the results of the request. Filter rules are case insensitive. If
multiple fields are included in a filter query, the query will return results that match any of the
fields. Some eligible fields for filtering are: + name
+ id
+ labels.
(where key is the name of
a label) + parent.type
+ parent.id
+ lifecycleState
Some examples of filter queries: | Query |
Description | |------------------|-----------------------------------------------------| | name:how* |
The project's name starts with "how". | | name:Howl | The project's name is Howl
or howl
. | |
name:HOWL | Equivalent to above. | | NAME:howl | Equivalent to above. | | labels.color:* | The project
has the label color
. | | labels.color:red | The project's label color
has the value red
. | |
labels.color:red labels.size:big | The project's label color
has the value red
or its label size
has the value big
. | | lifecycleState:DELETE_REQUESTED | Only show projects that are pending
deletion.| If no filter is specified, the call will return projects for which the user has the
resourcemanager.projects.get
permission. NOTE: To perform a by-parent query (eg., what projects are
directly in a Folder), the caller must have the resourcemanager.projects.list
permission on the parent
and the filter must contain both a parent.type
and a parent.id
restriction (example:
"parent.type:folder parent.id:123"). In this case an alternate search index is used which provides more
consistent results.
Declaration
[RequestParameter("filter", RequestParameterType.Query)]
public virtual string Filter { get; set; }
Property Value
Type | Description |
---|---|
string |
HttpMethod
Gets the HTTP method.
Declaration
public override string HttpMethod { get; }
Property Value
Type | Description |
---|---|
string |
Overrides
MethodName
Gets the method name.
Declaration
public override string MethodName { get; }
Property Value
Type | Description |
---|---|
string |
Overrides
PageSize
Optional. The maximum number of Projects to return in the response. The server can return fewer Projects than requested. If unspecified, server picks an appropriate default.
Declaration
[RequestParameter("pageSize", RequestParameterType.Query)]
public virtual int? PageSize { get; set; }
Property Value
Type | Description |
---|---|
int? |
PageToken
Optional. A pagination token returned from a previous call to ListProjects that indicates from where listing should continue.
Declaration
[RequestParameter("pageToken", RequestParameterType.Query)]
public virtual string PageToken { get; set; }
Property Value
Type | Description |
---|---|
string |
RestPath
Gets the REST path.
Declaration
public override string RestPath { get; }
Property Value
Type | Description |
---|---|
string |
Overrides
Methods
InitParameters()
Initializes List parameter list.
Declaration
protected override void InitParameters()