Google Cloud Service Directory V1 Client - Class ListServicesRequest (2.0.1)

Reference documentation and code samples for the Google Cloud Service Directory V1 Client class ListServicesRequest.

The request message for RegistrationService.ListServices.

Generated from protobuf message google.cloud.servicedirectory.v1.ListServicesRequest

Namespace

Google \ Cloud \ ServiceDirectory \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
`data`	`array` Optional. Data for populating the Message object.
`↳ parent`	`string` Required. The resource name of the namespace whose services you'd like to list.
`↳ page_size`	`int` Optional. The maximum number of items to return.
`↳ page_token`	`string` Optional. The next_page_token value returned from a previous List request, if any.
`↳ filter`	`string` Optional. The filter to list results by. General `filter` string syntax: `<field> <operator> <value> (<logical connector>)` * * `<field>` can be `name` or `annotations.<key>` for map field * * `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:` means `HAS`, and is roughly the same as `=` * * `<value>` must be the same data type as field * * `<logical connector>` can be `AND`, `OR`, `NOT` Examples of valid filters: * * `annotations.owner` returns services that have a annotation with the key `owner`, this is the same as `annotations:owner` * * `annotations.protocol=gRPC` returns services that have key/value `protocol=gRPC` * `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/service-c` returns services that have name that is alphabetically later than the string, so "service-e" is returned but "service-a" is not * * `annotations.owner!=sd AND annotations.foo=bar` returns services that have `owner` in annotation key but value is not `sd` AND have key/value `foo=bar` * * `doesnotexist.foo=bar` returns an empty list. Note that service doesn't have a field called "doesnotexist". Since the filter does not match any services, it returns no results For more information about filtering, see API Filtering.
`↳ order_by`	`string` Optional. The order to list results by. General `order_by` string syntax: `<field> (<asc\|desc>) (,)` * * `<field>` allows value: `name` * * `<asc\|desc>` ascending or descending order by `<field>`. If this is left blank, `asc` is used Note that an empty `order_by` string results in default order, which is order by `name` in ascending order.

getParent

Required. The resource name of the namespace whose services you'd like to list.

Returns
Type	Description
`string`

setParent

Required. The resource name of the namespace whose services you'd like to list.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getPageSize

Optional. The maximum number of items to return.

Returns
Type	Description
`int`

setPageSize

Optional. The maximum number of items to return.

Parameter
Name	Description
`var`	`int`

Returns
Type	Description
`$this`

getPageToken

Optional. The next_page_token value returned from a previous List request, if any.

Returns
Type	Description
`string`

setPageToken

Optional. The next_page_token value returned from a previous List request, if any.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getFilter

Optional. The filter to list results by.

General filter string syntax: <field> <operator> <value> (<logical connector>)

<field> can be name or annotations.<key> for map field
<operator> can be <, >, <=, >=, !=, =, :. Of which : means HAS, and is roughly the same as =
<value> must be the same data type as field
<logical connector> can be AND, OR, NOT Examples of valid filters:
annotations.owner returns services that have a annotation with the key owner, this is the same as annotations:owner
annotations.protocol=gRPC returns services that have key/value protocol=gRPC * name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/service-c returns services that have name that is alphabetically later than the string, so "service-e" is returned but "service-a" is not
annotations.owner!=sd AND annotations.foo=bar returns services that have owner in annotation key but value is not sd AND have key/value foo=bar
doesnotexist.foo=bar returns an empty list. Note that service doesn't have a field called "doesnotexist". Since the filter does not match any services, it returns no results For more information about filtering, see API Filtering.

Returns
Type	Description
`string`

setFilter

Optional. The filter to list results by.

General filter string syntax: <field> <operator> <value> (<logical connector>)

<field> can be name or annotations.<key> for map field
<operator> can be <, >, <=, >=, !=, =, :. Of which : means HAS, and is roughly the same as =
<value> must be the same data type as field
<logical connector> can be AND, OR, NOT Examples of valid filters:
annotations.owner returns services that have a annotation with the key owner, this is the same as annotations:owner
annotations.protocol=gRPC returns services that have key/value protocol=gRPC * name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/service-c returns services that have name that is alphabetically later than the string, so "service-e" is returned but "service-a" is not
annotations.owner!=sd AND annotations.foo=bar returns services that have owner in annotation key but value is not sd AND have key/value foo=bar
doesnotexist.foo=bar returns an empty list. Note that service doesn't have a field called "doesnotexist". Since the filter does not match any services, it returns no results For more information about filtering, see API Filtering.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getOrderBy

Optional. The order to list results by.

General order_by string syntax: <field> (<asc|desc>) (,)

<field> allows value: name
<asc|desc> ascending or descending order by <field>. If this is left blank, asc is used Note that an empty order_by string results in default order, which is order by name in ascending order.

Returns
Type	Description
`string`

setOrderBy

Optional. The order to list results by.

General order_by string syntax: <field> (<asc|desc>) (,)

<field> allows value: name
<asc|desc> ascending or descending order by <field>. If this is left blank, asc is used Note that an empty order_by string results in default order, which is order by name in ascending order.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

static::build

Parameter
Name	Description
`parent`	`string` Required. The resource name of the namespace whose services you'd like to list. Please see RegistrationServiceClient::namespaceName() for help formatting this field.

Returns
Type	Description
`ListServicesRequest`