내보내기: 커넥터 버전을 JSON 사양 파일로 다운로드합니다. 자세한 내용은 내보내기 및 가져오기를 참조하세요.
내보내기 및 가져오기
커넥터 사양을 내보내고 가져와 여러 Google Cloud 프로젝트 간에 커넥터를 공유할 수 있습니다. 연결 버전을 내보낸 후 사양을 동일한 프로젝트 또는 다른 Google Cloud 프로젝트로 가져올 수 있습니다. 지원 중단된 커넥터 버전 내보내기는 지원되지 않습니다.
필수 역할 및 권한
커스텀 커넥터를 내보내고 가져오는 데 필요한 권한을 얻으려면 관리자에게 다음의 IAM 역할을 부여해 달라고 요청하세요.
Cloud Storage 버킷에 대한 스토리지 객체 관리자(roles/storage.objectAdmin)
보안 비밀이 있는 프로젝트에 대한 보안 관리자(roles/iam.securityAdmin) 또는 관리자에게 보안 비밀이 있는 프로젝트에 대한 secretmanager.secrets.getIamPolicy 및 secretmanager.secrets.setIamPolicy 권한, 사용자 또는 서비스 계정을 부여해 달라고 요청할 수도 있습니다.
커스텀 커넥터의 JSON 사양 파일을 찾아서 선택합니다. 커넥터를 다른 프로젝트로 가져오는 경우 서비스 계정 필드가 미리 채워지지 않습니다.
커넥터가 이미 있는지 여부에 따라 다음 시나리오가 가능합니다.
같은 이름의 커넥터가 존재하지 않음:커스텀 커넥터 만들기 페이지가 표시됩니다. 가져온 JSON의 커넥터 버전이 미리 입력됩니다. 이 버전은 변경할 수 없습니다.
동일한 이름의 커넥터가 있지만 동일한 버전이 존재하지 않음: 해당 커넥터의 버전 만들기 페이지가 표시됩니다. 커넥터 유형, 이름, 설명과 같은 커넥터 속성은 기존 커넥터에서 미리 채워지며 가져온 JSON에서 덮어쓰기되지 않습니다. 하지만 커넥터 버전 세부정보 및 이름은 가져온 JSON에서 읽습니다. 버전 이름만 수정할 수 있습니다.
이름 및 버전이 동일한 커넥터가 있음: 버전이 이미 존재하며 JSON 사양을 가져올 때 새 버전이 사용된다는 경고 메시지가 표시됩니다. 가져오기를 클릭하면 해당 커넥터의 버전 만들기 페이지가 표시됩니다. 커넥터 유형, 이름, 설명과 같은 커넥터 속성은 기존 커넥터에서 미리 채워지며 가져온 JSON으로 덮어쓰기되지 않습니다. 하지만 가져온 JSON에서 버전 세부정보를 읽고 수정할 수 있습니다. 사용 가능한 최신 버전 번호가 버전 이름에 사용됩니다.
나머지 세부정보를 입력하고 만들기를 클릭합니다. 커넥터는 가져온 JSON 사양으로 생성됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-03(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."]]
