Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

Quota Manager API, gRPC: QuotaRequestService.List

Written by
Updated at July 9, 2025

Retrieves the list of quota requests in the specified resource.

gRPC request

rpc List (ListQuotaRequestRequest) returns (ListQuotaRequestResponse)

ListQuotaRequestRequest

{
  "resource": {
    "id": "string",
    "type": "string"
  },
  "filter": "string",
  "page_size": "int64",
  "page_token": "string"
}

Field

Description

resource

Resource

Required field. Resource to list quota requests in.

filter

string

A filter expression that filters resources listed in the response.
The expression must specify:

  1. The field name. Currently you can use filtering only on the [quotaRequest.status] field.
  2. An = operator.
  3. The value in double quotes ("). Must be 3-63 characters long and match the regular expression [a-z][-a-z0-9]{1,61}[a-z0-9].

page_size

int64

The maximum number of results per page to return. If the number of available
results is larger than page_size,
the service returns a [ListQuotaRequestsResponse.next_page_token]
that can be used to get the next page of results in subsequent list requests.
Default value: 100

page_token

string

Page token. To get the next page of results, set page_token
to the [ListQuotaRequestsResponse.next_page_token]
returned by a previous list request.

Resource

Field

Description

id

string

Required field. The id if the resource.

type

string

Required field. The type of the resource, e.g. resource-manager.cloud, billing.account.

ListQuotaRequestResponse

{
  "quota_requests": [
    {
      "id": "string",
      "resource": {
        "id": "string",
        "type": "string"
      },
      "created_at": "google.protobuf.Timestamp",
      "status": "Status",
      "quota_limits": [
        {
          "quota_id": "string",
          "desired_limit": "double",
          "approved_limit": "double",
          "unit": "string",
          "status": "Status",
          "message": "string",
          "modified_by": "string"
        }
      ],
      "created_by": "string"
    }
  ],
  "next_page_token": "string"
}

Field

Description

quota_requests[]

QuotaRequest

List of quota requests.

next_page_token

string

This token allows you to get the next page of results for list requests. If the number of results
is larger than [ListQuotaRequestsRequest.page_size], use
the next_page_token as the value
for the [ListQuotaRequestsRequest.page_token] query parameter
in the next list request. Each subsequent list request will have its own
next_page_token to continue paging through the results.

QuotaRequest

Field

Description

id

string

ID of the quota request.

resource

Resource

created_at

google.protobuf.Timestamp

Creation timestamp.

status

enum Status

Status of current quota request.

  • STATUS_UNSPECIFIED
  • PENDING: The request is pending and is waiting to be processed.
  • PROCESSING: The request is processing.
  • PROCESSED: The request was processed.
  • CANCELED: The request was canceled.
  • DELETING: The request is deleting.

quota_limits[]

QuotaLimit

Quota limits

created_by

string

ID of the subject who created quota request.

Resource

Field

Description

id

string

Required field. The id if the resource.

type

string

Required field. The type of the resource, e.g. resource-manager.cloud, billing.account.

QuotaLimit

Field

Description

quota_id

string

ID of the quota.

desired_limit

double

Desired limit.

approved_limit

double

Approved limit.

unit

string

Unit of quota.

status

enum Status

Status of current quota limit.

  • STATUS_UNSPECIFIED
  • PENDING: The request is pending and is waiting to be processed.
  • PROCESSING: The request is processing.
  • PARTIAL_APPROVED: The request was partially approved.
  • APPROVED: The request was approved.
  • REJECTED: The request was rejected.
  • CANCELED: The request was canceled.

message

string

modified_by

string

ID of the subject who modified quota limit.
Previous
Cancel
Next
ListOperations