com.qcloud.cos.model

类 SSECustomerKey

java.lang.Object

com.qcloud.cos.model.SSECustomerKey

所有已实现的接口:

Serializable

public class SSECustomerKey
extends Object
implements Serializable

Represents a customer provided key for use with Qcloud COS server-side encryption. Server-side encryption is about data encryption at rest, that is, Qcloud COS encrypts your data as it writes it to disks in its data centers and decrypts it for you when you access it. Qcloud COS manages encryption and decryption for you. This class allows you to specify your own encryption key for Qcloud COS to use when encrypting your data on the server-side, instead of allowing Qcloud to automatically generate an encryption key for you.

另请参阅:

序列化表格

构造器概要

构造器

构造器和说明
SSECustomerKey(byte[] rawKeyMaterial) Constructs a new customer provided server-side encryption key using the specified raw key material.
SSECustomerKey(SecretKey key) Constructs a new customer provided server-side encryption key using the specified SecretKey.
SSECustomerKey(String base64EncodedKey) Constructs a new customer provided server-side encryption key using the specified base64-encoded key material.

方法概要

方法

限定符和类型	方法和说明
static SSECustomerKey	generateSSECustomerKeyForPresignUrl(String algorithm) Constructs a new SSECustomerKey that can be used for generating the presigned URL's.
String	getAlgorithm() Returns the encryption algorithm to use with this customer-provided server-side encryption key.
String	getKey() Returns the base64-encoded server-side encryption key that was provided in this object's constructor.
String	getMd5() Returns the optional base64-encoded MD5 digest of the encryption key to use when validating the integrity of the transmitted server-side encryption key.
void	setAlgorithm(String algorithm) Sets the encryption algorithm to use with this customer-provided server-side encryption key.
void	setMd5(String md5Digest) Sets the optional MD5 digest (base64-encoded) of the encryption key to use when encrypting the object.
SSECustomerKey	withAlgorithm(String algorithm) Sets the encryption algorithm to use with this customer-provided server-side encryption key, and returns this object so that method calls can be chained together.
SSECustomerKey	withMd5(String md5Digest) Sets the optional MD5 digest (base64-encoded) of the encryption key to use when encrypting the object, and returns the updated object so that additional method calls can be chained together.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

SSECustomerKey

public SSECustomerKey(String base64EncodedKey)

Constructs a new customer provided server-side encryption key using the specified base64-encoded key material. By default, this is assumed to be an AES-256 key, but the key algorithm can be set through the setAlgorithm(String) method. Currently, Qcloud COS only supports AES-256 encryption keys.

参数:

base64EncodedKey - The base 64 encoded encryption key material.

SSECustomerKey

public SSECustomerKey(byte[] rawKeyMaterial)

Constructs a new customer provided server-side encryption key using the specified raw key material. By default, this is assumed to be an AES-256 key, but the key algorithm can be set through the setAlgorithm(String) method. Currently, Qcloud COS only supports AES-256 encryption keys.

参数:

rawKeyMaterial - The raw bytes of the customer provided encryption key.

SSECustomerKey

public SSECustomerKey(SecretKey key)

Constructs a new customer provided server-side encryption key using the specified SecretKey. By default, this is assumed to be an AES-256 key, but the key algorithm can be set through the setAlgorithm(String) method. Currently, Qcloud COS only supports AES-256 encryption keys.

参数:

key - The customer provided server-side encryption key.

方法详细资料

getKey

public String getKey()

Returns the base64-encoded server-side encryption key that was provided in this object's constructor.

返回:

The base64-encoded server-side encryption key.

getAlgorithm

public String getAlgorithm()

Returns the encryption algorithm to use with this customer-provided server-side encryption key. Currently, "AES256" is the only supported algorithm.

返回:

The encryption algorithm to use with this customer-provided server-side encryption key.

setAlgorithm

public void setAlgorithm(String algorithm)

Sets the encryption algorithm to use with this customer-provided server-side encryption key. Currently, "AES256" is the only supported algorithm.

参数:

algorithm - The server-side encryption algorithm to use with this customer-provided server-side encryption key.

另请参阅:

SSEAlgorithm.AES256

withAlgorithm

public SSECustomerKey withAlgorithm(String algorithm)

Sets the encryption algorithm to use with this customer-provided server-side encryption key, and returns this object so that method calls can be chained together. Currently, "AES256" is the only supported algorithm.

参数:

algorithm - The server-side encryption algorithm to use with this customer-provided server-side encryption key.

返回:

The updated ServerSideEncryptionKey object, so that method calls may be chained together.

另请参阅:

SSEAlgorithm.AES256

getMd5

public String getMd5()

Returns the optional base64-encoded MD5 digest of the encryption key to use when validating the integrity of the transmitted server-side encryption key. If a MD5 digest is not explicitly specified, then it will be automatically calculated.

返回:

The base64-encoded MD5 digest of this customer-provided server-side encryption key.

setMd5

public void setMd5(String md5Digest)

Sets the optional MD5 digest (base64-encoded) of the encryption key to use when encrypting the object. This will be used as a message integrity check that the key was transmitted without error. If not set, the SDK will fill in this value by calculating the MD5 digest of the secret key, before sending the request.

参数:

md5Digest - The MD5 digest (base64-encoded) of the encryption key to use when encrypting the object.

withMd5

public SSECustomerKey withMd5(String md5Digest)

Sets the optional MD5 digest (base64-encoded) of the encryption key to use when encrypting the object, and returns the updated object so that additional method calls can be chained together. This will be used as a message integrity check that the key was transmitted without error. If not set, the SDK will fill in this value by calculating the MD5 digest of the secret key, before sending the request.

参数:

md5Digest - The MD5 digest (base64-encoded) of the encryption key to use when encrypting the object.

返回:

The updated object, so that additional method calls can be chained together.

generateSSECustomerKeyForPresignUrl

public static SSECustomerKey generateSSECustomerKeyForPresignUrl(String algorithm)

Constructs a new SSECustomerKey that can be used for generating the presigned URL's. Currently, "AES256" is the only supported algorithm.

参数:

algorithm - The server-side encryption algorithm to use with this customer-provided server-side encryption key; must not be null.

抛出:

IllegalArgumentException - if the input parameter is null.

另请参阅:

SSEAlgorithm.AES256