Finden Sie heraus, wie Sie die API nutzen können, indem Sie sie etwa zusammen mit unserem Befehlszeilentool ecctl verwenden, um Deployments zu erstellen und zu verwalten.

Mit der Elastic Cloud-Konsole erhalten Sie einen zentralen Ort, an dem Sie Ihre Deployments erstellen und verwalten, Abrechnungsinformationen anzeigen und sich über neue Versionen informieren können. In der einfachen und intuitiven Benutzeroberfläche (UI) können Sie allgemeine Verwaltungs- und administrative Aufgaben ausführen.
Eine Verwaltungs-UI ist zwar praktisch, aber viele Unternehmen wünschen sich auch eine API, um gängige Aufgaben und Workflows automatisieren zu können, insbesondere für die Verwaltung von Deployments. Wir freuen uns, die allgemein verfügbare Version der Elasticsearch Service API zu präsentieren, mit der Sie diese Workflows aktivieren können.
Sie können die API entweder direkt integrieren oder Elastic Cloud Control (<a href="https://github.com/elastic/ecctl">ecctl</a>) verwenden, die Befehlszeilenschnittstelle der Elastic Cloud, die jetzt auch die Elasticsearch Service API unterstützt. Bei Bedarf können Sie auch die Bibliothek <a href="https://github.com/elastic/cloud-sdk-go">cloud-sdk-go</a> verwenden oder ein <a href="/guide/en/cloud/current/ec-openapi-specification.html">SDK in einer anderen Programmiersprache generieren</a>.
Bevor wir Ihnen an einem Beispiel zeigen, wie Sie ein Deployment mit der Elasticsearch Service API erstellen und skalieren können, möchte ich Ihnen einige gängige Nutzungsszenarien für die API vorstellen:
<h2>Integration mit CI/CD-Pipelines</h2>Für viele unserer Benutzer ist der Elastic Stack ein kritischer Teil ihres Produktionsstacks. Angenommen, Sie möchten Änderungen an Ihrer Anwendung vornehmen, die sich auf Elasticsearch auswirken, etwa indem Sie Abfragen optimieren oder neue Elastic Stack-Versionen testen.
Eine CI/CD-Pipeline könnte beispielsweise ein Deployment exakt nach Ihrer Spezifikation hochfahren und dabei möglicherweise einen Snapshot verwenden, um Daten aus Ihrem Produktions-Cluster einzubinden. Auf diese Weise erhalten Sie sofort Feedback für eine bestimmte Codeänderung an Ihrer Anwendung in einer Entwicklungs- oder Stagingumgebung, bevor Sie die Änderung in Ihre Produktionsumgebung übernehmen.
<h2>Onboarding für neue Teams und Anwendungsfälle</h2>Oft ist der Elastic Stack nicht nur ein Teil des Produktionsstacks, sondern wird auch für die Observability von Anwendungen und Infrastruktur eingesetzt. Anstelle eines einzigen Deployments für verschiedene Zwecke empfehlen wir, die Anwendungsfälle und Teams nach Möglichkeit mit dedizierten Deployments voneinander zu trennen. Auf diese Weise können Sie Reibungsverluste und mögliche Nachbarschaftskonflikte vermeiden, wenn ein ressourcenintensiver Anwendungsfall - oder sogar unbeabsichtigte Bugs - eines Teams sich auf die anderen Teams auswirken.
Mit dem <a href="/de/elasticsearch/service">Elasticsearch Service</a> können Sie eine beliebige Anzahl an Deployments mühelos verwalten. Und jetzt können Sie sogar Ihren bevorzugten Konfigurationsmanager oder Ihr Infrastruktur-als-Code-Tool, wie etwa Ansible, Chef, Puppet und Terraform oder sogar Ihr internes Unternehmensportal problemlos mit unserer API integrieren. Wenn ein neues Team einen neuen Entwicklungsstack registriert und dessen Erstellung anfordert, können Sie ohne manuelle Eingriffe ein Deployment mit der passenden Vorlage erstellen und Größe sowie Konfiguration an die Anforderungen des Teams anpassen.
<h2>Deployments skalieren</h2>Viele unserer Benutzer möchten ihre Deployments programmgesteuert skalieren können, um diese an ein erhöhtes Nutzungsprofil anzupassen oder um während inaktiver Zeiträume die Kosten zu reduzieren. Diese Ereignisse sind manchmal vorhersehbar, etwa ein Anstieg des Besucherverkehrs für eine E-Commerce-Website an einem nationalen Feiertag, manchmal jedoch auch nicht, zum Beispiel eine Schwankung der Ressourcenverwendung durch ein ungeplantes Last-Minute-Sonderangebot. Unsere Kunden können diese zeit- oder nutzungsbasierten Skalierungs-Workflows mit einer API implementieren.
Bei der metrikbasierten Skalierung (Festplattenspeicher, CPU oder RAM) gilt es immer verschiedene Punkte zu berücksichtigen. Sie müssen beispielsweise sicherstellen, dass genügend Festplattenspeicher vorhanden ist, wenn Sie ein Deployment herunterskalieren, um die aktuelle Speichernutzung zu unterstützen.
<h2>Erste Schritte mit der Elasticsearch Service API</h2>Diese Beispiele zeigen nur einige Vorschläge dafür, wie Sie unsere API nutzen können, um sich nicht mehr bei unserer Benutzerkonsole anmelden zu müssen, um Ihre Deployments zu verwalten. Die komplette Liste ist viel länger. Wir werden Ihnen jetzt Schritt für Schritt zeigen, wie Sie unser Befehlszeilentool <a href="https://github.com/elastic/ecctl">ecctl</a> oder <a href="https://curl.haxx.se/">curl</a> verwenden können, um ein Deployment direkt über die REST API zu erstellen und zu skalieren.
<h3>1. API-Schlüssel erstellen</h3>Um sich authentifizieren zu können, müssen Sie zunächst einen API-Schlüssel generieren, mit dem Sie sich anschließend als Kontobesitzer identifizieren. Um einen API-Schlüssel zu generieren, melden Sie sich bei der Benutzerkonsole an und navigieren Sie zur Schlüsselverwaltungsseite im Abschnitt „Account“.
Bei Bedarf können Sie mehrere API-Schlüssel generieren, um den Zugriff für mehrere Anwendungen einfacher zu verwalten, und Sie können einzelne Schlüssel unabhängig voneinander widerrufen.
Bei der Erstellung eines neuen Schlüssels müssen Sie Ihr Passwort erneut eingeben, dem Schlüssel einen Namen geben und ihn anschließend kopieren oder herunterladen. Dies ist der einzige Zeitpunkt, an dem der eigentliche Schlüssel angezeigt wird. Bewahren Sie ihn also an einem sicheren Ort auf.
<img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt659b8136af7e7d74/5eb3228b74d6d8619aa2dafd/gen-api-key.gif" data-sys-asset-uid="blt659b8136af7e7d74" alt="gen-api-key.gif"> 
<h3>2. ecctl konfigurieren</h3>Wenn sie ecctl zum ersten Mal verwenden, müssen Sie die Software auf Ihrem lokalen Computer installieren. (<a href="/de/downloads/ecctl">Hier finden Sie die Installationsanleitung.</a>) Falls Sie ecctl bereits auf Ihrem Computer installiert haben, stellen Sie sicher, dass Sie Version 1.0.0-beta3&nbsp;oder höher verwenden, um zu garantieren, dass die hier beschriebenen Befehle unterstützt werden. Wir werden zwar auch einige Beispiele mit curl zeigen, aber wir empfehlen ecctl, da dieses Programm eine viel benutzerfreundlichere Interaktion mit unserer API ermöglicht.
Nach der Installation können Sie den Befehl <code>ecctl init</code> ausführen und den Konfigurations-Assistenten verwenden. Wenn Sie zur Auswahl des Produkts aufgefordert werden, wählen Sie den Elasticsearch Service aus, wählen Sie Text oder JSON als Standardausgabe, den API-Schlüssel als Authentifizierungsmechanismus, und geben Sie den API-Schlüssel aus dem vorherigen Schritt an.
Um die Konfiguration zu überprüfen, können Sie den Befehl <code>ecctl deployment list</code> ausführen, der eine Liste der aktiven Deployments zurückgibt.
<img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt4c037e7ea507e8c1/5eb3231b9c5d3e37e05f1ed9/ecclt-init-2.gif" data-sys-asset-uid="blt4c037e7ea507e8c1" alt="ecclt-init-2.gif">
<h3>3. Erstes Deployment erstellen</h3>Sie haben jetzt alle Voraussetzungen erfüllt und können Ihr erstes Deployment erstellen. Der Elasticsearch Service unterstützt <a href="/guide/en/cloud/current/ec-getting-started-templates.html">Deployment-Vorlagen</a>, mit denen Sie ein Deployment mit den passenden Komponenten und der gewünschten Hardware für Ihren Anwendungsfall schnell und einfach erstellen können.
Beim Erstellen von Deployments mit unserer API müssen Sie angeben, welche Vorlage Sie verwenden möchten, und die Nutzlast muss mit der erwarteten Nutzlast der Vorlage übereinstimmen. Sie finden eine Liste der verfügbaren Vorlagen für Ihren Cloudanbieter und Ihre Region in unserem <a href="/guide/en/cloud/current/ec-regions-templates-instances.html">Benutzerhandbuch</a>.
Für dieses Beispiel verwenden wir GCP Iowa (us-central1) und die Vorlage <a href="/guide/en/cloud/current/ec-getting-started-templates-io.html">I/O optimized template</a>. Kopieren sie die folgende JSON-Nutzlast und speichern Sie sie in einer Datei mit dem Namen „create-deployment.json“.
JSON-Nutzlast:
<pre class="prettyprint">{
 "name": "created-via-api",
 "resources": {
 "elasticsearch": [
 {
 "region": "gcp-us-central1",
 "ref_id": "main-elasticsearch",
 "plan": {
 "cluster_topology": [
 {
 "node_type": {
 "master": true,
 "data": true,
 "ingest": true
 },
 "instance_configuration_id": "gcp.data.highio.1",
 "zone_count": 2,
 "size": {
 "resource": "memory",
 "value": 2048
 }
 }
 ],
 "elasticsearch": {
 "version": "7.6.2"
 },
 "deployment_template": {
 "id": "gcp-io-optimized"
 }
 }
 }
 ],
 "kibana": [
 {
 "region": "gcp-us-central1",
 "elasticsearch_cluster_ref_id": "main-elasticsearch",
 "ref_id": "main-kibana",
 "plan": {
 "cluster_topology": [
 {
 "instance_configuration_id": "gcp.kibana.1",
 "zone_count": 1,
 "size": {
 "resource": "memory",
 "value": 1024
 }
 }
 ],
 "kibana": {
 "version": "7.6.2"
 }
 }
 }
 ],
 "apm": [
 {
 "region": "gcp-us-central1",
 "elasticsearch_cluster_ref_id": "main-elasticsearch",
 "ref_id": "main-apm",
 "plan": {
 "cluster_topology": [
 {
 "instance_configuration_id": "gcp.apm.1",
 "zone_count": 1,
 "size": {
 "resource": "memory",
 "value": 512
 }
 }
 ],
 "apm": {
 "version": "7.6.2"
 }
 }
 }
 ]
 }
}
</pre>Mit weiteren Konfigurationsoptionen können Sie beispielsweise einen Überwachungscluster festlegen oder einen Snapshot für die Wiederherstellung verwenden. In diesem einfachen Beispiel erstellen wir jedoch nur ein neues Deployment mit einem hochverfügbaren Elasticsearch Cluster über zwei Verfügbarkeitszonen, einer einzigen Kibana-Instanz und einem einzigen APM-Server. Jetzt müssen wir nur noch den folgenden ecctl-Befehl ausführen, und das Deployment wird erstellt.
Sie können sich auch mit der API vertraut machen, indem Sie in der Elastic Cloud-Benutzerkonsole die passende API-Anfrage für die ausgewählte Konfiguration in der Benutzeroberfläche ausgeben lassen.
<img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt1d37a417c18c25ee/5eb3244e8682422a765fc0d2/rest_api_console.gif" data-sys-asset-uid="blt1d37a417c18c25ee" alt="rest_api_console.gif">
ecctl:
<pre class="prettyprint">ecctl deployment create -f create-deployment.json
</pre>Um den Fortschritt zu überwachen, können Sie in diesem und in anderen Befehlen das Flag <code>--track</code> verwenden. Das Flag <code>--help</code> ist allgemein sehr hilfreich, um die verfügbaren Optionen kennenzulernen.
Wenn Sie curl verwenden, können Sie dasselbe mit dem folgenden Befehl erreichen.
curl:
<pre class="prettyprint">curl -XPOST https://api.elastic-cloud.com/api/v1/deployments \
-H "Authorization: ApiKey &lt;API_KEY&gt;" \
-d @create-deployment.json
</pre>Die Antwort enthält Informationen darüber, ob die Anfrage erfolgreich gesendet wurde, sowie die Deployment-ID. Kopieren Sie diese ID, da Sie sie zum Skalieren Ihres Clusters im nächsten Schritt brauchen werden. Die Antwort enthält außerdem das zufällig generierte Passwort für den Benutzer <code>elastic</code>, mit dem Sie sich sofort bei Kibana anmelden oder die Elasticsearch REST API verwenden können, um Ihr Deployment zu konfigurieren oder zu verwenden.
<img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt060f7218509c2568/5eb3256421a5027d7741f8d1/create_deployment_ecctl.gif" data-sys-asset-uid="blt060f7218509c2568" alt="create_deployment_ecctl.gif"> 
<h3>4. Deployment skalieren</h3>Ihr Deployment ist jetzt einsatzbereit, und wir werden uns genauer ansehen, wie Sie es skalieren können. In diesem Beispiel werden Sie die Größe Ihrer Datenknoten von 4.096 auf 8.192 MB erhöhen. Da Sie nur Änderungen an Ihrem Elasticsearch-Cluster vornehmen, sollten Sie das Feld „prune_orphans“ auf „false“ setzen. Damit geben Sie an, dass andere Komponenten, die zu Ihrem Deployment gehören (in diesem Fall Kibana und APM) nicht entfernt werden sollen.
Kopieren sie die folgende JSON-Nutzlast und speichern Sie sie in einer Datei mit dem Namen „update-deployment.json“.
JSON-Nutzlast:
<pre class="prettyprint">{
 "prune_orphans": false,
 "resources": {
 "elasticsearch": [
 {
 "region": "gcp-us-central1",
 "ref_id": "main-elasticsearch",
 "plan": {
 "cluster_topology": [
 {
 "zone_count": 2,
 "node_type": {
 "master": true,
 "data": true,
 "ingest": true,
 "ml": false
 },
 "instance_configuration_id": "gcp.data.highio.1",
 "size": {
 "resource": "memory",
 "value": 4096
 }
 }
 ],
 "elasticsearch": {
 "version": "7.6.2"
 },
 "deployment_template": {
 "id": "gcp-io-optimized"
 }
 }
 }
 ]
 }
}
</pre>Dieses Mal verwenden Sie den Befehl „update“.
ecctl:
<pre class="prettyprint">ecctl deployment update &lt;DEPLOYMENT_ID&gt; -f update-deployment.json
</pre>Für curl verwenden Sie die PUT-Methode, um den neuen Plan zu übermitteln.
curl:
<pre class="prettyprint">curl -XPUT https://api.elastic-cloud.com/api/v1/deployments/&lt;DEPLOYMENT_ID&gt; \
-H "Authorization: ApiKey &lt;API_KEY&gt;" \
-d @update-deployment.json
</pre>Angenommen, Sie möchten einen Plan vor dessen Abschluss abbrechen. In diesem Fall können Sie den Planbefehl mit ecctl abbrechen, indem Sie „elasticsearch“ als Typ übergeben. Falls Sie curl verwenden, können Sie eine Löschanfrage für den ausstehenden Plan übermitteln und die ref-id von Elasticsearch angeben, z.&nbsp;B. „main-elasticsearch“.
ecctl:
<pre class="prettyprint">ecctl deployment plan cancel &lt;DEPLOYMENT_ID&gt; --kind elasticsearch
</pre>curl:
<pre class="prettyprint">curl -XDELETE https://api.elastic-cloud.com/api/v1/deployments/&lt;DEPLOYMENT_ID&gt;/elasticsearch/main-elasticsearch/plan/pending \
-H "Authorization: ApiKey &lt;API_KEY&gt;"
</pre><h3>5. Ressourcen bereinigen</h3>Im letzten Schritt werden Sie den shutdown-Befehl verwenden, um das erstellte Deployment zu löschen.
ecctl:
<pre class="prettyprint">ecctl deployment shutdown &lt;DEPLOYMENT_ID&gt;
</pre>Beim Übermitteln einer Löschaktion zeigt ecctl vor der Ausführung eine Bestätigungsmeldung an. Wenn Sie diesen Befehl für Ihre Automatisierung verwenden, können Sie das globale Flag <code>--force</code> verwenden.
Falls Sie curl verwenden, können Sie die folgende Anfrage übermitteln:
curl:
<pre class="prettyprint">curl -XPOST https://api.elastic-cloud.com/api/v1/deployments/&lt;DEPLOYMENT_ID&gt;/_shutdown \
-H "Authorization: ApiKey &lt;API_KEY&gt;"
</pre><h2>Fazit</h2>Wir haben uns verschiedene Anwendungsfälle für die Automatisierung von Deployments angesehen, um Ihnen zu zeigen, wie Sie Ihre Deployments erstellen, skalieren und herunterfahren können. Sie können unsere API auf viele weitere Arten verwenden, um verschiedene Vorgänge zu automatisieren und die erforderlichen Interaktionen zur Verwaltung Ihrer Deployments zu reduzieren.
Eine komplette Liste der verfügbaren API-Endpunkte finden Sie in den <a href="/guide/en/cloud/current/ec-api-examples.html">API-Beispielen</a> im Abschnitt <a href="/guide/en/cloud/current/ec-restful-api.html">RESTful API</a> in unserem Benutzerhandbuch.
Elasticsearch Service-Neuling? <a href="/de/elasticsearch/service">Registrieren Sie sich für eine 14-tägige Testversion</a>, um die Lösung zu auszuprobieren.

elasticsearch-service-blog-banner.png

blog-thumb-elasticsearch-service.png

Elastic Cloud: Elasticsearch Service API is now GA

Elastic Cloud: Die Elasticsearch Service API ist jetzt allgemein verfügbar.

Start free trial

Blog Footer CTA

Sign up for Elastic Cloud free trial

Principal Product Manager

Roy Zanbel

By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_self">Terms of Service</a>, and you agree to receive the <a href="/legal/privacy-statement#how-we-use-the-information" target="_self">selected communications</a> at the contact details you provided above. See <a href="/legal/privacy-statement/" target="_self">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Communication Preferences - ONLY for /communication-preferences

Durch das Absenden erklären Sie, dass Sie unsere <a href="/de/legal/elastic-cloud-account-terms" target="_self">Nutzungsbedingungen</a> gelesen haben und mit ihnen einverstanden sind und dass Sie Elastic erlauben, <a href="/de/legal/privacy-statement#how-we-use-the-information" target="_self">ausgewählte Nachrichten und Informationen</a> an die oben von Ihnen bereitgestellten Kontaktangaben zu senden. Weitere Informationen, darunter auch dazu, wie Sie Ihre Einwilligung zurückziehen können, finden Sie in der <a href="/de/legal/privacy-statement/" target="_self">Datenschutzerklärung von Elastic</a>.

By submitting you acknowledge that you've read and agree to our <a href="/legal/serverless-preview-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Serverless GDPR Text

Durch das Absenden erklären Sie, dass Sie unsere <a href="/de/legal/serverless-preview-terms" target="_self">Nutzungsbedingungen</a> gelesen haben und mit ihnen einverstanden sind und dass Sie Elastic erlauben, bezüglich unserer zugehörigen Produkte und Dienstleistungen und unter Nutzung der von Ihnen oben bereitgestellten Kontaktangaben <a href="/de/legal/privacy-statement#how-we-use-the-information" target="_self">mit Ihnen in Kontakt zu treten</a>. Weitere Informationen, darunter auch dazu, wie Sie Ihre Einwilligung zurückziehen können, finden Sie in der <a href="/de/legal/privacy-statement/" target="_self">Datenschutzerklärung von Elastic</a>.

By submitting you agree to <a href="/agreements/global/cloud-services-monthly" rel="nofollow">Elastic Cloud Terms of Service</a>. Your personal data will be processed in accordance with <a href="/legal/privacy-statement">Elastic's Privacy Statement</a>.

Cloud Trial GDPR Text

Beim Absenden akzeptieren Sie die <a href="/de/agreements/global/cloud-services-monthly" rel="nofollow">Nutzungsbedingungen von Elastic Cloud</a>. Die Verarbeitung Ihrer personenbezogenen Daten unterliegt der <a href="/de/legal/privacy-statement">Datenschutzerklärung von Elastic</a>.

By submitting you acknowledge that you've read and agree to our <a href="/legal/terms-of-use" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Newsletter GDPR Text

Durch das Absenden erklären Sie, dass Sie unsere <a href="/de/legal/terms-of-use" target="_self">Nutzungsbedingungen</a> gelesen haben und mit ihnen einverstanden sind und dass Sie Elastic erlauben, bezüglich unserer zugehörigen Produkte und Dienstleistungen und unter Nutzung der von Ihnen oben bereitgestellten Kontaktangaben <a href="/de/legal/privacy-statement#how-we-use-the-information" target="_self">mit Ihnen in Kontakt zu treten</a>. Weitere Informationen, darunter auch dazu, wie Sie Ihre Einwilligung zurückziehen können, finden Sie in der <a href="/de/legal/privacy-statement/" target="_self">Datenschutzerklärung von Elastic</a>.

Explore similar demos

Overview

Speakers

Close

See more insights

The content on this page is not available in the selected language. As Elastic grows globally, we continue to support content in multiple languages.

The content on this page is not available in the selected language.

Der Inhalt dieser Seite ist in der ausgewählten Sprache nicht verfügbar. Wir bei Elastic arbeiten daran, die bereitgestellten Inhalte in verschiedenen Sprachen anzubieten. Bis dahin bitten wir Sie um etwas Geduld und hoffen auf Ihr Verständnis!

Author

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

Articles by

Share this story

Share by Email

Thank you for your interest!

Contact Info

Follow us on Youtube

Load More

Share on LinkedIn

Follow us on LinkedIn

Search Integrations

All Solutions

Video for

Follow us on Twitter

See when this webinar starts in my time zone

Register to Watch

Register now

See All Posts

Can't make it? Register and we'll send you the recording. You'll also receive an email with related content

Sie können nicht dabei sein? Registrieren Sie sich, damit wir Ihnen die Aufzeichnung zukommen lassen können. Außerdem erhalten Sie eine E‑Mail mit Begleitmaterial.

Small image for

On-demand webinar

Featured webinar

Register to Attend

Share on Facebook

Reset all

Upcoming webinar

View more posts

Print

Hosted by

Sign In to Attend

View next

Follow us on Facebook

Share

Highlights

Learn More

Read less

You'll also receive an email with related content

Wir schicken Ihnen zudem relevante Informationen, die von Interesse sein könnten.

Thank you for registering. We will send you a confirmation email soon.

Vielen Dank für Ihre Registrierung. Sie erhalten in Kürze eine Bestätigungs-E‑Mail von uns.

Author

Articles by Roy Zanbel

Principal Product Manager, Elastic

Elastic Cloud: Die Elasticsearch Service API ist jetzt allgemein verfügbar.