In diesem Dokument wird beschrieben, wie Sie mit Cloud FTP einen internen SFTP-Server erstellen. Auf einen internen SFTP-Server kann nur innerhalb Ihres VPC-Netzwerks (Virtual Private Cloud) über Private Service Connect zugegriffen werden. Mitarbeiter und interne Stakeholder in Ihrem Netzwerk können den Server verwenden, um Dateien sicher in und aus Cloud Storage zu übertragen.
Sie geben die Projekte an, die eine Verbindung zum Server herstellen dürfen. Optional können Sie Projekte angeben, deren Verbindung abgelehnt wird.
Hintergrundinformationen zu VPC finden Sie unter VPC-Übersicht.
Eine Anleitung zum Erstellen eines externen Servers, auf den über das Internet zugegriffen werden kann, finden Sie unter Externen SFTP-Server erstellen. Sie können nicht mehr ändern, ob ein Server extern oder intern ist, nachdem der Server erstellt wurde.
Hinweis
Console
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud FTP API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
Erheben Sie die folgenden Informationen zu den Nutzern Ihres Servers:
- Eine Liste von Projekt-IDs oder Projektnummern, die auf den Server zugreifen dürfen.
- (Optional) Eine Liste von Projekt-IDs oder Projektnummern, die vom Zugriff auf den Server ausgeschlossen sind.
gcloud
-
Installieren Sie die Google Cloud CLI.
-
Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.
Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.
-
Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init -
Google Cloud -Projekt erstellen oder auswählen.
Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts
- Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
-
Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Project Creator“ (
roles/resourcemanager.projectCreator), die die Berechtigungresourcemanager.projects.createenthält. Informationen zum Zuweisen von Rollen
-
Erstellen Sie ein Projekt in Google Cloud :
gcloud projects create PROJECT_ID
Ersetzen Sie
PROJECT_IDdurch einen Namen für das Google Cloud -Projekt, das Sie erstellen. -
Wählen Sie das von Ihnen erstellte Projekt Google Cloud aus:
gcloud config set project PROJECT_ID
Ersetzen Sie
PROJECT_IDdurch den Namen Ihres Projekts in Google Cloud .
-
Wenn Sie für diese Anleitung ein vorhandenes Projekt verwenden, prüfen Sie, ob Sie die erforderlichen Berechtigungen haben. Wenn Sie ein neues Projekt erstellt haben, haben Sie bereits die erforderlichen Berechtigungen.
-
Prüfen Sie, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.
Aktivieren Sie die Cloud FTP API, falls sie noch nicht aktiviert ist:
Erforderliche Rollen zum Aktivieren von APIs
Zum Aktivieren von APIs benötigen Sie die Berechtigung
serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollengcloud services enable ftp.googleapis.com
-
Erheben Sie die folgenden Informationen zu den Nutzern Ihres Servers:
- Eine Liste von Projekt-IDs oder Projektnummern, die auf den Server zugreifen dürfen.
- (Optional) Eine Liste von Projekt-IDs oder Projektnummern, die vom Zugriff auf den Server ausgeschlossen sind.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud FTP Admin (roles/ftp.admin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines SFTP-Servers benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen eines SFTP-Servers erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind zum Erstellen eines SFTP-Servers erforderlich:
-
ftp.servers.create -
Wenn Sie die Google Cloud Console für diese Aufgabe verwenden:
-
ftp.servers.list -
ftp.locations.list
-
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Internen Server erstellen
Console
- Rufen Sie in der Google Cloud Console die Seite Cloud FTP auf.
Klicken Sie auf Server erstellen.
Geben Sie auf dem Tab Serverkonfiguration die grundlegenden Details für den Server ein:
Geben Sie im Feld Server-ID eine eindeutige ID für den Server ein.
Wählen Sie in der Liste Region den Google Cloud -Standort für den Server aus.
Erstellen Sie den Server am selben Standort wie den Cloud Storage-Bucket, in dem Ihre Daten gespeichert sind, um die schnellsten Datenübertragungsgeschwindigkeiten zu erzielen. Wenn der Standort des Buckets von Cloud FTP nicht unterstützt wird, wählen Sie den nächstgelegenen verfügbaren Standort aus.
Optional: Geben Sie einen Anzeigenamen für den Server ein.
Klicken Sie auf Weiter.
Konfigurieren Sie auf dem Tab Netzwerk und Sicherheit die Verbindung für den Server:
Wählen Sie Intern (nur VPC) aus.
Geben Sie im Abschnitt Akzeptierte Projekte die Nutzerprojekte an, die über Private Service Connect eine Verbindung zum Server herstellen dürfen. Gehen Sie dazu so vor:
Geben Sie im Feld Projekt-ID oder -nummer die Projekt-ID oder -nummer eines Projekts ein, das eine Verbindung herstellen darf. Beispiel:
example-allowed-projectGeben Sie im Feld Verbindungslimit die maximale Anzahl von Private Service Connect-Endpunkten ein, die im Nutzerprojekt erstellt werden können. Der Wert muss zwischen 1 und 250 Endpunkten liegen.
Wenn Sie weitere Projekte hinzufügen möchten, klicken Sie auf Akzeptiertes Projekt hinzufügen und wiederholen Sie die vorherigen Schritte.
(Optional) Wenn Sie verhindern möchten, dass Projekte eine Verbindung zum Server herstellen, klicken Sie im Bereich Abgelehnte Projekte auf Abgelehntes Projekt hinzufügen. Geben Sie die Projekt-ID oder ‑nummer eines Nutzerprojekts ein, das keine Verbindung zum Server herstellen darf.
Projekten in dieser Liste wird der Zugriff auf den Server verweigert, auch wenn sie in der Liste der zulässigen Projekte enthalten sind.
Klicken Sie auf Erstellen.
Es dauert etwa 10 Minuten, bis der Server erstellt ist.
gcloud
Führen Sie den Befehl gcloud alpha storage ftp servers create aus und geben Sie das Flag --access-type=INTERNAL an, um einen internen Server zu erstellen.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- SERVER_ID: eine eindeutige ID für den Server. Muss mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden. Kann Kleinbuchstaben, Ziffern und Bindestriche enthalten.
Darf nicht mit dem Präfix
googbeginnen oder den Stringgoogleenthalten, einschließlich ähnlicher, falsch geschriebener Versionen wieg00gle. Die maximale Länge beträgt 30 Zeichen. -
LOCATION_ID: der Google Cloud -Standort des Servers, z. B.
us-west1.Erstellen Sie den Server am selben Standort wie den Cloud Storage-Bucket, in dem Ihre Daten gespeichert sind, um die schnellsten Datenübertragungsgeschwindigkeiten zu erzielen. Wenn der Standort des Buckets von Cloud FTP nicht unterstützt wird, wählen Sie den nächstgelegenen verfügbaren Standort aus.
-
PROJECT_TO_ALLOW: die Projekt-ID oder -Nummer eines Nutzerprojekts, das über Private Service Connect eine Verbindung zum Server herstellen darf. Beispiel:
example-allowed-project. Sie müssen mindestens ein Projekt angeben.Sie können maximal 500 Projekte zulassen. Geben Sie mehrere Projekte und die zugehörigen Verbindungslimits in einer durch Kommas getrennten Liste an. z. B.
--consumer-accept-list=projectA=20,projectB=15 - CONNECTION_LIMIT: die maximale Anzahl von Private Service Connect-Endpunkten, die im Nutzerprojekt erstellt werden können. Der Wert muss zwischen 1 und 250 Endpunkten liegen.
-
(Optional) PROJECT_TO_REJECT: die Projekt-ID oder ‑nummer eines Nutzerprojekts, das keine Verbindung zum Server herstellen darf. Beispiel:
example-rejected-project. Projekten in dieser Liste wird der Zugriff auf den Server verweigert, auch wenn sie in der Liste der zulässigen Projekte enthalten sind.Sie können maximal 64 Projekte ablehnen. Geben Sie mehrere Projekte in einer durch Kommas getrennten Liste an.
Wenn Sie keine Projekte explizit ablehnen möchten, lassen Sie das Flag--consumer-reject-listweg.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud alpha storage ftp servers create SERVER_ID --access-type=INTERNAL \ --location=LOCATION_ID \ --consumer-accept-list=PROJECT_TO_ALLOW=CONNECTION_LIMIT \ --consumer-reject-list=PROJECT_TO_REJECT
Windows (PowerShell)
gcloud alpha storage ftp servers create SERVER_ID --access-type=INTERNAL ` --location=LOCATION_ID ` --consumer-accept-list=PROJECT_TO_ALLOW=CONNECTION_LIMIT ` --consumer-reject-list=PROJECT_TO_REJECT
Windows (cmd.exe)
gcloud alpha storage ftp servers create SERVER_ID --access-type=INTERNAL ^ --location=LOCATION_ID ^ --consumer-accept-list=PROJECT_TO_ALLOW=CONNECTION_LIMIT ^ --consumer-reject-list=PROJECT_TO_REJECT
Es dauert etwa 10 Minuten, bis der Server erstellt ist.
REST
Verwenden Sie zum Erstellen eines internen Servers die Methode servers.create und geben Sie eine internalConfig-Zugriffskonfiguration an.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die Google Cloud -Projekt-ID des Servers.
-
LOCATION_ID: der Google Cloud -Standort des Servers, z. B.
us-west1.Erstellen Sie den Server am selben Standort wie den Cloud Storage-Bucket, in dem Ihre Daten gespeichert sind, um die schnellsten Datenübertragungsgeschwindigkeiten zu erzielen. Wenn der Standort des Buckets von Cloud FTP nicht unterstützt wird, wählen Sie den nächstgelegenen verfügbaren Standort aus.
- SERVER_ID: eine eindeutige ID für den Server. Muss mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden. Kann Kleinbuchstaben, Ziffern und Bindestriche enthalten.
Darf nicht mit dem Präfix
googbeginnen oder den Stringgoogleenthalten, einschließlich ähnlicher, falsch geschriebener Versionen wieg00gle. Die maximale Länge beträgt 30 Zeichen. -
PROJECT_TO_ALLOW: die Projekt-ID oder -Nummer eines Nutzerprojekts, das über Private Service Connect eine Verbindung zum Server herstellen darf. Beispiel:
example-allowed-project. Sie müssen mindestens ein Projekt angeben.Sie können maximal 500 Projekte zulassen.
- CONNECTION_LIMIT: die maximale Anzahl von Private Service Connect-Endpunkten, die im Nutzerprojekt erstellt werden können. Der Wert muss zwischen 1 und 250 Endpunkten liegen.
-
(Optional) PROJECT_TO_REJECT: die Projekt-ID oder ‑nummer eines Nutzerprojekts, das keine Verbindung zum Server herstellen darf. Beispiel:
example-rejected-project. Projekten in dieser Liste wird der Zugriff auf den Server verweigert, auch wenn sie in der Liste der zulässigen Projekte enthalten sind.Sie können maximal 64 Projekte ablehnen.
Wenn Sie keine Projekte explizit ablehnen möchten, lassen Sie das Objekt
consumerRejectListweg.
HTTP-Methode und URL:
POST https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers?serverId=SERVER_ID
JSON-Text anfordern:
{
"accessType": "INTERNAL",
"internalConfig": {
"consumerAcceptList": [
{
"project": "projects/PROJECT_TO_ALLOW",
"connectionLimit": CONNECTION_LIMIT
}
],
"consumerRejectList": [
{
"project": "projects/PROJECT_TO_REJECT"
}
]
}
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort identifiziert einen Vorgang mit langer Ausführungszeit.Es dauert etwa 10 Minuten, bis der Server erstellt ist.
Clientbibliotheken
Wenn Sie einen internen Server erstellen möchten, legen Sie den Zugriffstyp auf „internal“ fest und geben Sie eine interne Zugriffskonfiguration an.
C#
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP C#.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP Go.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP Java.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP Node.js.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP PHP.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP Python.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud FTP finden Sie unter Cloud FTP-Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Cloud FTP Ruby.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud FTP zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.