Gunakan ApsaraDB RDS SDK untuk Python - ApsaraDB RDS

Topik ini menjelaskan cara menggunakan Alibaba Cloud SDK untuk Python dalam memanggil operasi DescribeDBInstances dari ApsaraDB RDS untuk menanyakan instans.

Lihat dokumentasi API

Sebelum memanggil suatu operasi API, disarankan untuk membaca dokumentasi terkait operasi tersebut guna memahami parameter dan izin yang diperlukan. Untuk informasi lebih lanjut, lihat Daftar operasi berdasarkan fungsi.

Buat pengguna Resource Access Management (RAM) dan berikan izin kepada pengguna RAM

Jika Anda sudah memiliki pengguna RAM dengan izin yang sesuai, lewati langkah ini.

Buat pengguna RAM.
1. Masuk ke konsol RAM, buka halaman Pengguna, lalu klik Create User.
2. Atur Logon Name menjadi rds-openapi-operator dan pilih Using permanent AccessKey to access untuk Access Mode.
3. Klik OK. Setelah pengguna RAM dibuat, simpan ID AccessKey dan rahasia AccessKey pengguna tersebut.
Berikan izin kepada pengguna RAM.
1. Buka halaman Pengguna, temukan pengguna RAM yang telah dibuat, lalu klik Add Permissions di kolom Actions.
2. Cari AliyunRDS di kotak teks dan pilih kebijakan AliyunRDSReadOnlyAccess.
  Catatan
  Kebijakan AliyunRDSReadOnlyAccess memberikan izin kepada pengguna RAM untuk menanyakan instans RDS. Anda juga dapat memilih kebijakan AliyunRDSFullAccess untuk memberikan izin manajemen penuh pada instans RDS kepada pengguna RAM atau memilih kebijakan kustom. Untuk informasi lebih lanjut, lihat Buat kebijakan kustom.
3. Klik Grant permissions untuk menyelesaikan otorisasi.

Panggil operasi API

Topik ini menjelaskan cara menggunakan Alibaba Cloud SDK untuk Python dalam memanggil operasi API. Anda dapat menggunakan Alibaba Cloud SDK dalam bahasa pemrograman lain dengan cara serupa. Untuk informasi lebih lanjut, kunjungi OpenAPI Portal.

Instal Python

Unduh dan instal Python 3. Jika Anda telah menginstal Python, jalankan perintah python --version untuk melihat versi Python.

Konfigurasikan variabel lingkungan

Bagian ini menjelaskan cara mengonfigurasi variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET di sistem operasi Anda.

Jika Anda menggunakan sistem operasi Linux atau macOS, ganti <access_key_id> dan <access_key_secret> dalam perintah berikut dengan ID AccessKey dan rahasia AccessKey Anda. Lalu, jalankan perintah secara berurutan di perangkat Anda.
```
export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>
```
Jika Anda menggunakan sistem operasi Windows, buat file untuk menambahkan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET dan atur variabel tersebut ke ID AccessKey dan rahasia AccessKey Anda. Lalu, mulai ulang sistem operasi Windows.

Instal dependensi

Jalankan perintah berikut di perangkat Anda untuk menginstal dependensi:

pip install alibabacloud_rds20140815==5.0.1

Unduh kode contoh

Akses DescribeDBInstances.
Di tab Parameters, konfigurasikan parameter yang diperlukan. Dalam contoh ini, atur RegionId menjadi cn-beijing.
Di tab SDK Sample Code di sebelah kanan, pilih Python untuk Bahasa dan klik Download Project untuk mengunduh paket kode contoh.
Ekstrak paket di perangkat Anda dan masuk ke direktori alibabacloud_sample.

Jalankan kode contoh

Jalankan perintah berikut:

python sample.py

Contoh respons:

{
    "headers": {
        "date": "Sel, 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
    }
}