GetAggregateResourceConfigurationTimeline - API Reference| Alibaba Cloud Documentation Center

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

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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: DISCOVERED: A resource is created. DISCOVERED_REVISED: A resource is created by periodic remediation tasks. MODIFY: A resource is modified. MODIFY_REVISED: A resource is modified by periodic remediation tasks. REMOVE: A resource is deleted. Note To ensure the integrity of resources, periodic remediation tasks are run to check data and generate events that indicate the creation of new resources. Such events are infrequent. The time when a resource change event is generated by a periodic remediation task is considered as the detection time of Cloud Config. The detection time is later than the time when the resource is modified.
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.