Method: projects.locations.certificateAuthorities.certificateRevocationLists.list
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
GET https://privateca.googleapis.com/v1beta1/{parent=projects/*/locations/*/certificateAuthorities/*}/certificateRevocationLists
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
Required. The resource name of the location associated with the CertificateRevocationLists, in the format projects/*/locations/*/certificateauthorities/*.
Authorization requires the following IAM permission on the specified resource parent:
privateca.certificateRevocationLists.list
|
Query parameters
| Parameters |
pageSize |
integer
Optional. Limit on the number of CertificateRevocationLists to include in the response. Further CertificateRevocationLists can subsequently be obtained by including the ListCertificateRevocationListsResponse.next_page_token in a subsequent request. If unspecified, the server will pick an appropriate default.
|
pageToken |
string
Optional. Pagination token, returned earlier via ListCertificateRevocationListsResponse.next_page_token.
|
filter |
string
Optional. Only include resources that match the filter in the response.
|
orderBy |
string
Optional. Specify how the results should be sorted.
|
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
| JSON representation |
{
"certificateRevocationLists": [
{
object (CertificateRevocationList)
}
],
"nextPageToken": string,
"unreachable": [
string
]
} |
| Fields |
certificateRevocationLists[] |
object (CertificateRevocationList)
The list of CertificateRevocationLists.
|
nextPageToken |
string
A token to retrieve next page of results. Pass this value in [ListCertificateRevocationListsRequest.next_page_token][] to retrieve the next page of results.
|
unreachable[] |
string
A list of locations (e.g. "us-west1") that could not be reached.
|
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-05-30 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-30 UTC."],[[["\u003cp\u003eThis document describes how to list CertificateRevocationLists via an HTTP GET request to a specific URL with required parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe required \u003ccode\u003eparent\u003c/code\u003e path parameter specifies the location and associated certificate authority for which to retrieve the certificate revocation lists.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters such as \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003efilter\u003c/code\u003e, and \u003ccode\u003eorderBy\u003c/code\u003e can be used to refine the search of CertificateRevocationLists.\u003c/p\u003e\n"],["\u003cp\u003eThe response body, structured in JSON, provides a list of CertificateRevocationLists, a token for retrieving the next page of results, and a list of unreachable locations.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003eprivateca.certificateRevocationLists.list\u003c/code\u003e IAM permission on the specified parent resource, as well as the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.certificateAuthorities.certificateRevocationLists.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListCertificateRevocationListsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nLists [CertificateRevocationLists](/certificate-authority-service/docs/reference/rest/v1beta1/projects.locations.certificateAuthorities.certificateRevocationLists#CertificateRevocationList).\n\n### HTTP request\n\n`GET https://privateca.googleapis.com/v1beta1/{parent=projects/*/locations/*/certificateAuthorities/*}/certificateRevocationLists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for [CertificateAuthorityService.ListCertificateRevocationLists](/certificate-authority-service/docs/reference/rest/v1beta1/projects.locations.certificateAuthorities.certificateRevocationLists/list#google.cloud.security.privateca.v1beta1.CertificateAuthorityService.ListCertificateRevocationLists).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]
