SupplyChain / Client / delete_instance

delete_instance#

SupplyChain.Client.delete_instance(**kwargs)#

Enables you to programmatically delete an Amazon Web Services Supply Chain instance by deleting the KMS keys and relevant information associated with the API without using the Amazon Web Services console.

This is an asynchronous operation. Upon receiving a DeleteInstance request, Amazon Web Services Supply Chain immediately returns a response with the instance resource, delete state while cleaning up all Amazon Web Services resources created during the instance creation process. You can use the GetInstance action to check the instance status.

See also: AWS API Documentation

Request Syntax

response = client.delete_instance(
    instanceId='string'
)
Parameters:

instanceId (string) –

[REQUIRED]

The AWS Supply Chain instance identifier.

Return type:

dict

Returns:

Response Syntax

{
    'instance': {
        'instanceId': 'string',
        'awsAccountId': 'string',
        'state': 'Initializing'|'Active'|'CreateFailed'|'DeleteFailed'|'Deleting'|'Deleted',
        'errorMessage': 'string',
        'webAppDnsDomain': 'string',
        'createdTime': datetime(2015, 1, 1),
        'lastModifiedTime': datetime(2015, 1, 1),
        'instanceName': 'string',
        'instanceDescription': 'string',
        'kmsKeyArn': 'string',
        'versionNumber': 123.0
    }
}

Response Structure

  • (dict) –

    The response parameters for DeleteInstance.

    • instance (dict) –

      The AWS Supply Chain instance resource data details.

      • instanceId (string) –

        The Amazon Web Services Supply Chain instance identifier.

      • awsAccountId (string) –

        The Amazon Web Services account ID that owns the instance.

      • state (string) –

        The state of the instance.

      • errorMessage (string) –

        The Amazon Web Services Supply Chain instance error message. If the instance results in an unhealthy state, customers need to check the error message, delete the current instance, and recreate a new one based on the mitigation from the error message.

      • webAppDnsDomain (string) –

        The WebApp DNS domain name of the instance.

      • createdTime (datetime) –

        The instance creation timestamp.

      • lastModifiedTime (datetime) –

        The instance last modified timestamp.

      • instanceName (string) –

        The Amazon Web Services Supply Chain instance name.

      • instanceDescription (string) –

        The Amazon Web Services Supply Chain instance description.

      • kmsKeyArn (string) –

        The ARN (Amazon Resource Name) of the Key Management Service (KMS) key you optionally provided for encryption. If you did not provide anything here, AWS Supply Chain uses the Amazon Web Services owned KMS key and nothing is returned.

      • versionNumber (float) –

        The version number of the instance.

Exceptions