バケットポリシーを使用して、他のユーザーにベクターバケットへのアクセス権を付与できます。本トピックでは、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 のアクセス制御に関するドキュメント」をご参照ください。