2018-12-06 05:44:51 -05:00
|
|
|
|
|
|
|
--
|
|
|
|
:api: get-certificates
|
|
|
|
:response: GetSslCertificatesResponse
|
|
|
|
--
|
|
|
|
|
2019-09-11 16:19:13 -04:00
|
|
|
[role="xpack"]
|
2018-12-06 05:44:51 -05:00
|
|
|
[id="{upid}-{api}"]
|
2018-10-15 12:20:34 -04:00
|
|
|
=== SSL Certificate API
|
|
|
|
|
2018-12-06 05:44:51 -05:00
|
|
|
[id="{upid}-{api}-request"]
|
|
|
|
==== Get Certificates Request
|
2018-10-15 12:20:34 -04:00
|
|
|
|
|
|
|
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"]
|
|
|
|
--------------------------------------------------
|
2018-12-06 05:44:51 -05:00
|
|
|
include-tagged::{doc-tests}/SecurityDocumentationIT.java[{api}-execute]
|
2018-10-15 12:20:34 -04:00
|
|
|
--------------------------------------------------
|
|
|
|
|
2018-12-06 05:44:51 -05:00
|
|
|
[id="{upid}-{api}-response"]
|
|
|
|
==== Get Certificates Response
|
2018-10-15 12:20:34 -04:00
|
|
|
|
2018-12-06 05:44:51 -05:00
|
|
|
The returned +{response}+ contains a single field, `certificates`.
|
2018-10-15 12:20:34 -04:00
|
|
|
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"]
|
|
|
|
--------------------------------------------------
|
2018-12-06 05:44:51 -05:00
|
|
|
include-tagged::{doc-tests}/SecurityDocumentationIT.java[{api}-response]
|
2018-10-15 12:20:34 -04:00
|
|
|
--------------------------------------------------
|
|
|
|
<1> `certificates` is a List of `CertificateInfo`
|
|
|
|
|
2018-12-06 05:44:51 -05:00
|
|
|
include::../execution.asciidoc[]
|