你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

StorageCredentials 类

包:

com.microsoft.azure.storage

• java.lang.Object
• • com.microsoft.azure.storage.StorageCredentials

public class StorageCredentials

表示用于对 Microsoft Azure 存储帐户的访问进行身份验证的一组凭据。 这是 、 StorageCredentialsToken和 StorageCredentialsSharedAccessSignature 类的StorageCredentialsAccountAndKey基类。

方法摘要

修饰符和类型	方法和描述
String	getAccountName() 返回凭据的关联帐户名。 对于匿名和共享访问签名凭据，这为 null。
boolean	isHttpsOnly() 获取此对象是否仅允许通过 HTTPS 进行访问。
void	setHttpsOnly(boolean httpsOnly) 设置此对象是否仅允许通过 HTTPS 进行访问。
abstract String	toString(boolean exportSecrets) 返回表示此 实例的 。
URI	transformUri(final URI resourceUri) 通过追加共享访问标记将资源 URI 转换为共享访问签名 URI。
StorageUri	transformUri(StorageUri resourceUri) 通过追加共享访问标记将资源 URI 转换为共享访问签名 URI。
abstract StorageUri	transformUri(StorageUri resourceUri, OperationContext opContext) 通过追加共享访问令牌并使用指定的操作上下文，将资源 URI 转换为共享访问签名 URI。
abstract URI	transformUri(URI resourceUri, OperationContext opContext) 通过追加共享访问令牌并使用指定的操作上下文，将资源 URI 转换为共享访问签名 URI。
StorageCredentials	tryParseCredentials(final Map<String, String> settings) 尝试从名称/值对集合中确定存储凭据。 包括帐户名和帐户密钥 (指定和 ) 的值ACCOUNT_NAME_NAME，或共享访问签名 (指定 ) 的值SHARED_ACCESS_SIGNATURE_NAME。ACCOUNT_KEY_NAME 如果使用帐户名称和帐户密钥，请不要包含共享访问签名，反之亦然。
StorageCredentials	tryParseCredentials(final String connectionString) 尝试从连接字符串确定存储凭据。 连接字符串的格式采用模式“<i>keyname=value</i>”。 多个键/值对可以用分号分隔，例如“<i>keyname1=value1;keyname2=value2</i>”。 包括帐户名和帐户密钥或共享访问签名。 如果使用帐户名称和帐户密钥，请不要包含共享访问签名，反之亦然。 可以将相同的连接字符串用于 parse(final String connectionString) ，但此处将只检查帐户名称、帐户密钥和 sas 键/值对。

方法详细信息

getAccountName

public String getAccountName()

返回凭据的关联帐户名。 对于匿名和共享访问签名凭据，这为 null。

Returns:

一个 String ，表示凭据的关联帐户名称

isHttpsOnly

public boolean isHttpsOnly()

获取此对象是否仅允许通过 HTTPS 进行访问。

Returns:

一个 boolean ，它表示此 StorageCredentials 对象是否只允许通过 HTTPS 进行访问。

setHttpsOnly

protected void setHttpsOnly(boolean httpsOnly)

设置此对象是否仅允许通过 HTTPS 进行访问。

Parameters:

httpsOnly - 一个 boolean ，它表示此 StorageCredentials 对象是否只允许通过 HTTPS 进行访问。

toString

public abstract String toString(boolean exportSecrets)

返回表示此 实例的 。

Parameters:

exportSecrets -

true 若要在返回字符串中包含敏感数据，则为 ;否则为 false。

Returns:

一个 String 表示此 对象的 ，可以选择包含敏感数据。

transformUri

public URI transformUri(final URI resourceUri)

通过追加共享访问标记将资源 URI 转换为共享访问签名 URI。

Parameters:

resourceUri - 一个 java.net.URI 对象，表示要转换的资源 URI。

Returns:

一个 java.net.URI 对象，表示签名，包括资源 URI 和共享访问令牌。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException - 如果资源 URI 的格式不正确。

transformUri

public StorageUri transformUri(StorageUri resourceUri)

通过追加共享访问标记将资源 URI 转换为共享访问签名 URI。

Parameters:

resourceUri - 一个 StorageUri 对象，表示要转换的资源 URI。

Returns:

一个 StorageUri 对象，表示签名，包括资源 URI 和共享访问令牌。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException - 如果资源 URI 的格式不正确。

transformUri

public abstract StorageUri transformUri(StorageUri resourceUri, OperationContext opContext)

通过追加共享访问令牌并使用指定的操作上下文，将资源 URI 转换为共享访问签名 URI。

Parameters:

resourceUri - 一个 StorageUri 对象，表示要转换的资源 URI。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

一个 StorageUri 对象，表示签名，包括资源 URI 和共享访问令牌。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException - 如果资源 URI 的格式不正确。

transformUri

public abstract URI transformUri(URI resourceUri, OperationContext opContext)

通过追加共享访问令牌并使用指定的操作上下文，将资源 URI 转换为共享访问签名 URI。

Parameters:

resourceUri - 一个 java.net.URI 对象，表示要转换的资源 URI。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

一个 java.net.URI 对象，表示签名，包括资源 URI 和共享访问令牌。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException - 如果资源 URI 的格式不正确。

tryParseCredentials

protected static StorageCredentials tryParseCredentials(final Map settings)

尝试从名称/值对集合中确定存储凭据。

包括帐户名和帐户密钥 (指定和 ) 的值ACCOUNT_NAME_NAME，或共享访问签名 (指定 ) 的值SHARED_ACCESS_SIGNATURE_NAME。ACCOUNT_KEY_NAME 如果使用帐户名称和帐户密钥，请不要包含共享访问签名，反之亦然。

Parameters:

settings - 表示 Map 用于配置凭据的设置的名称/值对的对象。

Returns:

一个 StorageCredentials 对象，表示从名称/值对确定的存储凭据。

Throws:

InvalidKeyException - 如果为 ACCOUNT_KEY_NAME 指定的键值不是有效的 Base64 编码字符串。

tryParseCredentials

public static StorageCredentials tryParseCredentials(final String connectionString)

尝试从连接字符串确定存储凭据。

连接字符串的格式采用模式“<i>keyname=value</i>”。 多个键/值对可以用分号分隔，例如“<i>keyname1=value1;keyname2=value2</i>”。 包括帐户名和帐户密钥或共享访问签名。 如果使用帐户名称和帐户密钥，请不要包含共享访问签名，反之亦然。

可以将相同的连接字符串用于 parse(final String connectionString) ，但此处将只检查帐户名称、帐户密钥和 sas 键/值对。

Parameters:

connectionString - 一个 ， String 它包含表示存储凭据的键/值对。

Returns:

一个 StorageCredentials 对象，表示从连接字符串确定的存储凭据。

Throws:

InvalidKeyException - 如果 中指定的 connectionString 帐户密钥无效。

StorageException