| Copyright | (c) 2013-2021 Brendan Hay |
|---|---|
| License | Mozilla Public License, v. 2.0. |
| Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
| Stability | auto-generated |
| Portability | non-portable (GHC extensions) |
| Safe Haskell | None |
Amazonka.Config.GetResourceConfigHistory
Description
Returns a list of ConfigurationItems for the specified resource. The
list contains details about each state of the resource during the
specified time interval. If you specified a retention period to retain
your ConfigurationItems between a minimum of 30 days and a maximum of
7 years (2557 days), Config returns the ConfigurationItems for the
specified retention period.
The response is paginated. By default, Config returns a limit of 10
configuration items per page. You can customize this number with the
limit parameter. The response includes a nextToken string. To get
the next page of results, run the request again and specify the string
for the nextToken parameter.
Each call to the API is limited to span a duration of seven days. It is
likely that the number of records returned is smaller than the specified
limit. In such cases, you can make another call, using the
nextToken.
This operation returns paginated results.
Synopsis
- data GetResourceConfigHistory = GetResourceConfigHistory' {}
- newGetResourceConfigHistory :: ResourceType -> Text -> GetResourceConfigHistory
- getResourceConfigHistory_chronologicalOrder :: Lens' GetResourceConfigHistory (Maybe ChronologicalOrder)
- getResourceConfigHistory_nextToken :: Lens' GetResourceConfigHistory (Maybe Text)
- getResourceConfigHistory_limit :: Lens' GetResourceConfigHistory (Maybe Natural)
- getResourceConfigHistory_laterTime :: Lens' GetResourceConfigHistory (Maybe UTCTime)
- getResourceConfigHistory_earlierTime :: Lens' GetResourceConfigHistory (Maybe UTCTime)
- getResourceConfigHistory_resourceType :: Lens' GetResourceConfigHistory ResourceType
- getResourceConfigHistory_resourceId :: Lens' GetResourceConfigHistory Text
- data GetResourceConfigHistoryResponse = GetResourceConfigHistoryResponse' {}
- newGetResourceConfigHistoryResponse :: Int -> GetResourceConfigHistoryResponse
- getResourceConfigHistoryResponse_nextToken :: Lens' GetResourceConfigHistoryResponse (Maybe Text)
- getResourceConfigHistoryResponse_configurationItems :: Lens' GetResourceConfigHistoryResponse (Maybe [ConfigurationItem])
- getResourceConfigHistoryResponse_httpStatus :: Lens' GetResourceConfigHistoryResponse Int
Creating a Request
data GetResourceConfigHistory Source #
The input for the GetResourceConfigHistory action.
See: newGetResourceConfigHistory smart constructor.
Constructors
| GetResourceConfigHistory' | |
Fields
| |
Instances
newGetResourceConfigHistory Source #
Arguments
| :: ResourceType | |
| -> Text | |
| -> GetResourceConfigHistory |
Create a value of GetResourceConfigHistory with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:chronologicalOrder:GetResourceConfigHistory', getResourceConfigHistory_chronologicalOrder - The chronological order for configuration items listed. By default, the
results are listed in reverse chronological order.
$sel:nextToken:GetResourceConfigHistory', getResourceConfigHistory_nextToken - The nextToken string returned on a previous page that you use to get
the next page of results in a paginated response.
$sel:limit:GetResourceConfigHistory', getResourceConfigHistory_limit - The maximum number of configuration items returned on each page. The
default is 10. You cannot specify a number greater than 100. If you
specify 0, Config uses the default.
$sel:laterTime:GetResourceConfigHistory', getResourceConfigHistory_laterTime - The time stamp that indicates a later time. If not specified, current
time is taken.
$sel:earlierTime:GetResourceConfigHistory', getResourceConfigHistory_earlierTime - The time stamp that indicates an earlier time. If not specified, the
action returns paginated results that contain configuration items that
start when the first configuration item was recorded.
$sel:resourceType:GetResourceConfigHistory', getResourceConfigHistory_resourceType - The resource type.
$sel:resourceId:GetResourceConfigHistory', getResourceConfigHistory_resourceId - The ID of the resource (for example., sg-xxxxxx).
Request Lenses
getResourceConfigHistory_chronologicalOrder :: Lens' GetResourceConfigHistory (Maybe ChronologicalOrder) Source #
The chronological order for configuration items listed. By default, the results are listed in reverse chronological order.
getResourceConfigHistory_nextToken :: Lens' GetResourceConfigHistory (Maybe Text) Source #
The nextToken string returned on a previous page that you use to get
the next page of results in a paginated response.
getResourceConfigHistory_limit :: Lens' GetResourceConfigHistory (Maybe Natural) Source #
The maximum number of configuration items returned on each page. The default is 10. You cannot specify a number greater than 100. If you specify 0, Config uses the default.
getResourceConfigHistory_laterTime :: Lens' GetResourceConfigHistory (Maybe UTCTime) Source #
The time stamp that indicates a later time. If not specified, current time is taken.
getResourceConfigHistory_earlierTime :: Lens' GetResourceConfigHistory (Maybe UTCTime) Source #
The time stamp that indicates an earlier time. If not specified, the action returns paginated results that contain configuration items that start when the first configuration item was recorded.
getResourceConfigHistory_resourceType :: Lens' GetResourceConfigHistory ResourceType Source #
The resource type.
getResourceConfigHistory_resourceId :: Lens' GetResourceConfigHistory Text Source #
The ID of the resource (for example., sg-xxxxxx).
Destructuring the Response
data GetResourceConfigHistoryResponse Source #
The output for the GetResourceConfigHistory action.
See: newGetResourceConfigHistoryResponse smart constructor.
Constructors
| GetResourceConfigHistoryResponse' | |
Fields
| |
Instances
newGetResourceConfigHistoryResponse Source #
Create a value of GetResourceConfigHistoryResponse with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:nextToken:GetResourceConfigHistory', getResourceConfigHistoryResponse_nextToken - The string that you use in a subsequent request to get the next page of
results in a paginated response.
$sel:configurationItems:GetResourceConfigHistoryResponse', getResourceConfigHistoryResponse_configurationItems - A list that contains the configuration history of one or more resources.
$sel:httpStatus:GetResourceConfigHistoryResponse', getResourceConfigHistoryResponse_httpStatus - The response's http status code.
Response Lenses
getResourceConfigHistoryResponse_nextToken :: Lens' GetResourceConfigHistoryResponse (Maybe Text) Source #
The string that you use in a subsequent request to get the next page of results in a paginated response.
getResourceConfigHistoryResponse_configurationItems :: Lens' GetResourceConfigHistoryResponse (Maybe [ConfigurationItem]) Source #
A list that contains the configuration history of one or more resources.
getResourceConfigHistoryResponse_httpStatus :: Lens' GetResourceConfigHistoryResponse Int Source #
The response's http status code.