AWS AmazonS3: Document ListCallerAccessGrants instanceScope=ALL and add example
Summary
Adds a note that ListCallerAccessGrants defaults to the provided account's instance but can list grants across all AWS RAM-shared instances with instanceScope=ALL, plus a CLI example showing grants returned from two different accounts' instances.
Security assessment
Describes an authorization-visibility feature: listing grants across shared instances and identifying the owning instance via AccessGrantsInstanceArn. Security-adjacent documentation of access enumeration scope, not a fixed weakness.
Evidence
+By default, `ListCallerAccessGrants` returns grants from the S3 Access Grants instance in the AWS account ID you provide. To list grants across your own instance and every instance shared with you through AWS Resource Access Manager (AWS RAM), set the `instanceScope` parameter to `ALL`.
Diff
diff --git a/AmazonS3/latest/userguide/access-grants-list-grants.md b/AmazonS3/latest/userguide/access-grants-list-grants.md index b3dcfd2..b9c37cb 100644 --- a//AmazonS3/latest/userguide/access-grants-list-grants.md +++ b//AmazonS3/latest/userguide/access-grants-list-grants.md @@ -10,0 +11,2 @@ S3 data owners can use S3 Access Grants to create access grants for AWS Identity +By default, `ListCallerAccessGrants` returns grants from the S3 Access Grants instance in the AWS account ID you provide. To list grants across your own instance and every instance shared with you through AWS Resource Access Manager (AWS RAM), set the `instanceScope` parameter to `ALL`. Each returned grant includes the `AccessGrantsInstanceArn` of the instance it belongs to, so you can tell which account owns it. + @@ -94,0 +97,35 @@ Response: +###### Example List a caller's access grants across all shared instances + +You can list all the grants you have access to across the instances shared with you by setting the `instanceScope` parameter to `ALL`. + +Request: + + + aws s3control list-caller-access-grants \ + --account-id 111122223333 \ + --instance-scope ALL \ + --region us-east-2 \ + --max-results 5 + + +Response (grants returned from two different accounts' instances): + + + { + "CallerAccessGrantsList": [ + { + "Permission": "READWRITE", + "GrantScope": "s3://amzn-s3-demo-bucket/prefix1/*", + "ApplicationArn": "NA", + "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default" + }, + { + "Permission": "READ", + "GrantScope": "s3://amzn-s3-demo-other-bucket/reports/*", + "ApplicationArn": "NA", + "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:444455556666:access-grants/default" + } + ] + } + +