import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * This resource provides the Migration resource in Oracle Cloud Infrastructure Database Migration service. * Api doc link for the resource: https://docs.oracle.com/iaas/api/#/en/database-migration/latest/Migration * * Example terraform configs related to the resource : https://github.com/oracle/terraform-provider-oci/tree/master/examples/databasemigration * * Create a Migration resource that contains all the details to perform the * database migration operation, such as source and destination database * details, credentials, etc. * * Note: If you wish to use the DMS deprecated API version /20210929 it is necessary to pin the Terraform Provider version to v5.47.0. Newer Terraform provider versions will not support the DMS deprecated API version /20210929 * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as oci from "@pulumi/oci"; * * const testMigration = new oci.databasemigration.Migration("test_migration", { * compartmentId: compartmentId, * databaseCombination: migrationDatabaseCombination, * type: migrationType, * advancedParameters: [{ * dataType: migrationAdvancedParametersDataType, * name: migrationAdvancedParametersName, * value: migrationAdvancedParametersValue, * }], * advisorSettings: { * isIgnoreErrors: migrationAdvisorSettingsIsIgnoreErrors === "true", * isSkipAdvisor: migrationAdvisorSettingsIsSkipAdvisor === "true", * }, * assessmentId: testAssessment.id, * bulkIncludeExcludeData: migrationBulkIncludeExcludeData, * dataTransferMediumDetails: { * type: migrationDataTransferMediumDetailsType, * accessKeyId: testKey.id, * name: migrationDataTransferMediumDetailsName, * objectStorageBucket: { * bucket: migrationDataTransferMediumDetailsObjectStorageBucketBucket, * namespace: migrationDataTransferMediumDetailsObjectStorageBucketNamespace, * }, * region: migrationDataTransferMediumDetailsRegion, * secretAccessKey: migrationDataTransferMediumDetailsSecretAccessKey, * sharedStorageMountTargetId: testMountTarget.id, * source: { * kind: migrationDataTransferMediumDetailsSourceKind, * ociHome: migrationDataTransferMediumDetailsSourceOciHome, * walletLocation: migrationDataTransferMediumDetailsSourceWalletLocation, * }, * target: { * kind: migrationDataTransferMediumDetailsTargetKind, * ociHome: migrationDataTransferMediumDetailsTargetOciHome, * walletLocation: migrationDataTransferMediumDetailsTargetWalletLocation, * }, * }, * definedTags: { * "foo-namespace.bar-key": "value", * }, * description: migrationDescription, * displayName: migrationDisplayName, * excludeObjects: [{ * object: migrationExcludeObjectsObject, * isOmitExcludedTableFromReplication: migrationExcludeObjectsIsOmitExcludedTableFromReplication === "true", * owner: migrationExcludeObjectsOwner, * schema: migrationExcludeObjectsSchema, * type: migrationExcludeObjectsType, * }], * freeformTags: migrationFreeformTags, * ggsDetails: { * acceptableLag: Number(migrationGgsDetailsAcceptableLag), * extract: { * longTransDuration: Number(migrationGgsDetailsExtractLongTransDuration), * performanceProfile: migrationGgsDetailsExtractPerformanceProfile, * }, * replicat: { * performanceProfile: migrationGgsDetailsReplicatPerformanceProfile, * }, * }, * hubDetails: { * keyId: testKey.id, * restAdminCredentials: { * password: migrationHubDetailsRestAdminCredentialsPassword, * username: migrationHubDetailsRestAdminCredentialsUsername, * }, * url: migrationHubDetailsUrl, * vaultId: testVault.id, * acceptableLag: Number(migrationHubDetailsAcceptableLag), * computeId: testCompute.id, * extract: { * longTransDuration: Number(migrationHubDetailsExtractLongTransDuration), * performanceProfile: migrationHubDetailsExtractPerformanceProfile, * }, * replicat: { * performanceProfile: migrationHubDetailsReplicatPerformanceProfile, * }, * }, * includeObjects: [{ * object: migrationIncludeObjectsObject, * isOmitExcludedTableFromReplication: migrationIncludeObjectsIsOmitExcludedTableFromReplication === "true", * owner: migrationIncludeObjectsOwner, * schema: migrationIncludeObjectsSchema, * type: migrationIncludeObjectsType, * }], * initialLoadSettings: { * jobMode: migrationInitialLoadSettingsJobMode, * compatibilities: migrationInitialLoadSettingsCompatibility, * dataPumpParameters: { * estimate: migrationInitialLoadSettingsDataPumpParametersEstimate, * excludeParameters: migrationInitialLoadSettingsDataPumpParametersExcludeParameters, * exportParallelismDegree: Number(migrationInitialLoadSettingsDataPumpParametersExportParallelismDegree), * importParallelismDegree: Number(migrationInitialLoadSettingsDataPumpParametersImportParallelismDegree), * isCluster: migrationInitialLoadSettingsDataPumpParametersIsCluster === "true", * tableExistsAction: migrationInitialLoadSettingsDataPumpParametersTableExistsAction, * }, * exportDirectoryObject: { * name: migrationInitialLoadSettingsExportDirectoryObjectName, * path: migrationInitialLoadSettingsExportDirectoryObjectPath, * }, * handleGrantErrors: migrationInitialLoadSettingsHandleGrantErrors, * importDirectoryObject: { * name: migrationInitialLoadSettingsImportDirectoryObjectName, * path: migrationInitialLoadSettingsImportDirectoryObjectPath, * }, * isConsistent: migrationInitialLoadSettingsIsConsistent === "true", * isIgnoreExistingObjects: migrationInitialLoadSettingsIsIgnoreExistingObjects === "true", * isTzUtc: migrationInitialLoadSettingsIsTzUtc === "true", * metadataRemaps: [{ * newValue: migrationInitialLoadSettingsMetadataRemapsNewValue, * oldValue: migrationInitialLoadSettingsMetadataRemapsOldValue, * type: migrationInitialLoadSettingsMetadataRemapsType, * }], * primaryKeyCompatibility: migrationInitialLoadSettingsPrimaryKeyCompatibility, * tablespaceDetails: { * targetType: migrationInitialLoadSettingsTablespaceDetailsTargetType, * blockSizeInKbs: migrationInitialLoadSettingsTablespaceDetailsBlockSizeInKbs, * extendSizeInMbs: Number(migrationInitialLoadSettingsTablespaceDetailsExtendSizeInMbs), * isAutoCreate: migrationInitialLoadSettingsTablespaceDetailsIsAutoCreate === "true", * isBigFile: migrationInitialLoadSettingsTablespaceDetailsIsBigFile === "true", * remapTarget: migrationInitialLoadSettingsTablespaceDetailsRemapTarget, * }, * }, * sourceContainerDatabaseConnectionId: testConnection.id, * sourceDatabaseConnectionId: testConnection.id, * sourceStandbyDatabaseConnectionId: testConnection.id, * targetDatabaseConnectionId: testConnection.id, * }); * ``` * * ## Import * * Migrations can be imported using the `id`, e.g. * * ```sh * $ pulumi import oci:DatabaseMigration/migration:Migration test_migration "id" * ``` */ export declare class Migration extends pulumi.CustomResource { /** * Get an existing Migration resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: MigrationState, opts?: pulumi.CustomResourceOptions): Migration; /** * Returns true if the given object is an instance of Migration. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is Migration; /** * (Updatable) List of Migration Parameter objects. */ readonly advancedParameters: pulumi.Output; /** * (Updatable) Optional Pre-Migration advisor settings. */ readonly advisorSettings: pulumi.Output; /** * The OCID of the resource being referenced. */ readonly assessmentId: pulumi.Output; /** * Specifies the database objects to be excluded from the migration in bulk. The definition accepts input in a CSV format, newline separated for each entry. More details can be found in the documentation. */ readonly bulkIncludeExcludeData: pulumi.Output; /** * (Updatable) The OCID of the resource being referenced. */ readonly compartmentId: pulumi.Output; /** * (Updatable) Optional additional properties for data transfer. */ readonly dataTransferMediumDetails: pulumi.Output; /** * (Updatable) The combination of source and target databases participating in a migration. Example: ORACLE means the migration is meant for migrating Oracle source and target databases. */ readonly databaseCombination: pulumi.Output; /** * (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace.bar-key": "value"}` */ readonly definedTags: pulumi.Output<{ [key: string]: string; }>; /** * (Updatable) A user-friendly description. Does not have to be unique, and it's changeable. Avoid entering confidential information. */ readonly description: pulumi.Output; /** * (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. */ readonly displayName: pulumi.Output; /** * Database objects to exclude from migration, cannot be specified alongside 'includeObjects' */ readonly excludeObjects: pulumi.Output; /** * The OCID of the resource being referenced. */ readonly executingJobId: pulumi.Output; /** * (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"} */ readonly freeformTags: pulumi.Output<{ [key: string]: string; }>; /** * (Updatable) Optional settings for Oracle GoldenGate processes */ readonly ggsDetails: pulumi.Output; /** * (Updatable) Details about Oracle GoldenGate Microservices. */ readonly hubDetails: pulumi.Output; /** * Database objects to include from migration, cannot be specified alongside 'excludeObjects' */ readonly includeObjects: pulumi.Output; /** * (Updatable) Optional settings for Data Pump Export and Import jobs */ readonly initialLoadSettings: pulumi.Output; /** * Additional status related to the execution and current state of the Migration. */ readonly lifecycleDetails: pulumi.Output; /** * (Updatable) The OCID of the resource being referenced. */ readonly sourceContainerDatabaseConnectionId: pulumi.Output; /** * (Updatable) The OCID of the resource being referenced. */ readonly sourceDatabaseConnectionId: pulumi.Output; /** * (Updatable) The OCID of the resource being referenced. */ readonly sourceStandbyDatabaseConnectionId: pulumi.Output; /** * The current state of the Migration resource. */ readonly state: pulumi.Output; /** * Usage of system tag keys. These predefined keys are scoped to namespaces. Example: `{"orcl-cloud.free-tier-retained": "true"}` */ readonly systemTags: pulumi.Output<{ [key: string]: string; }>; /** * (Updatable) The OCID of the resource being referenced. */ readonly targetDatabaseConnectionId: pulumi.Output; /** * An RFC3339 formatted datetime string such as `2016-08-25T21:10:29.600Z`. */ readonly timeCreated: pulumi.Output; /** * An RFC3339 formatted datetime string such as `2016-08-25T21:10:29.600Z`. */ readonly timeLastMigration: pulumi.Output; /** * An RFC3339 formatted datetime string such as `2016-08-25T21:10:29.600Z`. */ readonly timeUpdated: pulumi.Output; /** * (Updatable) The type of the migration to be performed. Example: ONLINE if no downtime is preferred for a migration. This method uses Oracle GoldenGate for replication. * * ** IMPORTANT ** * Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values */ readonly type: pulumi.Output; /** * You can optionally pause a migration after a job phase. This property allows you to optionally specify the phase after which you can pause the migration. */ readonly waitAfter: pulumi.Output; /** * Create a Migration resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: MigrationArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering Migration resources. */ export interface MigrationState { /** * (Updatable) List of Migration Parameter objects. */ advancedParameters?: pulumi.Input[] | undefined>; /** * (Updatable) Optional Pre-Migration advisor settings. */ advisorSettings?: pulumi.Input; /** * The OCID of the resource being referenced. */ assessmentId?: pulumi.Input; /** * Specifies the database objects to be excluded from the migration in bulk. The definition accepts input in a CSV format, newline separated for each entry. More details can be found in the documentation. */ bulkIncludeExcludeData?: pulumi.Input; /** * (Updatable) The OCID of the resource being referenced. */ compartmentId?: pulumi.Input; /** * (Updatable) Optional additional properties for data transfer. */ dataTransferMediumDetails?: pulumi.Input; /** * (Updatable) The combination of source and target databases participating in a migration. Example: ORACLE means the migration is meant for migrating Oracle source and target databases. */ databaseCombination?: pulumi.Input; /** * (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace.bar-key": "value"}` */ definedTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) A user-friendly description. Does not have to be unique, and it's changeable. Avoid entering confidential information. */ description?: pulumi.Input; /** * (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. */ displayName?: pulumi.Input; /** * Database objects to exclude from migration, cannot be specified alongside 'includeObjects' */ excludeObjects?: pulumi.Input[] | undefined>; /** * The OCID of the resource being referenced. */ executingJobId?: pulumi.Input; /** * (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"} */ freeformTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) Optional settings for Oracle GoldenGate processes */ ggsDetails?: pulumi.Input; /** * (Updatable) Details about Oracle GoldenGate Microservices. */ hubDetails?: pulumi.Input; /** * Database objects to include from migration, cannot be specified alongside 'excludeObjects' */ includeObjects?: pulumi.Input[] | undefined>; /** * (Updatable) Optional settings for Data Pump Export and Import jobs */ initialLoadSettings?: pulumi.Input; /** * Additional status related to the execution and current state of the Migration. */ lifecycleDetails?: pulumi.Input; /** * (Updatable) The OCID of the resource being referenced. */ sourceContainerDatabaseConnectionId?: pulumi.Input; /** * (Updatable) The OCID of the resource being referenced. */ sourceDatabaseConnectionId?: pulumi.Input; /** * (Updatable) The OCID of the resource being referenced. */ sourceStandbyDatabaseConnectionId?: pulumi.Input; /** * The current state of the Migration resource. */ state?: pulumi.Input; /** * Usage of system tag keys. These predefined keys are scoped to namespaces. Example: `{"orcl-cloud.free-tier-retained": "true"}` */ systemTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) The OCID of the resource being referenced. */ targetDatabaseConnectionId?: pulumi.Input; /** * An RFC3339 formatted datetime string such as `2016-08-25T21:10:29.600Z`. */ timeCreated?: pulumi.Input; /** * An RFC3339 formatted datetime string such as `2016-08-25T21:10:29.600Z`. */ timeLastMigration?: pulumi.Input; /** * An RFC3339 formatted datetime string such as `2016-08-25T21:10:29.600Z`. */ timeUpdated?: pulumi.Input; /** * (Updatable) The type of the migration to be performed. Example: ONLINE if no downtime is preferred for a migration. This method uses Oracle GoldenGate for replication. * * ** IMPORTANT ** * Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values */ type?: pulumi.Input; /** * You can optionally pause a migration after a job phase. This property allows you to optionally specify the phase after which you can pause the migration. */ waitAfter?: pulumi.Input; } /** * The set of arguments for constructing a Migration resource. */ export interface MigrationArgs { /** * (Updatable) List of Migration Parameter objects. */ advancedParameters?: pulumi.Input[] | undefined>; /** * (Updatable) Optional Pre-Migration advisor settings. */ advisorSettings?: pulumi.Input; /** * The OCID of the resource being referenced. */ assessmentId?: pulumi.Input; /** * Specifies the database objects to be excluded from the migration in bulk. The definition accepts input in a CSV format, newline separated for each entry. More details can be found in the documentation. */ bulkIncludeExcludeData?: pulumi.Input; /** * (Updatable) The OCID of the resource being referenced. */ compartmentId: pulumi.Input; /** * (Updatable) Optional additional properties for data transfer. */ dataTransferMediumDetails?: pulumi.Input; /** * (Updatable) The combination of source and target databases participating in a migration. Example: ORACLE means the migration is meant for migrating Oracle source and target databases. */ databaseCombination: pulumi.Input; /** * (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace.bar-key": "value"}` */ definedTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) A user-friendly description. Does not have to be unique, and it's changeable. Avoid entering confidential information. */ description?: pulumi.Input; /** * (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. */ displayName?: pulumi.Input; /** * Database objects to exclude from migration, cannot be specified alongside 'includeObjects' */ excludeObjects?: pulumi.Input[] | undefined>; /** * (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"} */ freeformTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) Optional settings for Oracle GoldenGate processes */ ggsDetails?: pulumi.Input; /** * (Updatable) Details about Oracle GoldenGate Microservices. */ hubDetails?: pulumi.Input; /** * Database objects to include from migration, cannot be specified alongside 'excludeObjects' */ includeObjects?: pulumi.Input[] | undefined>; /** * (Updatable) Optional settings for Data Pump Export and Import jobs */ initialLoadSettings?: pulumi.Input; /** * (Updatable) The OCID of the resource being referenced. */ sourceContainerDatabaseConnectionId?: pulumi.Input; /** * (Updatable) The OCID of the resource being referenced. */ sourceDatabaseConnectionId?: pulumi.Input; /** * (Updatable) The OCID of the resource being referenced. */ sourceStandbyDatabaseConnectionId?: pulumi.Input; /** * (Updatable) The OCID of the resource being referenced. */ targetDatabaseConnectionId?: pulumi.Input; /** * (Updatable) The type of the migration to be performed. Example: ONLINE if no downtime is preferred for a migration. This method uses Oracle GoldenGate for replication. * * ** IMPORTANT ** * Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values */ type: pulumi.Input; } //# sourceMappingURL=migration.d.ts.map