Skip to content

Client

s3control R Documentation

AWS S3 Control

Description

Amazon Web Services S3 Control provides access to Amazon S3 control plane actions.

Usage

s3control(
  config = list(),
  credentials = list(),
  endpoint = NULL,
  region = NULL
)

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

  • endpoint: The complete URL to use for the constructed client.

  • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. ⁠http://s3.amazonaws.com/BUCKET/KEY⁠.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- s3control(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

associate_access_grants_identity_center
Associate your S3 Access Grants instance with an Amazon Web Services IAM Identity Center instance
create_access_grant
Creates an access grant that gives a grantee access to your S3 data
create_access_grants_instance
Creates an S3 Access Grants instance, which serves as a logical grouping for access grants
create_access_grants_location
The S3 data location that you would like to register in your S3 Access Grants instance
create_access_point
This operation is not supported by directory buckets
create_access_point_for_object_lambda
This operation is not supported by directory buckets
create_bucket
This action creates an Amazon S3 on Outposts bucket
create_job
This operation creates an S3 Batch Operations job
create_multi_region_access_point
This operation is not supported by directory buckets
create_storage_lens_group
Creates a new S3 Storage Lens group and associates it with the specified Amazon Web Services account ID
delete_access_grant
Deletes the access grant from the S3 Access Grants instance
delete_access_grants_instance
Deletes your S3 Access Grants instance
delete_access_grants_instance_resource_policy
Deletes the resource policy of the S3 Access Grants instance
delete_access_grants_location
Deregisters a location from your S3 Access Grants instance
delete_access_point
This operation is not supported by directory buckets
delete_access_point_for_object_lambda
This operation is not supported by directory buckets
delete_access_point_policy
This operation is not supported by directory buckets
delete_access_point_policy_for_object_lambda
This operation is not supported by directory buckets
delete_bucket
This action deletes an Amazon S3 on Outposts bucket
delete_bucket_lifecycle_configuration
This action deletes an Amazon S3 on Outposts bucket's lifecycle configuration
delete_bucket_policy
This action deletes an Amazon S3 on Outposts bucket policy
delete_bucket_replication
This operation deletes an Amazon S3 on Outposts bucket's replication configuration
delete_bucket_tagging
This action deletes an Amazon S3 on Outposts bucket's tags
delete_job_tagging
Removes the entire tag set from the specified S3 Batch Operations job
delete_multi_region_access_point
This operation is not supported by directory buckets
delete_public_access_block
This operation is not supported by directory buckets
delete_storage_lens_configuration
This operation is not supported by directory buckets
delete_storage_lens_configuration_tagging
This operation is not supported by directory buckets
delete_storage_lens_group
Deletes an existing S3 Storage Lens group
describe_job
Retrieves the configuration parameters and status for a Batch Operations job
describe_multi_region_access_point_operation
This operation is not supported by directory buckets
dissociate_access_grants_identity_center
Dissociates the Amazon Web Services IAM Identity Center instance from the S3 Access Grants instance
get_access_grant
Get the details of an access grant from your S3 Access Grants instance
get_access_grants_instance
Retrieves the S3 Access Grants instance for a Region in your account
get_access_grants_instance_for_prefix
Retrieve the S3 Access Grants instance that contains a particular prefix
get_access_grants_instance_resource_policy
Returns the resource policy of the S3 Access Grants instance
get_access_grants_location
Retrieves the details of a particular location registered in your S3 Access Grants instance
get_access_point
This operation is not supported by directory buckets
get_access_point_configuration_for_object_lambda
This operation is not supported by directory buckets
get_access_point_for_object_lambda
This operation is not supported by directory buckets
get_access_point_policy
This operation is not supported by directory buckets
get_access_point_policy_for_object_lambda
This operation is not supported by directory buckets
get_access_point_policy_status
This operation is not supported by directory buckets
get_access_point_policy_status_for_object_lambda
This operation is not supported by directory buckets
get_bucket
Gets an Amazon S3 on Outposts bucket
get_bucket_lifecycle_configuration
This action gets an Amazon S3 on Outposts bucket's lifecycle configuration
get_bucket_policy
This action gets a bucket policy for an Amazon S3 on Outposts bucket
get_bucket_replication
This operation gets an Amazon S3 on Outposts bucket's replication configuration
get_bucket_tagging
This action gets an Amazon S3 on Outposts bucket's tags
get_bucket_versioning
This operation returns the versioning state for S3 on Outposts buckets only
get_data_access
Returns a temporary access credential from S3 Access Grants to the grantee or client application
get_job_tagging
Returns the tags on an S3 Batch Operations job
get_multi_region_access_point
This operation is not supported by directory buckets
get_multi_region_access_point_policy
This operation is not supported by directory buckets
get_multi_region_access_point_policy_status
This operation is not supported by directory buckets
get_multi_region_access_point_routes
This operation is not supported by directory buckets
get_public_access_block
This operation is not supported by directory buckets
get_storage_lens_configuration
This operation is not supported by directory buckets
get_storage_lens_configuration_tagging
This operation is not supported by directory buckets
get_storage_lens_group
Retrieves the Storage Lens group configuration details
list_access_grants
Returns the list of access grants in your S3 Access Grants instance
list_access_grants_instances
Returns a list of S3 Access Grants instances
list_access_grants_locations
Returns a list of the locations registered in your S3 Access Grants instance
list_access_points
This operation is not supported by directory buckets
list_access_points_for_object_lambda
This operation is not supported by directory buckets
list_jobs
Lists current S3 Batch Operations jobs as well as the jobs that have ended within the last 90 days for the Amazon Web Services account making the request
list_multi_region_access_points
This operation is not supported by directory buckets
list_regional_buckets
This operation is not supported by directory buckets
list_storage_lens_configurations
This operation is not supported by directory buckets
list_storage_lens_groups
Lists all the Storage Lens groups in the specified home Region
list_tags_for_resource
This operation allows you to list all the Amazon Web Services resource tags for a specified resource
put_access_grants_instance_resource_policy
Updates the resource policy of the S3 Access Grants instance
put_access_point_configuration_for_object_lambda
This operation is not supported by directory buckets
put_access_point_policy
This operation is not supported by directory buckets
put_access_point_policy_for_object_lambda
This operation is not supported by directory buckets
put_bucket_lifecycle_configuration
This action puts a lifecycle configuration to an Amazon S3 on Outposts bucket
put_bucket_policy
This action puts a bucket policy to an Amazon S3 on Outposts bucket
put_bucket_replication
This action creates an Amazon S3 on Outposts bucket's replication configuration
put_bucket_tagging
This action puts tags on an Amazon S3 on Outposts bucket
put_bucket_versioning
This operation sets the versioning state for S3 on Outposts buckets only
put_job_tagging
Sets the supplied tag-set on an S3 Batch Operations job
put_multi_region_access_point_policy
This operation is not supported by directory buckets
put_public_access_block
This operation is not supported by directory buckets
put_storage_lens_configuration
This operation is not supported by directory buckets
put_storage_lens_configuration_tagging
This operation is not supported by directory buckets
submit_multi_region_access_point_routes
This operation is not supported by directory buckets
tag_resource
Creates a new Amazon Web Services resource tag or updates an existing resource tag
untag_resource
This operation removes the specified Amazon Web Services resource tags from an S3 resource
update_access_grants_location
Updates the IAM role of a registered location in your S3 Access Grants instance
update_job_priority
Updates an existing S3 Batch Operations job's priority
update_job_status
Updates the status for the specified job
update_storage_lens_group
Updates the existing Storage Lens group

Examples

## Not run: 
svc <- s3control()
svc$associate_access_grants_identity_center(
  Foo = 123
)

## End(Not run)