Data Disaster Recovery (DBS) Python SDK を使用して DescribeBackupPlanList API オペレーションを呼び出し、バックアッププランの詳細をクエリします。
前提条件
開始する前に、以下のものが揃っていることを確認してください:
Python 3 がインストールされていること。確認するには、
python --versionを実行します。AccessKey 認証情報と
AliyunDBSFullAccessまたはAliyunDBSReadOnlyAccessポリシーがアタッチされた Resource Access Management (RAM) ユーザー。まだ作成していない場合は、「RAM ユーザーの作成と権限の付与」をご参照ください。
仕組み
このトピックのすべての例では、alibabacloud_dbs20190306 SDK パッケージを使用して、DBS サービスに API リクエストを送信します。SDK は環境変数から認証情報を読み取り、DescribeBackupPlanList リクエストを送信し、バックアッププランの詳細を含むページ分割された JSON 応答を返します。
RAM ユーザーの作成と権限の付与
AccessKey と必要な権限を持つ RAM ユーザーが既にある場合は、このセクションをスキップしてください。
RAM コンソールの[ユーザー] ページに移動し、[ユーザーの作成] をクリックします。
[ログイン名] を dbs-openapi-operator に、[アクセスモード] を [永続的な AccessKey を使用してアクセス] に設定します。
[OK] をクリックします。表示されたページで、RAM ユーザーの AccessKey ID と AccessKey Secret を保存します。
[ユーザー] ページで、対象の RAM ユーザーを見つけ、[操作] 列の [権限の追加] をクリックします。
検索ボックスに
AliyunDBSと入力し、次のいずれかのポリシーを選択します:ポリシー 権限 AliyunDBSFullAccess読み取りおよび書き込みアクセス。バックアッププランの購入、構成、管理を許可します。 AliyunDBSReadOnlyAccess読み取り専用アクセス。タスクの詳細と構成の表示を許可しますが、変更はできません。 ビジネス要件に基づいてカスタムポリシーを作成するには、「データディザスタリカバリのカスタムポリシー」をご参照ください。
[権限を付与] をクリックします。
API の呼び出し
1. SDK パッケージのインストール
pip install alibabacloud_dbs20190306ヒント: システムにインストールされている他のパッケージとの依存関係の競合を避けるため、このコマンドは仮想環境内で実行してください:python -m venv .venv source .venv/bin/activate # Linux または macOS .venv\Scripts\activate # Windows pip install alibabacloud_dbs20190306
2. 環境変数の設定
SDK は、ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数から認証情報を読み取ります。
Linux または macOS — 次のコマンドを実行し、プレースホルダーをご利用の AccessKey ID と AccessKey Secret に置き換えます:
export ALIBABA_CLOUD_ACCESS_KEY_ID=<your-access-key-id>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<your-access-key-secret>Windows — ALIBABA_CLOUD_ACCESS_KEY_ID と ALIBABA_CLOUD_ACCESS_KEY_SECRET をシステム環境変数に追加し、システムを再起動します。
3. サンプルコードの取得
OpenAPI Explorer の DescribeBackupPlanList デバッグページに移動します。
[パラメーター] タブで、[リージョン] を cn-hangzhou (またはターゲットリージョン) に設定します。
[SDK サンプルコード] タブで、[Python] を選択し、[プロジェクトのダウンロード] をクリックします。
パッケージを展開し、
alibabacloud_sampleディレクトリに移動します。
4. サンプルコードの実行
python sample.py成功した場合の応答は、次のようになります:
{
"headers": {
"date": "Mon, 17 Jun 2024 07:22:04 GMT",
"content-type": "application/json;charset=utf-8",
"content-length": "1064",
"connection": "keep-alive",
"keep-alive": "timeout=25",
"vary": "Accept-Encoding",
"access-control-allow-origin": "*",
"access-control-expose-headers": "*",
"x-acs-request-id": "4C4073F2-35A9-5819-88F1-C018A871****",
"x-acs-trace-id": "3c79c1be14f6f17be6aaa9af0f02****",
"etag": "1Jukbw3tBgZiZxgb8TVR****"
},
"statusCode": 200,
"body": {
"HttpStatusCode": 200,
"Items": {
"BackupPlanDetail": [
{
"BackupGatewayId": 16****,
"BackupMethod": "physical",
"BackupObjects": "[]",
"BackupPeriod": "SUNDAY,MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY,SATURDAY",
"BackupPlanCreateTime": 1718606018000,
"BackupPlanId": "dbsqe3w3vxq****",
"BackupPlanName": "DBS-csyl-L-3",
"BackupPlanStatus": "init",
"BackupRetentionPeriod": 730,
"BackupStartTime": "12:00",
"BackupStorageType": "system",
"DuplicationArchivePeriod": 0,
"DuplicationInfrequentAccessPeriod": 0,
"EnableBackupLog": true,
"InstanceClass": "medium",
"OSSBucketName": "dbs-backup-137383785969****-cn-hangzhou-qxl0qf4g****",
"OSSBucketRegion": "cn-hangzhou",
"OpenBackupSetAutoDownload": false,
"ResourceGroupId": "rg-acfmz7u4zzr****",
"SourceEndpointDatabaseName": "",
"SourceEndpointInstanceID": "",
"SourceEndpointInstanceType": "agent",
"SourceEndpointIpPort": "121.XX.XXX.171:3306",
"SourceEndpointRegion": "cn-hangzhou",
"SourceEndpointUserName": "root"
}
]
},
"PageNum": 0,
"PageSize": 30,
"RequestId": "4C4073F2-35A9-5819-88F1-C018A871****",
"Success": true,
"TotalElements": 1,
"TotalPages": 1
}
}主要な応答フィールド:
| フィールド | 説明 |
|---|---|
BackupPlanStatus | バックアッププランの現在のステータス。init は、プランは作成されたがまだ開始されていないことを意味します。 |
BackupRetentionPeriod | バックアップが保持される期間 (日数)。この例では 730 日 (2 年) です。 |
BackupMethod | バックアップの種類。physical は、ストレージレベルでの物理バックアップを意味します。 |
BackupPeriod | バックアップが実行される曜日。 |
BackupStartTime | バックアップが開始される時刻。 |
EnableBackupLog | ポイントインタイムリカバリのためにログバックアップが有効になっているかどうか。 |
TotalElements | 応答に含まれるバックアッププランの総数。ページネーションには PageNum と PageSize と共に使用します。 |
次のステップ
サポートされているすべてのリクエストパラメーターと応答フィールドについては、「DescribeBackupPlanList API リファレンス」をご参照ください。
すべての Data Disaster Recovery API オペレーションの一覧を閲覧します:「2019 年 3 月 6 日版」、または「2021 年 1 月 1 日版」。
他の言語の SDK を使用するには、「DBS SDK ページ」をご参照ください。