# GenerateServiceLastAccessedDetails
Generates a report that includes details about when an IAM resource (user, group, role, or policy) was last used in an attempt to access Amazon services. Recent activity usually appears within four hours. IAM reports activity for at least the last 400 days, or less if your Region began supporting this feature within the last year. For more information, see [Regions where data is tracked](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_access-advisor.html#access-advisor_tracking-period). For more information about services and actions for which action last accessed information is displayed, see [IAM action last accessed information services and actions](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_access-advisor-action-last-accessed.html).
**Important**
The service last accessed data includes all attempts to access an Amazon API, not just the successful ones. This includes all attempts that were made using the Amazon Web Services Management Console, the Amazon API through any of the SDKs, or any of the command line tools. An unexpected entry in the service last accessed data does not mean that your account has been compromised, because the request might have been denied. Refer to your CloudTrail logs as the authoritative source for information about all API calls and whether they were successful or denied access. For more information, see [Logging IAM events with CloudTrail](https://docs.amazonaws.cn/IAM/latest/UserGuide/cloudtrail-integration.html) in the *IAM User Guide*.
The `GenerateServiceLastAccessedDetails` operation returns a `JobId`. Use this parameter in the following operations to retrieve the following details from your report:
+ [GetServiceLastAccessedDetails](https://docs.amazonaws.cn/IAM/latest/APIReference/API_GetServiceLastAccessedDetails.html) – Use this operation for users, groups, roles, or policies to list every Amazon service that the resource could access using permissions policies. For each service, the response includes information about the most recent access attempt.
The `JobId` returned by `GenerateServiceLastAccessedDetail` must be used by the same role within a session, or by the same user when used to call `GetServiceLastAccessedDetail`.
+ [GetServiceLastAccessedDetailsWithEntities](https://docs.amazonaws.cn/IAM/latest/APIReference/API_GetServiceLastAccessedDetailsWithEntities.html) – Use this operation for groups and policies to list information about the associated entities (users or roles) that attempted to access a specific Amazon service.
To check the status of the `GenerateServiceLastAccessedDetails` request, use the `JobId` parameter in the same operations and test the `JobStatus` response parameter.
For additional information about the permissions policies that allow an identity (user, group, or role) to access specific services, use the [ListPoliciesGrantingServiceAccess](https://docs.amazonaws.cn/IAM/latest/APIReference/API_ListPoliciesGrantingServiceAccess.html) operation.
**Note**
Service last accessed data does not use other policy types when determining whether a resource could access a service. These other policy types include resource-based policies, access control lists, Amazon Organizations policies, IAM permissions boundaries, and Amazon STS assume role policies. It only applies permissions policy logic. For more about the evaluation of policy types, see [Evaluating policies](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_evaluation-logic.html#policy-eval-basics) in the *IAM User Guide*.
For more information about service and action last accessed data, see [Reducing permissions using service last accessed data](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_access-advisor.html) in the *IAM User Guide*.
## Request Parameters
For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).
** Arn **
The ARN of the IAM resource (user, group, role, or managed policy) used to generate information about when the resource was last used in an attempt to access an Amazon service.
Type: String
Length Constraints: Minimum length of 20. Maximum length of 2048.
Required: Yes
** Granularity **
The level of detail that you want to generate. You can specify whether you want to generate information about the last attempt to access services or actions. If you specify service-level granularity, this operation generates only service data. If you specify action-level granularity, it generates service and action data. If you don't include this optional parameter, the operation generates service data.
Type: String
Valid Values: `SERVICE_LEVEL | ACTION_LEVEL`
Required: No
## Response Elements
The following element is returned by the service.
** JobId **
The `JobId` that you can use in the [GetServiceLastAccessedDetails](https://docs.amazonaws.cn/IAM/latest/APIReference/API_GetServiceLastAccessedDetails.html) or [GetServiceLastAccessedDetailsWithEntities](https://docs.amazonaws.cn/IAM/latest/APIReference/API_GetServiceLastAccessedDetailsWithEntities.html) operations. The `JobId` returned by `GenerateServiceLastAccessedDetail` must be used by the same role within a session, or by the same user when used to call `GetServiceLastAccessedDetail`.
Type: String
Length Constraints: Fixed length of 36.
## Errors
For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).
** InvalidInput **
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.
HTTP Status Code: 400
** NoSuchEntity **
The request was rejected because it referenced a resource entity that does not exist. The error message describes the resource.
HTTP Status Code: 404
## Examples
### Example
This example illustrates one usage of GenerateServiceLastAccessedDetails.
#### Sample Request
```
https://iam.amazonaws.com/?Action=GenerateServiceLastAccessedDetails
&Arn=arn:aws:iam::123456789012:policy/ExamplePolicy1
&Version=2010-05-08
&AUTHPARAMS
```
#### Sample Response
```
examplef-1305-c245-eba4-71fe298bcda7
```
## See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following:
+ [Amazon Command Line Interface V2](https://docs.amazonaws.cn/goto/cli2/iam-2010-05-08/GenerateServiceLastAccessedDetails)
+ [Amazon SDK for .NET V4](https://docs.amazonaws.cn/goto/DotNetSDKV4/iam-2010-05-08/GenerateServiceLastAccessedDetails)
+ [Amazon SDK for C\$1\$1](https://docs.amazonaws.cn/goto/SdkForCpp/iam-2010-05-08/GenerateServiceLastAccessedDetails)
+ [Amazon SDK for Go v2](https://docs.amazonaws.cn/goto/SdkForGoV2/iam-2010-05-08/GenerateServiceLastAccessedDetails)
+ [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/iam-2010-05-08/GenerateServiceLastAccessedDetails)
+ [Amazon SDK for JavaScript V3](https://docs.amazonaws.cn/goto/SdkForJavaScriptV3/iam-2010-05-08/GenerateServiceLastAccessedDetails)
+ [Amazon SDK for Kotlin](https://docs.amazonaws.cn/goto/SdkForKotlin/iam-2010-05-08/GenerateServiceLastAccessedDetails)
+ [Amazon SDK for PHP V3](https://docs.amazonaws.cn/goto/SdkForPHPV3/iam-2010-05-08/GenerateServiceLastAccessedDetails)
+ [Amazon SDK for Python](https://docs.amazonaws.cn/goto/boto3/iam-2010-05-08/GenerateServiceLastAccessedDetails)
+ [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/iam-2010-05-08/GenerateServiceLastAccessedDetails)