Uploading objects by using an access point

This section explains how to upload objects by using an access point.

This function is supported by the following optional products:

HULFT8 Cloud Storage Option(Amazon S3) for Windows
HULFT8 Cloud Storage Option(Amazon S3) for Linux

In this example, the values retrieved after configuring the settings for AWS are assumed to be as shown in Table D.16 Values retrieved after configuring AWS.

Table D.16 Values retrieved after configuring AWS
Field	Value
Amazon Resource Name (ARN) of the access point	arn:aws:s3:ap-northeast-1:123456789012:accesspoint
Alias of the access point	accesspoint-alias

The procedure to register the following values in the Receive Storage Management Information is shown below:

Table D.17 Example of setting values for the Receive Storage Management Information
Field Name in Receive Storage Management Information	Setting Value	Register or Not
Receive Storage Management Information ID	bucket01	✓
Bucket Name	arn:aws:s3:ap-northeast-1:123456789012:accesspoint	✓
Storage Timeout	Not specified	-
Maximum number of parallels per transfer	Not specified	-
Part Size	Not specified	-
Region (*1)	ap-northeast-1	✓
Endpoint URL (*1)	Not specified	-
ACL that is applied to upload files (*1)	Not specified	-
Storage Authentication Information ID	Not specified	-

✓	:	Register the setting value
-	:	Do not register the setting value
*1	:	This field can be set only when you use Amazon S3.

You can access via an access point by specifying Amazon Resource Name (ARN) of the access point for Bucket Name.

= Remarks =

When an alias of the access point is available, specify the alias for Bucket Name to access via the access point.

In this example, specify the access point alias "accesspoint-alias" for Bucket Name to access via the access point.

Register the Bucket Name and Region setting values using the registration command of the Receive Storage Management Information.

utls3infoadd -t rcv --id bucket01 --bucket arn:aws:s3:ap-northeast-1:123456789012:accesspoint --default-region ap-northeast-1

For details on the registration command of the Storage Management Information on Amazon S3, refer to Registration command of the Storage Management Information (Amazon S3).

Note

For a field that is not specified with the option, the value "Use the default value." is set.

In this case, the value in the downward-compatible settings is used.

To check the values set in the default information for the Receive Storage Management Information on Amazon S3, refer to Output command of the Cloud Storage DB Information List (Amazon S3).

The following list is output:

$ utls3infoadd -t rcv --id bucket01 --bucket arn:aws:s3:ap-northeast-1:123456789012:accesspoint \ 
    --default-region ap-northeast-1 
The Receive Storage Management Information "bucket01" will be registered. 
Bucket:            arn:aws:s3:ap-northeast-1:123456789012:accesspoint 
Timeout:           Use the default value. 
Parallels:         Use the default value. 
Part Size:         Use the default value. 
Default Region:    ap-northeast-1 
Endpoint:          Use the default value. 
ACL:               Use the default value. 
Auth ID:           Use the default value.

Check whether the values specified for Bucket Name and Region are registered.

If you do not specify "-f" or "--force" with the registration command of the Storage Management Information, the following confirmation message is output:

Are you sure to register? [y/n]:

After the confirmation message is output, input "y" or "Y" to execute the registration command of the Storage Management Information.

The registration of the settings to upload files to the bucket via the access point is completed.