Mengakses OSS dengan menggunakan nama domain bucket - Object Storage Service

OSS menyediakan serangkaian titik akhir default untuk setiap bucket. Titik akhir ini memungkinkan Anda mengakses sumber daya OSS secara fleksibel sesuai kebutuhan bisnis dan lingkungan jaringan Anda, seperti Internet, jaringan internal, atau jaringan akselerasi transfer.

Konsep inti

Titik akhir OSS standar terdiri dari beberapa bagian. Memahami empat konsep inti berikut merupakan kunci untuk mengakses OSS dengan benar:

Konsep	Deskripsi	Contoh	Penggunaan
ID Wilayah	ID wilayah umum	`ap-southeast-1`	Digunakan dalam skenario seperti penandatanganan V4 dengan SDK atau ossutil.
ID wilayah khusus OSS	ID wilayah khusus OSS	`oss-ap-southeast-1`	Digunakan untuk membentuk titik akhir dan dalam skenario seperti parameter permintaan dan respons API.
Titik akhir	Titik akhir layanan	`oss-ap-southeast-1.aliyuncs.com`	Dikonfigurasi dalam SDK atau ossutil. Digunakan dalam skenario seperti menjalin konektivitas jaringan dengan layanan OSS.
Nama domain bucket	Titik akhir untuk bucket tertentu	`bucket-name.oss-ap-southeast-1.aliyuncs.com`	Digunakan dalam skenario seperti akses langsung melalui browser, menghasilkan URL yang ditandatangani, atau menghosting situs web statis.

Keempat konsep ini bersifat hierarkis. ID Wilayah mengidentifikasi lokasi geografis. OSS menetapkan ID wilayah khusus OSS yang sesuai untuk lokasi tersebut. ID wilayah khusus OSS digabungkan dengan akhiran nama domain untuk membentuk Titik Akhir (titik akhir layanan). Untuk mengakses bucket tertentu, gunakan Nama Domain Bucket (titik akhir sumber daya), yang dibuat dengan menggabungkan nama bucket dengan Titik Akhir.

Jenis Nama Domain

OSS menyediakan berbagai jenis titik akhir berdasarkan lingkungan jaringan dan kebutuhan performa Anda.

Penting

Titik akhir publik

Titik akhir ini digunakan untuk akses melalui Internet. Gunakan titik akhir ini untuk aplikasi web, klien seluler, dan akses lintas wilayah.

Format nama domain

Titik akhir: oss-[RegionID].aliyuncs.com
Nama domain bucket: [BucketName].oss-[RegionID].aliyuncs.com

Contoh akses

URL File

Contoh berikut menunjukkan cara mendapatkan URL yang ditandatangani untuk file di bucket pribadi dari konsol. Untuk metode lain mendapatkan URL yang ditandatangani, lihat Menggunakan URL yang telah ditentukan sebelumnya untuk mengunduh atau melihat pratinjau file.

Buka halaman Daftar Bucket dan klik bucket target.
Klik File Name pada file target atau Details di kolom Tindakan.
Untuk Domain Name, pilih Public Endpoint, lalu klik Copy Object URL.
Akses URL tersebut di browser.

Saat Anda menggunakan nama domain bucket OSS untuk mengakses file seperti HTML atau gambar, browser akan memaksa unduhan alih-alih menampilkannya secara langsung. Untuk melihat pratinjau file secara online, gunakan nama domain kustom untuk mengakses OSS.

ossutil

Contoh berikut menunjukkan cara menggunakan alat antarmuka baris perintah (CLI) ossutil 2.0 untuk mengunduh file. Sebelum memulai, instal dan konfigurasikan ossutil 2.0. Alat ini menggunakan titik akhir publik secara default. Anda juga dapat secara eksplisit menentukan titik akhir publik menggunakan parameter -e.

ossutil cp oss://example-bucket/dest.jpg dest.jpg -e oss-ap-southeast-1.aliyuncs.com

SDK

Bagian berikut menyediakan contoh integrasi kit pengembangan perangkat lunak (SDK) untuk bahasa umum. Untuk contoh integrasi dalam bahasa lain, lihat metode inisialisasi untuk bahasa yang sesuai di Referensi SDK.

Java SDK V2

Saat menginisialisasi klien SDK, titik akhir publik digunakan secara default. Anda hanya perlu menentukan ID Wilayah dan tidak perlu menentukan titik akhir. Untuk contoh kode inisialisasi lengkap, lihat OSS Java SDK V2 (Pratinjau).

Java SDK V1

Tentukan titik akhir publik saat menginisialisasi instance klien OSS. Untuk kode inisialisasi lengkap, lihat OSS Java SDK V1.

// Gunakan titik akhir publik Singapura sebagai contoh.
String endpoint = "oss-ap-southeast-1.aliyuncs.com";
// Inisialisasi klien OSS.
OSS ossClient = OSSClientBuilder.create()
        .credentialsProvider(provider)
        .clientConfiguration(clientBuilderConfiguration)
        .region("ap-southeast-1")
        .endpoint(endpoint)
        .build();

Python SDK V2

Python SDK V1

Tentukan titik akhir publik saat menginisialisasi instance klien OSS. Untuk kode inisialisasi lengkap, lihat Inisialisasi (Python SDK V1).

# Gunakan titik akhir publik Singapura sebagai contoh.
endpoint = "https://oss-ap-southeast-1.aliyuncs.com"
# Inisialisasi instance klien OSS.
bucket = oss.Bucket(auth, endpoint, bucket, region="ap-southeast-1")

Go SDK V2

Go SDK V1

Tentukan titik akhir publik saat menginisialisasi instance klien OSS. Untuk kode inisialisasi lengkap, lihat Konfigurasi klien.

// Buat instance klien OSS.
client, _ := oss.New(
        "oss-ap-southeast-1.aliyuncs.com",	// Gunakan titik akhir publik Singapura sebagai contoh.
        "",
        "",
        oss.SetCredentialsProvider(&provider),
        oss.AuthVersion(oss.AuthV4),
        oss.Region("ap-southeast-1"),
)

Titik akhir internal

Titik akhir ini digunakan untuk akses melalui jaringan internal Alibaba Cloud. Titik akhir ini ideal untuk skenario di mana Instance ECS perlu mengakses OSS di wilayah yang sama. Menggunakan jaringan internal untuk mengakses OSS membantu Anda menghindari biaya lalu lintas jaringan publik serta memberikan konektivitas jaringan yang lebih stabil dengan latensi lebih rendah.

Format nama domain

Titik akhir: oss-[RegionID]-internal.aliyuncs.com
Nama domain bucket: [BucketName].oss-[RegionID]-internal.aliyuncs.com

Catatan penggunaan

Optimalisasi konfigurasi DNS
Saat menggunakan titik akhir internal, konfigurasikan alamat DNS privat Alibaba Cloud (100.100.2.136 dan 100.100.2.138). Hal ini memastikan Anda mendapatkan alamat IP virtual (VIP) yang benar dan menghindari masalah akses OSS akibat kesalahan resolusi DNS.
Integritas routing segmen jaringan VIP
Di setiap wilayah, OSS mengalokasikan rentang alamat tetap untuk segmen jaringan VIP internal. Sistem secara dinamis mengganti alamat IP dalam segmen jaringan VIP ini. Jika perangkat lokal atau pusat data mengakses OSS melalui jaringan internal, konfigurasi routing harus mencakup seluruh segmen jaringan VIP. Jika tidak, koneksi mungkin gagal karena routing jaringan yang tidak lengkap. Untuk informasi lebih lanjut tentang segmen jaringan VIP internal setiap wilayah, lihat Wilayah dan titik akhir.
Penting
Pastikan konfigurasi routing Anda mencakup seluruh segmen jaringan VIP untuk menghindari masalah konektivitas. Anda bertanggung jawab atas segala kerugian ketersediaan layanan OSS yang disebabkan oleh konfigurasi segmen jaringan VIP yang tidak lengkap.
Konfigurasi aturan grup keamanan
Saat menggunakan Instance ECS untuk mengakses OSS melalui jaringan internal, aturan grup keamanan tidak boleh memblokir akses ke segmen jaringan VIP. Hal ini memastikan konektivitas jaringan yang tepat.

Contoh akses

ossutil

Contoh berikut menunjukkan cara menggunakan alat antarmuka baris perintah (CLI) ossutil 2.0 pada Instance ECS untuk mengunduh file di wilayah yang sama. Sebelum memulai, instal dan konfigurasikan ossutil 2.0. Anda dapat menentukan titik akhir internal selama konfigurasi atau menggunakan parameter -e saat mengunduh file.

ossutil cp oss://example-bucket/dest.jpg dest.jpg -e oss-ap-southeast-1-internal.aliyuncs.com

SDK

Bagian berikut menyediakan contoh integrasi SDK untuk bahasa umum. Untuk informasi lebih lanjut tentang contoh integrasi dalam bahasa lain, lihat metode inisialisasi untuk bahasa tertentu di Referensi SDK.

Java SDK V2

Saat menginisialisasi instance klien OSS, Anda dapat mengatur titik akhir internal dengan menentukan parameter Endpoint atau menggunakan useInternalEndpoint(true). Untuk kode inisialisasi lengkap, lihat OSS Java SDK V2 (Pratinjau).

Metode 1: Tentukan titik akhir internal

// Gunakan titik akhir internal Singapura sebagai contoh.
String endpoint = "oss-ap-southeast-1-internal.aliyuncs.com";
// Inisialisasi klien OSS.
OSSClient client = OSSClient.newBuilder()
        .credentialsProvider(provider)
        .region("ap-southeast-1")
        .endpoint(endpoint)
        .build();

Metode 2: Gunakan useInternalEndpoint(true)

// Inisialisasi klien OSS.
OSSClient client = OSSClient.newBuilder()
        .credentialsProvider(provider)
        .region("ap-southeast-1")
        .useInternalEndpoint(true)
        .build();

Java SDK V1

Tentukan titik akhir internal saat menginisialisasi instance klien OSS. Untuk kode inisialisasi lengkap, lihat OSS Java SDK V1.

// Gunakan titik akhir internal Singapura sebagai contoh.
String endpoint = "oss-ap-southeast-1-internal.aliyuncs.com";
// Inisialisasi klien OSS.
OSS ossClient = OSSClientBuilder.create()
        .credentialsProvider(provider)
        .clientConfiguration(clientBuilderConfiguration)
        .region("ap-southeast-1")
        .endpoint(endpoint)
        .build();

Python SDK V2

Saat menginisialisasi instance klien OSS, Anda dapat mengatur titik akhir internal dengan menentukan parameter Endpoint atau dengan mengatur use_internal_endpoint = True. Untuk kode inisialisasi lengkap, lihat OSS Python SDK V2.

Metode 1: Tentukan titik akhir internal

# Gunakan titik akhir internal Singapura sebagai contoh.
config.endpoint = "https://oss-ap-southeast-1-internal.aliyuncs.com"
# Inisialisasi klien OSS.
client = oss.Client(config)

Metode 2: Gunakan use_internal_endpoint = True

config.use_internal_endpoint = True
# Inisialisasi klien OSS.
client = oss.Client(config)

Python SDK V1

Tentukan titik akhir internal saat menginisialisasi instance klien OSS. Untuk kode inisialisasi lengkap, lihat Inisialisasi (Python SDK V1).

# Gunakan titik akhir internal Singapura sebagai contoh.
endpoint = "oss-ap-southeast-1-internal.aliyuncs.com"
# Inisialisasi instance klien OSS.
bucket = oss.Bucket(auth, endpoint, bucket, region="ap-southeast-1")

Go SDK V2

Saat menginisialisasi instance klien OSS, Anda dapat mengatur titik akhir internal dengan menentukan parameter Endpoint atau menggunakan WithUseInternalEndpoint(true). Untuk kode inisialisasi lengkap, lihat OSS Go SDK V2.

Metode 1: Tentukan titik akhir internal

// Konfigurasi klien OSS. Tetapkan penyedia kredensial dan wilayah layanan.
config := oss.LoadDefaultConfig().
        WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
        WithRegion("ap-southeast-1").
        WithEndpoint("oss-ap-southeast-1-internal.aliyuncs.com") // Gunakan titik akhir internal Singapura sebagai contoh.

// Inisialisasi instance klien OSS.
client := oss.NewClient(config)

Metode 2: Menggunakan WithUseInternalEndpoint(true)

// Konfigurasi klien OSS. Tetapkan penyedia kredensial dan wilayah layanan.
config := oss.LoadDefaultConfig().
        WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
        WithRegion("ap-southeast-1").
        WithUseInternalEndpoint(true)

// Inisialisasi instance klien OSS.
client := oss.NewClient(config)

Go SDK V1

Tentukan titik akhir internal saat menginisialisasi instance klien OSS. Untuk kode inisialisasi lengkap, lihat Konfigurasi klien.

// Buat instance klien OSS.
client, _ := oss.New(
        "oss-ap-southeast-1-internal.aliyuncs.com", // Gunakan titik akhir internal Singapura sebagai contoh.
        "",
        "",
        oss.SetCredentialsProvider(&provider),
        oss.AuthVersion(oss.AuthV4),
        oss.Region("ap-southeast-1"),
)

Titik akhir akselerasi transfer

Titik akhir akselerasi transfer adalah titik akhir khusus yang tersedia setelah Anda mengaktifkan akselerasi transfer untuk OSS. Titik akhir ini menggunakan node tepi Akselerator Global untuk mengoptimalkan jalur transfer data guna unggahan dan unduhan berkecepatan tinggi lintas wilayah dan negara. Titik akhir ini secara signifikan meningkatkan kualitas jaringan untuk akses jarak jauh.

Format nama domain

Titik akhir: oss-accelerate.aliyuncs.com
Nama domain bucket: [BucketName].oss-accelerate.aliyuncs.com

Contoh akses

ossutil

Contoh berikut menunjukkan cara menggunakan alat CLI ossutil 2.0 pada Instance ECS di wilayah Singapura untuk mengunduh file dari negara lain. Sebelum memulai, instal dan konfigurasikan ossutil 2.0. Anda dapat menggunakan titik akhir akselerasi selama konfigurasi atau menentukannya menggunakan parameter -e saat mengunduh file.

ossutil cp oss://example-bucket/dest.jpg dest.jpg -e oss-accelerate.aliyuncs.com

SDK

Bagian berikut menyediakan contoh integrasi SDK untuk bahasa umum. Untuk contoh dalam bahasa lain, lihat metode inisialisasi di Referensi SDK.

Java SDK V2

Saat menginisialisasi instance klien OSS, Anda dapat mengatur titik akhir akselerasi dengan menentukan Endpoint atau menggunakan useAccelerateEndpoint(true). Untuk kode inisialisasi lengkap, lihat OSS Java SDK V2 (Pratinjau).

Metode 1: Tentukan titik akhir akselerasi

String endpoint = "oss-accelerate.aliyuncs.com";
// Inisialisasi klien OSS.
OSSClient client = OSSClient.newBuilder()
        .credentialsProvider(provider)
        .region("ap-southeast-1")
        .endpoint(endpoint)
        .build();

Metode 2: Gunakan useAccelerateEndpoint(true)

// Inisialisasi klien OSS.
OSSClient client = OSSClient.newBuilder()
        .credentialsProvider(provider)
        .region("ap-southeast-1")
        .useAccelerateEndpoint(true)
        .build();

Java SDK V1

Anda dapat menentukan titik akhir akselerasi saat menginisialisasi instance klien OSS. Untuk kode inisialisasi lengkap, lihat OSS Java SDK V1.

String endpoint = "oss-accelerate.aliyuncs.com";
// Inisialisasi klien OSS.
OSS ossClient = OSSClientBuilder.create()
        .credentialsProvider(provider)
        .clientConfiguration(clientBuilderConfiguration)
        .region("ap-southeast-1")
        .endpoint(endpoint)
        .build();

Python SDK V2

Saat menginisialisasi instance klien OSS, Anda dapat mengatur titik akhir akselerasi dengan menentukan Endpoint atau menggunakan use_accelerate_endpoint = True. Untuk kode inisialisasi lengkap, lihat OSS Python SDK V2.

Metode 1: Tentukan titik akhir akselerasi

config.endpoint = "oss-accelerate.aliyuncs.com"
# Inisialisasi klien OSS.
client = oss.Client(config)

Metode 2: Gunakan use_accelerate_endpoint = True

config.use_accelerate_endpoint = True
# Inisialisasi klien OSS.
client = oss.Client(config)

Python SDK V1

Anda dapat menentukan titik akhir akselerasi saat menginisialisasi instance klien OSS. Untuk kode inisialisasi lengkap, lihat Inisialisasi (Python SDK V1).

endpoint = "oss-accelerate.aliyuncs.com"
# Inisialisasi instance klien OSS.
bucket = oss.Bucket(auth, endpoint, bucket, region="ap-southeast-1")

Go SDK V2

Saat menginisialisasi instance klien OSS, Anda dapat mengatur titik akhir akselerasi dengan menentukan Endpoint atau menggunakan WithUseAccelerateEndpoint(true). Untuk kode inisialisasi lengkap, lihat OSS Go SDK V2.

Metode 1: Tentukan titik akhir akselerasi

// Konfigurasi klien OSS. Tetapkan penyedia kredensial dan wilayah layanan.
config := oss.LoadDefaultConfig().
        WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
        WithRegion("ap-southeast-1").
        WithEndpoint("oss-accelerate.aliyuncs.com")

// Inisialisasi instance klien OSS.
client := oss.NewClient(config)

Metode 2: Gunakan WithUseAccelerateEndpoint(true)

// Konfigurasi klien OSS. Tetapkan penyedia kredensial dan wilayah layanan.
config := oss.LoadDefaultConfig().
        WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
        WithRegion("ap-southeast-1").
        WithUseAccelerateEndpoint(true)

// Inisialisasi instance klien OSS.
client := oss.NewClient(config)

Go SDK V1

Anda dapat menentukan titik akhir akselerasi saat menginisialisasi instance klien OSS. Untuk kode inisialisasi lengkap, lihat Konfigurasi klien.

// Buat instance klien OSS.
client, _ := oss.New(
        "oss-accelerate.aliyuncs.com",
        "",
        "",
        oss.SetCredentialsProvider(&provider),
        oss.AuthVersion(oss.AuthV4),
        oss.Region("ap-southeast-1"),
)

Dukungan protokol

Protokol HTTP/HTTPS

Semua titik akhir dan nama domain bucket di semua wilayah mendukung akses melalui HTTP dan HTTPS. Untuk transfer data yang aman, gunakan HTTPS di lingkungan produksi.

Protokol IP

Semua wilayah mendukung akses IPv4. Beberapa wilayah juga mendukung akses dual-stack ke titik akhir melalui IPv4 dan IPv6. Hal ini memungkinkan klien di lingkungan jaringan IPv6 untuk terhubung langsung ke sumber daya OSS. Untuk titik akhir yang mendukung IPv6, klien tidak memerlukan konfigurasi khusus. Di lingkungan jaringan IPv6 murni atau dual-stack, DNS secara otomatis melakukan resolusi dan memprioritaskan alamat IPv6 untuk koneksi. Instance ECS di jaringan klasik tidak dapat mengakses sumber daya OSS melalui IPv4 maupun IPv6.

Cara memverifikasi dukungan IPv6 untuk titik akhir

Anda dapat menggunakan perintah dig AAAA untuk memverifikasi apakah titik akhir mendukung akses IPv6.

dig AAAA ap-southeast-1.oss.aliyuncs.com

Jika titik akhir mendukung IPv6, bagian ANSWER SECTION pada keluaran perintah akan menampilkan catatan AAAA. Catatan ini menunjukkan bahwa alamat IPv6 telah dikonfigurasi untuk nama domain tersebut.

ap-southeast-1.oss.aliyuncs.com. 60 IN  AAAA    240b:4000:f10::2c5

Referensi

Wilayah dan titik akhir