DatabaseMigrationService / Client / create_instance_profile

create_instance_profile#

DatabaseMigrationService.Client.create_instance_profile(**kwargs)#

Creates the instance profile using the specified parameters.

See also: AWS API Documentation

Request Syntax

response = client.create_instance_profile(
    AvailabilityZone='string',
    KmsKeyArn='string',
    PubliclyAccessible=True|False,
    Tags=[
        {
            'Key': 'string',
            'Value': 'string',
            'ResourceArn': 'string'
        },
    ],
    NetworkType='string',
    InstanceProfileName='string',
    Description='string',
    SubnetGroupIdentifier='string',
    VpcSecurityGroups=[
        'string',
    ]
)
Parameters:
  • AvailabilityZone (string) – The Availability Zone where the instance profile will be created. The default value is a random, system-chosen Availability Zone in the Amazon Web Services Region where your data provider is created, for examplem us-east-1d.

  • KmsKeyArn (string) –

    The Amazon Resource Name (ARN) of the KMS key that is used to encrypt the connection parameters for the instance profile.

    If you don’t specify a value for the KmsKeyArn parameter, then DMS uses your default encryption key.

    KMS creates the default encryption key for your Amazon Web Services account. Your Amazon Web Services account has a different default encryption key for each Amazon Web Services Region.

  • PubliclyAccessible (boolean) – Specifies the accessibility options for the instance profile. A value of true represents an instance profile with a public IP address. A value of false represents an instance profile with a private IP address. The default value is true.

  • Tags (list) –

    One or more tags to be assigned to the instance profile.

    • (dict) –

      A user-defined key-value pair that describes metadata added to an DMS resource and that is used by operations such as the following:

      • AddTagsToResource

      • ListTagsForResource

      • RemoveTagsFromResource

      • Key (string) –

        A key is the required name of the tag. The string value can be 1-128 Unicode characters in length and can’t be prefixed with “aws:” or “dms:”. The string can only contain only the set of Unicode letters, digits, white-space, ‘_’, ‘.’, ‘/’, ‘=’, ‘+’, ‘-’ (Java regular expressions: “^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$”).

      • Value (string) –

        A value is the optional value of the tag. The string value can be 1-256 Unicode characters in length and can’t be prefixed with “aws:” or “dms:”. The string can only contain only the set of Unicode letters, digits, white-space, ‘_’, ‘.’, ‘/’, ‘=’, ‘+’, ‘-’ (Java regular expressions: “^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$”).

      • ResourceArn (string) –

        The Amazon Resource Name (ARN) string that uniquely identifies the resource for which the tag is created.

  • NetworkType (string) – Specifies the network type for the instance profile. A value of IPV4 represents an instance profile with IPv4 network type and only supports IPv4 addressing. A value of IPV6 represents an instance profile with IPv6 network type and only supports IPv6 addressing. A value of DUAL represents an instance profile with dual network type that supports IPv4 and IPv6 addressing.

  • InstanceProfileName (string) – A user-friendly name for the instance profile.

  • Description (string) – A user-friendly description of the instance profile.

  • SubnetGroupIdentifier (string) – A subnet group to associate with the instance profile.

  • VpcSecurityGroups (list) –

    Specifies the VPC security group names to be used with the instance profile. The VPC security group must work with the VPC containing the instance profile.

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'InstanceProfile': {
        'InstanceProfileArn': 'string',
        'AvailabilityZone': 'string',
        'KmsKeyArn': 'string',
        'PubliclyAccessible': True|False,
        'NetworkType': 'string',
        'InstanceProfileName': 'string',
        'Description': 'string',
        'InstanceProfileCreationTime': datetime(2015, 1, 1),
        'SubnetGroupIdentifier': 'string',
        'VpcSecurityGroups': [
            'string',
        ]
    }
}

Response Structure

  • (dict) –

    • InstanceProfile (dict) –

      The instance profile that was created.

      • InstanceProfileArn (string) –

        The Amazon Resource Name (ARN) string that uniquely identifies the instance profile.

      • AvailabilityZone (string) –

        The Availability Zone where the instance profile runs.

      • KmsKeyArn (string) –

        The Amazon Resource Name (ARN) of the KMS key that is used to encrypt the connection parameters for the instance profile.

        If you don’t specify a value for the KmsKeyArn parameter, then DMS uses your default encryption key.

        KMS creates the default encryption key for your Amazon Web Services account. Your Amazon Web Services account has a different default encryption key for each Amazon Web Services Region.

      • PubliclyAccessible (boolean) –

        Specifies the accessibility options for the instance profile. A value of true represents an instance profile with a public IP address. A value of false represents an instance profile with a private IP address. The default value is true.

      • NetworkType (string) –

        Specifies the network type for the instance profile. A value of IPV4 represents an instance profile with IPv4 network type and only supports IPv4 addressing. A value of IPV6 represents an instance profile with IPv6 network type and only supports IPv6 addressing. A value of DUAL represents an instance profile with dual network type that supports IPv4 and IPv6 addressing.

      • InstanceProfileName (string) –

        The user-friendly name for the instance profile.

      • Description (string) –

        A description of the instance profile. Descriptions can have up to 31 characters. A description can contain only ASCII letters, digits, and hyphens (‘-‘). Also, it can’t end with a hyphen or contain two consecutive hyphens, and can only begin with a letter.

      • InstanceProfileCreationTime (datetime) –

        The time the instance profile was created.

      • SubnetGroupIdentifier (string) –

        The identifier of the subnet group that is associated with the instance profile.

      • VpcSecurityGroups (list) –

        The VPC security groups that are used with the instance profile. The VPC security group must work with the VPC containing the instance profile.

        • (string) –

Exceptions

  • DatabaseMigrationService.Client.exceptions.AccessDeniedFault

  • DatabaseMigrationService.Client.exceptions.ResourceAlreadyExistsFault

  • DatabaseMigrationService.Client.exceptions.ResourceNotFoundFault

  • DatabaseMigrationService.Client.exceptions.ResourceQuotaExceededFault

  • DatabaseMigrationService.Client.exceptions.InvalidResourceStateFault

  • DatabaseMigrationService.Client.exceptions.KMSKeyNotAccessibleFault

  • DatabaseMigrationService.Client.exceptions.S3ResourceNotFoundFault

  • DatabaseMigrationService.Client.exceptions.S3AccessDeniedFault