Interface CreateAccessGrantRequest.Builder
- All Superinterfaces:
AwsRequest.Builder
,Buildable
,CopyableBuilder<CreateAccessGrantRequest.Builder,
,CreateAccessGrantRequest> S3ControlRequest.Builder
,SdkBuilder<CreateAccessGrantRequest.Builder,
,CreateAccessGrantRequest> SdkPojo
,SdkRequest.Builder
- Enclosing class:
CreateAccessGrantRequest
-
Method Summary
Modifier and TypeMethodDescriptiondefault CreateAccessGrantRequest.Builder
accessGrantsLocationConfiguration
(Consumer<AccessGrantsLocationConfiguration.Builder> accessGrantsLocationConfiguration) The configuration options of the grant location.accessGrantsLocationConfiguration
(AccessGrantsLocationConfiguration accessGrantsLocationConfiguration) The configuration options of the grant location.accessGrantsLocationId
(String accessGrantsLocationId) The ID of the registered location to which you are granting access.The ID of the Amazon Web Services account that is making this request.applicationArn
(String applicationArn) The Amazon Resource Name (ARN) of an Amazon Web Services IAM Identity Center application associated with your Identity Center instance.default CreateAccessGrantRequest.Builder
grantee
(Consumer<Grantee.Builder> grantee) The user, group, or role to which you are granting access.The user, group, or role to which you are granting access.overrideConfiguration
(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Add an optional request override configuration.overrideConfiguration
(AwsRequestOverrideConfiguration overrideConfiguration) Add an optional request override configuration.permission
(String permission) The type of access that you are granting to your S3 data, which can be set to one of the following values:permission
(Permission permission) The type of access that you are granting to your S3 data, which can be set to one of the following values:s3PrefixType
(String s3PrefixType) The type ofS3SubPrefix
.s3PrefixType
(S3PrefixType s3PrefixType) The type ofS3SubPrefix
.tags
(Collection<Tag> tags) The Amazon Web Services resource tags that you are adding to the access grant.tags
(Consumer<Tag.Builder>... tags) The Amazon Web Services resource tags that you are adding to the access grant.The Amazon Web Services resource tags that you are adding to the access grant.Methods inherited from interface software.amazon.awssdk.awscore.AwsRequest.Builder
overrideConfiguration
Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.services.s3control.model.S3ControlRequest.Builder
build
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
accountId
The ID of the Amazon Web Services account that is making this request.
- Parameters:
accountId
- The ID of the Amazon Web Services account that is making this request.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
accessGrantsLocationId
The ID of the registered location to which you are granting access. S3 Access Grants assigns this ID when you register the location. S3 Access Grants assigns the ID
default
to the default locations3://
and assigns an auto-generated ID to other locations that you register.If you are passing the
default
location, you cannot create an access grant for the entire default location. You must also specify a bucket or a bucket and prefix in theSubprefix
field.- Parameters:
accessGrantsLocationId
- The ID of the registered location to which you are granting access. S3 Access Grants assigns this ID when you register the location. S3 Access Grants assigns the IDdefault
to the default locations3://
and assigns an auto-generated ID to other locations that you register.If you are passing the
default
location, you cannot create an access grant for the entire default location. You must also specify a bucket or a bucket and prefix in theSubprefix
field.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
accessGrantsLocationConfiguration
CreateAccessGrantRequest.Builder accessGrantsLocationConfiguration(AccessGrantsLocationConfiguration accessGrantsLocationConfiguration) The configuration options of the grant location. The grant location is the S3 path to the data to which you are granting access. It contains the
S3SubPrefix
field. The grant scope is the result of appending the subprefix to the location scope of the registered location.- Parameters:
accessGrantsLocationConfiguration
- The configuration options of the grant location. The grant location is the S3 path to the data to which you are granting access. It contains theS3SubPrefix
field. The grant scope is the result of appending the subprefix to the location scope of the registered location.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
accessGrantsLocationConfiguration
default CreateAccessGrantRequest.Builder accessGrantsLocationConfiguration(Consumer<AccessGrantsLocationConfiguration.Builder> accessGrantsLocationConfiguration) The configuration options of the grant location. The grant location is the S3 path to the data to which you are granting access. It contains the
This is a convenience method that creates an instance of theS3SubPrefix
field. The grant scope is the result of appending the subprefix to the location scope of the registered location.AccessGrantsLocationConfiguration.Builder
avoiding the need to create one manually viaAccessGrantsLocationConfiguration.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toaccessGrantsLocationConfiguration(AccessGrantsLocationConfiguration)
.- Parameters:
accessGrantsLocationConfiguration
- a consumer that will call methods onAccessGrantsLocationConfiguration.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
grantee
The user, group, or role to which you are granting access. You can grant access to an IAM user or role. If you have added your corporate directory to Amazon Web Services IAM Identity Center and associated your Identity Center instance with your S3 Access Grants instance, the grantee can also be a corporate directory user or group.
- Parameters:
grantee
- The user, group, or role to which you are granting access. You can grant access to an IAM user or role. If you have added your corporate directory to Amazon Web Services IAM Identity Center and associated your Identity Center instance with your S3 Access Grants instance, the grantee can also be a corporate directory user or group.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
grantee
The user, group, or role to which you are granting access. You can grant access to an IAM user or role. If you have added your corporate directory to Amazon Web Services IAM Identity Center and associated your Identity Center instance with your S3 Access Grants instance, the grantee can also be a corporate directory user or group.
This is a convenience method that creates an instance of theGrantee.Builder
avoiding the need to create one manually viaGrantee.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tograntee(Grantee)
.- Parameters:
grantee
- a consumer that will call methods onGrantee.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
permission
The type of access that you are granting to your S3 data, which can be set to one of the following values:
-
READ
– Grant read-only access to the S3 data. -
WRITE
– Grant write-only access to the S3 data. -
READWRITE
– Grant both read and write access to the S3 data.
- Parameters:
permission
- The type of access that you are granting to your S3 data, which can be set to one of the following values:-
READ
– Grant read-only access to the S3 data. -
WRITE
– Grant write-only access to the S3 data. -
READWRITE
– Grant both read and write access to the S3 data.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
permission
The type of access that you are granting to your S3 data, which can be set to one of the following values:
-
READ
– Grant read-only access to the S3 data. -
WRITE
– Grant write-only access to the S3 data. -
READWRITE
– Grant both read and write access to the S3 data.
- Parameters:
permission
- The type of access that you are granting to your S3 data, which can be set to one of the following values:-
READ
– Grant read-only access to the S3 data. -
WRITE
– Grant write-only access to the S3 data. -
READWRITE
– Grant both read and write access to the S3 data.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
applicationArn
The Amazon Resource Name (ARN) of an Amazon Web Services IAM Identity Center application associated with your Identity Center instance. If an application ARN is included in the request to create an access grant, the grantee can only access the S3 data through this application.
- Parameters:
applicationArn
- The Amazon Resource Name (ARN) of an Amazon Web Services IAM Identity Center application associated with your Identity Center instance. If an application ARN is included in the request to create an access grant, the grantee can only access the S3 data through this application.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
s3PrefixType
The type of
S3SubPrefix
. The only possible value isObject
. Pass this value if the access grant scope is an object. Do not pass this value if the access grant scope is a bucket or a bucket and a prefix.- Parameters:
s3PrefixType
- The type ofS3SubPrefix
. The only possible value isObject
. Pass this value if the access grant scope is an object. Do not pass this value if the access grant scope is a bucket or a bucket and a prefix.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
s3PrefixType
The type of
S3SubPrefix
. The only possible value isObject
. Pass this value if the access grant scope is an object. Do not pass this value if the access grant scope is a bucket or a bucket and a prefix.- Parameters:
s3PrefixType
- The type ofS3SubPrefix
. The only possible value isObject
. Pass this value if the access grant scope is an object. Do not pass this value if the access grant scope is a bucket or a bucket and a prefix.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
tags
The Amazon Web Services resource tags that you are adding to the access grant. Each tag is a label consisting of a user-defined key and value. Tags can help you manage, identify, organize, search for, and filter resources.
- Parameters:
tags
- The Amazon Web Services resource tags that you are adding to the access grant. Each tag is a label consisting of a user-defined key and value. Tags can help you manage, identify, organize, search for, and filter resources.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The Amazon Web Services resource tags that you are adding to the access grant. Each tag is a label consisting of a user-defined key and value. Tags can help you manage, identify, organize, search for, and filter resources.
- Parameters:
tags
- The Amazon Web Services resource tags that you are adding to the access grant. Each tag is a label consisting of a user-defined key and value. Tags can help you manage, identify, organize, search for, and filter resources.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The Amazon Web Services resource tags that you are adding to the access grant. Each tag is a label consisting of a user-defined key and value. Tags can help you manage, identify, organize, search for, and filter resources.
This is a convenience method that creates an instance of theTag.Builder
avoiding the need to create one manually viaTag.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed totags(List<Tag>)
.- Parameters:
tags
- a consumer that will call methods onTag.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
overrideConfiguration
CreateAccessGrantRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration) Description copied from interface:AwsRequest.Builder
Add an optional request override configuration.- Specified by:
overrideConfiguration
in interfaceAwsRequest.Builder
- Parameters:
overrideConfiguration
- The override configuration.- Returns:
- This object for method chaining.
-
overrideConfiguration
CreateAccessGrantRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Description copied from interface:AwsRequest.Builder
Add an optional request override configuration.- Specified by:
overrideConfiguration
in interfaceAwsRequest.Builder
- Parameters:
builderConsumer
- AConsumer
to which an emptyAwsRequestOverrideConfiguration.Builder
will be given.- Returns:
- This object for method chaining.
-