AWS SDK for Python を使用してAmazon Connectのオペレーション時間を別のインスタンスにコピーしてみた

#Amazon Connect

繁松昂大

2024.5.31

こんにちは。
繁松です。

はじめに

AWS SDK for Python (Boto3) を使用して、同一アカウント、同一リージョン内のAmazon Connectにオペレーション時間をコピーしてみました。

オペレーション時間を同様の設定で作成したい場合、インポート/エクスポートの機能がないため、手作業で一つ一つ作成する必要があります。AWS SDK for Python (Boto3) を使用することで、同様の設定のオペレーション時間を簡単に作成できました。
オペレーション時間をコピーしたいケースとしては、開発環境で作成したオペレーション時間を本番環境でも同じ設定で利用したい場合や、Amazon Connectのユーザー認証方式を変更したい場合等、新たに作成したインスタンスでも既存のインスタンスと同様の設定が使いたいといったケースが考えられます。

やってみた

コピー元のインスタンスのIDと、コピー先のインスタンスのIDを確認しスクリプト内で指定します。

コピー元のインスタンスからオペレーション時間のリストを取得し、TimeZoneや設定された営業時間等の詳細情報を取得します。
コピー元とコピー先に同じ名前のオペレーション時間がある場合は、設定値をアップデートするようにしています。

import boto3

def copy_hours_of_operation(source_instance_id, target_instance_id, region_name='ap-northeast-1'):
    connect = boto3.client('connect', region_name=region_name)

    # コピー元のインスタンスからオペレーション時間のリストを取得
    hours_of_operations = connect.list_hours_of_operations(
        InstanceId=source_instance_id
    )['HoursOfOperationSummaryList']

    for hours_of_operation in hours_of_operations:
        hours_id = hours_of_operation['Id']

        # オペレーション時間の詳細情報を取得
        hours_details = connect.describe_hours_of_operation(
            InstanceId=source_instance_id,
            HoursOfOperationId=hours_id
        )['HoursOfOperation']

        # 既存のオペレーション時間を確認
        existing_hours = connect.list_hours_of_operations(
            InstanceId=target_instance_id
        )['HoursOfOperationSummaryList']

        # 説明が空の場合は空の文字列を使用
        description = hours_details.get('Description', '')

        for existing_hour in existing_hours:
            # 同じ名前のオペレーション時間が存在する場合はアップデートを実施
            if existing_hour['Name'] == hours_details['Name']:
                update_params = {
                    'InstanceId': target_instance_id,
                    'HoursOfOperationId': existing_hour['Id'],
                    'TimeZone': hours_details['TimeZone'],
                    'Config': hours_details['Config'],
                    'Description': description
                }
                
                connect.update_hours_of_operation(**update_params)
                print(f"Updated existing Hours of Operation: {existing_hour['Name']}")
                break
        else:
            create_params = {
                'InstanceId': target_instance_id,
                'Name': hours_details['Name'],
                'TimeZone': hours_details['TimeZone'],
                'Config': hours_details['Config'],
                'Tags': hours_details.get('Tags', {})
            }
            if description:
                create_params['Description'] = description

            connect.create_hours_of_operation(**create_params)
            print(f"Copied Hours of Operation: {hours_details['Name']}")

# コピー元とコピー先のインスタンスIDを指定
source_instance_id = 'source_instance_idを指定'
target_instance_id = 'target_instance_idを指定'

copy_hours_of_operation(source_instance_id, target_instance_id)