Tüm Ürünler
Search

Bu Ürün

    Data Management:DBS için Python SDK örneği

    Belge Merkezi

    Data Management:DBS için Python SDK örneği

    Son Güncelleme:Oct 04, 2026

    Data Disaster Recovery Python SDK kullanarak yedekleme planı ayrıntılarını sorgulamak için DescribeBackupPlanList API işlemini çağırın.

    Ön koşullar

    Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

    • Python 3 yüklü olmalıdır. Kontrol etmek için python --version komutunu çalıştırın.

    • AccessKey kimlik bilgilerine ve AliyunDBSFullAccess ya da AliyunDBSReadOnlyAccess ilkesine sahip bir Resource Access Management (RAM) kullanıcınız olmalıdır. Henüz yapmadıysanız RAM kullanıcısı oluşturma ve izin verme bölümüne bakın.

    Nasıl çalışır

    Bu konudaki tüm örnekler, Data Disaster Recovery hizmetine API istekleri göndermek için alibabacloud_dbs20190306 SDK paketini kullanır. SDK, kimlik bilgilerini ortam değişkenlerinden okur; bir DescribeBackupPlanList isteği gönderir ve yedekleme planı ayrıntılarınızı içeren sayfalara ayrılmış bir JSON yanıtı döndürür.

    RAM kullanıcısı oluşturma ve izin verme

    Zaten bir AccessKey'e ve gerekli izinlere sahip bir RAM kullanıcınız varsa bu bölümü atlayabilirsiniz.

    1. RAM konsolunda Kullanıcılar sayfasına gidin ve Create User seçeneğine tıklayın.

    2. Logon Name alanını dbs-openapi-operator olarak, Access Mode alanını ise Using permanent AccessKey to access olarak ayarlayın.

    3. OK seçeneğine tıklayın. Görüntülenen sayfada RAM kullanıcısının AccessKey ID ve AccessKey secret değerlerini kaydedin.

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

    5. Arama kutusuna AliyunDBS yazın ve aşağıdaki ilkelerden birini seçin:

      İlke İzinler
      AliyunDBSFullAccess Okuma ve yazma erişimi. Yedekleme planlarını satın alma, yapılandırma ve yönetme izni verir.
      AliyunDBSReadOnlyAccess Salt okunur erişim. Görev ayrıntılarını ve yapılandırmaları görüntüleme izni verir ancak değişiklik yapılmasına izin vermez.
      İş gereksinimlerinize göre özel bir ilke oluşturmak için Data Disaster Recovery için özel ilkeler konusuna bakın.

    6. Grant permissions seçeneğine tıklayın.

    API'yi çağırma

    1. SDK paketini yükleme

    pip install alibabacloud_dbs20190306
    İpucu: Sisteminizde yüklü diğer paketlerle bağımlılık çakışmalarını önlemek için bu komutu sanal bir ortam içinde çalıştırın: python -m venv .venv source .venv/bin/activate # Linux or macOS .venv\Scripts\activate # Windows pip install alibabacloud_dbs20190306

    2. Ortam değişkenlerini ayarlama

    SDK, kimlik bilgilerinizi ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET ortam değişkenlerinden okur.

    Linux veya macOS — Yer tutucuları kendi AccessKey ID ve AccessKey secret değerlerinizle değiştirerek aşağıdaki komutları çalıştırın:

    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 ve ALIBABA_CLOUD_ACCESS_KEY_SECRET değişkenlerini sistem ortam değişkenlerinize ekleyin, ardından sisteminizi yeniden başlatın.

    3. Örnek kodu edinme

    1. OpenAPI Explorer'da DescribeBackupPlanList hata ayıklama sayfasına gidin.

    2. Parameters sekmesinde Region değerini cn-hangzhou (veya hedef bölgeniz) olarak ayarlayın.

    3. SDK Sample Code sekmesinde Python seçeneğini belirleyin ve Download Project seçeneğine tıklayın.

    4. Paketi çıkarın ve alibabacloud_sample dizinine gidin.

    4. Örnek kodu çalıştırma

    python sample.py

    Başarılı bir yanıt şuna benzer:

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

    Temel yanıt alanları:

    Alan Açıklama
    BackupPlanStatus Yedekleme planının mevcut durumu. init değeri, planın oluşturulduğunu ancak henüz başlatılmadığını gösterir.
    BackupRetentionPeriod Yedeklemelerin saklanma süresi (gün cinsinden). Bu örnekte 730 gün (2 yıl).
    BackupMethod Yedekleme türü. physical değeri, depolama düzeyinde fiziksel bir yedekleme olduğunu gösterir.
    BackupPeriod Yedeklemelerin çalıştığı haftanın günleri.
    BackupStartTime Yedeklemenin başladığı saat.
    EnableBackupLog Anlık kurtarma için günlük yedeklemenin etkin olup olmadığı.
    TotalElements Yanıttaki toplam yedekleme planı sayısı. Sayfalandırma için PageNum ve PageSize ile birlikte kullanın.

    Sonraki adımlar