Once a single-region access point is created, TOS automatically generates an alias. You can share this alias with other users, who can then access TOS resources through the single-region access point. This topic describes how to use a single-region access point to access TOS resources.

Alias

Once a single-region access point is created, TOS automatically generates an alias. This alias is always unique and cannot be modified. Accessing a bucket typically requires including the bucket name in the request. However, when accessing a bucket through a single-region access point, you do not need to specify the bucket name. Instead, specify the access point alias. TOS will then route the request to the resource through the alias.

Supported operations

Not all operations are supported when you access TOS through a single-region access point. For more information, see API operations supported by single-region access points.

Notes

Single-region access points do not support anonymous access.

Steps

Use a single-region access point via API

Use a single-region access point via SDK

Use a single-region access point via tosutil

Obtain the single-region access point alias.

Log in to the TOS console.

In the left navigation pane, select Access point > Single-Region Access Point.

On the Single-Region Access Point page, click the single-region access point you want to manage.

On the Overview tab, locate the access point alias in the Basic information section. Then, find the TOS Endpoint in the Domain name section.

Use the single-region access point.

To use the single-region access point when accessing TOS via API, replace the Host in the request with <alias>.<TOS Endpoint>. Leave the other parameters as they are. For more information, see API overview.

The following example shows how to download an object (ai.png) via GetObject using the alias test-01976881ee547ed28a05b5ecaf93****-tosalias.

GET /ai.png HTTP/1.1
Host: test-01976881ee547ed28a05b5ecaf93****-tosalias.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 GMT
Authorization: authorization string

Obtain the single-region access point alias.

Log in to the TOS console.

In the left navigation pane, select Access point > Single-Region Access Point.

On the Single-Region Access Point page, click the single-region access point you want to manage.

On the Overview tab, locate the access point alias in the Basic information section.

Use the single-region access point.

To use the single-region access point when accessing TOS via SDK, replace the bucket name in the code with the alias obtained in Step 1. Leave the other parameters as they are. For more information, see SDK overview.

The following example shows how to download an object (example_dir/example.txt) locally using Go SDK and the alias test-01976881ee547ed28a05b5ecaf93****-tosalias.

package main

import (
"context"
"fmt"

"github.com/volcengine/ve-tos-golang-sdk/v2/tos"
)

func checkErr(err error) {
if err != nil {
if serverErr, ok := err.(*tos.TosServerError); ok {
fmt.Println("Error:", serverErr.Error())
fmt.Println("Request ID:", serverErr.RequestID)
fmt.Println("Response Status Code:", serverErr.StatusCode)
fmt.Println("Response Header:", serverErr.Header)
fmt.Println("Response Err Code:", serverErr.Code)
fmt.Println("Response Err Msg:", serverErr.Message)
} else if clientErr, ok := err.(*tos.TosClientError); ok {
fmt.Println("Error:", clientErr.Error())
fmt.Println("Client Cause Err:", clientErr.Cause.Error())
} else {
fmt.Println("Error:", err)
}
panic(err)
}
}

func main() {
var (
accessKey = os.Getenv("TOS_ACCESS_KEY")
secretKey = os.Getenv("TOS_SECRET_KEY")
// The endpoint for the bucket. For example, the endpoint for a bucket in China (Beijing) is https://tos-cn-beijing.volces.com.
endpoint = "https://tos-cn-beijing.volces.com"
region = "cn-beijing"
// Provide your bucket name
bucketName = "test-01976881ee547ed28a05b5ecaf93****-tosalias"

// Download the specified object
objectKey = "example_dir/example.txt"
ctx = context.Background()
)
// Initialize the client
client, err := tos.NewClientV2(endpoint, tos.WithRegion(region), tos.WithCredentials(tos.NewStaticCredentials(accessKey, secretKey)))
checkErr(err)

// Download the object to the specified location, i.e., example_dir/example.txt
getObjectToFileOutput, err := client.GetObjectToFile(ctx, &tos.GetObjectToFileInput{
GetObjectV2Input: tos.GetObjectV2Input{
Bucket: bucketName,
Key: objectKey,
},
FilePath: "example_dir/example.txt",
})
checkErr(err)
fmt.Println("GetObjectToFile Request ID:", getObjectToFileOutput.RequestID)
fmt.Println("GetObjectToFile File Size:", getObjectToFileOutput.ContentLength)
}

Torch Object Storage