PythonのBoto3ライブラリでAWS S3・Glue・SQSなど各種サービスに接続する方法

本記事では、PythonのBoto3ライブラリを使用して、さまざまなAWSサービスに接続する方法を詳しく解説します。

接続できるAWSサービスの例

• AWS S3への接続
• AWS Glueジョブへの接続
• AWS SQSなど、その他多数のサービスへの接続

接続の手順とアルゴリズム

ステップ1 — Boto3ライブラリを使用してAWSセッションを作成します。

ステップ2 — clientにAWSサービス名を渡すことで、低レベルのAPI経由でサービスにアクセスできます。

または、resourceにAWSサービス名を渡すことで、高レベルのオブジェクト指向インターフェースを通じてサービスにアクセスできます。
※ clientは利用可能なすべてのAWSサービスに対応していますが、resourceは一部の主要サービスのみのサポートとなっています。

コード例

以下のコードは、複数のAWSサービスに接続する例です。

import boto3

# AWSクライアント（低レベルインターフェース）を取得する
def getconnection_AWSClient(service_name):
    session = boto3.session.Session()
    # カスタマイズしたアクセスキー、シークレットキー、トークンを渡すことも可能
    s3_client = session.client(service_name)
    return s3_client

print(getconnection_AWSClient('s3'))   # S3への接続
print(getconnection_AWSClient('glue')) # Glueへの接続
print(getconnection_AWSClient('sqs'))  # SQSおよびその他のサービスへの接続

# AWSリソース（高レベルオブジェクト指向インターフェース）を取得する
def getconnection_AWSResource(service_name):
    session = boto3.session.Session()
    s3_resource = session.resource(service_name)
    return s3_resource

print(getconnection_AWSResource('s3'))  # S3への接続
print(getconnection_AWSResource('sqs')) # SQSおよびその他のサービスへの接続

出力結果

<botocore.client.S3 object at 0x00000216C4CB89B0>
<botocore.client.Glue object at 0x00000216C5129358>
<botocore.client.SQS object at 0x00000216C4E03E10>
s3.ServiceResource()
sqs.ServiceResource()

注意点：resourceが対応していないサービスがある

resourceはすべてのAWSサービスの接続をサポートしているわけではありません。たとえば、resourceを使ってGlueサービスに接続しようとすると、AWSから次のような例外がスローされます。

boto3.exceptions.ResourceNotExistsError: The 'glue' resource does not exist.

この場合、エラーメッセージにあるように、Glueに対してはresourceではなくboto3.client('glue')を使用することを検討してください。

resourceがサポートしている主なサービス一覧

• cloudformation
• cloudwatch
• dynamodb
• ec2
• glacier
• iam
• opsworks
• s3
• sns
• sqs

上記以外のサービスに接続する場合は、clientを使用するようにしましょう。用途に応じて低レベルAPIと高レベルインターフェースを使い分けることで、より柔軟かつ効率的にAWSを操作できます。