Requester pays (Java SDK V2)
Manage the requester pays mode by calling the PutBucketRequestPayment and GetBucketRequestPayment operations with OSS Java SDK V2.
Prerequisites
-
OSS Java SDK V2 is installed. If you use Maven, add
com.aliyun:alibabacloud-oss-v2as a dependency in the pom.xml file. -
Access credentials are configured by using environment variables. The sample code in this topic uses
EnvironmentVariableCredentialsProviderto read credentials from theOSS_ACCESS_KEY_IDandOSS_ACCESS_KEY_SECRETenvironment variables.
Permissions
An Alibaba Cloud account has full permissions by default. RAM users and RAM roles that belong to the account have no permissions. The Alibaba Cloud account or an account administrator must grant the required permissions.
|
API |
Action |
Description |
|
PutBucketRequestPayment |
|
Set or query the requester pays mode. |
Sample code
import com.aliyun.sdk.service.oss2.OSSClient;
import com.aliyun.sdk.service.oss2.OSSClientBuilder;
import com.aliyun.sdk.service.oss2.credentials.CredentialsProvider;
import com.aliyun.sdk.service.oss2.credentials.EnvironmentVariableCredentialsProvider;
import com.aliyun.sdk.service.oss2.models.*;
public class RequestPaymentSample {
public static void main(String[] args) throws Exception {
String region = "cn-hangzhou";
String bucket = "examplebucket";
CredentialsProvider provider = new EnvironmentVariableCredentialsProvider();
OSSClientBuilder clientBuilder = OSSClient.newBuilder()
.credentialsProvider(provider)
.region(region);
try (OSSClient client = clientBuilder.build()) {
// Set the requester pays mode
PutBucketRequestPaymentResult putResult = client.putBucketRequestPayment(
PutBucketRequestPaymentRequest.newBuilder()
.bucket(bucket)
.requestPaymentConfiguration(RequestPaymentConfiguration.newBuilder()
.payer("Requester")
.build())
.build());
System.out.printf("PutBucketRequestPayment status code:%d%n", putResult.statusCode());
// Query the requester pays configuration
GetBucketRequestPaymentResult getResult = client.getBucketRequestPayment(
GetBucketRequestPaymentRequest.newBuilder()
.bucket(bucket)
.build());
System.out.printf("Payer: %s%n", getResult.requestPaymentConfiguration().payer());
} catch (Exception e) {
System.out.printf("error:%n%s", e);
}
}
}
References
-
For the sample code in synchronous mode, see PutBucketRequestPayment.java.
-
For the sample code in asynchronous mode, see PutBucketRequestPaymentAsync.java.
-
For the sample code in synchronous mode, see GetBucketRequestPayment.java.
-
For the sample code in asynchronous mode, see GetBucketRequestPaymentAsync.java.