Aquí se muestra la lista de conectores personalizados.
Haz clic en el conector personalizado para el que deseas agregar una versión.
Se mostrará la página de detalles de la conexión.
Haz clic en Versiones.
En la página, se muestran todas las versiones del conector.
Haz clic en Crear. Se mostrará la página Crear versión nueva con el nuevo número de versión. Los pasos para crear una versión nueva son similares a los de crear un conector personalizado nuevo.
Esto significa que puedes crear una versión con conectividad directa o indirecta.
Aquí se muestra la lista de conectores personalizados.
Haz clic en el conector personalizado que tiene versiones.
Se mostrará la página de detalles de la conexión.
Haz clic en Versiones.
Aparecerán las versiones del conector seleccionado.
Haz clic en more_vertAcciones para seleccionar una de las siguientes opciones:
View Details: Para ver los detalles de la versión del conector personalizado.
Dar de baja la versión: Para dar de baja la versión.
Borrar: Para borrar la versión.
Export: Descarga la versión del conector como un archivo de especificación JSON. Para obtener más información, consulta Importa y exporta.
Importa y exporta
Puedes compartir el conector entre diferentes proyectos Google Cloud exportando e importando la especificación del conector. Puedes exportar cualquier versión de la conexión y, luego, importar la especificación al mismo proyecto o a proyectos Google Cloud diferentes. No se admite la exportación de versiones de conectores que ya no están disponibles.
Roles y permisos requeridos
Para obtener los permisos que
necesitas para importar y exportar un conector personalizado,
pídele a tu administrador que te otorgue los
siguientes roles de IAM:
Administrador de seguridad (roles/iam.securityAdmin)
en el proyecto en el que se encuentra el secreto. Como alternativa, también puedes pedirle a tu administrador que te otorgue a ti o a la cuenta de servicio los permisos secretmanager.secrets.getIamPolicy y secretmanager.secrets.setIamPolicy en el proyecto en el que se encuentra el secreto.
Busca y selecciona el archivo de especificación JSON para el conector personalizado. Si importas el conector a un proyecto diferente, el campo Cuenta de servicio no se completará previamente.
Según si el conector ya existe o no, se pueden dar las siguientes situaciones:
No existe un conector con el mismo nombre: Aparecerá la página Crear conector personalizado. La versión del conector en el archivo JSON importado se completa previamente. No se puede cambiar esta versión.
Ya existe un conector con el mismo nombre, pero no existe la misma versión: Aparecerá la página Crear versión para ese conector. Las propiedades del conector, como el tipo, el nombre y la descripción, se completan previamente a partir del conector existente y no se sobrescriben desde el JSON importado. Sin embargo, los detalles y el nombre de la versión del conector se leen del JSON importado. Solo se puede editar el nombre de la versión.
Ya existe un conector con el mismo nombre y versión: Aparece un mensaje de advertencia que indica que la versión ya existe y que se usará una nueva cuando importes la especificación JSON. Si haces clic en Importar, aparecerá la página Crear versión para ese conector. Las propiedades del conector, como el tipo, el nombre y la descripción, se completan previamente a partir del conector existente y no se reemplazan con el JSON importado. Sin embargo, los detalles de la versión se leen desde el JSON importado y se pueden editar. El número de versión disponible más reciente se usa para el nombre de la versión.
Completa los detalles restantes y haz clic en Crear. El conector se crea con la especificación JSON importada.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003ePre-GA offerings, including the custom connector features described, are subject to the "Pre-GA Offerings Terms" and are provided "as is" with potentially limited support.\u003c/p\u003e\n"],["\u003cp\u003eYou can create new versions of custom connectors, using either direct or indirect connectivity, through the Integration Connectors section of the Google Cloud Console.\u003c/p\u003e\n"],["\u003cp\u003eExisting custom connector versions can be managed via the Console, allowing you to view details, deprecate, delete, or export versions as a JSON specification file.\u003c/p\u003e\n"],["\u003cp\u003eCustom connector versions can be shared across different Google Cloud projects by exporting the connector's JSON specification and importing it into another project.\u003c/p\u003e\n"],["\u003cp\u003eSpecific IAM roles, including Storage Object Admin and Security Admin, are required to successfully export and import custom connectors.\u003c/p\u003e\n"]]],[],null,["# Manage custom connector versions\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\nManage custom connector versions\n================================\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 **Integration Connectors \\\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/connectors/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 **Integration Connectors \\\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/connectors/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 **Integration Connectors \\\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/connectors/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 **Integration Connectors \\\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/connectors/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."]]
