AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
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 Web Services 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. For more information about services and actions for which
action last accessed information is displayed, see IAM
action last accessed information services and actions.
The service last accessed data includes all attempts to access an Amazon Web Services
API, not just the successful ones. This includes all attempts that were made using
the Amazon Web Services Management Console, the Amazon Web Services 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 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 – Use this operation for users, groups, roles, or policies to list every Amazon Web Services 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 – Use this operation for groups and policies to list information about the associated entities (users or roles) that attempted to access a specific Amazon Web Services 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 operation.
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, Organizations policies, IAM permissions boundaries, and STS assume role policies. It only applies permissions policy logic. For more about the evaluation of policy types, see Evaluating policies in the IAM User Guide.
For more information about service and action last accessed data, see Reducing permissions using service last accessed data in the IAM User Guide.
For .NET Core this operation is only available in asynchronous form. Please refer to GenerateServiceLastAccessedDetailsAsync.
Namespace: Amazon.IdentityManagement
Assembly: AWSSDK.IdentityManagement.dll
Version: 3.x.y.z
public virtual GenerateServiceLastAccessedDetailsResponse GenerateServiceLastAccessedDetails( GenerateServiceLastAccessedDetailsRequest request )
Container for the necessary parameters to execute the GenerateServiceLastAccessedDetails service method.
| Exception | Condition |
|---|---|
| InvalidInputException | The request was rejected because an invalid or out-of-range value was supplied for an input parameter. |
| NoSuchEntityException | The request was rejected because it referenced a resource entity that does not exist. The error message describes the resource. |
The following operation generates a report for the policy: ExamplePolicy1
var client = new AmazonIdentityManagementServiceClient();
var response = client.GenerateServiceLastAccessedDetails(new GenerateServiceLastAccessedDetailsRequest
{
Arn = "arn:aws:iam::123456789012:policy/ExamplePolicy1"
});
string jobId = response.JobId;
.NET Framework:
Supported in: 4.5, 4.0, 3.5