如何在Azure Storage Python SDK中获取或设置x-ms-client-request-id/x-ms-request-id

针对你使用block_blob_service.put_block的场景，我来详细说明如何处理这两个请求ID：

设置x-ms-client-request-id（客户端请求ID） #

这个ID是由你主动指定的，用来唯一标识你的请求，方便后续排查问题。在旧版Azure Storage Blob SDK（也就是你当前使用的BlockBlobService所属的v2.x版本）中，put_block方法直接支持传入client_request_id参数。

你可以自己生成一个唯一ID（比如用UUID），然后在调用方法时传入，SDK会自动把这个ID添加到请求头的x-ms-client-request-id字段中。

获取x-ms-request-id（服务端请求ID） #

这个ID是Azure存储服务生成并返回的，会被记录在Storage Analytics日志里。当你调用put_block成功后，方法会返回一个响应对象，你可以从响应的headers中提取x-ms-request-id的值，以此验证请求是否成功到达服务端。

代码示例 #

下面是结合put_block方法的完整示例：

from azure.storage.blob import BlockBlobService
import uuid

# 初始化BlockBlobService（替换成你的存储账户信息）
block_blob_service = BlockBlobService(
    account_name="your_storage_account",
    account_key="your_account_key"
)

# 生成一个自定义的客户端请求ID
client_request_id = str(uuid.uuid4())

try:
    # 调用put_block并传入自定义的client_request_id
    response = block_blob_service.put_block(
        container_name="your_container_name",
        blob_name="your_target_blob",
        block_id="your_block_id",
        block_data=b"your_block_content_here",
        client_request_id=client_request_id
    )
    
    # 从响应头中提取服务端返回的请求ID
    server_request_id = response.headers.get("x-ms-request-id")
    
    print(f"已设置客户端请求ID: {client_request_id}")
    print(f"服务端返回的请求ID: {server_request_id}")
except Exception as ex:
    print(f"请求执行失败: {str(ex)}")

额外说明 #

如果你后续升级到新版的Azure Storage Blob SDK（v12+，使用BlobClient等新类），逻辑是类似的：上传块时可以通过upload_block方法的**kwargs传入client_request_id，然后从响应headers中获取x-ms-request-id。

内容的提问来源于stack exchange，提问作者Shingo Tada