Contoh pemanggilan SDK ApsaraDB RDS dengan Python - ApsaraDB RDS

Gunakan Alibaba Cloud SDK untuk Python guna memanggil operasi DescribeDBInstances dan mengkueri instans ApsaraDB RDS.

Sebelum memulai

Sebelum memanggil operasi API, tinjau ikhtisar API untuk memahami parameter yang diperlukan dan izin yang dibutuhkan.

Buat pengguna RAM dan berikan izin

Lewati bagian ini jika Anda sudah memiliki pengguna RAM dengan izin yang diperlukan.

Buat pengguna RAM:
1. Di Konsol RAM, buka halaman Users dan klik Create User.
2. Atur Logon Name menjadi rds-openapi-operator, dan atur Access Method menjadi Programmatic Access.
3. Klik OK dan simpan ID AccessKey serta AccessKey Secret dari pengguna RAM baru tersebut.
Berikan izin kepada pengguna RAM:
1. Pada halaman Users, temukan pengguna RAM tersebut dan klik Add Permissions di kolom Actions.
2. Pada kotak pencarian, masukkan AliyunRDS dan pilih kebijakan AliyunRDSReadOnlyAccess.
  
  Catatan
  AliyunRDSReadOnlyAccess memberikan akses read-only ke instans ApsaraDB RDS. Untuk akses penuh, pilih AliyunRDSFullAccess. Anda juga dapat membuat kebijakan kustom.
3. Klik OK.

Panggil API

Langkah-langkah berikut menggunakan Python sebagai contoh. Untuk bahasa lainnya, unduh SDK dari halaman ApsaraDB RDS SDK.

Siapkan lingkungan Python

Unduh dan instal Python 3. Untuk memverifikasi instalasi yang sudah ada, jalankan perintah python --version.

Konfigurasikan variabel lingkungan

Atur variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET.

Pada Linux dan macOS, ganti <access_key_id> dan <access_key_secret> dengan nilai aktual Anda, lalu jalankan perintah berikut:
```
export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>
```
Pada Windows, buat variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET dengan nilai Pasangan Kunci Akses Anda, lalu restart sistem.

Instal dependensi

Jalankan perintah berikut untuk menginstal SDK:

pip install alibabacloud_rds20140815==5.0.1

Unduh kode contoh

Di OpenAPI Explorer, buka halaman DescribeDBInstances.
Pada tab Parameter Configuration, konfigurasikan parameter. Pada contoh ini, atur RegionId menjadi cn-beijing.
Di panel sebelah kanan, pada tab SDK Sample, pilih Python dan klik Download Project.
Ekstrak paket yang diunduh dan masuk ke direktori alibabacloud_sample.

Jalankan kode

Jalankan perintah berikut:

python sample.py

Contoh respons:

{
    "headers": {
        "date": "Tue, 18 Jun 2024 10:12:14 GMT",
        "content-type": "application/json;charset=utf-8",
        "content-length": "1018",
        "connection": "keep-alive",
        "keep-alive": "timeout=25",
        "access-control-allow-origin": "*",
        "access-control-expose-headers": "*",
        "x-acs-request-id": "3BBF9A9B-E74C-5EF5-99BB-4F65B4B67499",
        "x-acs-trace-id": "dcfce27991f7d63647cc3c31ae3daa65",
        "etag": "1se2pACCKd0kse87Rqtbprg8"
    },
    "statusCode": 200,
    "body": {
        "Items": {
            "DBInstance": [
                {
                    "ConnectionMode": "Standard",
                    "ConnectionString": "rm-2zea24972vgw2****.mysql.rds.aliyuncs.com",
                    "CreateTime": "2024-06-18T10:09:56Z",
                    "DBInstanceClass": "mysql.n1e.small.1",
                    "DBInstanceId": "rm-2zea24972vgw2****",
                    "DBInstanceMemory": 1024,
                    "DBInstanceNetType": "Intranet",
                    "DBInstanceStatus": "Creating",
                    "DBInstanceStorageType": "general_essd",
                    "DBInstanceType": "Primary",
                    "DeletionProtection": false,
                    "Engine": "MySQL",
                    "EngineVersion": "8.0",
                    "ExpireTime": "2024-07-18T16:00:00Z",
                    "InstanceNetworkType": "VPC",
                    "LockMode": "Unlock",
                    "MutriORsignle": false,
                    "PayType": "Prepaid",
                    "ReadOnlyDBInstanceIds": {
                        "ReadOnlyDBInstanceId": []
                    },
                    "RegionId": "cn-beijing",
                    "ResourceGroupId": "rg-acfmz7u4zzr****",
                    "TipsLevel": 0,
                    "VSwitchId": "vsw-2zeyawzswr2lno0ys****",
                    "VpcCloudInstanceId": "rm-2zea24972vgw2****-20240618180950",
                    "VpcId": "vpc-2zeev9fov0chw8hjt****",
                    "ZoneId": "cn-beijing-l"
                }
            ]
        },
        "NextToken": "o7PHCFqQhehg8NUW9EJ7Yw",
        "PageNumber": 1,
        "PageRecordCount": 1,
        "RequestId": "3BBF9A9B-E74C-5EF5-99BB-4F65B4B67499",
        "TotalRecordCount": 1
    }
}