すべてのプロダクト
Search
ドキュメントセンター

Tair (Redis® OSS-Compatible):Alibaba Cloud CLIを使用したTair (Redis OSS互換) リソースの管理

最終更新日:Jan 21, 2025

Alibaba Cloud CLIは、APIに基づいて開発された汎用のコマンドラインツールです。 このツールを使用して、Tair (Redis OSS-compatible) APIを呼び出し、Tair (Redis OSS-compatible) インスタンスを管理できます。 このトピックでは、Alibaba Cloud CLIを使用して、特定のリージョンのTair (Redis OSS-compatible) インスタンスをクエリする方法について説明します。

あなたが始める前に

Alibaba Cloud CLIに精通してください。 詳細については、「Alibaba Cloud CLI の概要」をご参照ください。

Alibaba Cloud CLIでAPI操作を呼び出して複雑なタスクを実行する場合は、コマンドをシェルスクリプトにコンパイルしてからシェルスクリプトを実行して効率を向上させることを推奨します。

RAMユーザーを作成し、RAMユーザーに権限を付与する

RAM (Resource Access Management) ユーザーを作成し、そのユーザーに権限を付与している場合は、この手順をスキップできます。

  1. RAMユーザーを作成するには、次の手順を実行します。

    1. RAMコンソールの [ユーザー] ページに移動し、[ユーザーの作成] をクリックします。

    2. [ログイン名]redis-openapi-operatorに設定し、[アクセスモード][永続的なAccessKeyを使用してアクセスする] に設定します。

    3. [OK] をクリックします。 RAMユーザーが作成されたら、RAMユーザーのAccessKey IDとAccessKey secretを保存します。

  2. RAMユーザーに権限を付与するには、次の手順を実行します。

    1. [ユーザー] ページに移動し、作成したRAMユーザーを見つけて、[操作] 列の [権限の追加] をクリックします。

    2. 表示されるパネルで、検索ボックスにAliyunKvstoreと入力し、AliyunKvstoreReadOnlyAccessポリシーを選択します。

      説明

      AliyunKvstoreReadOnlyAccessポリシーはTairインスタンスに対する読み取り権限を提供し、AliyunKvstoreFullAccessポリシーはTairインスタンスに対する読み取りおよび書き込み権限を提供します。 ビジネス要件に基づいてカスタムポリシーを指定することもできます。 詳細については、「ID管理」をご参照ください。

    3. [権限付与] をクリックします。

Alibaba Cloud CLIのインストール

Alibaba Cloudが提供するCloud Shellを使用して、Alibaba Cloud CLIで実行するコマンドをデバッグすることもできます。 Cloud Shellの詳細については、Cloud Shellとは

CLIコマンドの生成

  1. のデバッグページに移動します。

    OpenAPI ExplorerのDescribeInstancesOverview

  2. 左側の [パラメーター] タブで、必要なパラメーターを指定します。 この例では、RegionIdパラメーターにcn-hangzhouを指定します。

  3. 右側のウィンドウの [CLIの例] タブをクリックして、指定したパラメーターで生成されたCLIコマンドを表示します。

    image

    • アイコンをクリックし运行命令.pngます。 Cloud Shellに移動します。 Cloud Shellでコマンドをデバッグできます。

    • アイコンをクリックして、复制.pngCLIコマンドをクリップボードにコピーします。 CLIコマンドをローカルシェルに貼り付けて、コマンドを実行することもできます。

      説明
      • デバッグのためにCLIコマンドをローカルシェルに貼り付けるときは、パラメーターの形式に注意してください。 Alibaba Cloud CLIコマンドのパラメーター形式の詳細については、「パラメーター形式」をご参照ください。

      • コマンドをシェルにコピーすると、Alibaba Cloud CLIはデフォルトのID資格情報と環境変数設定のリージョン情報を無視し、指定されたリージョンでコマンドを実行します。 ビジネス要件に基づいてオプションを削除または保持できます。 デフォルトでは、OpenAPI Explorerは、生成されたCLIコマンドに -- regionオプションを追加します。

次のサンプルコードは、Alibaba Cloud CLIを使用してDescribeInstancesOverview操作を呼び出して、IDがcn-Hangzhouである中国 (杭州) リージョンのインスタンスのリストを照会する方法を示しています。 Alibaba Cloud CLIコマンドの詳細については、「CLIコマンドの生成と実行」をご参照ください。

  1. 以下のコマンドを実行します。

    aliyun r-kvstore DescribeInstancesOverview --region cn-hangzhou --RegionId 'cn-hangzhou'
  2. コマンド出力を表示します。

    {
            "Instances": [
                    {
                            "ArchitectureType": "cluster",
                            "Capacity": 1024,
                            "ChargeType": "PostPaid",
                            "ConnectionDomain": "r-bp1y****svonly41sr.redis.rds.aliyuncs.com",
                            "CreateTime": "2023-11-27T05:42:50Z",
                            "EngineVersion": "6.0",
                            "InstanceClass": "tair.rdb.cluster.sharding.common",
                            "InstanceId": "r-bp1y****svonly41sr",
                            "InstanceName": "yaluTest",
                            "InstanceStatus": "Normal",
                            "InstanceType": "tair_rdb",
                            "NetworkType": "VPC",
                            "RegionId": "cn-hangzhou",
                            "ResourceGroupId": "rg-acfm****zzrngoa",
                            "VSwitchId": "vsw-bp1g****keaw3xvndvvz0",
                            "VpcId": "vpc-bp1o****4yvz4kxeik3uu",
                            "ZoneId": "cn-hangzhou-k"
                    },
                    {
                            "ArchitectureType": "cluster",
                            "Capacity": 1024,
                            "ChargeType": "PostPaid",
                            "ConnectionDomain": "r-bp1s****lvbzmgedgj.redis.rds.aliyuncs.com",
                            "CreateTime": "2024-03-04T05:08:46Z",
                            "EngineVersion": "6.0",
                            "InstanceClass": "tair.rdb.cluster.sharding.common",
                            "InstanceId": "r-bp1s****lvbzmgedgj",
                            "InstanceName": "LidTest",
                            "InstanceStatus": "Normal",
                            "InstanceType": "tair_rdb",
                            "NetworkType": "VPC",
                            "RegionId": "cn-hangzhou",
                            "ResourceGroupId": "rg-acfm****zzrngoa",
                            "VSwitchId": "vsw-bp12****3z4zu9k4dhaew",
                            "VpcId": "vpc-bp1o****4yvz4kxeik3uu",
                            "ZoneId": "cn-hangzhou-k"
                    }
            ],
            "RequestId": "0E89ADAB-D582-5F49-9D7F-F482D15BE426",
            "TotalCount": 2
    }