Overview of OSS on CloudBox - Object Storage Service - Alibaba Cloud Dokümantasyon Merkezi

Avantajlar

CloudBox, Alibaba Cloud'un tamamen yönetilen bir cloud hizmetidir; genel clouddan alınan entegre donanım ve yazılım yığınını şirket içi veri merkezinize dağıtır. Veri güvenliği, yerel veri işleme ve düşük gecikme süresi gereksinimlerini karşılarken genel cloud ile aynı deneyimi sunar. Kullanıma hazır bir çözüm olarak CloudBox, iş mantığına odaklanmanızı sağlar ve donanım ile cloud platformu işletme ve bakım yükünü azaltır. Daha fazla bilgi için bkz. CloudBox Nedir?.

Genel cloud ile karşılaştırıldığında CloudBox, yerel dağıtımın avantajlarını sunar: gelişmiş veri güvenliği, yerel veri işleme ve düşük gecikme süresi.

Veri güvenliği: Veriler, kontrolünüz altındaki veri merkezlerinde depolanarak veri ikametgahına ilişkin düzenleyici gereksinimleri karşılar.
Yerel veri işleme: Veriler cloud'a gönderilmek yerine yerel olarak işlenir ve bu sayede veri aktarım maliyetleri azaltılır.
Düşük gecikme süresi: CloudBox, şirket içi cihazlarınıza fiziksel olarak yakın konumdadır; bu sayede yerel cihazlar ve uygulamalarla neredeyse gerçek zamanlı etkileşim mümkün olur.
Özel kaynaklar: Depolama alanı diğer genel cloud müşterileriyle paylaşılmaz, böylece hassas verilerinizi güvenli bir şekilde depolayabilirsiniz.

Faturalama

CloudBox üzerindeki OSS için faturalama yöntemleri, ölçek genişletme kuralları ve faturalama örnekleri hakkında bilgi edinmek için bkz. Object Storage Service faturalaması.

Sınırlamalar

Her Alibaba Cloud hesabı, CloudBox üzerindeki OSS'de en fazla 100 bölgeye özel paket oluşturabilir.

CloudBox üzerindeki OSS'deki tüm paketler ve bunların içindeki nesneler yalnızca Standart depolama sınıfını destekler.
Sunucu tarafı şifreleme için CloudBox üzerindeki OSS yalnızca SSE-OSS'i destekler. SSE-KMS desteklenmez.
CloudBox üzerindeki OSS yalnızca dahili uç noktalar sağlar. CloudBox ile genel cloud OSS kaynakları arasında veri aktarmak için ağ bağlantısı kurun ve ossimport aracını kullanın.

CloudBox uç noktaları

CloudBox üzerindeki OSS paketlerine, CloudBox VPC üzerinden iki tür uç nokta kullanılarak erişilir: kontrol uç noktaları ve veri uç noktaları.

Kontrol uç noktası

Kontrol uç noktaları yalnızca CloudBox üzerindeki OSS'deki paket düzeyindeki işlemleri gerçekleştirir. Desteklenen API işlemleri için bkz. Kontrol uç noktalarının desteklediği API işlemleri.

Biçimi şu şekildedir: <Cloudbox-Id>.<Region>.oss-cloudbox-control.aliyuncs.com. Örnek: cb-f8z7yvzgwfkl9q0h****.cn-shenzhen.oss-cloudbox-control.aliyuncs.com.
Veri uç noktası

Veri uç noktaları, CloudBox üzerindeki OSS paketleri ve bunların verileriyle ilgili işlemleri gerçekleştirir. Desteklenen API işlemleri için bkz. Veri uç noktalarının desteklediği API işlemleri.

Biçimi şu şekildedir: <Cloudbox-Id>.<Region>.oss-cloudbox.aliyuncs.com. Örnek: cb-f8z7yvzgwfkl9q0h****.cn-shenzhen.oss-cloudbox.aliyuncs.com.

CloudBox'ta bir VPC oluşturur ve bu VPC içinde OSS kullanmanız gerekiyorsa etki alanı adlarını etkinleştirmek için teknik destek ile iletişime geçin.

SDK desteği

CloudBox üzerindeki OSS'e Java, Python veya Go için OSS SDK kullanılarak erişilebilir. CloudBox üzerindeki OSS için SDK işlemleri, genel cloud OSS ile aynı şekilde çağrılır. Tek fark, istemci oluştururken V4 imzalarını kullanmanız, CloudBox'ın bölgesini ve cloud box ID'sini belirtmeniz ve uç noktayı CloudBox veri etki alanı adına ayarlamanızdır. Aşağıdaki tabloda, her bir SDK için CloudBox üzerindeki OSS'i destekleyen minimum sürüm listelenmektedir:

SDK	CloudBox'u destekleyen minimum sürüm	İstemci oluşturmak için temel yapılandırma
Java SDK	3.15.0 veya sonraki sürümler	SignVersion.V4, region, cloudBoxId
Python SDK V2 (alibabacloud-oss-python-sdk-v2)	1.1.1 veya sonraki sürümler	region, cloud_box_id (veya enable_auto_detect_cloud_box_id); V4 imzaları varsayılan olarak kullanılır
Go SDK V2 (alibabacloud-oss-go-sdk-v2)	v1.2.1 veya sonraki sürümler	WithRegion, WithCloudBoxId (veya WithEnableAutoDetectCloudBoxId); V4 imzaları varsayılan olarak kullanılır

Not

Daha eski Go SDK'sı (aliyun-oss-go-sdk) da v2.2.3 sürümünden itibaren CloudBox'u destekler. İstemci oluştururken oss.AuthVersion(oss.AuthV4) değerini açıkça ayarlamanız ve bunu oss.CloudBoxId ile birlikte kullanmanız gerekir. Yeni projeler için bir sonraki nesil Go SDK V2'yi (alibabacloud-oss-go-sdk-v2) kullanmanızı öneririz.

Aşağıdaki örneklerde, CloudBox'a erişen bir istemcinin nasıl oluşturulacağı gösterilmektedir. Uç nokta, <Cloudbox-Id>.<Region>.oss-cloudbox.aliyuncs.com biçimindeki CloudBox veri etki alanı adıdır:

Java

import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.DefaultCredentialProvider;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;
import com.aliyun.oss.common.comm.SignVersion;

// The CloudBox data domain name, in the format Cloudbox-Id.Region.oss-cloudbox.aliyuncs.com.
String endpoint = "https://cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com";
// The region where the CloudBox is located.
String region = "cn-hangzhou";
// The CloudBox ID.
String cloudBoxId = "cb-f8z7yvzgwfkl9q0h****";
// Obtain access credentials from environment variables. Make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
// CloudBox requires V4 signatures.
conf.setSignatureVersion(SignVersion.V4);
OSS ossClient = OSSClientBuilder.create()
        .endpoint(endpoint)
        .credentialsProvider(new DefaultCredentialProvider(credentialsProvider.getCredentials()))
        .clientConfiguration(conf)
        .region(region)
        .cloudBoxId(cloudBoxId)
        .build();
// After the client is created, bucket and object operations are called in the same way as in public cloud OSS.

Python

import alibabacloud_oss_v2 as oss

# Load the default configuration. V4 signatures are used by default.
cfg = oss.config.load_default()
# Obtain access credentials from environment variables. Make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
cfg.credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
# The region where the CloudBox is located.
cfg.region = "cn-hangzhou"
# The CloudBox ID. This is equivalent to .cloudBoxId() in the Java SDK and sets the signing product to oss-cloudbox.
cfg.cloud_box_id = "cb-f8z7yvzgwfkl9q0h****"
# The CloudBox data domain name, in the format Cloudbox-Id.Region.oss-cloudbox.aliyuncs.com.
cfg.endpoint = "cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com"
client = oss.Client(cfg)
# After the client is created, bucket and object operations are called in the same way as in public cloud OSS.

Go

package main

import (
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

func main() {
	cfg := oss.LoadDefaultConfig().
		// Obtain access credentials from environment variables. Make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		// The region where the CloudBox is located.
		WithRegion("cn-hangzhou").
		// V4 signatures are used by default. This line sets it explicitly.
		WithSignatureVersion(oss.SignatureVersionV4).
		// The CloudBox data domain name, in the format Cloudbox-Id.Region.oss-cloudbox.aliyuncs.com.
		WithEndpoint("cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com").
		// The CloudBox ID. This is equivalent to .cloudBoxId() in the Java SDK and sets the signing product to oss-cloudbox.
		WithCloudBoxId("cb-f8z7yvzgwfkl9q0h****")
	client := oss.NewClient(cfg)
	_ = client
	// After the client is created, bucket and object operations are called in the same way as in public cloud OSS.
}

Kontrol uç noktalarının desteklediği API işlemleri

Aşağıdaki tabloda, CloudBox üzerindeki OSS'in kontrol uç noktalarının desteklediği paket düzeyindeki API işlemleri listelenmiştir.

Kategori	API	Açıklama
Temel işlemler	PutBucket	CloudBox üzerindeki OSS'de bir paket oluşturur.
	DeleteBucket	CloudBox üzerindeki OSS'den bir paketi siler.
	GetBucketInfo	CloudBox üzerindeki OSS'deki bir paket hakkında bilgi alır.
	GetBucketLocation	CloudBox üzerindeki OSS'deki bir paketin konumunu sorgular.
Erişim denetimi (ACL)	PutBucketAcl	CloudBox üzerindeki OSS'deki bir paket için erişim izinlerini yapılandırır.
Erişim denetimi (ACL)	GetBucketAcl	CloudBox üzerindeki OSS'deki bir paketin erişim izinlerini sorgular.
Yaşam döngüsü	PutBucketLifecycle	CloudBox üzerindeki OSS'deki bir paket için yaşam döngüsü kuralı yapılandırır.
	GetBucketLifecycle	CloudBox üzerindeki OSS'deki bir paketin yaşam döngüsü kurallarını sorgular.
	DeleteBucketLifecycle	CloudBox üzerindeki OSS'deki bir paketin yaşam döngüsü kurallarını siler.
Sürüm oluşturma	PutBucketVersioning	CloudBox üzerindeki OSS'deki bir paketin sürüm oluşturma durumunu yapılandırır.
Sürüm oluşturma	GetBucketVersioning	CloudBox üzerindeki OSS'deki bir paketin sürüm oluşturma durumunu sorgular.
Yetkilendirme ilkesi	PutBucketPolicy	CloudBox üzerindeki OSS'deki bir paket için yetkilendirme ilkesi yapılandırır.
	GetBucketPolicy	CloudBox üzerindeki OSS'deki bir paketin yetkilendirme ilkesini sorgular.
	DeleteBucketPolicy	CloudBox üzerindeki OSS'deki bir paketin yetkilendirme ilkesini siler.
Günlük Yönetimi	PutBucketLogging	CloudBox üzerindeki OSS'deki bir paket için günlük depolama özelliğini etkinleştirir.
	GetBucketLogging	CloudBox üzerindeki OSS'deki bir paketin günlük depolama yapılandırmasını sorgular.
	DeleteBucketLogging	CloudBox üzerindeki OSS'deki bir paket için günlük depolama özelliğini devre dışı bırakır.
Statik Web Sitesi	PutBucketWebsite	CloudBox üzerindeki OSS'deki bir paketi statik web sitesi barındırma için yapılandırır.
	GetBucketWebsite	CloudBox üzerindeki OSS'deki bir paketin statik web sitesi barındırma yapılandırmasını alır.
	DeleteBucketWebsite	CloudBox üzerindeki OSS'deki bir paket için statik web sitesi barındırmayı devre dışı bırakır.
Hotlink koruması (Referer)	PutBucketReferer	CloudBox üzerindeki OSS'deki bir paket için hotlink koruma kuralı yapılandırır.
Hotlink koruması (Referer)	GetBucketReferer	CloudBox üzerindeki OSS'deki bir paketin hotlink koruma kuralını sorgular.
Şifreleme	PutBucketEncryption	CloudBox üzerindeki OSS'deki bir paket için şifreleme kuralı yapılandırır.
	GetBucketEncryption	CloudBox üzerindeki OSS'deki bir paketin şifreleme kuralını sorgular.
	DeleteBucketEncryption	CloudBox üzerindeki OSS'deki bir paketin şifreleme kuralını siler.

Veri uç noktalarının desteklediği API işlemleri

Aşağıdaki tablolarda, CloudBox üzerindeki OSS'in veri uç noktalarının desteklediği API işlemleri listelenmiştir.

Hizmet işlemleri

API	Açıklama
ListBuckets (GetService)	İstekte bulunan kişiye ait tüm CloudBox üzerindeki OSS paketlerini döndürür.

Paket işlemleri

Kategori	API	Açıklama
Temel işlemler	PutBucket	CloudBox üzerindeki OSS'de bir paket oluşturur.
	DeleteBucket	CloudBox üzerindeki OSS'den bir paketi siler.
	GetBucket (ListObjects)	CloudBox üzerindeki OSS'deki bir paketteki tüm nesneler hakkında bilgi listeler.
	ListObjectsV2 (GetBucketV2)	CloudBox üzerindeki OSS'deki bir paketteki tüm nesneler hakkında bilgi listeler.
	GetBucketInfo	CloudBox üzerindeki OSS'deki bir paket hakkında bilgi sorgular.
	GetBucketLocation	CloudBox üzerindeki OSS'deki bir paketin konumunu sorgular.
Erişim denetimi (ACL)	PutBucketAcl	CloudBox üzerindeki OSS'deki bir paket için erişim izinlerini yapılandırır.
Erişim denetimi (ACL)	GetBucketAcl	CloudBox üzerindeki OSS'deki bir paketin erişim izinlerini sorgular.
Yaşam döngüsü	PutBucketLifecycle	CloudBox üzerindeki OSS'deki bir paket için yaşam döngüsü kuralı yapılandırır.
	GetBucketLifecycle	CloudBox üzerindeki OSS'deki bir paketin yaşam döngüsü kuralını sorgular.
	DeleteBucketLifecycle	CloudBox üzerindeki OSS'deki bir paketin yaşam döngüsü kuralını siler.
Sürüm oluşturma	PutBucketVersioning	CloudBox üzerindeki OSS'deki bir paketin sürüm oluşturma durumunu yapılandırır.
	GetBucketVersioning	CloudBox üzerindeki OSS'deki bir paketin sürüm oluşturma durumunu sorgular.
	ListObjectVersions (GetBucketVersions)	CloudBox üzerindeki OSS'deki bir paketteki tüm nesnelerin sürümlerini listeler.
Yetkilendirme ilkesi	PutBucketPolicy	CloudBox üzerindeki OSS'deki bir paket için yetkilendirme ilkesi yapılandırır.
	GetBucketPolicy	CloudBox üzerindeki OSS'deki bir paketin yetkilendirme ilkesini sorgular.
	DeleteBucketPolicy	CloudBox üzerindeki OSS'deki bir paketin yetkilendirme ilkesini siler.
Günlük Yönetimi	PutBucketLogging	CloudBox üzerindeki OSS'deki bir paket için günlük depolama özelliğini etkinleştirir.
	GetBucketLogging	CloudBox üzerindeki OSS'deki bir paketin günlük depolama yapılandırmasını sorgular.
	DeleteBucketLogging	CloudBox üzerindeki OSS'deki bir paket için günlük depolama özelliğini devre dışı bırakır.
Statik web sitesi	PutBucketWebsite	CloudBox üzerindeki OSS'deki bir paketi statik web sitesi barındırma için yapılandırır.
	GetBucketWebsite	CloudBox üzerindeki OSS'deki bir paketin statik web sitesi barındırma yapılandırmasını sorgular.
	DeleteBucketWebsite	CloudBox üzerindeki OSS'deki bir paket için statik web sitesi barındırmayı devre dışı bırakır.
Hotlink koruması (Referer)	PutBucketReferer	CloudBox üzerindeki OSS'deki bir paket için hotlink koruma kuralı yapılandırır.
Hotlink koruması (Referer)	GetBucketReferer	CloudBox üzerindeki OSS'deki bir paketin hotlink koruma kuralını sorgular.
Şifreleme	PutBucketEncryption	CloudBox üzerindeki OSS'deki bir paket için şifreleme kuralı yapılandırır.
	GetBucketEncryption	CloudBox üzerindeki OSS'deki bir paketin şifreleme kuralını sorgular.
	DeleteBucketEncryption	CloudBox üzerindeki OSS'deki bir paketin şifreleme kuralını siler.

Nesne işlemleri

Kategori	API	Açıklama
Temel işlemler	PutObject	Bir nesne yükler.
	GetObject	Bir nesneyi alır.
	CopyObject	Bir nesneyi kopyalar.
	AppendObject	Ekleme yükleme yöntemiyle bir nesne yükler.
	DeleteObject	Tek bir nesneyi siler.
	DeleteMultipleObjects	Birden çok nesneyi siler.
	HeadObject	Nesnenin içeriğini değil, yalnızca meta verilerini döndürür.
	GetObjectMeta	İçerik olmadan ETag, boyut ve Last-Modified zamanı dahil olmak üzere bir nesnenin temel meta verilerini döndürür.
Parçalı yükleme	InitiateMultipartUpload	Bir parçalı yükleme olayını başlatır.
	UploadPart	Belirtilen nesne adı ve yükleme kimliğine göre verileri parçalar halinde yükler.
	UploadPartCopy	Mevcut bir nesneden veri kopyalayarak bir parça yükler. Bu işlem, bir UploadPart isteğine x-oss-copy-source istek üstbilgisini ekleyerek yapılır.
	CompleteMultipartUpload	Tüm parçalar yüklendikten sonra parçalı yüklemeyi tamamlar.
	AbortMultipartUpload	Bir parçalı yükleme olayını iptal eder ve ilgili parçaları siler.
	ListMultipartUploads	Başlatılmış ancak tamamlanmamış veya iptal edilmemiş tüm devam eden parçalı yükleme olaylarını listeler.
	ListParts	Belirtilen bir yükleme kimliğine ait başarıyla yüklenmiş tüm parçaları listeler.
Erişim denetimi (ACL)	PutObjectACL	Bir nesnenin erişim izinlerini değiştirir.
Erişim denetimi (ACL)	GetObjectACL	Bir nesnenin erişim izinlerini sorgular.
Sembolik bağlantı	PutSymlink	Bir sembolik bağlantı oluşturur.
Sembolik bağlantı	GetSymlink	Bir sembolik bağlantıyı alır.
Etiketleme	PutObjectTagging	Bir nesnenin etiketlerini ayarlar veya günceller.
	GetObjectTagging	Bir nesnenin etiketlerini alır.
	DeleteObjectTagging	Bir nesnenin belirtilen etiketlerini siler.

Object Storage Service:Overview of OSS on CloudBox