适用于 Python 的 Azure SDK：如何限制 list_blob() 中的结果？

Question

如何限制ContainerClient.list_blobs()方法返回的blob数量？

Azure Blob service RESP API docs 提到了一个maxresults 参数，但似乎list_blobs(maxresults=123) 不承认它。

Answer 1

itertools.islice 和 results_per_page 参数（转换为 REST maxresults 参数）的组合可以解决问题：

import itertools

service: BlobServiceClient = BlobServiceClient.from_connection_string(cstr)
cc = service.get_container_client("foo")

n = 42
for b in itertools.islice(cc.list_blobs(results_per_page=n), n):
    print(b.name)

Answer 2

请在ItemPaged class上使用 by_page()

pages = ContainerClient.list_blobs(maxresults=123).by_page()
first_page = next(pages)
items_in_page = list(a_page) #this will give you 123 results on the first page
second_page = next(pages) # it will throw exception if there's no second page
items_in_page = list(a_page) #this will give you 123 results on the second page

Answer 3

目前无法使用 SDK 执行此操作。 maxresults 参数真正的意思是“每页最大结果”；如果您有比这更多的 blob，list_blobs 将多次调用 REST API，直到列表完成。

您可以直接调用 API 并忽略第一个页面之后的页面，但这需要您处理身份验证、解析响应等细节。