通过

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

CloudStorageAccount 类

  • 参考
包:
com.microsoft.azure.storage
  • java.lang.Object
    • com.microsoft.azure.storage.CloudStorageAccount

public class CloudStorageAccount

表示 Microsoft Azure 存储帐户。

字段摘要

修饰符和类型 字段和描述
final String ACCOUNT_KEY_NAME

表示帐户密钥的设置名称。

final String ACCOUNT_NAME_NAME

表示帐户名称的设置名称。

final String ACCOUNT_TOKEN_NAME

表示令牌凭据的设置名称。

final String BLOB_ENDPOINT_NAME

表示自定义 Blob 存储终结点的设置名称。

final String BLOB_SECONDARY_ENDPOINT_NAME

表示自定义 Blob 存储辅助终结点的设置名称。

final String QUEUE_ENDPOINT_NAME

表示自定义队列终结点的设置名称。

final String QUEUE_SECONDARY_ENDPOINT_NAME

表示自定义队列辅助终结点的设置名称。

final String SHARED_ACCESS_SIGNATURE_NAME

表示共享访问密钥的设置名称。

final String TABLE_ENDPOINT_NAME

表示自定义表存储终结点的设置名称。

final String TABLE_SECONDARY_ENDPOINT_NAME

表示自定义表存储辅助终结点的设置名称。

构造函数摘要

构造函数 说明
CloudStorageAccount(final StorageCredentials storageCredentials)

使用指定的帐户凭据创建 类的实例。

使用此构造函数时，对象是使用默认 HTTP 存储服务终结点构造的。 默认 HTTP 存储服务终结点为 、、 和 ，其中 是存储帐户的名称。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。
CloudStorageAccount(final StorageCredentials storageCredentials, final boolean useHttps)

使用指定的帐户凭据和默认服务终结点（使用指定的 HTTP 或 HTTPS）创建 类的实例。

使用此构造函数时，对象是使用默认存储服务终结点构造的。 默认存储服务终结点为：;;;和 ，其中 是存储帐户的名称。 可以通过 HTTP 或 HTTPS 访问云存储帐户，如 参数所指定。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。
CloudStorageAccount(final StorageCredentials storageCredentials, final boolean useHttps, final String endpointSuffix)

使用指定的帐户凭据创建 类的实例。

使用此构造函数时，将使用给定的 HTTP 存储服务终结点后缀 (构造对象（如果有），否则将使用默认值) 。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。
CloudStorageAccount(final StorageCredentials storageCredentials, final boolean useHttps, final String endpointSuffix, String accountName)

使用指定的帐户凭据创建 类的实例。

使用此构造函数时，将使用给定的 HTTP 存储服务终结点后缀 (构造对象（如果有），否则将使用默认值) 。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。
CloudStorageAccount(final StorageCredentials storageCredentials, final StorageUri blobStorageUri, final StorageUri queueStorageUri, final StorageUri tableStorageUri)

使用指定的帐户凭据和服务终结点创建 类的实例。

在已为存储帐户配置自定义域名的情况下，使用此构造函数使用自定义终结点构造对象。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。
CloudStorageAccount(final StorageCredentials storageCredentials, final StorageUri blobStorageUri, final StorageUri queueStorageUri, final StorageUri tableStorageUri, final StorageUri fileStorageUri)

使用指定的帐户凭据和服务终结点创建 类的实例。

在已为存储帐户配置自定义域名的情况下，使用此构造函数使用自定义终结点构造对象。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。
CloudStorageAccount(final StorageCredentials storageCredentials, final URI blobEndpoint, final URI queueEndpoint, final URI tableEndpoint)

使用指定的帐户凭据和服务终结点创建 类的实例。

在已为存储帐户配置自定义域名的情况下，使用此构造函数使用自定义终结点构造对象。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。
CloudStorageAccount(final StorageCredentials storageCredentials, final URI blobEndpoint, final URI queueEndpoint, final URI tableEndpoint, final URI fileEndpoint)

使用指定的帐户凭据和服务终结点创建 类的实例。

在已为存储帐户配置自定义域名的情况下，使用此构造函数使用自定义终结点构造对象。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。

方法摘要

修饰符和类型 方法和描述
CloudAnalyticsClient createCloudAnalyticsClient()

创建新的 Analytics 服务客户端。
CloudBlobClient createCloudBlobClient()

创建新的 Blob 服务客户端。
CloudFileClient createCloudFileClient()

创建新的文件服务客户端。
CloudQueueClient createCloudQueueClient()

创建新的队列服务客户端。
CloudTableClient createCloudTableClient()

创建新的表服务客户端。
String generateSharedAccessSignature(SharedAccessAccountPolicy policy)

返回帐户的共享访问签名。
URI getBlobEndpoint()

返回存储帐户的 Blob 服务的终结点。 使用共享访问签名凭据时，不支持此方法。
StorageUri getBlobStorageUri()

返回存储帐户的 Blob 服务的终结点。 使用共享访问签名凭据时，不支持此方法。
StorageCredentials getCredentials()

返回存储帐户的凭据。
CloudStorageAccount getDevelopmentStorageAccount()

返回一个 CloudStorageAccount 对象，该对象表示开发存储凭据。 默认情况下，辅助终结点处于启用状态。
CloudStorageAccount getDevelopmentStorageAccount(final URI proxyUri)

使用指定的代理 URI 返回表示 CloudStorageAccount 开发存储凭据的 对象。 默认情况下，辅助终结点处于启用状态。
String getEndpointSuffix()

如果指定了终结点后缀，请返回它
URI getFileEndpoint()

返回存储帐户的文件服务的终结点。 使用共享访问签名凭据时，不支持此方法。
StorageUri getFileStorageUri()

返回存储帐户的文件服务的终结点。 使用共享访问签名凭据时，不支持此方法。
URI getQueueEndpoint()

返回存储帐户的队列服务的终结点。
StorageUri getQueueStorageUri()

返回存储帐户的队列服务的终结点。
URI getTableEndpoint()

返回存储帐户的表服务的终结点。
StorageUri getTableStorageUri()

返回存储帐户的表服务的终结点。
CloudStorageAccount parse(final String connectionString)

分析连接字符串并返回从连接字符串创建的云存储帐户。

连接字符串应采用 Azure 连接字符串 格式。

请注意，虽然连接字符串可能包含 SAS 令牌，但直接使用 CloudBlobContainer(final URI uri)、 CloudQueue(final URI uri)CloudTable(final URI uri) 构造函数通常更容易。 为此，请使用 SAS 令牌创建对象 StorageCredentialsSharedAccessSignature(final String token) ，在 transformUri(final URI resourceUri) 容器、队列或表 URI 上使用 方法，然后使用该 URI 构造对象。
void setCredentials(final StorageCredentials credentials)

设置要用于此帐户的 StorageCredentials。 警告：仅供内部使用，因为将凭据更新到新帐户可能会使预先存在的对象失效。
String toString()

返回存储帐户的连接字符串，不包含敏感数据。
String toString(final boolean exportSecrets)

返回此存储帐户的连接字符串，可以选择使用敏感数据。

字段详细信息

ACCOUNT_KEY_NAME

protected static final String ACCOUNT_KEY_NAME= "AccountKey"

表示帐户密钥的设置名称。

ACCOUNT_NAME_NAME

protected static final String ACCOUNT_NAME_NAME= "AccountName"

表示帐户名称的设置名称。

ACCOUNT_TOKEN_NAME

protected static final String ACCOUNT_TOKEN_NAME= "AccountToken"

表示令牌凭据的设置名称。

BLOB_ENDPOINT_NAME

protected static final String BLOB_ENDPOINT_NAME= "BlobEndpoint"

表示自定义 Blob 存储终结点的设置名称。

BLOB_SECONDARY_ENDPOINT_NAME

protected static final String BLOB_SECONDARY_ENDPOINT_NAME= "BlobSecondaryEndpoint"

表示自定义 Blob 存储辅助终结点的设置名称。

QUEUE_ENDPOINT_NAME

protected static final String QUEUE_ENDPOINT_NAME= "QueueEndpoint"

表示自定义队列终结点的设置名称。

QUEUE_SECONDARY_ENDPOINT_NAME

protected static final String QUEUE_SECONDARY_ENDPOINT_NAME= "QueueSecondaryEndpoint"

表示自定义队列辅助终结点的设置名称。

SHARED_ACCESS_SIGNATURE_NAME

protected static final String SHARED_ACCESS_SIGNATURE_NAME= "SharedAccessSignature"

表示共享访问密钥的设置名称。

TABLE_ENDPOINT_NAME

protected static final String TABLE_ENDPOINT_NAME= "TableEndpoint"

表示自定义表存储终结点的设置名称。

TABLE_SECONDARY_ENDPOINT_NAME

protected static final String TABLE_SECONDARY_ENDPOINT_NAME= "TableSecondaryEndpoint"

表示自定义表存储辅助终结点的设置名称。

构造函数详细信息

CloudStorageAccount

public CloudStorageAccount(final StorageCredentials storageCredentials)

使用指定的帐户凭据创建 类的实例。

使用此构造函数时，对象是使用默认 HTTP 存储服务终结点构造的。 默认 HTTP 存储服务终结点为 、、 和 ，其中 是存储帐户的名称。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。

Parameters:

storageCredentials - 一个 StorageCredentials 对象，表示用于对此帐户进行身份验证的存储凭据。

Throws:

URISyntaxException - 如果 storageCredentials 指定无效的帐户名称。

CloudStorageAccount

public CloudStorageAccount(final StorageCredentials storageCredentials, final boolean useHttps)

使用指定的帐户凭据和默认服务终结点（使用指定的 HTTP 或 HTTPS）创建 类的实例。

使用此构造函数时，对象是使用默认存储服务终结点构造的。 默认存储服务终结点为：;;;和 ，其中 是存储帐户的名称。 可以通过 HTTP 或 HTTPS 访问云存储帐户，如 参数所指定。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。

Parameters:

storageCredentials - 一个 StorageCredentials 对象，表示用于对此帐户进行身份验证的存储凭据。
useHttps -

true 使用 HTTPS 连接到存储服务终结点;否则为 false。

Throws:

URISyntaxException - 如果 storageCredentials 指定无效的帐户名称。

CloudStorageAccount

public CloudStorageAccount(final StorageCredentials storageCredentials, final boolean useHttps, final String endpointSuffix)

使用指定的帐户凭据创建 类的实例。

使用此构造函数时，将使用给定的 HTTP 存储服务终结点后缀 (构造对象（如果有），否则将使用默认值) 。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。

Parameters:

storageCredentials - 一个 StorageCredentials 对象，表示用于对此帐户进行身份验证的存储凭据。
useHttps -

true 使用 HTTPS 连接到存储服务终结点;否则为 false。

endpointSuffix - 一个字符串，表示要使用的 endpointSuffix（如果有）。

Throws:

URISyntaxException - 如果 storageCredentials 指定无效的帐户名称。

CloudStorageAccount

public CloudStorageAccount(final StorageCredentials storageCredentials, final boolean useHttps, final String endpointSuffix, String accountName)

使用指定的帐户凭据创建 类的实例。

使用此构造函数时，将使用给定的 HTTP 存储服务终结点后缀 (构造对象（如果有），否则将使用默认值) 。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。

Parameters:

storageCredentials - 一个 StorageCredentials 对象，表示用于对此帐户进行身份验证的存储凭据。
useHttps -

true 使用 HTTPS 连接到存储服务终结点;否则为 false。

endpointSuffix - 一个字符串，表示要使用的 endpointSuffix（如果有）。
accountName - 包含 String 帐户名称的 。 这将用于代替 nullgetAccountName()，但如果两者不是 null，则两者必须匹配。

Throws:

URISyntaxException - 如果 storageCredentials 指定无效的帐户名称。

CloudStorageAccount

public CloudStorageAccount(final StorageCredentials storageCredentials, final StorageUri blobStorageUri, final StorageUri queueStorageUri, final StorageUri tableStorageUri)

使用指定的帐户凭据和服务终结点创建 类的实例。

在已为存储帐户配置自定义域名的情况下，使用此构造函数使用自定义终结点构造对象。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。

Parameters:

storageCredentials - 一个 StorageCredentials 对象，表示用于对此帐户进行身份验证的存储凭据。
blobStorageUri - 一个 StorageUri 表示 Blob 服务终结点的 对象。
queueStorageUri - 一个 StorageUri 表示队列服务终结点的 对象。
tableStorageUri - 一个 StorageUri 表示表服务终结点的 对象。

CloudStorageAccount

public CloudStorageAccount(final StorageCredentials storageCredentials, final StorageUri blobStorageUri, final StorageUri queueStorageUri, final StorageUri tableStorageUri, final StorageUri fileStorageUri)

使用指定的帐户凭据和服务终结点创建 类的实例。

在已为存储帐户配置自定义域名的情况下，使用此构造函数使用自定义终结点构造对象。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。

Parameters:

storageCredentials - 一个 StorageCredentials 对象，表示用于对此帐户进行身份验证的存储凭据。
blobStorageUri - 一个 StorageUri 表示 Blob 服务终结点的 对象。
queueStorageUri - 一个 StorageUri 表示队列服务终结点的 对象。
tableStorageUri - 一个 StorageUri 表示表服务终结点的 对象。
fileStorageUri - 一个 StorageUri 表示文件服务终结点的 对象。

CloudStorageAccount

public CloudStorageAccount(final StorageCredentials storageCredentials, final URI blobEndpoint, final URI queueEndpoint, final URI tableEndpoint)

使用指定的帐户凭据和服务终结点创建 类的实例。

在已为存储帐户配置自定义域名的情况下，使用此构造函数使用自定义终结点构造对象。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。

Parameters:

storageCredentials - 一个 StorageCredentials 对象，表示用于对此帐户进行身份验证的存储凭据。
blobEndpoint - 一个 java.net.URI 表示 Blob 服务终结点的 对象。
queueEndpoint - 一个 java.net.URI 表示队列服务终结点的 对象。
tableEndpoint - 一个 java.net.URI 表示表服务终结点的 对象。

CloudStorageAccount

public CloudStorageAccount(final StorageCredentials storageCredentials, final URI blobEndpoint, final URI queueEndpoint, final URI tableEndpoint, final URI fileEndpoint)

使用指定的帐户凭据和服务终结点创建 类的实例。

在已为存储帐户配置自定义域名的情况下，使用此构造函数使用自定义终结点构造对象。

构造 对象时提供的凭据用于对通过 对象或从对象创建的客户端对象访问的资源的所有进一步请求进行身份验证。 客户端对象可以是 对象 CloudBlobClient 。

Parameters:

storageCredentials - 一个 StorageCredentials 对象，表示用于对此帐户进行身份验证的存储凭据。
blobEndpoint - 一个 java.net.URI 表示 Blob 服务终结点的 对象。
queueEndpoint - 一个 java.net.URI 表示队列服务终结点的 对象。
tableEndpoint - 一个 java.net.URI 表示表服务终结点的 对象。
fileEndpoint - 一个 java.net.URI 表示文件服务终结点的 对象。

方法详细信息

createCloudAnalyticsClient

public CloudAnalyticsClient createCloudAnalyticsClient()

创建新的 Analytics 服务客户端。

Returns:

使用 Blob 和表服务终结点的分析客户端对象。

createCloudBlobClient

public CloudBlobClient createCloudBlobClient()

创建新的 Blob 服务客户端。

Returns:

一个 CloudBlobClient ，它表示云 Blob 客户端。

createCloudFileClient

public CloudFileClient createCloudFileClient()

创建新的文件服务客户端。

Returns:

一个 CloudFileClient ，它表示云文件客户端。

createCloudQueueClient

public CloudQueueClient createCloudQueueClient()

创建新的队列服务客户端。

Returns:

使用队列服务终结点的客户端对象。

createCloudTableClient

public CloudTableClient createCloudTableClient()

创建新的表服务客户端。

Returns:

使用表服务终结点的客户端对象。

generateSharedAccessSignature

public String generateSharedAccessSignature(SharedAccessAccountPolicy policy)

返回帐户的共享访问签名。

Parameters:

policy - 指定 SharedAccessAccountPolicy 共享访问签名的访问策略的 。

Returns:

返回的查询字符串包含前导问号。

Throws:

StorageException - 如果发生存储服务错误。
InvalidKeyException - 如果密钥无效。

getBlobEndpoint

public URI getBlobEndpoint()

返回存储帐户的 Blob 服务的终结点。 使用共享访问签名凭据时，不支持此方法。

Returns:

一个 java.net.URI 对象，表示与此帐户关联的 Blob 终结点。

getBlobStorageUri

public StorageUri getBlobStorageUri()

返回存储帐户的 Blob 服务的终结点。 使用共享访问签名凭据时，不支持此方法。

Returns:

一个 StorageUri 对象，表示与此帐户关联的 Blob 终结点。

getCredentials

public StorageCredentials getCredentials()

返回存储帐户的凭据。

Returns:

一个 StorageCredentials 对象，表示此存储帐户的凭据。

getDevelopmentStorageAccount

public static CloudStorageAccount getDevelopmentStorageAccount()

返回一个 CloudStorageAccount 对象，该对象表示开发存储凭据。 默认情况下，辅助终结点处于启用状态。

Returns:

CloudStorageAccount开发存储凭据的 对象。

getDevelopmentStorageAccount

public static CloudStorageAccount getDevelopmentStorageAccount(final URI proxyUri)

使用指定的代理 URI 返回表示 CloudStorageAccount 开发存储凭据的 对象。 默认情况下，辅助终结点处于启用状态。

Parameters:

proxyUri - 一个 java.net.URI 对象，表示要使用的代理终结点。 指定 null 将使用默认 http://127.0.0.1的 。

Returns:

CloudStorageAccount开发存储凭据的 对象。

Throws:

URISyntaxException - 如果资源 URI 无效。

getEndpointSuffix

public String getEndpointSuffix()

如果指定了终结点后缀，请返回它

Returns:

终结点后缀

getFileEndpoint

public URI getFileEndpoint()

返回存储帐户的文件服务的终结点。 使用共享访问签名凭据时，不支持此方法。

Returns:

一个 java.net.URI 对象，表示与此帐户关联的 File 终结点。

getFileStorageUri

public StorageUri getFileStorageUri()

返回存储帐户的文件服务的终结点。 使用共享访问签名凭据时，不支持此方法。

Returns:

一个 StorageUri 对象，表示与此帐户关联的 File 终结点。

getQueueEndpoint

public URI getQueueEndpoint()

返回存储帐户的队列服务的终结点。

Returns:

一个 java.net.URI 对象，表示与此帐户关联的队列终结点。

getQueueStorageUri

public StorageUri getQueueStorageUri()

返回存储帐户的队列服务的终结点。

Returns:

一个 StorageUri 对象，表示与此帐户关联的队列终结点。

getTableEndpoint

public URI getTableEndpoint()

返回存储帐户的表服务的终结点。

Returns:

一个 StorageUri 对象，表示与此帐户关联的表终结点。

getTableStorageUri

public StorageUri getTableStorageUri()

返回存储帐户的表服务的终结点。

Returns:

一个 java.net.URI 对象，表示与此帐户关联的表终结点。

parse

public static CloudStorageAccount parse(final String connectionString)

分析连接字符串并返回从连接字符串创建的云存储帐户。

连接字符串应采用 Azure 连接字符串 格式。

请注意，虽然连接字符串可能包含 SAS 令牌，但直接使用 CloudBlobContainer(final URI uri)、 CloudQueue(final URI uri)CloudTable(final URI uri) 构造函数通常更容易。 为此，请使用 SAS 令牌创建对象 StorageCredentialsSharedAccessSignature(final String token) ，在 transformUri(final URI resourceUri) 容器、队列或表 URI 上使用 方法，然后使用该 URI 构造对象。

Parameters:

connectionString - 一个 String ，表示要分析的连接字符串。

Returns:

一个 CloudStorageAccount 对象，表示从连接字符串中提供的值构造的云存储帐户。

Throws:

InvalidKeyException - 如果连接字符串中的凭据包含无效密钥。
URISyntaxException - 如果连接字符串指定了无效的 URI。

setCredentials

protected void setCredentials(final StorageCredentials credentials)

设置要用于此帐户的 StorageCredentials。 警告：仅供内部使用，因为将凭据更新到新帐户可能会使预先存在的对象失效。

Parameters:

credentials - 要设置的凭据

toString

public String toString()

返回存储帐户的连接字符串，不包含敏感数据。

Returns:

一个 String ，表示此存储帐户的连接字符串，不包含敏感数据。

toString

public String toString(final boolean exportSecrets)

返回此存储帐户的连接字符串，可以选择使用敏感数据。

Parameters:

exportSecrets -

如果在字符串中包含敏感数据，则为 true；否则为 false。

Returns:

一个 String ，它表示此存储帐户的连接字符串（可选）包含敏感数据。

适用于