All Products
Search
Document Center

Tair (Redis® OSS-Compatible):DescribeAvailableResource

Last Updated:Jun 12, 2026

Mengkueri spesifikasi instans yang dapat dibuat di zona tertentu.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

kvstore:DescribeAvailableResource

get

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID region. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar region terbaru.

cn-hangzhou

ZoneId

string

No

ID zona. Anda dapat memanggil operasi DescribeZones untuk mengkueri daftar zona terbaru.

cn-hangzhou-h

InstanceChargeType

string

No

Metode penagihan. Nilai yang valid:

  • PrePaid (default): langganan.

  • PostPaid: bayar sesuai pemakaian.

PrePaid

OrderType

string

No

Tipe pesanan. Nilai yang valid:

  • BUY (default): pembelian.

  • UPGRADE: meningkatkan spesifikasi instans.

  • DOWNGRADE: menurunkan spesifikasi instans.

BUY

Engine

string

No

Mesin basis data instans. Nilai yang valid:

  • Redis.

  • Memcache.

Redis

ResourceGroupId

string

No

ID grup sumber daya. Anda dapat memanggil operasi ListResourceGroups untuk mengkueri ID grup sumber daya.

Catatan

Anda juga dapat mengkueri ID grup sumber daya di konsol Resource Management. Untuk informasi lebih lanjut, lihat Melihat informasi dasar tentang grup sumber daya.

rg-acfmyiu4e******

InstanceId

string

No

ID instans.

Catatan

Parameter ini tersedia dan diperlukan hanya jika OrderType diatur ke UPGRADE atau DOWNGRADE.

r-bp1zxszhcgatnx****

AcceptLanguage

string

No

Bahasa nilai yang dikembalikan. Nilai yang valid:

  • zh-CN: Bahasa Tionghoa. Ini adalah nilai default.

  • en-US: Bahasa Inggris.

zh-CN

ProductType

string

No

Tipe produk. Nilai yang valid (nilai default-nya adalah Local):

  • Local: instans ApsaraDB for Redis Community Edition (edisi klasik) atau instans memory-optimized ApsaraDB for Redis Enhanced Edition (Tair) (edisi klasik).

  • Tair_rdb: instans memory-optimized (edisi cloud-native).

  • Tair_scm: instans persistent memory-optimized.

  • Tair_essd: instans berbasis disk.

  • OnECS: instans ApsaraDB for Redis Community Edition (edisi cloud-native).

Catatan

Nilai default parameter ini adalah Local. Jika Anda ingin mengkueri sumber daya cloud disk, Anda harus menentukan tipe produk yang sesuai dengan sumber daya cloud disk yang diperlukan.

Local

NodeId

string

No

ID node data. Anda dapat memanggil operasi DescribeLogicInstanceTopology untuk mengkueri ID node data. Untuk ID node data yang dikueri, Anda harus menghapus tanda angka (#) dan konten yang mengikutinya. Misalnya, hanya pertahankan r-bp10noxlhcoim2****-db-0.

Catatan

Sebelum Anda menentukan parameter ini, Anda juga harus menentukan parameter InstanceId. Instans harus menggunakan arsitektur cluster atau arsitektur read/write splitting.

r-bp1zxszhcgatnx****-db-0

InstanceScene

string

No

Seri produk. Nilai yang valid:

  • professional: Standard Edition. Mendukung empat arsitektur: standalone, master-replica, read/write splitting, dan cluster. Sangat scalable.

professional

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

493B7308-D9C2-55F6-B042-0313BD63****

AvailableZones

object

AvailableZone

array<object>

Detail zona.

array<object>

ZoneId

string

The ID of the zone in which the instance is located.

cn-hangzhou-h

ZoneName

string

The name of the zone.

杭州 可用区H

RegionId

string

The ID of the region.

cn-hangzhou

SupportedEngines

object

SupportedEngine

array<object>

The supported engines.

array<object>

Engine

string

The database engine of the instance.

Redis

SupportedEditionTypes

object

SupportedEditionType

array<object>

The instance edition types.

array<object>

EditionType

string

The edition of the instance. Valid values:

  • Community: Community Edition

  • Enterprise: Enhanced Edition (Tair)

Enterprise

SupportedSeriesTypes

object

SupportedSeriesType

array<object>

The instance series types.

array<object>

SeriesType

string

The instance series. Valid values:

  • enhanced_performance_type: Tair (Enterprise Edition) DRAM-based instance

  • hybrid_storage: Redis Open-Source Edition hybrid-storage instance

enhanced_performance_type

SupportedEngineVersions

object

SupportedEngineVersion

array<object>

The available engine versions.

array<object>

Version

string

The engine version of the instance.

5.0

SupportedArchitectureTypes

object

SupportedArchitectureType

array<object>

The available architectures.

array<object>

Architecture

string

The architecture of the instance. Valid values:

  • standard: standard architecture

  • cluster: cluster architecture

  • rwsplit: read/write splitting architecture

cluster

SupportedShardNumbers

object

SupportedShardNumber

array<object>

The numbers of available shards.

array<object>

ShardNumber

string

The number of shards.

8

SupportedNodeTypes

object

SupportedNodeType

array<object>

The supported node types.

array<object>

The supported node type.

SupportedNodeType

string

The node type of the instance. Valid values:

  • single: standalone

  • double: master-replica

double

AvailableResources

object

AvailableResource

array<object>

The available instance types.

object

The available instance type.

InstanceClassRemark

string

The description of the instance type.

16G集群版(8节点)(QPS:1920000 Connections:240000)

Capacity

integer

The memory size of the instance. Unit: MB.

16384

InstanceClass

string

The code of the instance type. If you want to view the code of an instance type, you can search for the code of the instance type in Help Center.

redis.amber.logic.sharding.2g.8db.0rodb.24proxy.multithread

IsMainSale

boolean

An internal parameter.

true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "493B7308-D9C2-55F6-B042-0313BD63****",
  "AvailableZones": {
    "AvailableZone": [
      {
        "ZoneId": "cn-hangzhou-h",
        "ZoneName": "杭州 可用区H",
        "RegionId": "cn-hangzhou",
        "SupportedEngines": {
          "SupportedEngine": [
            {
              "Engine": "Redis",
              "SupportedEditionTypes": {
                "SupportedEditionType": [
                  {
                    "EditionType": "Enterprise",
                    "SupportedSeriesTypes": {
                      "SupportedSeriesType": [
                        {
                          "SeriesType": "enhanced_performance_type",
                          "SupportedEngineVersions": {
                            "SupportedEngineVersion": [
                              {
                                "Version": "5.0",
                                "SupportedArchitectureTypes": {
                                  "SupportedArchitectureType": [
                                    {
                                      "Architecture": "cluster",
                                      "SupportedShardNumbers": {
                                        "SupportedShardNumber": [
                                          {
                                            "ShardNumber": "8",
                                            "SupportedNodeTypes": {
                                              "SupportedNodeType": [
                                                {
                                                  "SupportedNodeType": "double",
                                                  "AvailableResources": {
                                                    "AvailableResource": [
                                                      {
                                                        "InstanceClassRemark": "16G集群版(8节点)(QPS:1920000 Connections:240000)",
                                                        "Capacity": 16384,
                                                        "InstanceClass": "redis.amber.logic.sharding.2g.8db.0rodb.24proxy.multithread"
                                                      }
                                                    ]
                                                  }
                                                }
                                              ]
                                            }
                                          }
                                        ]
                                      }
                                    }
                                  ]
                                }
                              }
                            ]
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          ]
        },
        "IsMainSale": true
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.