exemplos de api rds alibaba cloud cli - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Pré-requisitos

Ainda não conhece o Alibaba Cloud CLI? Comece por What is Alibaba Cloud CLI?.

Instalar o Alibaba Cloud CLI

Instale o Alibaba Cloud CLI para o seu sistema operacional:

Também é possível depurar comandos do CLI no Cloud Shell. What is Cloud Shell?

Configurar o Alibaba Cloud CLI

Importante

Sua conta Alibaba Cloud tem acesso total à API, o que representa um risco de segurança. Crie e utilize um usuário RAM. Associe a política AliyunRDSReadOnlyAccess para acesso somente leitura ou AliyunRDSFullAccess para controle total do ApsaraDB RDS.

Configure suas credenciais de identidade, o ID da região padrão e outras definições antes de usar o CLI. O CLI aceita vários tipos de credenciais (Configure and manage identity credentials). Este exemplo usa credenciais AccessKey.

Create a RAM user e conceda as permissões de serviço necessárias (Manage RAM user permissions).
Create an AccessKey pair para o usuário RAM. Registre o AccessKey ID e o AccessKey secret para a configuração das credenciais.
Escolha um ID de região. O CLI envia as chamadas de API para a região especificada. Regiões disponíveis: Endpoints.

Nota
A opção --region substitui a região padrão definida nas credenciais e nas variáveis de ambiente. Command-line options.
Configure as credenciais AccessKey em um perfil chamado AkProfile usando o par AccessKey do usuário RAM. Configure and manage identity credentials.

Gerar um comando CLI de exemplo

Acesse a ApsaraDB RDS API reference no OpenAPI Explorer.
Pesquise a API na left-side search box. Na guia Parameters, insira os valores necessários. Ao lado da guia Parameters, clique em CLI Example para gerar um comando de exemplo.
- Clique no ícone para abrir o Cloud Shell e depurar o comando.
- Clique no ícone para copiar o exemplo de CLI para a área de transferência. Depois, cole-o no shell local para executá-lo.
  - Ao colar um exemplo de CLI no shell local, verifique o formato dos parâmetros. Understand command parameters.
  - O OpenAPI Explorer adiciona a opção --region aos comandos de exemplo por padrão, o que substitui a região definida nas credenciais e variáveis de ambiente. Mantenha ou remova conforme necessário.

Chamar APIs de serviços em nuvem

Estrutura do comando

Os comandos do CLI seguem esta estrutura (Generate and call a command):

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

Opções de linha de comando comuns

Use as opções de linha de comando para modificar o comportamento do comando ou adicionar funcionalidades.

--profile<profileName>: usa o perfil especificado, substituindo as credenciais padrão e as variáveis de ambiente.
--help: exibe informações de ajuda de um comando. Get help.

Command-line options.

Exemplos

Exemplo 1: liste as APIs disponíveis do ApsaraDB RDS com --help. Também é possível consultar a API overview.

Execute o comando.
```
aliyun rds --help
```

Visualize a saída do comando.

Saída do comando

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.
...

Exemplo 2: chame a API DescribeDBInstanceAttribute para consultar os detalhes da instância.

Execute o comando.

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

Visualize a saída do comando.

Saída do comando

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

Nota

Se uma chamada de API falhar, verifique o código de erro para validar os parâmetros da solicitação.

Use o ID da solicitação ou a mensagem de erro com o Alibaba Cloud OpenAPI Diagnostics para diagnosticar o problema.