Overview of OSS on CloudBox - Object Storage Service - Centre de documentation Alibaba Cloud

Avantages

CloudBox est un service cloud entièrement géré par Alibaba Cloud qui déploie une pile matérielle et logicielle intégrée du cloud public dans votre centre de données sur site. Il offre la même expérience que le cloud public tout en répondant aux exigences de sécurité des données, de traitement local des données et de faible latence. En tant que solution clé en main, CloudBox vous permet de vous concentrer sur la logique métier et réduit la maintenance opérationnelle du matériel et de la plateforme cloud. Pour plus d'informations, consultez Qu'est-ce que CloudBox ?.

Par rapport au cloud public, CloudBox présente les avantages suivants liés au déploiement local : amélioration de la sécurité des données, traitement local des données et faible latence.

Sécurité des données : Les données sont stockées dans des centres de données sous votre contrôle, ce qui satisfait aux exigences réglementaires en matière de résidence des données.
Traitement local des données : Les données sont traitées localement au lieu d'être envoyées vers le cloud, ce qui réduit les coûts de transfert de données.
Faible latence : CloudBox se trouve physiquement à proximité de vos appareils sur site, permettant une interaction quasi temps réel avec les appareils et applications locaux.
Ressources dédiées : Le stockage n'est pas partagé avec d'autres clients du cloud public, ce qui vous permet de stocker en toute sécurité vos données sensibles.

Facturation

Pour obtenir des informations sur les méthodes de facturation, les règles de mise à l'échelle horizontale et des exemples de facturation pour OSS sur CloudBox, consultez Facturation d'Object Storage Service.

Limites

Chaque compte Alibaba Cloud peut créer un maximum de 100 buckets spécifiques à une région dans OSS sur CloudBox.

Tous les buckets dans OSS sur CloudBox et les objets qu'ils contiennent prennent uniquement en charge la classe de stockage Standard.
Pour le chiffrement côté serveur, OSS sur CloudBox prend uniquement en charge SSE-OSS. SSE-KMS n'est pas pris en charge.
OSS sur CloudBox fournit uniquement des endpoints internes. Pour transférer des données entre CloudBox et les ressources OSS du cloud public, établissez une connexion réseau et utilisez ossimport.

Endpoints CloudBox

L'accès aux buckets OSS sur CloudBox s'effectue via un VPC CloudBox à l'aide de deux types d'endpoints : les endpoints de contrôle et les endpoints de données.

Endpoint de contrôle

Les endpoints de contrôle gèrent uniquement les opérations au niveau du bucket dans OSS sur CloudBox. Pour connaître les opérations API prises en charge, consultez Opérations API prises en charge par les endpoints de contrôle.

Le format est <Cloudbox-Id>.<Region>.oss-cloudbox-control.aliyuncs.com. Par exemple : cb-f8z7yvzgwfkl9q0h****.cn-shenzhen.oss-cloudbox-control.aliyuncs.com.
Endpoint de données

Les endpoints de données gèrent les opérations sur les buckets OSS sur CloudBox et leurs données. Pour connaître les opérations API prises en charge, consultez Opérations API prises en charge par les endpoints de données.

Le format est <Cloudbox-Id>.<Region>.oss-cloudbox.aliyuncs.com. Par exemple : cb-f8z7yvzgwfkl9q0h****.cn-shenzhen.oss-cloudbox.aliyuncs.com.

Si vous créez un VPC dans CloudBox et devez utiliser OSS au sein de ce VPC, contactez le support technique pour activer les noms de domaine.

Support SDK

Il est possible d'accéder à OSS sur CloudBox à l'aide du SDK OSS pour Java, Python ou Go. Pour OSS sur CloudBox, les appels aux opérations SDK s'effectuent de la même manière que pour OSS dans le cloud public. La seule différence réside dans la création du client : vous devez utiliser des signatures V4, spécifier la région et l'ID du CloudBox, et définir l'endpoint sur le nom de domaine de données du CloudBox. Le tableau suivant indique la version minimale prenant en charge OSS sur CloudBox pour chaque SDK :

SDK

Version minimale prenant en charge CloudBox

Configuration clé pour la création d'un client

SDK Java

3.15.0 ou ultérieure

SignVersion.V4, region, cloudBoxId

SDK Python V2 (alibabacloud-oss-python-sdk-v2)

1.1.1 ou ultérieure

region, cloud_box_id (ou enable_auto_detect_cloud_box_id) ; les signatures V4 sont utilisées par défaut

SDK Go V2 (alibabacloud-oss-go-sdk-v2)

v1.2.1 ou ultérieure

WithRegion, WithCloudBoxId (ou WithEnableAutoDetectCloudBoxId) ; les signatures V4 sont utilisées par défaut

Remarque

L'ancien SDK Go (aliyun-oss-go-sdk) prend également en charge CloudBox à partir de la version v2.2.3. Lors de la création d'un client, vous devez définir explicitement oss.AuthVersion(oss.AuthV4) et l'utiliser conjointement avec oss.CloudBoxId. Pour les nouveaux projets, nous vous recommandons d'utiliser le SDK Go V2 de nouvelle génération (alibabacloud-oss-go-sdk-v2).

Les exemples suivants montrent comment créer un client accédant à CloudBox. L'endpoint correspond au nom de domaine de données du CloudBox, au format <Cloudbox-Id>.<Region>.oss-cloudbox.aliyuncs.com :

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.
}

Opérations API prises en charge par les endpoints de contrôle

Le tableau suivant répertorie les opérations API au niveau du bucket prises en charge par les endpoints de contrôle d'OSS on CloudBox.

Catégorie	API	Description
Opérations de base	PutBucket	Crée un bucket OSS on CloudBox.
	DeleteBucket	Supprime un bucket OSS on CloudBox.
	GetBucketInfo	Récupère les informations relatives à un bucket OSS on CloudBox.
	GetBucketLocation	Interroge l'emplacement d'un bucket OSS on CloudBox.
Contrôle d'accès (ACL)	PutBucketAcl	Configure les autorisations d'accès pour un bucket OSS on CloudBox.
Contrôle d'accès (ACL)	GetBucketAcl	Interroge les autorisations d'accès d'un bucket OSS on CloudBox.
Cycle de vie	PutBucketLifecycle	Configure une règle de cycle de vie pour un bucket OSS on CloudBox.
	GetBucketLifecycle	Interroge les règles de cycle de vie d'un bucket OSS on CloudBox.
	DeleteBucketLifecycle	Supprime les règles de cycle de vie d'un bucket OSS on CloudBox.
Versioning	PutBucketVersioning	Configure l'état du versioning d'un bucket OSS on CloudBox.
Versioning	GetBucketVersioning	Interroge l'état du versioning d'un bucket OSS on CloudBox.
Politique d'autorisation	PutBucketPolicy	Configure une politique d'autorisation pour un bucket OSS on CloudBox.
	GetBucketPolicy	Interroge la politique d'autorisation d'un bucket OSS on CloudBox.
	DeleteBucketPolicy	Supprime la politique d'autorisation d'un bucket OSS on CloudBox.
Gestion des journaux	PutBucketLogging	Active la fonctionnalité de stockage des journaux pour un bucket OSS on CloudBox.
	GetBucketLogging	Interroge la configuration de stockage des journaux d'un bucket OSS on CloudBox.
	DeleteBucketLogging	Désactive la fonctionnalité de stockage des journaux pour un bucket OSS on CloudBox.
Site web statique	PutBucketWebsite	Configure un bucket OSS on CloudBox pour l'hébergement de sites web statiques.
	GetBucketWebsite	Récupère la configuration d'hébergement de site web statique pour un bucket OSS on CloudBox.
	DeleteBucketWebsite	Désactive l'hébergement de site web statique pour un bucket OSS on CloudBox.
Protection contre le hotlinking (Referer)	PutBucketReferer	Configure une règle de protection contre le hotlinking pour un bucket OSS on CloudBox.
Protection contre le hotlinking (Referer)	GetBucketReferer	Interroge la règle de protection contre le hotlinking d'un bucket OSS on CloudBox.
Chiffrement	PutBucketEncryption	Configure une règle de chiffrement pour un bucket OSS on CloudBox.
	GetBucketEncryption	Interroge la règle de chiffrement d'un bucket OSS on CloudBox.
	DeleteBucketEncryption	Supprime la règle de chiffrement d'un bucket OSS on CloudBox.

Opérations API prises en charge par les points de terminaison de données

Les tableaux suivants répertorient les opérations API prises en charge par les points de terminaison de données d'OSS on CloudBox.

Opérations de service

API

Description

ListBuckets (GetService)

Renvoie tous les buckets OSS on CloudBox appartenant au demandeur.

Opérations de bucket

Catégorie	API	Description
Opérations de base	PutBucket	Crée un bucket OSS on CloudBox.
	DeleteBucket	Supprime un bucket OSS on CloudBox.
	GetBucket (ListObjects)	Répertorie les informations relatives à tous les objets d'un bucket OSS on CloudBox.
	ListObjectsV2 (GetBucketV2)	Répertorie les informations relatives à tous les objets d'un bucket OSS on CloudBox.
	GetBucketInfo	Interroge les informations relatives à un bucket OSS on CloudBox.
	GetBucketLocation	Interroge l'emplacement d'un bucket OSS on CloudBox.
Contrôle d'accès (ACL)	PutBucketAcl	Configure les autorisations d'accès pour un bucket OSS on CloudBox.
Contrôle d'accès (ACL)	GetBucketAcl	Interroge les autorisations d'accès d'un bucket OSS on CloudBox.
Cycle de vie	PutBucketLifecycle	Configure une règle de cycle de vie pour un bucket OSS on CloudBox.
	GetBucketLifecycle	Interroge la règle de cycle de vie d'un bucket OSS on CloudBox.
	DeleteBucketLifecycle	Supprime la règle de cycle de vie d'un bucket OSS on CloudBox.
Versioning	PutBucketVersioning	Configure l'état du versioning d'un bucket OSS on CloudBox.
	GetBucketVersioning	Interroge l'état du versioning d'un bucket OSS on CloudBox.
	ListObjectVersions (GetBucketVersions)	Répertorie les versions de tous les objets d'un bucket OSS on CloudBox.
Politique d'autorisation	PutBucketPolicy	Configure une politique d'autorisation pour un bucket OSS on CloudBox.
	GetBucketPolicy	Interroge la politique d'autorisation d'un bucket OSS on CloudBox.
	DeleteBucketPolicy	Supprime la politique d'autorisation d'un bucket OSS on CloudBox.
Gestion des journaux	PutBucketLogging	Active la fonctionnalité de stockage des journaux pour un bucket OSS on CloudBox.
	GetBucketLogging	Interroge la configuration du stockage des journaux d'un bucket OSS on CloudBox.
	DeleteBucketLogging	Désactive la fonctionnalité de stockage des journaux pour un bucket OSS on CloudBox.
Site web statique	PutBucketWebsite	Configure un bucket OSS on CloudBox pour l'hébergement de sites web statiques.
	GetBucketWebsite	Interroge la configuration d'hébergement de site web statique d'un bucket OSS on CloudBox.
	DeleteBucketWebsite	Désactive l'hébergement de site web statique pour un bucket OSS on CloudBox.
Protection contre le hotlinking (Referer)	PutBucketReferer	Configure une règle de protection contre le hotlinking pour un bucket OSS on CloudBox.
Protection contre le hotlinking (Referer)	GetBucketReferer	Interroge la règle de protection contre le hotlinking d'un bucket OSS on CloudBox.
Chiffrement	PutBucketEncryption	Configure une règle de chiffrement pour un bucket OSS on CloudBox.
	GetBucketEncryption	Interroge la règle de chiffrement d'un bucket OSS on CloudBox.
	DeleteBucketEncryption	Supprime la règle de chiffrement d'un bucket OSS on CloudBox.

Opérations sur les objets

Catégorie	API	Description
Opérations de base	PutObject	Télécharge un objet.
	GetObject	Récupère un objet.
	CopyObject	Copie un objet.
	AppendObject	Télécharge un objet par ajout successif.
	DeleteObject	Supprime un seul objet.
	DeleteMultipleObjects	Supprime plusieurs objets.
	HeadObject	Renvoie uniquement les métadonnées d'un objet, sans son contenu.
	GetObjectMeta	Renvoie les métadonnées de base d'un objet, notamment ETag, la taille et l'heure Last-Modified, sans le contenu.
Téléchargement multipartie	InitiateMultipartUpload	Lance un événement de téléchargement multipartie.
	UploadPart	Télécharge des données par parties en fonction d'un nom d'objet et d'un ID de téléchargement spécifiés.
	UploadPartCopy	Copie les données d'un objet existant pour télécharger une partie. Cette opération s'effectue en ajoutant l'en-tête de requête x-oss-copy-source à une requête UploadPart.
	CompleteMultipartUpload	Finalise un téléchargement multipartie après le téléchargement de toutes les parties.
	AbortMultipartUpload	Interrompt un événement de téléchargement multipartie et supprime les parties correspondantes.
	ListMultipartUploads	Répertorie tous les événements de téléchargement multipartie en cours qui ont été lancés mais non finalisés ni interrompus.
	ListParts	Répertorie toutes les parties correctement téléchargées appartenant à un ID de téléchargement spécifié.
Contrôle d'accès (ACL)	PutObjectACL	Modifie les autorisations d'accès d'un objet.
Contrôle d'accès (ACL)	GetObjectACL	Interroge les autorisations d'accès d'un objet.
Lien symbolique	PutSymlink	Crée un lien symbolique.
Lien symbolique	GetSymlink	Récupère un lien symbolique.
Étiquetage	PutObjectTagging	Définit ou met à jour les tags d'un objet.
	GetObjectTagging	Récupère les tags d'un objet.
	DeleteObjectTagging	Supprime les tags spécifiés d'un objet.

Object Storage Service:Overview of OSS on CloudBox