OpenSearch/docs/java-rest/high-level/security/get-certificates.asciidoc

36 lines
1.1 KiB
Plaintext

--
:api: get-certificates
:response: GetSslCertificatesResponse
--
[role="xpack"]
[id="{upid}-{api}"]
=== SSL Certificate API
[id="{upid}-{api}-request"]
==== Get Certificates Request
The X.509 Certificates that are used to encrypt communications in an
Elasticsearch cluster using the `security().getSslCertificates()` method:
["source","java",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{doc-tests}/SecurityDocumentationIT.java[{api}-execute]
--------------------------------------------------
[id="{upid}-{api}-response"]
==== Get Certificates Response
The returned +{response}+ contains a single field, `certificates`.
This field, accessed with `getCertificates` returns a List of `CertificateInfo`
objects containing the information for all the certificates used.
["source","java",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{doc-tests}/SecurityDocumentationIT.java[{api}-response]
--------------------------------------------------
<1> `certificates` is a List of `CertificateInfo`
include::../execution.asciidoc[]