Amazon Relational Database Service
API Reference (API Version 2014-10-31)

ImportInstallationMedia

Imports the installation media for a DB engine that requires an on-premises customer provided license, such as SQL Server.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

CustomAvailabilityZoneId

The identifier of the custom Availability Zone (AZ) to import the installation media to.

Type: String

Required: Yes

Engine

The name of the database engine to be used for this instance.

The list only includes supported DB engines that require an on-premises customer provided license.

Valid Values:

  • sqlserver-ee

  • sqlserver-se

  • sqlserver-ex

  • sqlserver-web

Type: String

Required: Yes

EngineInstallationMediaPath

The path to the installation medium for the specified DB engine.

Example: SQLServerISO/en_sql_server_2016_enterprise_x64_dvd_8701793.iso

Type: String

Required: Yes

EngineVersion

The version number of the database engine to use.

For a list of valid engine versions, call DescribeDBEngineVersions.

The following are the database engines and links to information about the major and minor versions. The list only includes DB engines that require an on-premises customer provided license.

Microsoft SQL Server

See Version and Feature Support on Amazon RDS in the Amazon RDS User Guide.

Type: String

Required: Yes

OSInstallationMediaPath

The path to the installation medium for the operating system associated with the specified DB engine.

Example: WindowsISO/en_windows_server_2016_x64_dvd_9327751.iso

Type: String

Required: Yes

Response Elements

The following elements are returned by the service.

CustomAvailabilityZoneId

The custom Availability Zone (AZ) that contains the installation media.

Type: String

Engine

The DB engine.

Type: String

EngineInstallationMediaPath

The path to the installation medium for the DB engine.

Type: String

EngineVersion

The engine version of the DB engine.

Type: String

FailureCause

If an installation media failure occurred, the cause of the failure.

Type: InstallationMediaFailureCause object

InstallationMediaId

The installation medium ID.

Type: String

OSInstallationMediaPath

The path to the installation medium for the operating system associated with the DB engine.

Type: String

Status

The status of the installation medium.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

CustomAvailabilityZoneNotFound

CustomAvailabilityZoneId doesn't refer to an existing custom Availability Zone identifier.

HTTP Status Code: 404

InstallationMediaAlreadyExists

The specified installation medium has already been imported.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: