cancel_resource_request

cancel_resource_request(**kwargs)

Cancels the specified resource operation request. For more information, see Canceling resource operation requests in the Amazon Web Services Cloud Control API User Guide .

Only resource operations requests with a status of PENDING or IN_PROGRESS can be canceled.

See also: AWS API Documentation

Request Syntax

response = client.cancel_resource_request(
    RequestToken='string'
)

Parameters

RequestToken (string) --

[REQUIRED]

The RequestToken of the ProgressEvent object returned by the resource operation request.

Return type

dict

Returns

Response Syntax

{
    'ProgressEvent': {
        'TypeName': 'string',
        'Identifier': 'string',
        'RequestToken': 'string',
        'Operation': 'CREATE'|'DELETE'|'UPDATE',
        'OperationStatus': 'PENDING'|'IN_PROGRESS'|'SUCCESS'|'FAILED'|'CANCEL_IN_PROGRESS'|'CANCEL_COMPLETE',
        'EventTime': datetime(2015, 1, 1),
        'ResourceModel': 'string',
        'StatusMessage': 'string',
        'ErrorCode': 'NotUpdatable'|'InvalidRequest'|'AccessDenied'|'InvalidCredentials'|'AlreadyExists'|'NotFound'|'ResourceConflict'|'Throttling'|'ServiceLimitExceeded'|'NotStabilized'|'GeneralServiceException'|'ServiceInternalError'|'ServiceTimeout'|'NetworkFailure'|'InternalFailure',
        'RetryAfter': datetime(2015, 1, 1)
    }
}

Response Structure

• (dict) --
  • ProgressEvent (dict) --

    Represents the current status of a resource operation request. For more information, see Managing resource operation requests in the Amazon Web Services Cloud Control API User Guide .

    • TypeName (string) --

      The name of the resource type used in the operation.

    • Identifier (string) --

      The primary identifier for the resource.

      Note

      In some cases, the resource identifier may be available before the resource operation has reached a status of SUCCESS .

    • RequestToken (string) --

      The unique token representing this resource operation request.

      Use the RequestToken with GetResourceRequestStatus to return the current status of a resource operation request.

    • Operation (string) --

      The resource operation type.

    • OperationStatus (string) --

      The current status of the resource operation request.

      • PENDING : The resource operation hasn't yet started.
      • IN_PROGRESS : The resource operation is currently in progress.
      • SUCCESS : The resource operation has successfully completed.
      • FAILED : The resource operation has failed. Refer to the error code and status message for more information.
      • CANCEL_IN_PROGRESS : The resource operation is in the process of being canceled.
      • CANCEL_COMPLETE : The resource operation has been canceled.
    • EventTime (datetime) --

      When the resource operation request was initiated.

    • ResourceModel (string) --

      A JSON string containing the resource model, consisting of each resource property and its current value.

    • StatusMessage (string) --

      Any message explaining the current status.

    • ErrorCode (string) --

      For requests with a status of FAILED , the associated error code.

      For error code definitions, see Handler error codes in the CloudFormation Command Line Interface User Guide for Extension Development .

    • RetryAfter (datetime) --

      When to next request the status of this resource operation request.

Exceptions

• CloudControlApi.Client.exceptions.ConcurrentModificationException
• CloudControlApi.Client.exceptions.RequestTokenNotFoundException