Veröffentlichen und Aufheben der Veröffentlichung eines Dienstes der privaten Trasse
Nachdem Sie eine erfolgreiche Verbindung zu Ihrem Privatpfaddienst verifiziert haben, müssen Sie Ihren Dienst für die Bereitstellung an Verbraucher veröffentlichen.
Wenn ein Dienst des privaten Pfads nicht veröffentlicht wird, kann außerhalb des Kontos nicht auf ihn zugegriffen werden.
Durch die Veröffentlichung kann jedes Konto den Zugang zum Private Path-Dienst beantragen. Bei Bedarf können Sie die Veröffentlichung auch rückgängig machen, wenn der Zugang auf das Konto beschränkt ist, das den Dienst "Privater Pfad" erstellt hat.
Sie können einen IBM Cloud® Private Path Service über die Konsole, CLI, API oder Terraform veröffentlichen und wieder freigeben.
Veröffentlichen eines Dienstes des privaten Pfads in der Konsole
Führen Sie folgende Schritte aus, um einen privaten Pfaddienst in der Konsole IBM Cloud zu veröffentlichen:
-
Öffnen Sie im Browser die IBM Cloud-Konsole und melden Sie sich bei Ihrem Konto an.
-
Wählen Sie das Navigationsmenü
und klicken Sie dann auf
„Infrastruktur- VPC“ > „Netzwerk“ > „Private Pfaddienste“.
-
Suchen Sie den Namen Ihres neuen Privatpfaddienstes in der Tabelle, und klicken Sie auf den Namen, um die Detailseite des Privatpfaddienstes anzuzeigen.
-
Klicken Sie im Menü "Aktionen" auf " Veröffentlichen ".
Die Spalte Veröffentlichung in der Tabelle Private Path Services für VPC ändert sich in
Published.
Der Service 'Privater Pfad' ist jetzt für andere Konten verfügbar, um eine Verbindung zum Service über VPE-Gateways (Virtual Private Endpoint) herzustellen.
Nach der Veröffentlichung ist der Name des Dienstes "Privater Pfad" für Kunden sichtbar, die sich mit dem Dienst "Privater Pfad" verbinden.
Aufhebung der Veröffentlichung eines Dienstes "Privater Pfad" in der Konsole
Gehen Sie folgendermaßen vor, um die Veröffentlichung eines Private Path-Dienstes in der Konsole IBM Cloud aufzuheben:
- Öffnen Sie im Browser die IBM Cloud-Konsole und melden Sie sich bei Ihrem Konto an.
- Wählen Sie das
im Navigationsmenü und klicken Sie dann auf Infrastruktur > Netzwerk > Private Pfaddienste.
- Suchen Sie in der Tabelle Private Path-Services für VPC den Private Path, den Sie nicht mehr veröffentlichen möchten, und klicken Sie dann auf den Namen dieses Private Path-Service.
- Klicken Sie auf der Detailseite des Dienstes "Privater Pfad" auf das Menü " Aktionen" und dann auf " Veröffentlichung aufheben".
- Bestätigen Sie, dass Sie die Veröffentlichung Ihres Dienstes "Privater Pfad" aufheben möchten.
Veröffentlichen eines Dienstes für einen privaten Pfad über die CLI
Das folgende Beispiel zeigt, wie die Befehlszeilenschnittstelle zum Veröffentlichen eines Private-Path-Service verwendet wird.
Zur Vorbereitung müssen Sie Ihre CLI-Umgebung einrichten.
Führen Sie die folgenden Schritte aus, um einen Service für private Pfade über die Befehlszeilenschnittstelle zu veröffentlichen:
- Geben Sie den folgenden Befehl ein:
ibmcloud is private-path-service-gateway-publish PRIVATE_PATH_SERVICE_GATEWAY
[--output JSON]
[-f, --force]
[-q, --quiet]
Dabei gilt:
PRIVATE_PATH_SERVICE_GATEWAY- Gibt die ID oder den Namen des Dienstes "Private Path" an.
--output- Gibt das Ausgabeformat an. Es wird nur JSON unterstützt. Einer der folgenden Werte:
JSON. -q, --quiet- Unterdrückt die ausführliche Ausgabe.
Befehlsbeispiele
- Veröffentlichen Sie einen Dienst "Private Path":
ibmcloud is ppsgp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1ibmcloud is private-path-service-gateway-publish cli-ppsg-0
Aufhebung der Veröffentlichung eines Dienstes für einen privaten Pfad über die CLI
Das folgende Beispiel zeigt, wie Sie mit der Befehlszeilenschnittstelle (CLI) die Veröffentlichung eines Privatpfaddienstes aufheben können.
Zur Vorbereitung müssen Sie Ihre CLI-Umgebung einrichten.
Gehen Sie folgendermaßen vor, um die Veröffentlichung eines Dienstes für den privaten Pfad über die Befehlszeile aufzuheben:
- Geben Sie den folgenden Befehl ein:
ibmcloud is private-path-service-gateway-unpublish PRIVATE_PATH_SERVICE_GATEWAY
[--output JSON]
[-f, --force]
[-q, --quiet]
Dabei gilt:
PRIVATE_PATH_SERVICE_GATEWAY- Gibt die ID oder den Namen des Dienstes "Private Path" an.
--output- Gibt das Ausgabeformat an. Es wird nur JSON unterstützt. Einer der folgenden Werte:
JSON. -q, --quiet- Unterdrückt die ausführliche Ausgabe.
Service für private Pfade mit der API veröffentlichen
Führen Sie die folgenden Schritte aus, um einen privaten Pfadservice mit der API zu veröffentlichen:
-
Richten Sie die API-Umgebung ein.
-
Speichern Sie die folgenden Werte in Variablen, damit diese im API-Befehl verwendet werden können:
-
ppsgId-Rufen Sie Ihren privaten Pfadservice ab und füllen Sie dann die Variable:export ppsgId=<your_ppsg_id>
-
-
Wenn alle Variablen initiiert sind, veröffentlichen Sie Ihren Dienst "Private Path":
curl -X POST -sH "Authorization:${iam_token}" \ "$vpc_api_endpoint/v1/private_path_service_gateways/$ppsgId/publish?version=$api_version&generation=2" \ -d {}'
Aufhebung der Veröffentlichung eines Dienstes "Privater Pfad" mit der API
Führen Sie die folgenden Schritte aus, um die Veröffentlichung eines Dienstes mit privatem Pfad über die API aufzuheben:
-
Richten Sie die API-Umgebung ein.
-
Speichern Sie die folgenden Werte in Variablen, damit diese im API-Befehl verwendet werden können:
-
ppsgId-Rufen Sie Ihren privaten Pfadservice ab und füllen Sie dann die Variable:export ppsgId=<your_ppsg_id>
-
-
Wenn alle Variablen initiiert sind, heben Sie die Veröffentlichung des Dienstes "Privater Pfad" auf:
curl -X POST -sH "Authorization:${iam_token}" \ "$vpc_api_endpoint/v1/private_path_service_gateways/$ppsgId/unpublish?version=$api_version&generation=2" \ -d {}'
Befehlsbeispiele
- Veröffentlichen Sie einen Dienst "Private Path":
ibmcloud is ppsgunp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1ibmcloud is private-path-service-gateway-unpublish cli-ppsg-0
Veröffentlichen eines privaten Pfaddienstes mit Terraform
Im folgenden Beispiel wird ein Private Path-Netzwerk mit Terraform veröffentlicht:
resource "ibm_is_private_path_service_gateway_operations" "publish" {
published = true
private_path_service_gateway = ibm_is_private_path_service_gateway.ppsg.id
}
Die Dokumentation zu Terraform-Ressourcen finden Sie in der Terraform-Registry.
Unpublishing eines Private Path Dienstes mit Terraform
Terraform wird diese Funktion unterstützen, sobald es die allgemeine Verfügbarkeit (GA) erreicht und offiziell freigegeben ist.
Im folgenden Beispiel wird ein Private Path-Netzwerk mithilfe von Terraform veröffentlicht:
resource "ibm_is_private_path_service_gateway_operations" "publish" {
published = false
private_path_service_gateway = ibm_is_private_path_service_gateway.ppsg.id
}
Die Dokumentation zu Terraform-Ressourcen finden Sie in der Terraform-Registry.