All Products
Search
Document Center

ActionTrail:GetAccessKeyLastUsedIps

Last Updated:Mar 01, 2024

Queries the information about the IP addresses that are most recently used when a specified AccessKey pair is called to access Alibaba Cloud services.

Operation description

You can call this operation to query only the information about the IP addresses that are most recently used within 400 days after February 1, 2022 when a specified AccessKey pair is called to access Alibaba Cloud services. Data is updated at 1-hour intervals, which can cause query latency. We recommend that you do not change an AccessKey pair unless required.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
AccessKeystringYes

The AccessKey ID.

LTAI4Fz1ykT4qxgNMvN6****
ServiceNamestringYes

The Alibaba Cloud service. For more information about the Alibaba Cloud services supported by ActionTrail, see Supported Alibaba Cloud services.

Ecs
NextTokenstringNo

The token that determines the start point of the query.

Note The request parameters must be the same as those of the last request.
eyJhY2NvdW50IjoiMTQyNDM3OTU4NjM4NzE2MSIsImV2ZW50SWQiOiI3MkJDRTExRi02OTU3LTQ0NUItQjY0MC1CNEUyMkM4NUEwQzgiLCJsb2dJZCI6IjgyLTE0MjQzNzk1ODYzODcxNjEiLCJ0aW1lIjoxNjAyMzExNTQwMD****
PageSizestringNo

The number of entries to return on each page.

Valid values: 0 to 100.

Default value: 20.

20

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0
Ipsobject []

The list of returned IP addresses.

UsedTimestamplong

The timestamp when the IP address was used.

1657247532000
Detailstring

An array that consists of the details about the event.

{ "eventId": "239EB588-CD24-522E-B0B5-174A1A58****", "eventVersion": 1, "eventSource": "ecs.cn-hangzhou.aliyuncs.com", "sourceIpAddress": "10.10.**.**", "eventType": "ApiCall", "userIdentity": { "accountId": "104758519118****", "principalId": "24549429003625****", "type": "ram-user", "userName": "alice" }, "serviceName": "Ecs", "apiVersion": "2016-01-20", "requestId": "239EB588-CD24-522E-B0B5-174A1A588BE0", "eventTime": "2021-08-05T09:21:32Z", "isGlobal": false, "acsRegion": "cn-hangzhou", "eventName": "DescribeInstances" }
Sourcestring

The event source.

Enumeration Value:
  • Internal: other event..
  • ManagementEvent: management event..
  • DataEvent: data event..
ManagementEvent
Ipstring

The IP address.

10.10.**.**
NextTokenstring

The token that determines the start point of the query.

eyJhY2NvdW50IjoiMTQyNDM3OTU4NjM4NzE2MSIsImV2ZW50SWQiOiI3MkJDRTExRi02OTU3LTQ0NUItQjY0MC1CNEUyMkM4NUEwQzgiLCJsb2dJZCI6IjgyLTE0MjQzNzk1ODYzODcxNjEiLCJ0aW1lIjoxNjAyMzExNTQwMD****

Examples

Sample success responses

JSONformat

{
  "RequestId": "145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0",
  "Ips": [
    {
      "UsedTimestamp": 1657247532000,
      "Detail": "{\n  \"eventId\": \"239EB588-CD24-522E-B0B5-174A1A58****\",\n  \"eventVersion\": 1,\n  \"eventSource\": \"ecs.cn-hangzhou.aliyuncs.com\",\n  \"sourceIpAddress\": \"10.10.**.**\",\n  \"eventType\": \"ApiCall\",\n  \"userIdentity\": {\n    \"accountId\": \"104758519118****\",\n    \"principalId\": \"24549429003625****\",\n    \"type\": \"ram-user\",\n    \"userName\": \"alice\"\n  },\n  \"serviceName\": \"Ecs\",\n  \"apiVersion\": \"2016-01-20\",\n  \"requestId\": \"239EB588-CD24-522E-B0B5-174A1A588BE0\",\n  \"eventTime\": \"2021-08-05T09:21:32Z\",\n  \"isGlobal\": false,\n  \"acsRegion\": \"cn-hangzhou\",\n  \"eventName\": \"DescribeInstances\"\n}",
      "Source": "ManagementEvent",
      "Ip": "10.10.**.**"
    }
  ],
  "NextToken": "eyJhY2NvdW50IjoiMTQyNDM3OTU4NjM4NzE2MSIsImV2ZW50SWQiOiI3MkJDRTExRi02OTU3LTQ0NUItQjY0MC1CNEUyMkM4NUEwQzgiLCJsb2dJZCI6IjgyLTE0MjQzNzk1ODYzODcxNjEiLCJ0aW1lIjoxNjAyMzExNTQwMD****"
}

Error codes

HTTP status codeError codeError messageDescription
400IncompleteSignatureThe request signature does not conform to Alibaba Cloud standards.The request signature does not conform to Alibaba Cloud standards.
400InvalidQueryParameterThe specified query parameter is invalid.The specified query parameter is not valid.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-06-19The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400