Method: projects.locations.certificates.list

Lists Certificates in a given project and location.

HTTP request

GET https://certificatemanager.googleapis.com/v1/{parent=projects/*/locations/*}/certificates

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The project and location from which the certificate should be listed, specified in the format projects/*/locations/*.

Authorization requires the following IAM permission on the specified resource parent:

  • certificatemanager.certs.list

Query parameters

Parameters
pageSize

integer

Maximum number of certificates to return per call.

pageToken

string

The value returned by the last ListCertificatesResponse. Indicates that this is a continuation of a prior certificates.list call, and that the system should return the next page of data.

filter

string

Filter expression to restrict the Certificates returned.

orderBy

string

A list of Certificate field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix " desc".

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response for the certificates.list method.

JSON representation
{
  "certificates": [
    {
      object (Certificate)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Fields
certificates[]

object (Certificate)

A list of certificates for the parent resource.

nextPageToken

string

If there might be more results than those appearing in this response, then nextPageToken is included. To get the next set of results, call this method again using the value of nextPageToken as pageToken.

unreachable[]

string

A list of locations 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.