你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
StorageClient 类
这是服务对象的基类。 服务对象用于对存储执行所有请求。 无法直接实例化此类。
- 继承
-
builtins.objectStorageClient
构造函数
StorageClient(connection_params)
参数
- connection_params
变量
- account_name
- str
存储帐户名称。 这用于对使用帐户密钥签名的请求进行身份验证,并构造存储终结点。 除非提供了连接字符串,或者自定义域用于匿名身份验证,否则是必需的。
- account_key
- str
存储帐户密钥。 这用于共享密钥身份验证。 如果未指定帐户密钥或 sas 令牌,则将使用匿名访问。
- sas_token
- str
用于对请求进行身份验证的共享访问签名令牌,而不是帐户密钥。 如果同时指定了帐户密钥和 sas 令牌,则将使用帐户密钥进行签名。 如果两者均未指定,则将使用匿名访问。
- primary_endpoint
- str
要向其发送存储请求的终结点。
- secondary_endpoint
- str
要从中读取存储数据的辅助终结点。 仅当使用的存储帐户是 RA-GRS 并且允许从辅助数据库读取时,此终结点才有效。
- retry
- <xref:function>(<xref:context>)
确定是否重试的函数。 将 对象作为参数 RetryContext 。 返回重试请求前等待的秒数,或“无”表示不重试。
- location_mode
- LocationMode
用于发出请求的主机位置。 默认为 LocationMode.PRIMARY。 请注意,此设置仅适用于 RA-GRS 帐户,因为其他帐户类型不允许从辅助帐户读取数据。 如果location_mode设置为 LocationMode.SECONDARY,读取请求将发送到辅助终结点。 写入请求将继续发送到主服务器。
- protocol
- str
用于请求的协议。 默认为 https。
- request_session
- <xref:requests.Session>
用于 http 请求的会话对象。
- request_callback
- <xref:function>(<xref:request>)
在发送每个请求之前立即调用的函数。 此函数采用请求对象作为参数,不返回任何内容。 它可用于添加自定义标头或日志请求数据。
- response_callback
- <xref:function>()
收到每个响应后立即调用的函数。 此函数采用响应对象作为参数,不返回任何内容。 它可用于记录响应数据。
- retry_callback
- <xref:function>()
执行重试评估后立即调用的函数。 此函数采用重试上下文对象作为参数,不返回任何内容。 它可用于检测重试和记录上下文信息。
方法
extract_date_and_request_id | |
set_proxy |
设置 HTTP CONNECT 隧道的代理服务器主机和端口。 |
extract_date_and_request_id
static extract_date_and_request_id(retry_context)
参数
- retry_context
set_proxy
设置 HTTP CONNECT 隧道的代理服务器主机和端口。
set_proxy(host, port, user=None, password=None)