SFTP-Server aktualisieren

Sie können die Nutzer aktualisieren, die eine Verbindung zu einem Cloud FTP-Server herstellen dürfen, indem Sie die Zugriffskonfiguration des Servers aktualisieren. Sie können auch Metadaten wie den Anzeigenamen des Servers aktualisieren.

Nachdem ein Server erstellt wurde, können Sie nicht mehr ändern, ob er extern oder intern ist.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Cloud FTP-Administrator “ (roles/ftp.admin) für Ihr Projekt zuzuweisen, um die Berechtigung zum Aktualisieren eines SFTP-Servers zu erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die ftp.servers.update Berechtigung, die zum Aktualisieren eines SFTP-Servers erforderlich ist.

Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Zugriff für einen externen Server aktualisieren

REST

Verwenden Sie die servers.patch Methode, um die Zugriffskonfiguration für einen externen Server zu aktualisieren. Geben Sie im Abfrageparameter updateMask das Feld externalConfig an.

**Achtung** :Die CIDR-Blöcke, die Sie im Anfragetext angeben, überschreiben alle vorhandenen Werte.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die Google Cloud Projekt-ID des Servers.
• LOCATION_ID: der Standort des Servers, z. B. us-west1.
• SERVER_ID: die Server-ID.
• CIDR_BLOCK: ein CIDR-Block, der auf den Server zugreifen darf. Beispiel: 192.0.2.0/24. Sie müssen mindestens einen Wert angeben und können maximal 500 CIDR-Blöcke angeben. Verwenden Sie 0.0.0.0/0, um Verbindungen von allen IP-Adressen zuzulassen.

HTTP-Methode und URL:

PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=externalConfig

JSON-Text der Anfrage:

{
  "externalConfig": {
    "allowedCidrBlocks": [
      "CIDR_BLOCK"
    ]
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=externalConfig"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json, und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=externalConfig" | Select-Object -Expand Content

Die Antwort identifiziert einen Vorgang mit langer Ausführungszeit. Es dauert einige Sekunden, bis der Server aktualisiert ist.

Zugriff für einen internen Server aktualisieren

REST

Verwenden Sie die servers.patch Methode, um die Zugriffskonfiguration für einen internen Server zu aktualisieren. Geben Sie im Abfrageparameter updateMask das Feld internalConfig an.

**Achtung**: Die Listen der zulässigen und abgelehnten Nutzerprojekte, die Sie im Anfragetext angeben, überschreiben alle vorhandenen Werte.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die Google Cloud Projekt-ID des Servers.
• LOCATION_ID: der Standort des Servers, z. B. us-west1.
• SERVER_ID: die Server-ID.
• 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.
• CONNECTION_LIMIT: die maximale Anzahl von Private Service Connect Endpunkten, die im Nutzerprojekt erstellt werden können.
• (Optional) PROJECT_TO_REJECT: die Projekt-ID oder ‑nummer eines Nutzerprojekts, das keine Verbindung zum Server herstellen darf. Beispiel: example-rejected-project. Projekte in dieser Liste werden vom Zugriff auf den Server ausgeschlossen, auch wenn sie in der Liste der zulässigen Projekte enthalten sind. Wenn diese Liste leer ist, werden keine Projekte explizit abgelehnt.

HTTP-Methode und URL:

PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=internalConfig

JSON-Text der Anfrage:

{
  "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:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=internalConfig"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json, und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=internalConfig" | Select-Object -Expand Content

Die Antwort identifiziert einen Vorgang mit langer Ausführungszeit. Es dauert einige Sekunden, bis der Server aktualisiert ist.

Anzeigenamen eines Servers aktualisieren

REST

Verwenden Sie die servers.patch Methode, um Metadaten wie den Anzeigenamen eines SFTP-Servers zu aktualisieren. Geben Sie im Abfrageparameter updateMask eine durch Kommas getrennte Liste der zu aktualisierenden Felder an. Geben Sie im Anfragetext ein JSON-Objekt mit den festzulegenden Werten an.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die Google Cloud Projekt-ID des Servers.
• LOCATION_ID: der Standort des Servers, z. B. us-west1.
• SERVER_ID: die Server-ID.
• FIELDS_TO_UPDATE: eine durch Kommas getrennte Liste der zu aktualisierenden Felder relativ zur Server Ressource. Wenn Sie beispielsweise den Anzeigenamen aktualisieren möchten, geben Sie den Abfrageparameter updateMask=displayName an.
• DISPLAY_NAME: ein Anzeigename für den Server.

HTTP-Methode und URL:

PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=FIELDS_TO_UPDATE

JSON-Text der Anfrage:

{
  "displayName": "DISPLAY_NAME"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=FIELDS_TO_UPDATE"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json, und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=FIELDS_TO_UPDATE" | Select-Object -Expand Content

Die Antwort identifiziert einen Vorgang mit langer Ausführungszeit. Es dauert einige Sekunden, bis der Server aktualisiert ist.