Un bucket vectoriel est un conteneur qui stocke les index vectoriels et les données vectorielles. Pour créer un bucket vectoriel, appelez l'opération PutVectorBucket à l'aide du SDK Go V2.
Autorisations
Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM et les rôles RAM ne disposent d'aucune autorisation par défaut ; vous devez leur accorder l'accès via une politique RAM ou une politique de bucket.
|
API |
Action |
Description |
|
PutVectorBucket |
|
Crée un bucket vectoriel. Le nom d'un bucket vectoriel doit être unique pour un UID au sein d'une même région. Sa longueur doit être comprise entre 3 et 32 caractères. Il ne peut contenir que des lettres minuscules, des chiffres et des traits d'union (-). Le nom ne peut pas commencer ni se terminer par un trait d'union. |
Définition de la méthode
func (c *VectorsClient) PutVectorBucket(ctx context.Context, request *PutVectorBucketRequest, optFns ...func(*Options)) (*PutVectorBucketResult, error)
Paramètres de requête
|
Paramètre |
Type |
Description |
|
ctx |
context.Context |
Le contexte de la requête. |
|
request |
*PutVectorBucketRequest |
Les paramètres de la requête. Pour plus d'informations, consultez PutVectorBucketRequest. |
|
optFns |
...func(*Options) |
(Facultatif) Les paramètres de configuration au niveau de l'opération. Pour plus d'informations, consultez Options. |
Valeurs de retour
|
Valeur de retour |
Type |
Description |
|
result |
*PutVectorBucketResult |
La valeur de retour de l'opération. Ce paramètre n'est valide que si err est nul. Pour plus d'informations, consultez PutVectorBucketResult. |
|
err |
error |
L'état de la requête. Si la requête échoue, err n'est pas nul. |
Exemple de code
package main
import (
"context"
"flag"
"log"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/vectors"
)
var (
region string
bucketName string
accountId string
)
func init() {
flag.StringVar(®ion, "region", "", "The region in which the vector bucket is located.")
flag.StringVar(&bucketName, "bucket", "", "The name of the vector bucket.")
flag.StringVar(&accountId, "account-id", "", "The account ID.")
}
func main() {
flag.Parse()
if len(bucketName) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, bucket name required")
}
if len(region) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, region required")
}
if len(accountId) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, accountId required")
}
cfg := oss.LoadDefaultConfig().
WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
WithRegion(region).WithAccountId(accountId).
// To use a public endpoint, set this parameter to false or remove this line.
WithUseInternalEndpoint(true)
client := vectors.NewVectorsClient(cfg)
request := &vectors.PutVectorBucketRequest{
Bucket: oss.Ptr(bucketName),
}
result, err := client.PutVectorBucket(context.TODO(), request)
if err != nil {
log.Fatalf("failed to put vector bucket %v", err)
}
log.Printf("put vector bucket result:%#v\n", result)
}
Références
Pour consulter l'exemple de code complet relatif à la création d'un bucket vectoriel, voir put_vector_bucket.go.