Queries the configuration timeline of a resource in an account group.
The sample request in this topic shows you how to query the configuration timeline
of the new-bucket
resource that resides in the cn-hangzhou
region within the 100931896542****
member account of the ca-5885626622af0008****
account group. The new-bucket resource is an Object Storage Service (OSS) bucket.
The return result shows that the timestamp when the resource configuration changes
is 1624961112000
. The timestamp indicates 18:05:12 on June 29, 2021 (UTC+8).
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | GetAggregateResourceConfigurationTimeline |
The operation that you want to perform. Set the value to GetAggregateResourceConfigurationTimeline. |
ResourceId | String | Yes | new-bucket |
The ID of the resource. For more information about how to obtain the ID of a resource, see ListAggregateDiscoveredResources. |
StartTime | Long | No | 1623211156000 |
The timestamp that specifies the beginning of the time range to query. By default, Cloud Config retrieves the configuration changes in the last 30 days for the specified resource. Unit: milliseconds. |
EndTime | Long | No | 1625821156000 |
The timestamp that specifies the end of the time range to query. The default value indicates the time when the GetAggregateResourceConfigurationTimeline operation is called. Unit: milliseconds. |
MaxResults | Integer | No | 10 |
The maximum number of entries to return for a single request. Valid values: 1 to 100. |
ResourceType | String | Yes | ACS::OSS::Bucket |
The type of the resource. For more information about how to obtain the type of a resource, see ListAggregateDiscoveredResources. |
Region | String | Yes | cn-hangzhou |
The ID of the region in which the resource resides. For more information about how to obtain the ID of a region, see ListAggregateDiscoveredResources. |
AggregatorId | String | Yes | ca-5885626622af0008**** |
The ID of the account group. For more information about how to obtain the ID of an account group, see ListAggregators. |
ResourceOwnerId | Long | Yes | 100931896542**** |
The ID of the Alibaba Cloud account to which the resource belongs. Note The value must be the ID of the current management account or a member account in
the account group of the management account.
|
NextToken | String | No | IWBjqMYSy0is7zSMGu16**** |
The token that is used to initiate the next request. If the response of the current request is truncated, this token is used to initiate another request and obtain the remaining entries. |
For more information about common request parameters, see Common parameters.
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | ED9CD1B3-286C-4E05-A765-5E1E0B9BC2AB |
The ID of the request. |
ResourceConfigurationTimeline | Object |
The information about the configuration timeline. |
|
NextToken | String | IWBjqMYSy0is7zSMGu16**** |
The token that is used to initiate the next request. |
MaxResults | Integer | 10 |
The maximum number of entries returned for a single request. |
ConfigurationList | Array of ConfigurationList |
The configuration changes on the configuration timeline. |
|
Tags | String | {\"\"hc\"\":[\"\"value2\"\"]} |
The tags of the resource. |
AccountId | Long | 100931896542**** |
The ID of the Alibaba Cloud account to which the resource belongs. |
ResourceEventType | String | DISCOVERED |
The type of the resource change event involved. Valid values:
Note
|
AvailabilityZone | String | cn-hangzhou-h |
The ID of the zone in which the resource resides. |
ResourceType | String | ACS::OSS::Bucket |
The type of the resource. |
ResourceCreateTime | String | 1624961112000 |
The timestamp when the resource was created. Unit: milliseconds. |
Region | String | cn-hangzhou |
The ID of the region in which the resource resides. |
CaptureTime | String | 1624961156000 |
The timestamp when the resource change snapshot was recorded. Unit: milliseconds. |
ConfigurationDiff | String | {\"AccessControlList\":[null,{\"Grant\":\"private\"}],\"ServerSideEncryptionRule\":[null,{\"SSEAlgorithm\":\"None\"}],\"CreationDate\":[null,\"2021-06-29T10:05:12.000Z\"],\"Owner\":[null,{\"DisplayName\":\"100931896542****\",\"ID\":\"100931896542****\"}],\"BucketPolicy\":[null,{\"LogPrefix\":\"\",\"LogBucket\":\"\"}],\"StorageClass\":[null,\"Standard\"],\"ExtranetEndpoint\":[null,\"oss-cn-hangzhou.aliyuncs.com\"],\"DataRedundancyType\":[null,\"LRS\"],\"AllowEmptyReferer\":[null,\"true\"],\"IntranetEndpoint\":[null,\"oss-cn-hangzhou-internal.aliyuncs.com\"],\"Name\":[null,\"new-bucket\"],\"Location\":[null,\"oss-cn-hangzhou\"]} |
The details of the resource change that triggered the compliance evaluation. |
ResourceId | String | new-bucket |
The ID of the resource. |
ResourceName | String | new-bucket |
The name of the resource. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=GetAggregateResourceConfigurationTimeline
&ResourceId=new-bucket
&ResourceType=ACS::OSS::Bucket
&Region=cn-hangzhou
&AggregatorId=ca-5885626622af0008****
&ResourceOwnerId=100931896542****
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<GetAggregateResourceConfigurationTimelineResponse>
<RequestId>ED9CD1B3-286C-4E05-A765-5E1E0B9BC2AB</RequestId>
<ResourceConfigurationTimeline>
<MaxResults>10</MaxResults>
<ConfigurationList>
<AccountId>100931896542****</AccountId>
<ResourceName>new-bucket</ResourceName>
<AvailabilityZone>cn-hangzhou-h</AvailabilityZone>
<ResourceType>ACS::OSS::Bucket</ResourceType>
<ResourceEventType>DISCOVERED</ResourceEventType>
<ResourceCreateTime>1624961112000</ResourceCreateTime>
<CaptureTime>1624961156000</CaptureTime>
<ConfigurationDiff>{\"AccessControlList\":[null,{\"Grant\":\"private\"}],\"ServerSideEncryptionRule\":[null,{\"SSEAlgorithm\":\"None\"}],\"CreationDate\":[null,\"2021-06-29T10:05:12.000Z\"],\"Owner\":[null,{\"DisplayName\":\"100931896542****\",\"ID\":\"100931896542****\"}],\"BucketPolicy\":[null,{\"LogPrefix\":\"\",\"LogBucket\":\"\"}],\"StorageClass\":[null,\"Standard\"],\"ExtranetEndpoint\":[null,\"oss-cn-hangzhou.aliyuncs.com\"],\"DataRedundancyType\":[null,\"LRS\"],\"AllowEmptyReferer\":[null,\"true\"],\"IntranetEndpoint\":[null,\"oss-cn-hangzhou-internal.aliyuncs.com\"],\"Name\":[null,\"new-bucket\"],\"Location\":[null,\"oss-cn-hangzhou\"]}</ConfigurationDiff>
<ResourceId>new-bucket</ResourceId>
<Region>cn-hangzhou</Region>
<Tags>{\"\"hc\"\":[\"\"value2\"\"]}</Tags>
</ConfigurationList>
</ResourceConfigurationTimeline>
</GetAggregateResourceConfigurationTimelineResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "ED9CD1B3-286C-4E05-A765-5E1E0B9BC2AB",
"ResourceConfigurationTimeline" : {
"MaxResults" : 10,
"ConfigurationList" : [ {
"AccountId" : "100931896542****",
"ResourceName" : "new-bucket",
"AvailabilityZone" : "cn-hangzhou-h",
"ResourceType" : "ACS::OSS::Bucket",
"ResourceEventType" : "DISCOVERED",
"ResourceCreateTime" : 1624961112000,
"CaptureTime" : 1624961156000,
"ConfigurationDiff" : "{\"AccessControlList\":[null,{\"Grant\":\"private\"}],\"ServerSideEncryptionRule\":[null,{\"SSEAlgorithm\":\"None\"}],\"CreationDate\":[null,\"2021-06-29T10:05:12.000Z\"],\"Owner\":[null,{\"DisplayName\":\"100931896542****\",\"ID\":\"100931896542****\"}],\"BucketPolicy\":[null,{\"LogPrefix\":\"\",\"LogBucket\":\"\"}],\"StorageClass\":[null,\"Standard\"],\"ExtranetEndpoint\":[null,\"oss-cn-hangzhou.aliyuncs.com\"],\"DataRedundancyType\":[null,\"LRS\"],\"AllowEmptyReferer\":[null,\"true\"],\"IntranetEndpoint\":[null,\"oss-cn-hangzhou-internal.aliyuncs.com\"],\"Name\":[null,\"new-bucket\"],\"Location\":[null,\"oss-cn-hangzhou\"]}",
"ResourceId" : "new-bucket",
"Region" : "cn-hangzhou",
"Tags" : "{\"\"hc\"\":[\"\"value2\"\"]}"
} ]
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | NoPermission | You are not authorized to perform this operation. | The error message returned because you are not authorized to perform the specified operation. |
400 | Invalid.AggregatorId.Value | The specified AggregatorId is invalid. | The error message returned because the specified account group ID does not exist or you are not authorized to use the account group. |
400 | Invalid.ResourceOwnerId.Value | The specified ResourceOwnerId is invalid. | The error message returned because the specified account does not exist or it is not in the specified account group. |
404 | AccountNotExisted | Your account does not exist. | The error message returned because your account does not exist. |
503 | ServiceUnavailable | The request has failed due to a temporary failure of the server. | The error message returned because the service is unavailable. |
For a list of error codes, visit the API Error Center.