Optional. An expression that filters the list of Specs.
A filter expression consists of a field name, a comparison
operator, and a value for filtering. The value must be a string. The
comparison operator must be one of: <, >, : or =. Filters are not
case sensitive.
The following fields in the Spec are eligible for filtering:
display_name - The display name of the Spec. Allowed comparison
operators: =.
create_time - The time at which the Spec was created. The
value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339]
format. Allowed comparison operators: > and <.
spec_type.enum_values.values.id - The allowed value id of the
spec_type attribute associated with the Spec. Allowed comparison
operators: :.
spec_type.enum_values.values.display_name - The allowed value display
name of the spec_type attribute associated with the Spec. Allowed
comparison operators: :.
lint_response.json_values.values - The json value of the
lint_response attribute associated with the Spec. Allowed comparison
operators: :.
mime_type - The MIME type of the Spec. Allowed comparison
operators: =.
Expressions are combined with either AND logic operator or OR logical
operator but not both of them together i.e. only one of the AND or OR
operator can be used throughout the filter string and both the operators
cannot be used together. No other logical operators are
supported. At most three filter fields are allowed in the filter
string and if provided more than that then INVALID_ARGUMENT error is
returned by the API.
Here are a few examples:
spec_type.enum_values.values.id: rest-id - The filter
string specifies that the id of the allowed value associated with the
spec_type attribute is rest-id.
spec_type.enum_values.values.display_name: \"Rest Display Name\" -
The filter string specifies that the display name of the allowed value
associated with the spec_type attribute is Rest Display Name.
spec_type.enum_values.values.id: grpc-id AND create_time <
\"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\" -
The id of the allowed value associated with the spec_type attribute is
grpc-id and the spec was created before 2021-08-15 14:50:00 UTC and
after 2021-08-10 12:00:00 UTC.
spec_type.enum_values.values.id: rest-id OR
spec_type.enum_values.values.id: grpc-id
The id of the allowed value associated with the spec_type attribute is
rest-id or grpc-id.
Optional. The maximum number of specs to return. The service may return
fewer than this value. If unspecified, at most 50 specs will be
returned. The maximum value is 1000; values above 1000 will be coerced to
1000.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003e\u003ccode\u003eListSpecsRequest\u003c/code\u003e is a class used to request a list of specs from the API hub v1 API, and it implements several interfaces for message handling, equality checks, deep cloning, and buffer management.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eFilter\u003c/code\u003e property allows for filtering the list of specs based on criteria such as display name, creation time, and spec type values, using comparison operators and logical operators, but only one type of logical operator between AND or OR can be used throughout.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ePageSize\u003c/code\u003e property controls the maximum number of specs returned in a single response, with a default of 50 and a maximum of 1000.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePageToken\u003c/code\u003e is used for pagination, enabling the retrieval of subsequent pages of specs, requiring that all parameters match the call that generated the token, and \u003ccode\u003eParent\u003c/code\u003e is a required property that defines the resource in which the collection of specs resides.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eParentAsVersionName\u003c/code\u003e provides a version name typed view of the \u003ccode\u003eParent\u003c/code\u003e property, in order to be used as reference when defining the version of the API hub.\u003c/p\u003e\n"]]],[],null,["# API hub v1 API - Class ListSpecsRequest (1.0.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.0.0 (latest)](/dotnet/docs/reference/Google.Cloud.ApiHub.V1/latest/Google.Cloud.ApiHub.V1.ListSpecsRequest)\n- [1.0.0-beta02](/dotnet/docs/reference/Google.Cloud.ApiHub.V1/1.0.0-beta02/Google.Cloud.ApiHub.V1.ListSpecsRequest) \n\n public sealed class ListSpecsRequest : IPageRequest, IMessage\u003cListSpecsRequest\u003e, IEquatable\u003cListSpecsRequest\u003e, IDeepCloneable\u003cListSpecsRequest\u003e, IBufferMessage, IMessage\n\nReference documentation and code samples for the API hub v1 API class ListSpecsRequest.\n\nThe \\[ListSpecs\\]\\[ListSpecs\\] method's request. \n\nInheritance\n-----------\n\n[object](https://learn.microsoft.com/dotnet/api/system.object) \\\u003e ListSpecsRequest \n\nImplements\n----------\n\n[IPageRequest](https://cloud.google.com/dotnet/docs/reference/Google.Api.Gax/latest/Google.Api.Gax.Grpc.IPageRequest.html), [IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage-1.html)[ListSpecsRequest](/dotnet/docs/reference/Google.Cloud.ApiHub.V1/latest/Google.Cloud.ApiHub.V1.ListSpecsRequest), [IEquatable](https://learn.microsoft.com/dotnet/api/system.iequatable-1)[ListSpecsRequest](/dotnet/docs/reference/Google.Cloud.ApiHub.V1/latest/Google.Cloud.ApiHub.V1.ListSpecsRequest), [IDeepCloneable](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IDeepCloneable-1.html)[ListSpecsRequest](/dotnet/docs/reference/Google.Cloud.ApiHub.V1/latest/Google.Cloud.ApiHub.V1.ListSpecsRequest), [IBufferMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IBufferMessage.html), [IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage.html) \n\nInherited Members\n-----------------\n\n[object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode) \n[object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype) \n[object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)\n\nNamespace\n---------\n\n[Google.Cloud.ApiHub.V1](/dotnet/docs/reference/Google.Cloud.ApiHub.V1/latest/Google.Cloud.ApiHub.V1)\n\nAssembly\n--------\n\nGoogle.Cloud.ApiHub.V1.dll\n\nConstructors\n------------\n\n### ListSpecsRequest()\n\n public ListSpecsRequest()\n\n### ListSpecsRequest(ListSpecsRequest)\n\n public ListSpecsRequest(ListSpecsRequest other)\n\nProperties\n----------\n\n### Filter\n\n public string Filter { get; set; }\n\nOptional. An expression that filters the list of Specs.\n\nA filter expression consists of a field name, a comparison\noperator, and a value for filtering. The value must be a string. The\ncomparison operator must be one of: `\u003c`, `\u003e`, `:` or `=`. Filters are not\ncase sensitive.\n\nThe following fields in the `Spec` are eligible for filtering:\n\n- `display_name` - The display name of the Spec. Allowed comparison operators: `=`.\n- `create_time` - The time at which the Spec was created. The value should be in the (RFC3339)\\[\u003chttps://tools.ietf.org/html/rfc3339\u003e\\] format. Allowed comparison operators: `\u003e` and `\u003c`.\n- `spec_type.enum_values.values.id` - The allowed value id of the spec_type attribute associated with the Spec. Allowed comparison operators: `:`.\n- `spec_type.enum_values.values.display_name` - The allowed value display name of the spec_type attribute associated with the Spec. Allowed comparison operators: `:`.\n- `lint_response.json_values.values` - The json value of the lint_response attribute associated with the Spec. Allowed comparison operators: `:`.\n- `mime_type` - The MIME type of the Spec. Allowed comparison operators: `=`.\n\nExpressions are combined with either `AND` logic operator or `OR` logical\noperator but not both of them together i.e. only one of the `AND` or `OR`\noperator can be used throughout the filter string and both the operators\ncannot be used together. No other logical operators are\nsupported. At most three filter fields are allowed in the filter\nstring and if provided more than that then `INVALID_ARGUMENT` error is\nreturned by the API.\n\nHere are a few examples:\n\n- `spec_type.enum_values.values.id: rest-id` - The filter string specifies that the id of the allowed value associated with the spec_type attribute is *rest-id*.\n- `spec_type.enum_values.values.display_name: \\\"Rest Display Name\\\"` - The filter string specifies that the display name of the allowed value associated with the spec_type attribute is `Rest Display Name`.\n- `spec_type.enum_values.values.id: grpc-id AND create_time \u003c\n \\\"2021-08-15T14:50:00Z\\\" AND create_time \u003e \\\"2021-08-10T12:00:00Z\\\"` - The id of the allowed value associated with the spec_type attribute is *grpc-id* and the spec was created before *2021-08-15 14:50:00 UTC* and after *2021-08-10 12:00:00 UTC*.\n- `spec_type.enum_values.values.id: rest-id OR\n spec_type.enum_values.values.id: grpc-id`\n- The id of the allowed value associated with the spec_type attribute is *rest-id* or *grpc-id*.\n\n### PageSize\n\n public int PageSize { get; set; }\n\nOptional. The maximum number of specs to return. The service may return\nfewer than this value. If unspecified, at most 50 specs will be\nreturned. The maximum value is 1000; values above 1000 will be coerced to\n1000.\n\n### PageToken\n\n public string PageToken { get; set; }\n\nOptional. A page token, received from a previous `ListSpecs` call.\nProvide this to retrieve the subsequent page.\n\nWhen paginating, all other parameters provided to `ListSpecs` must\nmatch the call that provided the page token.\n\n### Parent\n\n public string Parent { get; set; }\n\nRequired. The parent, which owns this collection of specs.\nFormat:\n`projects/{project}/locations/{location}/apis/{api}/versions/{version}`\n\n### ParentAsVersionName\n\n public VersionName ParentAsVersionName { get; set; }\n\n[VersionName](/dotnet/docs/reference/Google.Cloud.ApiHub.V1/latest/Google.Cloud.ApiHub.V1.VersionName)-typed view over the [Parent](/dotnet/docs/reference/Google.Cloud.ApiHub.V1/latest/Google.Cloud.ApiHub.V1.ListSpecsRequest#Google_Cloud_ApiHub_V1_ListSpecsRequest_Parent) resource name property."]]
