Versionen benutzerdefinierter Connectors verwalten
Version eines benutzerdefinierten Connectors erstellen
So erstellen Sie eine benutzerdefinierte Connector-Version:
Rufen Sie in der Console die Seite Application Integration > Benutzerdefinierte Connectors auf und wählen Sie ein Google Cloud Projekt aus oder erstellen Sie eines.
Daraufhin wird die Liste der benutzerdefinierten Connectors angezeigt.
Klicken Sie auf den benutzerdefinierten Connector, für den Sie eine Version hinzufügen möchten.
Die Seite mit den Verbindungsdetails wird angezeigt.
Klicken Sie auf Versionen.
Auf der Seite werden alle Versionen des Connectors angezeigt.
Klicken Sie auf Erstellen. Die Seite Neue Version erstellen wird mit der neuen Versionsnummer angezeigt. Die Schritte zum Erstellen einer neuen Version ähneln denen zum Erstellen eines neuen benutzerdefinierten Connectors.
Das bedeutet, dass Sie eine Version mit direkter oder indirekter Verbindung erstellen können.
Version eines benutzerdefinierten Connectors verwalten
So bearbeiten Sie einen benutzerdefinierten Connector:
Rufen Sie in der Console die Seite Application Integration > Benutzerdefinierte Connectors auf und wählen Sie ein Google Cloud Projekt aus oder erstellen Sie eines.
Daraufhin wird die Liste der benutzerdefinierten Connectors angezeigt.
Klicken Sie auf den benutzerdefinierten Connector mit Versionen.
Die Seite mit den Verbindungsdetails wird angezeigt.
Klicken Sie auf Versionen.
Die Versionen für den ausgewählten Connector werden angezeigt.
Klicken Sie auf more_vertAktionen, um eine der folgenden Optionen auszuwählen:
View Details (Details ansehen): Hier können Sie die Versionsdetails des benutzerdefinierten Connectors aufrufen.
Version einstellen: Damit wird die Version eingestellt.
Löschen: Hiermit löschen Sie die Version.
Exportieren: Hiermit wird die Connector-Version als JSON-Spezifikationsdatei heruntergeladen. Weitere Informationen finden Sie unter Exportieren und importieren.
Export und Import
Sie können den Connector für verschiedene Google Cloud -Projekte freigeben, indem Sie die Connectorspezifikation exportieren und importieren. Sie können jede Verbindungsversion exportieren und die Spezifikation dann in dasselbe oder in andere Google Cloud Projekte importieren. Das Exportieren von eingestellten Connector-Versionen wird nicht unterstützt.
Erforderliche Rollen und Berechtigungen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Exportieren und Importieren eines benutzerdefinierten Connectors benötigen:
Sicherheitsadministrator (roles/iam.securityAdmin)
für das Projekt, in dem das Secret vorhanden ist. Alternativ können Sie Ihren Administrator auch bitten, Ihnen oder dem Dienstkonto die Berechtigungen secretmanager.secrets.getIamPolicy und secretmanager.secrets.setIamPolicy für das Projekt zu erteilen, in dem das Secret vorhanden ist.
Rufen Sie in der Console die Seite Application Integration > Benutzerdefinierte Connectors auf und wählen Sie ein Google Cloud Projekt aus oder erstellen Sie eines.
Klicken Sie auf den benutzerdefinierten Connector, den Sie exportieren möchten. Die Übersichtsseite des benutzerdefinierten Connectors wird geöffnet.
Klicken Sie auf Versionen. Eine Liste der Versionen des benutzerdefinierten Connectors wird angezeigt.
Klicken Sie auf das Dreipunkt-Menü more_vertWeitere Aktionen und dann auf das Dreipunkt-Menü uploadExportieren. Eine JSON-Spezifikationsdatei für den benutzerdefinierten Connector wird heruntergeladen.
Benutzerdefinierten Connector importieren
So importieren Sie eine Connector-Version:
Rufen Sie in der Console die Seite Application Integration > Benutzerdefinierte Connectors auf und wählen Sie ein Google Cloud Projekt aus oder erstellen Sie eines.
Die Seite Benutzerdefinierte Connectors wird angezeigt.
Klicken Sie auf downloadImportieren.
Suchen Sie nach der JSON-Spezifikationsdatei für den benutzerdefinierten Connector und wählen Sie sie aus. Wenn Sie den Connector in ein anderes Projekt importieren, ist das Feld Dienstkonto nicht vorausgefüllt.
Je nachdem, ob der Connector bereits vorhanden ist oder nicht, sind die folgenden Szenarien möglich:
Connector mit demselben Namen ist nicht vorhanden:Die Seite Benutzerdefinierten Connector erstellen wird angezeigt. Die Connector-Version in der importierten JSON-Datei ist bereits ausgefüllt. Diese Version kann nicht geändert werden.
Connector with the same name exists but the same version doesn't exist (Es ist ein Connector mit demselben Namen vorhanden, aber nicht mit derselben Version): Die Seite Create version (Version erstellen) für diesen Connector wird angezeigt. Connector-Attribute wie Connectortyp, Name und Beschreibung werden aus dem vorhandenen Connector übernommen und nicht durch die importierte JSON-Datei überschrieben. Die Details und der Name der Connector-Version werden jedoch aus dem importierten JSON gelesen. Nur der Versionsname kann bearbeitet werden.
Connector mit demselben Namen und derselben Version ist bereits vorhanden:Es wird eine Warnmeldung angezeigt, dass die Version bereits vorhanden ist und beim Importieren der JSON-Spezifikation eine neue Version verwendet wird. Wenn Sie auf Importieren klicken, wird die Seite Version erstellen für diesen Connector angezeigt. Connector-Attribute wie Connectortyp, Name und Beschreibung werden aus dem vorhandenen Connector übernommen und nicht durch den importierten JSON-Code überschrieben. Die Versionsdetails werden jedoch aus dem importierten JSON gelesen und können bearbeitet werden. Für den Versionsnamen wird die neueste verfügbare Versionsnummer verwendet.
Geben Sie die restlichen Details ein und klicken Sie auf Erstellen. Der Connector wird mit der importierten JSON-Spezifikation erstellt.
Kontingente und Limits
Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-03 (UTC)."],[[["\u003cp\u003eThis document guides you through creating and managing custom connector versions within Application Integration, including how to create a new version with direct or indirect connectivity.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage a custom connector version by viewing details, deprecating, deleting, or exporting it as a JSON specification file.\u003c/p\u003e\n"],["\u003cp\u003eConnectors can be shared between different Google Cloud projects by exporting the connector specification as a JSON file and then importing it into another project.\u003c/p\u003e\n"],["\u003cp\u003eImporting a connector specification allows you to create a new connector, or add a new version to an existing connector, depending on whether the connector name or version already exists.\u003c/p\u003e\n"],["\u003cp\u003eTo export or import custom connectors, ensure you have the required IAM roles, including \u003ccode\u003eStorage Object Admin\u003c/code\u003e and \u003ccode\u003eSecurity Admin\u003c/code\u003e, or the equivalent permissions.\u003c/p\u003e\n"]]],[],null,["# Manage custom connector version\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nManage custom connector version\n===============================\n\n|\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nCreate a custom connector version\n---------------------------------\n\nTo create a custom connector version, follow these steps:\n\n1. In the [Console](https://console.cloud.google.com/), go to the **Application Integration \\\u003e Custom connectors** page, and then select or create a Google Cloud project.\n\n\n [Go to the Custom connectors page](https://console.cloud.google.com/integrations/custom-connectors)\n\n This displays the list of custom connectors.\n2. Click the custom connector for which you want to add a version. The displays the connection details page.\n\n3. Click **Versions** .\n\n The page displays all the versions of the connector.\n4. Click **Create** . This displays the **Create new version** page with the new version number. The steps to create a new version are similar to that of creating a new custom connector. It means that you can create a version with direct or indirect connectivity.\n - For creating a version with direct connectivity, do steps (from step 3 onwards) as documented in [Create a custom connector with direct connectivity](/integration-connectors/docs/create-custom-connector#create-a-custom-connector-with-direct-connectivity).\n - For creating a version with indirect connectivity, do steps (from step 3 onwards) as documented in [Create a custom connector with indirect connectivity](/integration-connectors/docs/create-custom-connector#create-a-custom-connector-with-indirect-connectivity).\n\nManage a custom connector version\n---------------------------------\n\nTo edit a custom connector, do the following steps:\n\n1. In the [Console](https://console.cloud.google.com/), go to the **Application Integration \\\u003e Custom connectors** page, and then select or create a Google Cloud project.\n\n\n [Go to the Custom connectors page](https://console.cloud.google.com/integrations/custom-connectors)\n\n This displays the list of custom connectors.\n2. Click the custom connector that has versions. The displays the connection details page.\n\n3. Click **Versions** .\n\n The versions for the selected connector appears.\n4. Click more_vert **Actions** to select one of the following options:\n - **View Details**: To view the custom connector version details.\n - **Deprecate Version**: To deprecate the version.\n - **Delete**: To delete the version.\n - **Export** : To downloads the connector version as a JSON specification file. For more information, see [Export and import](#export-import).\n\nExport and import\n-----------------\n\nYou can share the connector between different Google Cloud projects by exporting and importing the connector specification. You can export any connection version and then import the specification to the same project or different Google Cloud projects. Exporting deprecated connector versions is not supported.\n\n### Required roles and permissions\n\n\nTo get the permissions that\nyou need to export and import a custom connector,\n\nask your administrator to grant you the\nfollowing IAM roles:\n\n- [Storage Object Admin](/iam/docs/roles-permissions/storage#storage.objectAdmin) (`roles/storage.objectAdmin`) on the Cloud Storage bucket\n- [Security Admin](/iam/docs/roles-permissions/iam#iam.securityAdmin) (`roles/iam.securityAdmin`) on the project in which the secret is present. Alternatively, you can also ask your administrator to grant you or the service account, the `secretmanager.secrets.getIamPolicy` and `secretmanager.secrets.setIamPolicy` permissions on the project in which the secret is present.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\n### Export a custom connector\n\nTo export a connector version, follow these steps:\n\n1. In the [Console](https://console.cloud.google.com/), go to the **Application Integration \\\u003e Custom connectors** page, and then select or create a Google Cloud project.\n\n\n [Go to the Custom connectors page](https://console.cloud.google.com/integrations/custom-connectors)\n2. Click the custom connector that you want to export. The custom connector's overview page opens.\n3. Click **Versions**. A list of versions of the custom connector is displayed.\n4. Click more_vert **More Actions** and then click upload **Export**. A JSON specification file for the custom connector is downloaded.\n\n### Import a custom connector\n\nTo import a connector version, follow these steps:\n\n1. In the [Console](https://console.cloud.google.com/), go to the **Application Integration \\\u003e Custom connectors** page, and then select or create a Google Cloud project.\n\n\n [Go to the Custom connectors page](https://console.cloud.google.com/integrations/custom-connectors)\nThe **Custom connectors** page appears.\n2. Click download **Import**.\n3. Browse and select the JSON specification file for the custom connector. If you are importing the connector to a different project, then the **Service account** field is not prefilled.\n\n \u003cbr /\u003e\n\n | **Note:** Ensure that the connector that you want to import is not deprecated.\n\n Based on whether the connector already exists or not, the following scenarios are possible:\n - **Connector with the same name doesn't exist:** The **Create custom connector** page appears. The connector version in the imported JSON is prefilled. This version can't be changed.\n - **Connector with the same name exists but the same version doesn't exist:** The **Create version** page for that connector appears. Connector properties like connector type, name, description are prefilled from the existing connector and are not overwritten from the imported JSON. However, the connector version details and name are read from the imported JSON. Only the version name can be edited.\n - **Connector with the same name and version exists:** A warning message appears stating that the version already exists and a new version will be used when you import the JSON specification. If you click **Import** , the **Create version** page for that connector appears. Connector properties like the connector type, name, description are prefilled from the existing connector and are not overwritten by the imported JSON. However, the version details are read from the imported JSON and can be edited. The latest available version number is used for the version name.\n4. Fill the remaining details and click **Create**. The connector is created with the imported JSON specification.\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
