ロギングを有効にすると、Object Storage Service (OSS) はベクターバケットの時間単位のアクセスログを生成し、固定の命名規則に基づいてログファイルを作成し、指定したターゲットバケットに書き込みます。このトピックでは、OSS Java SDK V2 を使用して、ベクターバケットのロギングを有効化、取得、無効化する方法について説明します。
注:ベクターバケットのロギングを実行するには、ベクタークライアント (OSSVectorsClient) を使用し、アカウント ID (accountId) を設定する必要があります。 Java SDK V2 は、ベクターロギング用の厳密に型指定されたインターフェイスをまだ提供していないため、次の例では汎用的な invokeOperation 呼び出しを使用します。
権限
Alibaba Cloud アカウントには、デフォルトで完全な権限があります。次の操作を実行するには、RAM ポリシーまたはバケットポリシーを使用して、RAM ユーザーまたは RAM ロールに権限を付与する必要があります。
API | アクション | 説明 |
PutBucketLogging | oss:PutBucketLogging | ベクターバケットのロギングを有効にします。 |
GetBucketLogging | oss:GetBucketLogging | ベクターバケットのロギング設定を取得します。 |
DeleteBucketLogging | oss:DeleteBucketLogging | ベクターバケットのロギングを無効にします。 |
ロギングの有効化
ベクトルバケットのログ記録を有効にすると、ターゲットバケット (TargetBucket) 内のターゲットプレフィックス (TargetPrefix) 配下にアクセスログが保存されます。 リクエストボディは JSON 形式です。 TargetBucket は、同じアカウントに属し、書き込み権限が付与されている、ログ記録用のターゲットバケットである必要があります。
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 PutBucketLoggingSample {
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 loggingConfig = "{\n"
+ " \"BucketLoggingStatus\": {\n"
+ " \"LoggingEnabled\": {\n"
+ " \"TargetBucket\": \"targetbucket\",\n"
+ " \"TargetPrefix\": \"log/\"\n"
+ " }\n"
+ " }\n"
+ "}";
Map<String, String> headers = new HashMap<>();
headers.put("Content-Type", "application/json");
Map<String, String> parameters = new HashMap<>();
parameters.put("logging", "");
OperationInput input = OperationInput.newBuilder()
.opName("PutBucketLogging")
.method("PUT")
.bucket("examplebucket")
.parameters(parameters)
.headers(headers)
.body(BinaryData.fromString(loggingConfig))
.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.util.HashMap;
import java.util.Map;
import com.aliyun.sdk.service.oss2.vectors.OSSVectorsClient;
public class GetBucketLoggingSample {
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("logging", "");
OperationInput input = OperationInput.newBuilder()
.opName("GetBucketLogging")
.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"));
}
}
}ロギングの無効化
ベクターバケットのロギングを無効にします。
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 DeleteBucketLoggingSample {
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("logging", "");
OperationInput input = OperationInput.newBuilder()
.opName("DeleteBucketLogging")
.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"));
}
}
}関連ドキュメント
ログフィールドとログファイルの命名規則の詳細については、「OSS のロギングに関するドキュメント」をご参照ください。