boto3资源的API文档在哪里?

Mar*_*ase 5 python amazon-web-services boto3

我了解到,它boto3提供了两个抽象层次:一个称为低层API的API client,它是AWS HTTP API的薄包装,另一个resource是提供真实Python对象的高级客户端。我的问题是,API的API文档在resource哪里?

我找到了这个:

https://boto3.readthedocs.io/zh_CN/stable/reference/services/ec2.html#client

但这描述了clientAPI,并且没有到resourceAPI的一对一映射。例如,枚举实例describe_instances()client对象上被调用,并且instances.all()resource对象上被调用。

接下来,我发现了这一点:

http://boto3.readthedocs.io/en/stable/reference/core/resources.html?highlight=resource

它描述了一组基类和工厂方法,但没有描述EC2之类的特定服务的API。

在运行时,我打印了一个感兴趣的对象,发现它是一个boto3.resources.factory.ec2.ServiceResource,但是搜索boto3文档不会显示该资源的任何人类可读文档。

是否有API文档说明所有不同的Python类是什么,以及它们具有哪些属性/方法?我可以在运行时将其打印出来,例如,print(dir(ec2))但这是一种发现API的乏味方法。

Mar*_*ase 6

感谢@jordanm 在评论中回答。我正在扩展一个更详细的答案。

client文档包含一个我以前没有注意到的名为“服务资源”的部分。

突出显示目录中的服务资源:

客户文档目录

单击此标题会显示 EC2 资源实例的方法和属性。

EC2 资源实例的方法


小智 5

希望这个答案对某些人有用,尽管已经晚了。

相应地使用这两个链接

将第一个作为主要参考。这是另一个答案中提供的链接 https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#service-resource

主要参考

第二个提供了有关特定资源(如实例、图像、VPC 等)可用的方法和属性的更详细视图

https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html

^this is almost the same link -- all options below the service-resource provide detailed info on that particular resource such as instance,image etc.,

共同资源