alibaba cloud cli rds api examples - ApsaraDB RDS - Alibaba Cloud Dokümantasyon Merkezi

Alibaba Cloud CLI, OpenAPI üzerine inşa edilmiş bir komut satırı aracıdır. Bu aracı kullanarak kabuk ortamından ApsaraDB RDS örneklerinizi yönetebilirsiniz. CLI'nin nasıl kurulacağını ve yapılandırılacağını öğrenin; ayrıca ApsaraDB RDS API'lerini nasıl çağıracağınızı keşfedin.

Ön koşullar

Alibaba Cloud CLI konusunda yeni misiniz? Alibaba Cloud CLI nedir? konusundan başlayın.

Alibaba Cloud CLI'yı yükleme

İşletim sisteminize uygun şekilde Alibaba Cloud CLI'yı yükleyin:

CLI komutlarını Cloud Shell ortamında da hata ayıklayabilirsiniz. Cloud Shell nedir?

Alibaba Cloud CLI'yı yapılandırma

Önemli

Alibaba Cloud hesabınız tam API erişimine sahiptir ve bu durum güvenlik riski oluşturur. Bunun yerine bir RAM kullanıcısı oluşturun ve kullanın. Salt okunur erişim için AliyunRDSReadOnlyAccess ilkesini veya ApsaraDB RDS üzerinde tam denetim için AliyunRDSFullAccess ilkesini atayın.

CLI'yı kullanmadan önce kimlik bilgilerinizi, varsayılan bölge kimliğinizi ve diğer ayarları yapılandırın. CLI birden fazla kimlik bilgisi türünü destekler (Kimlik bilgilerini yapılandırma ve yönetme). Bu örnekte AccessKey kimlik bilgileri kullanılmaktadır.

Bir RAM kullanıcısı oluşturun ve gerekli hizmet izinlerini verin (RAM kullanıcı izinlerini yönetme).
RAM kullanıcısı için bir AccessKey çifti oluşturun. Kimlik bilgisi yapılandırması için AccessKey ID ve AccessKey secret değerlerini kaydedin.
Bir bölge kimliği seçin. CLI, API çağrılarını belirtilen bölgeye gönderir. Kullanılabilir bölgeler: Uç noktalar.

Not
--region seçeneği, kimlik bilgisi yapılandırmanızdaki ve ortam değişkenlerinizdeki varsayılan bölgeyi geçersiz kılar. Komut satırı seçenekleri.
RAM kullanıcısının AccessKey çiftini kullanarak AkProfile adlı bir profil altında AccessKey kimlik bilgilerini yapılandırın. Kimlik bilgilerini yapılandırma ve yönetme.

Örnek bir CLI komutu oluşturma

OpenAPI Explorer'da ApsaraDB RDS API referansı sayfasına gidin.
API'yi left-side search box arayın. Parameters sekmesinde gerekli değerleri girin. Parameters sekmesinin yanındaki CLI Example öğesine tıklayarak örnek bir komut oluşturun.
- simgesine tıklayarak Cloud Shell ortamını açın ve komutu hata ayıklayın.
- simgesine tıklayarak CLI örneğini panoya kopyalayın. Ardından yerel kabuğunuza yapıştırıp çalıştırabilirsiniz.
  - Bir CLI örneğini yerel kabuğunuza yapıştırdığınızda parametre formatını doğrulayın. Komut parametrelerini anlama.
  - OpenAPI Explorer, varsayılan olarak örnek komutlara --region seçeneğini ekler; bu seçenek kimlik bilgilerinizdeki ve ortam değişkenlerinizdeki bölgeyi geçersiz kılar. İhtiyacınıza göre bu seçeneği koruyun veya kaldırın.

Cloud hizmet API'lerini çağırma

Komut yapısı

CLI komutları aşağıdaki yapıyı takip eder (Komut oluşturma ve çağırma):

aliyun <command> <subcommand> [options and parameters]

Yaygın komut satırı seçenekleri

Komut davranışını değiştirmek veya işlevsellik eklemek için komut satırı seçeneklerini kullanın.

--profile<profileName>: Varsayılan kimlik bilgilerini ve ortam değişkenlerini geçersiz kılarak belirtilen profili kullanır.
--help: Bir komut için yardım bilgilerini görüntüler. Yardım alma.

Komut satırı seçenekleri.

Örnekler

Örnek 1: --help kullanarak mevcut ApsaraDB RDS API'lerini listeleyin. Ayrıca API genel bakışı sayfasını da kontrol edebilirsiniz.

Komutu çalıştırın.
```
aliyun rds --help
```

Komut çıktısını görüntüleyin.

Komut çıktısı

Alibaba Cloud Command Line Interface Version 3.0.216
Usage:
  aliyun rds <ApiName> --parameter1 value1 --parameter2 value2 ...
Product: Rds (ApsaraDB for RDS)
Version: 2014-08-15
Available API List:
  ActivateMigrationTargetInstance             Switches workloads over from the source PostgreSQL instance to the destination ApsaraDB RDS for PostgreSQL instance.
  AddTagsToResource                           Adds tags to an instance.
  AllocateInstancePublicConnection            Applies for a public endpoint for an ApsaraDB RDS instance
  AllocateReadWriteSplittingConnection        Applies for a read-only routing endpoint for an instance.
  AttachWhitelistTemplateToInstance           Associates a whitelist template with an instance.
  CalculateDBInstanceWeight                   Queries system-assigned read weights.
...

Örnek 2: Örnek ayrıntılarını sorgulamak için DescribeDBInstanceAttribute API'sini çağırın.

Komutu çalıştırın.

aliyun rds DescribeDBInstanceAttribute --region cn-hangzhou --DBInstanceId 'pgm-bp16k272p478****'

Komut çıktısını görüntüleyin.

Komut çıktısı

{
        "Items": {
                "DBInstanceAttribute": [
                        {
                                "AccountMaxQuantity": 99999,
                                "AccountType": "Mix",
                                "AdvancedFeatures": "LinkedServer,DistributeTransaction",
                                "AutoUpgradeMinorVersion": "Auto",
                                "AvailabilityValue": "100.0%",
                                "BabelfishConfig": {},
                                "CanTempUpgrade": false,
                                "Category": "HighAvailability",
                                "ColdDataEnabled": false,
                                "ConnectionMode": "Standard",
                                "ConnectionString": "pgm-bp16k272p478****.pg.rds.aliyuncs.com",
                                "ConsoleVersion": "2",
                                "CreationTime": "2024-08-06T06:18:48Z",
                                "CurrentKernelVersion": "rds_postgres_1400_20240530",
                                "DBClusterNodes": {
                                        "DBClusterNode": []
                                },
                                "DBInstanceCPU": "2",
                                "DBInstanceClass": "pg.n4.2c.2m",
                                "DBInstanceClassType": "x",
                                "DBInstanceDescription": "DB-test",
                                "DBInstanceDiskUsed": 3520069632,
                                "DBInstanceId": "pgm-bp16k272p478****",
                                "DBInstanceMemory": 8192,
                                "DBInstanceNetType": "Intranet",
                                "DBInstanceStatus": "Running",
                                "DBInstanceStorage": 100,
                                "DBInstanceStorageType": "cloud_essd",
                                "DBInstanceType": "Primary",
                                "DBMaxQuantity": 99999,
                                "DedicatedHostGroupId": "",
                                "DeletionProtection": false,
                                "DispenseMode": "MultiAVZDispenseMode",
                                "Engine": "PostgreSQL",
                                "EngineVersion": "14.0",
                                "ExpireTime": "",
                                "Extra": {
                                        "DBInstanceIds": {
                                                "DBInstanceId": []
                                        }
                                },
                                "IPType": "IPv4",
                                "InsId": 1,
                                "InstanceNetworkType": "VPC",
                                "InstructionSetArch": "x86",
                                "IoAccelerationEnabled": "0",
                                "LatestKernelVersion": "rds_postgres_1400_20240530",
                                "LockMode": "Unlock",
                                "MaintainTime": "18:00Z-22:00Z",
                                "MasterZone": "cn-hangzhou-j",
                                "MaxConnections": 800,
                                "MaxIOMBPS": 0,
                                "MaxIOPS": 6800,
                                "OriginConfiguration": "{\"KindCode\":\"18\"}",
                                "PayType": "Postpaid",
                                "Port": "5432",
                                "ProxyType": 2,
                                "ReadOnlyDBInstanceIds": {
                                        "ReadOnlyDBInstanceId": []
                                },
                                "RegionId": "cn-hangzhou",
                                "ResourceGroupId": "rg-acfmz7u4zzrngoa",
                                "SecurityIPList": "0.0.0.0/0,172.16.0.0/12",
                                "SecurityIPMode": "normal",
                                "ServerlessConfig": {},
                                "SlaveZones": {
                                        "SlaveZone": [
                                                {
                                                        "ZoneId": "cn-hangzhou-k"
                                                }
                                        ]
                                },
                                "SuperPermissionMode": "",
                                "SupportCreateSuperAccount": "Yes",
                                "SupportUpgradeAccountType": "Yes",
                                "Tips": "ok",
                                "TipsLevel": 1,
                                "VSwitchId": "vsw-bp1sxxsodv28ey5dl****",
                                "VpcCloudInstanceId": "pgm-bp16k272p478****-20240806141842",
                                "VpcId": "vpc-bp1ov7as4yvz4kxei****",
                                "ZoneId": "cn-hangzhou-j",
                                "kindCode": "18"
                        }
                ]
        },
        "RequestId": "14B99E32-4ECD-5B8E-A9C8-6738C8C95910"
}

Not

Bir API çağrısı başarısız olursa istek parametrelerinizi doğrulamak için hata kodunu kontrol edin.

Sorunu teşhis etmek için istek kimliğini veya hata mesajını Alibaba Cloud OpenAPI Tanılama aracıyla birlikte kullanın.