Tüm Ürünler
Search
Belge Merkezi

ApsaraDB RDS:Python SDK example

Son Güncelleme:Oct 14, 2026

ApsaraDB RDS örneklerini sorgulamak için DescribeDBInstances API işlemini çağırmak amacıyla Alibaba Cloud SDK for Python kullanın.

Başlamadan önce

Bir API işlemini çağırmadan önce, gerekli parametreleri ve izinleri anlamak için API genel bakış konusunu inceleyin.

RAM kullanıcısı oluşturun ve izin verin

Gerekli izinlere sahip bir RAM kullanıcınız zaten varsa bu bölümü atlayın.

  1. RAM kullanıcısı oluşturun:

    1. RAM konsolunda Kullanıcılar sayfasına gidin ve Create User öğesine tıklayın.

    2. Logon Name değerini rds-openapi-operator olarak ayarlayın ve Access Method değerini Programmatic Access olarak seçin.

    3. OK öğesine tıklayın ve yeni RAM kullanıcısının AccessKey ID ve AccessKey Secret değerlerini kaydedin.

  2. RAM kullanıcısına izin verin:

    1. Kullanıcılar sayfasında ilgili RAM kullanıcısını bulun ve Actions sütunundaki Add Permissions seçeneğine tıklayın.

    2. Arama kutusuna AliyunRDS girin ve AliyunRDSReadOnlyAccess ilkesini seçin.

      Not

      AliyunRDSReadOnlyAccess, ApsaraDB RDS örneklerine salt okunur erişim sağlar. Tam erişim için AliyunRDSFullAccess ilkesini seçin. Ayrıca özel bir ilke oluşturabilirsiniz.

    3. OK düğmesine tıklayın.

API'yi çağırma

Aşağıdaki adımlarda örnek olarak Python kullanılmıştır. Diğer diller için SDK'yı ApsaraDB RDS SDK sayfasından indirin.

Python ortamını hazırlama

Python 3 sürümünü indirin ve yükleyin. Mevcut bir kurulumu doğrulamak için python --version komutunu çalıştırın.

Ortam değişkenlerini yapılandırma

ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET ortam değişkenlerini ayarlayın.

  • Linux ve macOS'ta <access_key_id> ve <access_key_secret> değerlerini kendi gerçek değerlerinizle değiştirin ve aşağıdaki komutları çalıştırın:

    export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id>
    export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>
  • Windows'ta AccessKey çifti değerlerinizi kullanarak ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET ortam değişkenlerini oluşturun, ardından sistemi yeniden başlatın.

Bağımlılıkları yükleme

SDK'yı yüklemek için aşağıdaki komutu çalıştırın:

pip install alibabacloud_rds20140815==5.0.1

Örnek kodu indirme

  1. OpenAPI Explorer'da DescribeDBInstances sayfasına gidin.

  2. Parameter Configuration sekmesinde parametreleri yapılandırın. Bu örnekte RegionId değerini cn-beijing olarak ayarlayın.

  3. Sağ taraftaki panelde SDK Sample sekmesinden Python seçeneğini belirleyin ve Download Project düğmesine tıklayın.

  4. İndirilen paketi çıkarın ve alibabacloud_sample dizinine gidin.

Kodu çalıştırma

Aşağıdaki komutu çalıştırın:

python sample.py

Örnek yanıt:

{
    "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
    }
}