Returns a list of S3 Access Grants instances. An S3 Access Grants instance serves as a logical grouping for your individual access grants. You can only have one S3 Access Grants instance per Region per account.
You must have the s3:ListAccessGrantsInstances
permission to use this operation.
You must URL encode any signed header values that contain spaces. For example, if your header value is my file.txt
, containing two spaces after my
, you must URL encode this value to my%20%20file.txt
.
GET /v20180820/accessgrantsinstances?maxResults=MaxResults
&nextToken=NextToken
HTTP/1.1
Host: s3-control.amazonaws.com
x-amz-account-id: AccountId
URI Request Parameters
The request uses the following URI parameters.
The maximum number of access grants that you would like returned in the List Access Grants
response. If the results include the pagination token NextToken
, make another call using the NextToken
to determine if there are more results.
Valid Range: Minimum value of 0. Maximum value of 1000.
A pagination token to request the next page of results. Pass this value into a subsequent List Access Grants Instances
request in order to retrieve the next page of results.
The AWS account ID of the S3 Access Grants instance.
Length Constraints: Maximum length of 64.
Pattern: ^\d{12}$
Required: Yes
The request does not have a request body.
Response SyntaxHTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<ListAccessGrantsInstancesResult>
<NextToken>string</NextToken>
<AccessGrantsInstancesList>
<AccessGrantsInstance>
<AccessGrantsInstanceArn>string</AccessGrantsInstanceArn>
<AccessGrantsInstanceId>string</AccessGrantsInstanceId>
<CreatedAt>timestamp</CreatedAt>
<IdentityCenterApplicationArn>string</IdentityCenterApplicationArn>
<IdentityCenterArn>string</IdentityCenterArn>
<IdentityCenterInstanceArn>string</IdentityCenterInstanceArn>
</AccessGrantsInstance>
</AccessGrantsInstancesList>
</ListAccessGrantsInstancesResult>
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
ListAccessGrants
ListAccessGrantsLocations
Did this page help you? - Yes
Thanks for letting us know we're doing a good job!
If you've got a moment, please tell us what we did right so we can do more of it.
Did this page help you? - No
Thanks for letting us know this page needs work. We're sorry we let you down.
If you've got a moment, please tell us how we can make the documentation better.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4