Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Certificate Manager
  • Getting started
  • Access management
  • Pricing policy
  • Terraform reference
    • Authentication with the API
      • Overview
        • Overview
          • Overview
          • IssueCertificate
          • IssueCertificateByCsr
          • Update
          • Delete
          • Get
          • List
          • RevokeCertificate
          • ListAccessBindings
          • SetAccessBindings
          • UpdateAccessBindings
  • Monitoring metrics
  • Audit Trails events
  • Release notes
  • FAQ

In this article:

  • HTTP request
  • Query parameters
  • Response
  • PrivateCertificate
  1. API reference
  2. REST
  3. Certificate Manager Private CA API
  4. PrivateCaCertificate
  5. List

Certificate Manager Private CA API, REST: PrivateCaCertificate.List

Written by
Yandex Cloud
Updated at December 17, 2024
  • HTTP request
  • Query parameters
  • Response
  • PrivateCertificate

Lists the certificates issued by a given Certificate Authority (CA).

HTTP requestHTTP request

GET https://private-ca.certificate-manager.api.cloud.yandex.net/privateca/v1/privateCertificates

Query parametersQuery parameters

Request to list certificates issued by a specific Certificate Authority.

Field

Description

certificateAuthorityId

string

Required field. The ID of the Certificate Authority issuing the certificates.

pageSize

string (int64)

Maximum number of certificates to return per page, optional. Default is 100.

pageToken

string

Page token, allows request for the next page of results from a previous list call.

ResponseResponse

HTTP Code: 200 - OK

{
  "certificates": [
    {
      "id": "string",
      "certificateAuthorityId": "string",
      "name": "string",
      "description": "string",
      "issuedAt": "string",
      "notAfter": "string",
      "notBefore": "string",
      "deletionProtection": "boolean",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "nextPageToken": "string"
}

Response to the ListCertificates request, containing the certificates and pagination information.

Field

Description

certificates[]

PrivateCertificate

The list of certificates issued by the Certificate Authority.

nextPageToken

string

Token to use to fetch the next page of results, if there are more results.

PrivateCertificatePrivateCertificate

A private certificate issued by a private certificate authority.

Field

Description

id

string

ID of the private certificate.

certificateAuthorityId

string

ID of the certificate authority that issued the private certificate.

name

string

Name of the private certificate.

description

string

Description of the private certificate.

issuedAt

string (date-time)

Time when the private certificate was issued.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

notAfter

string (date-time)

Time after which the private certificate is not valid.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

notBefore

string (date-time)

Time before which the private certificate is not valid.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

deletionProtection

boolean

Flag that protects deletion of the private certificate.

createdAt

string (date-time)

Time when the private certificate was created.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

updatedAt

string (date-time)

Time when the private certificate was updated.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

Was the article helpful?

Previous
Get
Next
RevokeCertificate
Yandex project
© 2025 Yandex.Cloud LLC