すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:バケットポリシー (Java SDK V2)

最終更新日:Jul 01, 2026

バケットポリシーを使用して、他のユーザーにベクターバケットへのアクセス権を付与できます。本トピックでは、OSS Java SDK V2 を使用して、ベクターバケットのバケットポリシーを設定、表示、削除する方法について説明します。

説明

注:ベクターバケットのバケットポリシーを管理するには、OSSVectorsClient を使用し、アカウント ID (accountId) を設定する必要があります。Java SDK V2 では、現在ベクターバケットポリシーに対する厳密に型指定されたインターフェイスを提供していません。以下の例では、汎用的な invokeOperation メソッドを使用します。権限付与ポリシーでは、Resource フィールドにはベクター固有の形式 acs:ossvector:{region}:{accountId}:*/* を、Action フィールドには oss:PutVectors や oss:GetVectors などのベクター固有のアクションを使用します。

アクセス許可

デフォルトでは、Alibaba Cloud アカウントはすべてのリソースに対する完全なアクセス権を持ちます。RAM ユーザーまたは RAM ロールの場合、以下の操作に対する権限を付与するには、RAM ポリシーまたはバケットポリシーを使用する必要があります。

API

アクション

説明

PutBucketPolicy

oss:PutBucketPolicy

ベクターバケットのバケットポリシーを設定します。

GetBucketPolicy

oss:GetBucketPolicy

ベクターバケットのバケットポリシーを表示します。

DeleteBucketPolicy

oss:DeleteBucketPolicy

ベクターバケットのバケットポリシーを削除します。

バケットポリシーの設定

ベクターバケットに権限付与ポリシーを設定します。以下の例では、指定したアカウントによるベクターバケットに対する PutVectors または GetVectors アクションの実行を拒否するポリシーを設定します。

import com.aliyun.sdk.service.oss2.credentials.CredentialsProvider;
import com.aliyun.sdk.service.oss2.credentials.EnvironmentVariableCredentialsProvider;
import com.aliyun.sdk.service.oss2.OperationInput;
import com.aliyun.sdk.service.oss2.OperationOptions;
import com.aliyun.sdk.service.oss2.OperationOutput;
import com.aliyun.sdk.service.oss2.transport.BinaryData;
import java.util.HashMap;
import java.util.Map;
import com.aliyun.sdk.service.oss2.vectors.OSSVectorsClient;

public class PutBucketPolicySample {
    public static void main(String[] args) throws Exception {
        CredentialsProvider provider = new EnvironmentVariableCredentialsProvider();
        try (OSSVectorsClient client = OSSVectorsClient.newBuilder()
                .region("cn-hangzhou")
                .accountId("1234567890")
                .credentialsProvider(provider)
                .build()) {
            String policy = "{\n"
                    + "  \"Version\": \"1\",\n"
                    + "  \"Statement\": [\n"
                    + "    {\n"
                    + "      \"Action\": [\"oss:PutVectors\", \"oss:GetVectors\"],\n"
                    + "      \"Effect\": \"Deny\",\n"
                    + "      \"Principal\": [\"1234567890\"],\n"
                    + "      \"Resource\": [\"acs:ossvector:cn-hangzhou:1234567890:*/*\"]\n"
                    + "    }\n"
                    + "  ]\n"
                    + "}";
            Map<String, String> headers = new HashMap<>();
            headers.put("Content-Type", "application/json");
            OperationInput input = OperationInput.newBuilder()
                    .opName("PutBucketPolicy")
                    .method("PUT")
                    .bucket("examplebucket")
                    .headers(headers)
                    .body(BinaryData.fromString(policy))
                    .build();
            OperationOutput output = client.invokeOperation(input, OperationOptions.defaults());
            System.out.println("status code: " + output.statusCode()
                    + ", request id: " + output.headers().get("x-oss-request-id"));
        }
    }
}

バケットポリシーの表示

以下の例では、ベクターバケットのバケットポリシーを表示する方法を示しています。ポリシーはレスポンスボディで返されます。

import com.aliyun.sdk.service.oss2.credentials.CredentialsProvider;
import com.aliyun.sdk.service.oss2.credentials.EnvironmentVariableCredentialsProvider;
import com.aliyun.sdk.service.oss2.OperationInput;
import com.aliyun.sdk.service.oss2.OperationOptions;
import com.aliyun.sdk.service.oss2.OperationOutput;
import com.aliyun.sdk.service.oss2.transport.BinaryData;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;
import com.aliyun.sdk.service.oss2.vectors.OSSVectorsClient;

public class GetBucketPolicySample {
    public static void main(String[] args) throws Exception {
        CredentialsProvider provider = new EnvironmentVariableCredentialsProvider();
        try (OSSVectorsClient client = OSSVectorsClient.newBuilder()
                .region("cn-hangzhou")
                .accountId("1234567890")
                .credentialsProvider(provider)
                .build()) {
            Map<String, String> parameters = new HashMap<>();
            parameters.put("policy", "");
            OperationInput input = OperationInput.newBuilder()
                    .opName("GetBucketPolicy")
                    .method("GET")
                    .bucket("examplebucket")
                    .parameters(parameters)
                    .build();
            OperationOutput output = client.invokeOperation(input, OperationOptions.defaults());
            System.out.println("status code: " + output.statusCode()
                    + ", request id: " + output.headers().get("x-oss-request-id"));
            // ポリシーはレスポンスボディで返されます。
            System.out.println("policy: " + output.body().asString(StandardCharsets.UTF_8));
        }
    }
}

バケットポリシーの削除

以下の例では、ベクターバケットのバケットポリシーを削除する方法を示しています。

import com.aliyun.sdk.service.oss2.credentials.CredentialsProvider;
import com.aliyun.sdk.service.oss2.credentials.EnvironmentVariableCredentialsProvider;
import com.aliyun.sdk.service.oss2.OperationInput;
import com.aliyun.sdk.service.oss2.OperationOptions;
import com.aliyun.sdk.service.oss2.OperationOutput;
import com.aliyun.sdk.service.oss2.transport.BinaryData;
import java.util.HashMap;
import java.util.Map;
import com.aliyun.sdk.service.oss2.vectors.OSSVectorsClient;

public class DeleteBucketPolicySample {
    public static void main(String[] args) throws Exception {
        CredentialsProvider provider = new EnvironmentVariableCredentialsProvider();
        try (OSSVectorsClient client = OSSVectorsClient.newBuilder()
                .region("cn-hangzhou")
                .accountId("1234567890")
                .credentialsProvider(provider)
                .build()) {
            Map<String, String> parameters = new HashMap<>();
            parameters.put("policy", "");
            OperationInput input = OperationInput.newBuilder()
                    .opName("DeleteBucketPolicy")
                    .method("DELETE")
                    .bucket("examplebucket")
                    .parameters(parameters)
                    .build();
            OperationOutput output = client.invokeOperation(input, OperationOptions.defaults());
            System.out.println("status code: " + output.statusCode()
                    + ", request id: " + output.headers().get("x-oss-request-id"));
        }
    }
}

関連ドキュメント

  • ベクターバケットポリシーの構文、および Action と Resource の有効な値の詳細については、「OSS Vectors のアクセス制御に関するドキュメント」をご参照ください。