ベクターバケットは、ベクトルデータおよびベクトルインデックスを格納するためのコンテナです。ベクターバケットを作成するには、Python SDK V2 の put_vector_bucket メソッドを呼び出します。
権限
デフォルトでは、Alibaba Cloud アカウント (root ユーザー) はすべての権限を持ちますが、Resource Access Management (RAM) ユーザーまたは RAM ロールにはデフォルトで権限がありません。Alibaba Cloud アカウントのオーナーまたは管理者が、RAM ポリシーまたはバケットポリシーを使用して権限を付与する必要があります。
|
API |
アクション |
説明 |
|
PutVectorBucket |
|
ベクターバケットを作成します。ベクターバケットの名前は、同一リージョン内の UID に対して一意である必要があります。名前の長さは 3~32 文字で、小文字、数字、ハイフン (-) のみを使用できます。ハイフンで始まったり、ハイフンで終わったりすることはできません。 |
メソッド定義
put_vector_bucket(request: PutVectorBucketRequest, **kwargs) → PutVectorBucketResult
リクエストパラメーター
|
パラメーター |
型 |
説明 |
|
request |
PutVectorBucketRequest |
ベクターバケットの名前などのリクエストパラメーターです。詳細については、「PutVectorBucketRequest」をご参照ください。 |
戻り値
|
型 |
説明 |
|
PutVectorBucketResult |
戻り値です。詳細については、「PutVectorBucketResult」をご参照ください。 |
put_vector_bucket メソッドの完全な定義については、「put_vector_bucket」をご参照ください。
サンプルコード
次のコードを使用して、ベクターバケットを作成できます。
import argparse
import alibabacloud_oss_v2 as oss
import alibabacloud_oss_v2.vectors as oss_vectors
parser = argparse.ArgumentParser(description="vector put bucket sample")
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The endpoint for accessing OSS.', required=False)
parser.add_argument('--account_id', help='The account id.', required=True)
def main():
args = parser.parse_args()
# 環境変数から認証情報をロード
credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
# SDK のデフォルト構成を使用
cfg = oss.config.load_default()
cfg.credentials_provider = credentials_provider
cfg.region = args.region
cfg.account_id = args.account_id
cfg.use_internal_endpoint = True # パブリックネットワーク経由で OSS にアクセスする場合は、False に設定するか、この行を削除してください。
if args.endpoint is not None:
cfg.endpoint = args.endpoint
vector_client = oss_vectors.Client(cfg)
result = vector_client.put_vector_bucket(oss_vectors.models.PutVectorBucketRequest(
bucket=args.bucket,
))
print(f'status code: {result.status_code},'
f' request id: {result.request_id},'
)
if __name__ == "__main__":
main()
参考資料
ベクターバケットの作成に関する完全なサンプルコードについては、「put_vector_bucket.py」をご参照ください。