Method: projects.locations.certificateAuthorities.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
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
parent |
string
Required. The resource name of the location associated with the CertificateAuthorities , in the format projects/*/locations/* .
Authorization requires the following IAM permission on the specified resource parent :
privateca.certificateAuthorities.list
|
Query parameters
Parameters |
pageSize |
integer
Optional. Limit on the number of CertificateAuthorities to include in the response. Further CertificateAuthorities can subsequently be obtained by including the ListCertificateAuthoritiesResponse.next_page_token in a subsequent request. If unspecified, the server will pick an appropriate default.
|
pageToken |
string
Optional. Pagination token, returned earlier via ListCertificateAuthoritiesResponse.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 |
{
"certificateAuthorities": [
{
object (CertificateAuthority )
}
],
"nextPageToken": string,
"unreachable": [
string
]
} |
Fields |
certificateAuthorities[] |
object (CertificateAuthority )
The list of CertificateAuthorities .
|
nextPageToken |
string
A token to retrieve next page of results. Pass this value in [ListCertificateAuthoritiesRequest.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 endpoint lists Certificate Authorities within a specified location using a GET request to the provided URL structure.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required to identify the location of the Certificate Authorities, and the request requires \u003ccode\u003eprivateca.certificateAuthorities.list\u003c/code\u003e IAM permission on the specified parent resource.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters, including \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003efilter\u003c/code\u003e, and \u003ccode\u003eorderBy\u003c/code\u003e, allow for control over the number of results returned, pagination, filtering, and result sorting.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful response will return a JSON object that includes a list of Certificate Authorities, a token for the next page of results, and a list of unreachable locations.\u003c/p\u003e\n"],["\u003cp\u003eThe request to list Certificate Authorities requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,[]]