本文旨在帮助初学者理解如何从 Azure SDK 返回的 ItemPaged 迭代器中提取数据，并将其转换为更易于使用的数据结构，如字典或列表。我们将重点介绍如何访问迭代器中对象的属性，以及如何将这些属性提取到自定义的数据结构中。通过本文，你将能够有效地处理 Azure API 返回的数据，并将其用于后续的数据分析或处理。
在使用 Azure SDK for Python 时，经常会遇到需要从 API 获取大量数据的情况。 Azure SDK 通常使用 ItemPaged 迭代器来返回这些数据。 尽管可以直接迭代 ItemPaged 对象，但有时我们需要将数据转换为更方便处理的格式，例如字典或列表。
以下示例展示了如何从 ItemPaged 迭代器中提取订阅信息，并将其存储在列表中。
from azure.identity import DefaultAzureCredential
from azure.mgmt.resource import SubscriptionClient
def get_subscriptions_as_list():
"""
从 Azure 获取订阅信息，并将其存储在列表中。
"""
client = SubscriptionClient(
credential=DefaultAzureCredential(),
)
response = client.subscriptions.list()
subscription_list = []
for item in response:
# 创建一个字典来存储订阅信息
subscription_data = {
"id": item.id,
"subscription_id": item.subscription_id,
"display_name": item.display_name,
"state": item.state
}
subscription_list.append(subscription_data)
return subscription_list
if __name__ == "__main__":
subscriptions = get_subscriptions_as_list()
for subscription in subscriptions:
print(subscription)代码解释：
- 导入必要的模块： 导入 azure.identity 用于身份验证，azure.mgmt.resource 用于访问 Azure 资源管理 API。
- 创建 SubscriptionClient 实例： 使用 DefaultAzureCredential 进行身份验证，并创建 SubscriptionClient 实例。DefaultAzureCredential 会尝试使用多种身份验证方法，例如环境变量、托管标识等，来获取 Azure 资源的访问权限。
- 调用 subscriptions.list() 方法： client.subscriptions.list() 方法返回一个 ItemPaged 迭代器，其中包含订阅信息。
- 迭代 ItemPaged 对象： 使用 for 循环迭代 ItemPaged 对象中的每个 item。 这里的 item 是一个 azure.mgmt.resource.subscriptions.v2021_01_01.models._models_py3.Subscription 类型的对象。
- 访问对象的属性： 通过 item.id、item.subscription_id、item.display_name 和 item.state 等属性，可以访问 Subscription 对象的各个属性。 请参考 Azure 官方文档，了解 Subscription 对象的所有可用属性。
- 创建字典： 将需要提取的属性存储在一个字典 subscription_data 中。
- 添加到列表： 将包含订阅信息的字典 subscription_data 添加到列表 subscription_list 中。
- 返回列表： 函数返回包含所有订阅信息的列表。
- 打印列表： 遍历列表，打印每个订阅的字典信息。
注意事项：
- ItemPaged 迭代器是惰性加载的，这意味着只有在迭代时才会实际从 API 获取数据。
- DefaultAzureCredential 是一种方便的身份验证方式，它会自动尝试多种身份验证方法。 在生产环境中，建议根据实际情况选择更安全的身份验证方式，例如服务主体。
- 可以根据需要修改代码，提取 Subscription 对象的其他属性，或者将数据存储在其他数据结构中，例如 Pandas DataFrame。
- 在处理大量数据时，可以考虑使用分页来提高性能。 ItemPaged 迭代器会自动处理分页，无需手动处理。
总结：
通过本文，你学习了如何从 Azure SDK 返回的 ItemPaged 迭代器中提取数据，并将其转换为更易于使用的数据结构，例如列表。 掌握这些技能将帮助你更有效地处理 Azure API 返回的数据，并将其用于后续的数据分析或处理。 记住，关键在于理解 ItemPaged 对象中包含的是对象实例，需要通过属性访问来获取具体的数据。
