[metadata]
abstract: This is the API Reference for AWS Cloud Control API. With Cloud Control API, you can create, read, update, delete, and list (CRUD-L) your cloud resources that belong to AWS and third-party services. With the Cloud Control API standardized set of application programming interfaces (APIs), you can perform CRUD-L operations on any supported resources in your AWS account. Using Cloud Control API, you won't have to generate code or scripts specific to each individual service responsible for those resources.
assets_root: /assets
default_state: API_GetResourceRequestStatus
deployment_region: IAD
description: Returns the current status of a resource operation request. For more information, see Tracking the progress of resource operation requests in the AWS Cloud Control API User Guide .
feedback-item: CloudFormation
feedback-no: feedbackno.html?topic_url=https://docs.aws.amazon.com/en_us/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html
feedback-yes: feedbackyes.html?topic_url=https://docs.aws.amazon.com/en_us/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html
feedback: https://docs.aws.amazon.com/forms/aws-doc-feedback?hidden_service_name=CloudFormation&topic_url=https://docs.aws.amazon.com/en_us/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html
forums: https://repost.aws/tags/TAm3R3LNU3RfSX9L23YIpo3w
guide-locale: en_us
guide: API Reference
keywords: API,requests,GetResourceRequestStatus
pdf: /pdfs/cloudcontrolapi/latest/APIReference/cloudcontrolapi.pdf#API_GetResourceRequestStatus
product: AWS Cloud Control API
target_state: API_GetResourceRequestStatus
this_doc_guide: API Reference
this_doc_product: AWS Cloud Control API
tocs: toc-contents.json
viewport: width=device-width,initial-scale=1

[canonical-links]
https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html

[document-links]
/pdfs/cloudcontrolapi/latest/APIReference/cloudcontrolapi.pdf#API_GetResourceRequestStatus
API Reference: Welcome.html
AWS Cloud Control API: /cloudcontrolapi/index.html
AWS Command Line Interface V2: https://docs.aws.amazon.com/goto/cli2/cloudcontrol-2021-09-30/GetResourceRequestStatus
AWS SDK for .NET V4: https://docs.aws.amazon.com/goto/DotNetSDKV4/cloudcontrol-2021-09-30/GetResourceRequestStatus
AWS SDK for C++: https://docs.aws.amazon.com/goto/SdkForCpp/cloudcontrol-2021-09-30/GetResourceRequestStatus
AWS SDK for Go v2: https://docs.aws.amazon.com/goto/SdkForGoV2/cloudcontrol-2021-09-30/GetResourceRequestStatus
AWS SDK for Java V2: https://docs.aws.amazon.com/goto/SdkForJavaV2/cloudcontrol-2021-09-30/GetResourceRequestStatus
AWS SDK for JavaScript V3: https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/cloudcontrol-2021-09-30/GetResourceRequestStatus
AWS SDK for Kotlin: https://docs.aws.amazon.com/goto/SdkForKotlin/cloudcontrol-2021-09-30/GetResourceRequestStatus
AWS SDK for PHP V3: https://docs.aws.amazon.com/goto/SdkForPHPV3/cloudcontrol-2021-09-30/GetResourceRequestStatus
AWS SDK for Python: https://docs.aws.amazon.com/goto/boto3/cloudcontrol-2021-09-30/GetResourceRequestStatus
AWS SDK for Ruby V3: https://docs.aws.amazon.com/goto/SdkForRubyV3/cloudcontrol-2021-09-30/GetResourceRequestStatus
Common Error Types: ./CommonErrors.html
Common Parameters: ./CommonParameters.html
Document Conventions: /general/latest/gr/docconventions.html
Documentation: /index.html
ErrorCode: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-ErrorCode
EventTime: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-EventTime
FailureMode: ./API_HookProgressEvent.html#ccapi-Type-HookProgressEvent-FailureMode
HookEventTime: ./API_HookProgressEvent.html#ccapi-Type-HookProgressEvent-HookEventTime
HookProgressEvent: ./API_HookProgressEvent.html
HookStatus: ./API_HookProgressEvent.html#ccapi-Type-HookProgressEvent-HookStatus
HookStatusMessage: ./API_HookProgressEvent.html#ccapi-Type-HookProgressEvent-HookStatusMessage
HookTypeArn: ./API_HookProgressEvent.html#ccapi-Type-HookProgressEvent-HookTypeArn
HookTypeName: ./API_HookProgressEvent.html#ccapi-Type-HookProgressEvent-HookTypeName
HookTypeVersionId: ./API_HookProgressEvent.html#ccapi-Type-HookProgressEvent-HookTypeVersionId
HooksRequestToken: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-HooksRequestToken
Identifier: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-Identifier
InvocationPoint: ./API_HookProgressEvent.html#ccapi-Type-HookProgressEvent-InvocationPoint
Operation: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-Operation
OperationStatus: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-OperationStatus
ProgressEvent: ./API_ProgressEvent.html
RequestToken: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-RequestToken
ResourceModel: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-ResourceModel
RetryAfter: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-RetryAfter
StatusMessage: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-StatusMessage
Tracking the progress of resource operation requests: https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html#resource-operations-manage-requests-track
TypeName: ./API_ProgressEvent.html#ccapi-Type-ProgressEvent-TypeName
View a markdown version of this page: API_GetResourceRequestStatus.md

[structured-data]
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://aws.amazon.com","name":"AWS","position":1},{"@type":"ListItem","item":"https://docs.aws.amazon.com/cloudcontrolapi/index.html","name":"AWS Cloud Control API","position":2},{"@type":"ListItem","item":"https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference","name":"API Reference","position":3},{"@type":"ListItem","item":"https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_Operations.html","name":"Actions","position":4},{"@type":"ListItem","item":"https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_Operations.html","name":"GetResourceRequestStatus","position":5}]}

[content]
GetResourceRequestStatus - AWS Cloud Control API
View a markdown version of this page
GetResourceRequestStatus - AWS Cloud Control API
Documentation
AWS Cloud Control API
API Reference
Request Syntax
Request Parameters
Response Syntax
Response Elements
Errors
Examples
See Also
GetResourceRequestStatus
Returns the current status of a resource operation request. For more information, see
Tracking the progress of resource operation requests
in the
AWS Cloud Control API User Guide
.
Request Syntax
{
"
RequestToken
": "
string
" }
Request Parameters
For information about the parameters that are common to all actions, see
Common Parameters
.
The request accepts the following data in JSON format.
RequestToken
A unique token used to track the progress of the resource operation request.
Request tokens are included in the
ProgressEvent
type returned by a resource operation request.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 128.
Pattern:
[-A-Za-z0-9+/=]+
Required: Yes
Response Syntax
{
"
HooksProgressEvent
": [
{
"
FailureMode
": "
string
", "
HookEventTime
":
number
, "
HookStatus
": "
string
", "
HookStatusMessage
": "
string
", "
HookTypeArn
": "
string
", "
HookTypeName
": "
string
", "
HookTypeVersionId
": "
string
", "
InvocationPoint
": "
string
" } ], "
ProgressEvent
":
{
"
ErrorCode
": "
string
", "
EventTime
":
number
, "
HooksRequestToken
": "
string
", "
Identifier
": "
string
", "
Operation
": "
string
", "
OperationStatus
": "
string
", "
RequestToken
": "
string
", "
ResourceModel
": "
string
", "
RetryAfter
":
number
, "
StatusMessage
": "
string
", "
TypeName
": "
string
" } }
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
HooksProgressEvent
Lists Hook invocations for the specified target in the request. This is a list since the same target can invoke multiple Hooks.
Type: Array of
HookProgressEvent
objects
ProgressEvent
Represents the current status of the resource operation request.
Type:
ProgressEvent
object
Errors
For information about the errors that are common to all actions, see
Common Error Types
.
RequestTokenNotFoundException
A resource operation with the specified request token can't be found.
HTTP Status Code: 400
Examples
GetResourceRequestStatus
The following example returns the successful completion status of the specified resource creation operation.
Sample Request
https://cloudcontrolapi.us-east-1.amazonaws.com/ ?Action=GetResourceRequestStatus &RequestToken=b4a1cc5a-a2ae-4dec-9e1e-150123456789 &Version=2021-09-30 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=[Access key ID and scope] &X-Amz-Date=20250316T233349Z &X-Amz-SignedHeaders=content-type;host &X-Amz-Signature=[Signature]
Sample Response
<GetResourceRequestStatusResponse xmlns="http://cloudcontrol.amazonaws.com/doc/2021-09-30/"> <GetResourceRequestStatusResult> <ProgressEvent> <Identifier>LogGroupResourceExample</Identifier> <OperationStatus>SUCCESS</OperationStatus> <EventTime>2025-02-27T18:52:57.406Z</EventTime> <TypeName>AWS::Logs::LogGroup</TypeName> <RequestToken>b4a1cc5a-a2ae-4dec-9e1e-150123456789</RequestToken> <Operation>CREATE</Operation> </ProgressEvent> </GetResourceRequestStatusResult> <ResponseMetadata> <RequestId>620e5d19-0c03-4069-ae3b-9e0123456789</RequestId> </ResponseMetadata> </GetResourceRequestStatusResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
AWS Command Line Interface V2
AWS SDK for .NET V4
AWS SDK for C++
AWS SDK for Go v2
AWS SDK for Java V2
AWS SDK for JavaScript V3
AWS SDK for Kotlin
AWS SDK for PHP V3
AWS SDK for Python
AWS SDK for Ruby V3
Document Conventions
GetResource
ListResourceRequests
Did this page help you? - Yes
Thanks for letting us know we're doing a good job!
If you've got a moment, please tell us what we did right so we can do more of it.
Did this page help you? - No
Thanks for letting us know this page needs work. We're sorry we let you down.
If you've got a moment, please tell us how we can make the documentation better.
