v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1312112148.4 KB
services

Search tenancy units for a managed service.

get/v1/{+parent}:search

Path parameters

parentstring required

Required. Service for which search is performed. services/{service} {service} the name of a service, for example 'service.googleapis.com'.

Query parameters

pageSizeinteger

Optional. The maximum number of results returned by this request. Currently, the default maximum is set to 256. If page_size <= 256, the request proceeds. Else, the request fails with an TU_INVALID_PAGE_SIZE error.

pageTokenstring

Optional. The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of nextPageToken from the previous response.

querystring

Optional. Set a query {expression} for querying tenancy units. Your {expression} must be in the format: field_name=literal_string. The field_name is the name of the field you want to compare. Supported fields are tenant_resources.tag and tenant_resources.resource. For example, to search tenancy units that contain at least one tenant resource with a given tag 'xyz', use the query tenant_resources.tag=xyz. To search tenancy units that contain at least one tenant resource with a given resource name 'projects/123456', use the query tenant_resources.resource=projects/123456. Multiple expressions can be joined with ANDs. Tenancy units must match all expressions to be included in the result set. For example, tenant_resources.tag=xyz AND tenant_resources.resource=projects/123456

Response

Successful response