DatabaseMigrationService / Client / delete_instance_profile

delete_instance_profile#

DatabaseMigrationService.Client.delete_instance_profile(**kwargs)#

Deletes the specified instance profile.

Note

All migration projects associated with the instance profile must be deleted or modified before you can delete the instance profile.

See also: AWS API Documentation

Request Syntax

response = client.delete_instance_profile(
    InstanceProfileIdentifier='string'
)
Parameters:

InstanceProfileIdentifier (string) –

[REQUIRED]

The identifier of the instance profile to delete.

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 deleted.

      • 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.ResourceNotFoundFault

  • DatabaseMigrationService.Client.exceptions.InvalidResourceStateFault