Agent-Pools verwalten

Agents sind Softwareelemente, die von Transfer Service for On Premises Data zum Übertragen Ihrer Daten an Cloud Storage verwendet werden. Ein Agent-Pool ist eine Sammlung von Agents, die dieselbe Konfiguration verwenden, mit einheitlichem Zugriff und Sichtbarkeit auf Ihre Quelle und Ihr Ziel.

In dieser Anleitung wird beschrieben, wie Sie Transfer Service for On Premises Data verwenden.

Hinweis

Sie müssen bestimmte Berechtigungen für Ihr Projekt haben, um mit Agent-Pools arbeiten zu können. Weitere Informationen zu Berechtigungen und Rollen finden Sie unter Zugriffssteuerung mit IAM.

Aktuelle Berechtigungen ansehen

Agent-Pool erstellen

So erstellen Sie einen Agent-Pool:

Cloud Console

  1. Rufen Sie in der Cloud Console die Seite Transfer Service for On Premises Data auf.

    Zu „Transfer Service for On Premises Data“

  2. Klicken Sie auf Verbindungseinstellungen.

    Die Seite Agent-Pools wird angezeigt, auf der die vorhandenen Agent-Pools aufgeführt sind. Alle Projekte enthalten einen Standardpool mit dem Namen transfer_service_default.

  3. Klicken Sie auf Weiteren Pool erstellen.

  4. Benennen Sie den Pool und beschreiben Sie ihn eventuell.

  5. Sie können ein Bandbreitenlimit festlegen, das für den gesamten Pool gilt. Die angegebene Bandbreite in MB/s wird zwischen allen Agents im Pool aufgeteilt.

  6. Klicken Sie auf Erstellen.

REST API

Verwenden Sie projects.agentPools.create:

POST https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{agent_pool_id=AGENT_POOL_ID}:create

Wobei:

  • PROJECT_ID: die Projekt-ID ist, in der Sie den Agent-Pool erstellen.
  • AGENT_POOL_ID: die Agent-Pool-ID ist, die Sie erstellen.

Wenn ein Agent-Pool länger als 30 Minuten im Status Creating verbleibt, empfehlen wir, den Agent-Pool zu löschen und neu zu erstellen.

Der Widerruf der erforderlichen Übertragung für lokale Berechtigungen aus einem Projekt, während sich ein Agent-Pool im Status Creating befindet, führt zu einem falschen Dienstverhalten.

Agents einem Pool zuweisen

Neue Agent-Pools sind leer und ihnen müssen Agents zugewiesen sein. Ein Agent kann einem Agent-Pool nur zum Zeitpunkt der Erstellung des Agents über das Feld --agent-pool zugewiesen werden.

Wenn --agent-pool nicht angegeben ist, wird der Agent dem Pool transfer_service_default zugewiesen.

So erstellen Sie einen Agent und weisen ihn einem Pool zu:

  1. Wählen Sie auf der Seite Agent-Pools den Pool aus, dem Sie die Agents zuweisen möchten.

  2. Klicken Sie auf Agent installieren. Die Installationsanleitung für den Agent wird angezeigt.

  3. Folgen Sie der Anleitung zum Erstellen des Agents in diesem Agent-Pool.

Weitere Optionen finden Sie unter Erweiterte Agent-Einrichtung.

Informationen zum Verwalten von Agents finden Sie unter Übertragung für lokale Agents verwalten.

Agent-Pool einem Job zuweisen

Nachdem der Agent-Pool erstellt wurde, kann er einem Job während der Joberstellung oder -aktualisierung zugewiesen werden.

Agent-Pool aktualisieren

Sie können den Anzeigenamen und das Bandbreitenlimit eines Agent-Pools aktualisieren.

So aktualisieren Sie einen Agent-Pool:

Cloud Console

Rufen Sie in der Cloud Console die Seite Agent-Pools auf.

Zu „Agent-Pools“

Sie können die folgenden Elemente bearbeiten:

  • Anzeigename des Agent-Pools: Klicken Sie auf Bearbeiten neben dem Namen des aktuellen Agent-Pools.

  • Bandbreitenlimit des Agent-Pools: Klicken Sie auf Bandbreitenlimit festlegen und geben Sie ein neues Bandbreitenlimit im Dialogfeld Bandbreitenlimit festlegen ein. Klicken Sie auf Limit festlegen, um das neue Bandbreitenlimit anzuwenden. Die Bandbreite wird von allen Agents im Pool gemeinsam genutzt.

REST API

Verwenden Sie zum Aktualisieren eines Agent-Pools projects.agentPools.patch mit einer Feldmaske der zu aktualisierenden Felder. Die folgenden Agent-Pool-Felder können aktualisiert werden:

Wenn Sie beispielsweise displayName auf my-transfer aktualisieren möchten, geben Sie die Feldmaske "displayName,my-transfer" an.

Im Folgenden finden Sie eine Beispiel-Patch-Anfrage zum Aktualisieren des Anzeigenamens:

PATCH https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{AGENT_POOL_ID}:"displayName,NEW_NAME"

Wobei:

  • PROJECT_ID: die Projekt-ID ist, in der Sie den Agent-Pool aktualisieren.
  • AGENT_POOL_ID: die Agent-Pool-ID ist, die Sie aktualisieren.
  • NEW_NAME: der neue Anzeigename für diesen Agent-Pool ist.

Das folgende Beispiel zeigt eine Patch-Anfrage zum Aktualisieren des Bandbreitenlimits:

PATCH https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{AGENT_POOL_ID}:"bandwidthLimit,NEW_LIMIT"

Wobei:

  • PROJECT_ID: die Projekt-ID ist, in der Sie den Agent-Pool aktualisieren.
  • AGENT_POOL_ID: die Agent-Pool-ID ist, die Sie aktualisieren.
  • NEW_LIMIT: das neue Bandbreitenlimit für diesen Agent-Pool ist.

Agent-Pool löschen

Sie können einen Agent-Pool löschen, der keine aktiven Agents und keine aktiven Jobausführungen enthält.

So löschen Sie einen Agent-Pool:

Cloud Console

  1. Rufen Sie in der Cloud Console die Seite Agent-Pools auf.

    Zu „Agent-Pools“

  2. Klicken Sie auf Löschen. Lesen Sie das Pop-up-Fenster und klicken Sie zur Bestätigung auf Löschen.

    Wenn die Löschschaltfläche nicht aktiv ist, müssen Sie alle Agents und Jobs beenden, die diesem Pool zugeordnet sind.

REST API

Verwenden Sie projects.agentPools.delete:

DELETE https://storagetransfer.googleapis.com/v1/{name=PROJECT_ID/*/agentPools/}

Wobei:

  • PROJECT_ID: die Projekt-ID ist, aus der Sie den Agent-Pool löschen.

Agent-Pool abrufen

So rufen Sie einen Agent-Pool ab:

Cloud Console

Rufen Sie in der Cloud Console die Seite Agent-Pools auf.

Zu „Agent-Pools“

Auf dieser Seite werden eine Liste aller Agent-Pools und die folgenden Informationen für jeden Agent-Pool angezeigt:

  • Name des Agent-Pools
  • Verbindungsstatus
  • Anzahl der verbundenen Agents
  • Bandbreitenlimit, falls festgelegt
  • Anzahl der verknüpften Übertragungsjobs
  • Anzeigename des Agent-Pools

Klicken Sie auf den Namen eines Agent-Pools, um diesen Agent-Pool anzuzeigen.

Die folgenden Aktionen sind auf der Informationsseite eines Agent-Pools verfügbar:

  • Agent installieren: Zeigt eine Anleitung zum Installieren von Transfer for On Premises-Agents an.
  • Agent anhalten: Wählen Sie einen Agent in der Tabelle aus und klicken Sie dann auf Agent beenden.
  • Übertragungsjobs auflisten: Klicken Sie auf Übertragungsjobs, um die Übertragungsjobs-Agents in diesem Pool aufzurufen.

REST API

Verwenden Sie projects.agentPools.get:

GET https://storagetransfer.googleapis.com/v1/{name=PROJECT_ID/*/agentPools/}

Wobei:

  • PROJECT_ID: die Projekt-ID ist, von der Sie einen Agent-Pool erhalten.

Agent-Pools auflisten

So listen Sie Ihre Agent-Pools auf:

Cloud Console

Rufen Sie in der Cloud Console die Seite Agent-Pools auf.

Zu „Agent-Pools“

Alle Agent-Pools werden angezeigt.

REST API

Verwenden Sie projects.agentPools.list:

GET https://storagetransfer.googleapis.com/v1/projects/{project_id=PROJECT_ID}/agentPools

Wobei:

  • PROJECT_ID: die Projekt-ID ist, von der Sie einen Agent-Pool erhalten.