Answers:
这里是有关Client,Resource和Session的所有更详细的信息。
客户:
以下是客户端级别访问S3存储桶的对象(最多1000 **)的示例:
import boto3
client = boto3.client('s3')
response = client.list_objects_v2(Bucket='mybucket')
for content in response['Contents']:
obj_dict = client.get_object(Bucket='mybucket', Key=content['Key'])
print(content['Key'], obj_dict['LastModified'])
**您必须使用分页器,或实现自己的循环,如果数量超过1000,则使用连续标记重复调用list_objects()。
资源:
以下是使用资源级别访问S3存储桶的对象(全部)的等效示例:
import boto3
s3 = boto3.resource('s3')
bucket = s3.Bucket('mybucket')
for obj in bucket.objects.all():
print(obj.key, obj.last_modified)
请注意,在这种情况下,您无需进行第二次API调用即可获取对象。您可以将其作为存储桶中的集合使用。这些子资源集合是延迟加载的。
您可以看到Resource
该代码的版本更简单,更紧凑并且具有更多功能(它可以为您分页)。Client
如果要包括分页,代码的版本实际上比上面显示的要复杂。
会议:
re:Invent video入门视频是了解这些boto3概念的有用资源。
我将尽力解释它。因此,不能保证实际条款的准确性。
会话是启动与AWS服务的连接的地方。例如,以下是使用默认凭据配置文件的默认会话(例如〜/ .aws / credentials,或使用IAM实例配置文件假设您的EC2)
sqs = boto3.client('sqs')
s3 = boto3.resource('s3')
由于默认会话仅限于使用的配置文件或实例配置文件,因此有时您需要使用自定义会话来覆盖默认会话配置(例如region_name,endpoint_url等),例如
# custom resource session must use boto3.Session to do the override
my_west_session = boto3.Session(region_name = 'us-west-2')
my_east_session = boto3.Session(region_name = 'us-east-1')
backup_s3 = my_west_session.resource('s3')
video_s3 = my_east_session.resource('s3')
# you have two choices of create custom client session.
backup_s3c = my_west_session.client('s3')
video_s3c = boto3.client("s3", region_name = 'us-east-1')
资源:这是建议使用的高级服务类。这使您可以绑定特定的AWS资源并将其传递,因此您只需要使用此抽象,就不必担心要指向哪个目标服务。从会话部分可以注意到,如果您有一个自定义会话,则只需传递此抽象对象,而不必担心所有自定义区域等的传递。以下是一个复杂的示例,例如
import boto3
my_west_session = boto3.Session(region_name = 'us-west-2')
my_east_session = boto3.Session(region_name = 'us-east-1')
backup_s3 = my_west_session.resource("s3")
video_s3 = my_east_session.resource("s3")
backup_bucket = backup_s3.Bucket('backupbucket')
video_bucket = video_s3.Bucket('videobucket')
# just pass the instantiated bucket object
def list_bucket_contents(bucket):
for object in bucket.objects.all():
print(object.key)
list_bucket_contents(backup_bucket)
list_bucket_contents(video_bucket)
客户端是低级别的对象。对于每个客户端调用,您需要显式指定目标资源,指定的服务目标名称必须传递很长时间。您将失去抽象能力。
例如,如果仅处理默认会话,则该外观类似于boto3.resource。
import boto3
s3 = boto3.client('s3')
def list_bucket_contents(bucket_name):
for object in s3.list_objects_v2(Bucket=bucket_name) :
print(object.key)
list_bucket_contents('Mybucket')
但是,如果要列出不同区域中存储桶中的对象,则需要指定客户端所需的显式存储桶参数。
import boto3
backup_s3 = my_west_session.client('s3',region_name = 'us-west-2')
video_s3 = my_east_session.client('s3',region_name = 'us-east-1')
# you must pass boto3.Session.client and the bucket name
def list_bucket_contents(s3session, bucket_name):
response = s3session.list_objects_v2(Bucket=bucket_name)
if 'Contents' in response:
for obj in response['Contents']:
print(obj['key'])
list_bucket_contents(backup_s3, 'backupbucket')
list_bucket_contents(video_s3 , 'videobucket')