All Products
Search

This Product

    Resource Management:SearchResources

    Document Center

    Resource Management:SearchResources

    Last Updated:Jun 10, 2026

    Mencari sumber daya di akun Anda saat ini yang diizinkan untuk Anda akses.

    Deskripsi operasi

    • Anda hanya dapat mencari sumber daya di akun Anda saat ini yang diizinkan untuk Anda akses.

    • Anda hanya dapat mencari layanan Alibaba Cloud dan jenis sumber daya yang didukung oleh Resource Center.

    • Secara default, operasi SearchResources mengembalikan maksimum 20 entri. Anda dapat menentukan parameter MaxResults untuk mengubah jumlah maksimum entri yang dikembalikan.

    • Jika respons tidak menyertakan nilai NextToken, tidak ada lagi hasil yang tersedia. Untuk mengambil halaman hasil berikutnya, sertakan nilai NextToken dari respons sebelumnya dalam permintaan Anda berikutnya. Jika Anda tidak menentukan parameter NextToken, halaman pertama hasil akan dikembalikan.

    • Anda dapat menetapkan satu atau lebih kondisi filter untuk mempersempit cakupan pencarian. Untuk informasi tentang parameter filter dan metode pencocokan yang didukung, lihat bagian berikut. Beberapa kondisi filter digabungkan dengan logika AND. Hanya sumber daya yang memenuhi semua kondisi filter yang akan dikembalikan. Nilai-nilai dalam satu kondisi filter digabungkan dengan logika OR. Sumber daya yang memenuhi nilai apa pun dari kondisi filter akan dikembalikan.

    • Untuk contoh kueri lainnya, lihat API Explorer.

    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

    resourcecenter:SearchResources

    list

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    NextToken

    string

    No

    Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Anda tidak perlu menentukan parameter ini untuk permintaan pertama. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai dari NextToken.

    eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****
    MaxResults

    integer

    No

    Jumlah maksimum entri per halaman.

    Nilai yang valid: 1 hingga 500.

    Nilai default: 20.

    10
    Filter

    array<object>

    No

    Kondisi filter.

    object

    No

    Kondisi filter.

    Key

    string

    No

    Kunci kondisi filter. Untuk informasi lebih lanjut tentang nilai yang valid, lihat bagian "Parameter filter yang didukung" di bawah.

    RegionId
    MatchType

    string

    No

    Metode pencocokan. Nilai yang valid:

    • Equals: Pencocokan tepat.

    • Prefix: Pencocokan prefiks.

    • Contains: Berisi nilai.

    • NotContains: Tidak berisi nilai.

    • Exists: Kunci ada.

    • NotExists: Kunci tidak ada.

    Equals
    Value

    array

    No

    Nilai kondisi filter.

    string

    No

    Nilai kondisi filter.

    过滤条件值。
    ResourceGroupId

    string

    No

    ID grup sumber daya.

    rg-acfmzawhxxc****
    SortCriterion

    object

    No

    Parameter pengurutan.

    Key

    string

    No

    Kunci pengurutan.

    Atur parameter ini ke CreateTime, yang berarti hasil diurutkan berdasarkan waktu pembuatan sumber daya.

    CreateTime
    Order

    string

    No

    Urutan pengurutan. Nilai yang valid:

    • ASC: Urutan menaik.

    • DESC: Urutan menurun.

    Nilai default: ASC.

    ASC
    SearchExpression

    string

    No

    Kata kunci pencarian. Resource Center memfilter dan mengurutkan hasil pencarian berdasarkan relevansi. Jika Anda tidak menentukan parameter pengurutan, sumber daya yang lebih cocok dengan kata kunci akan ditampilkan dengan prioritas lebih tinggi.

    keywords
    IncludeDeletedResources

    boolean

    No

    Menentukan apakah akan menyertakan sumber daya yang dihapus. Nilai yang valid:

    • true

    • false

    true

    Parameter filter yang didukung

    ParameterDeskripsiMetode pencocokan yang didukung
    ResourceTypeJenis sumber daya.Equals
    RegionIdID region.Equals
    ResourceIdID sumber daya.Equals, Prefix
    ResourceGroupIdID grup sumber daya.Equals, Exists, NotExists
    ResourceNameNama sumber daya.Equals, Contains
    TagPasangan kunci-nilai dari sebuah tag. Nilainya harus berupa string JSON dalam format { "key": $key, "value": $value }. Anda harus menentukan setidaknya key atau value. Misalnya, jika Anda ingin mengkueri kunci tag foo dan nilai tag bar, atur parameter ini ke { "key": "foo", "value": "bar" }. Jika Anda hanya ingin mengkueri kunci tag foo, atur parameter ini ke { "key": "foo" }.Contains, NotContains, NotExists
    VpcIdID VPC.Equals
    VSwitchIdID vSwitch.Equals
    IpAddressAlamat IP.Equals, Contains

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    Filters

    array<object>

    Kondisi filter.

    object

    Kondisi filter.

    Key

    string

    Kunci kondisi filter.

    RegionId
    MatchType

    string

    Metode pencocokan.

    Equals
    Values

    array

    Nilai-nilai kondisi filter.

    string

    Nilai kondisi filter.

    cn-hangzhou
    MaxResults

    integer

    Jumlah maksimum entri yang dikembalikan per halaman.

    10
    NextToken

    string

    Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru.

    eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****

    RequestId

    string

    ID permintaan.

    D696E6EF-3A6D-5770-801E-4982081FE4D0
    Resources

    array<object>

    Informasi tentang sumber daya.

    array<object>

    Informasi tentang sumber daya.

    AccountId

    string

    ID akun Alibaba Cloud.

    151266687691****
    CreateTime

    string

    Waktu saat sumber daya dibuat.

    Catatan

    Apakah parameter ini dikembalikan tergantung pada layanan Alibaba Cloud tempat sumber daya tersebut berada.

    2021-06-30T09:20:08Z
    ExpireTime

    string

    Waktu saat sumber daya kedaluwarsa.

    2021-07-30T09:20:08Z
    IpAddressAttributes

    array<object>

    Atribut alamat IP.

    object

    Atribut alamat IP.

    IpAddress

    string

    The IP address.

    192.168.1.2
    NetworkType

    string

    The network type. Valid values:

    • Public: Internet

    • Private: Private network

    Public
    Version

    string

    The IP address version.

    Ipv4
    IpAddresses

    array

    Alamat IP.

    Catatan

    Apakah parameter ini dikembalikan tergantung pada layanan Alibaba Cloud tempat sumber daya tersebut berada.

    string

    Alamat IP.

    Catatan

    Apakah parameter ini dikembalikan tergantung pada layanan Alibaba Cloud tempat sumber daya tersebut berada.

    192.168.1.2
    RegionId

    string

    ID region.

    cn-hangzhou
    ResourceGroupId

    string

    ID grup sumber daya.

    rg-acfmzawhxxc****
    ResourceId

    string

    ID sumber daya.

    vtb-bp11lbh452fr8940s****
    ResourceName

    string

    Nama sumber daya.

    group1
    ResourceType

    string

    Jenis sumber daya.

    ACS::VPC::RouteTable
    Tags

    array<object>

    Tag.

    object

    Tag.

    Key

    string

    The tag key.

    test_key
    Value

    string

    The tag value.

    test_value
    ZoneId

    string

    ID zona.

    Catatan

    Apakah parameter ini dikembalikan tergantung pada layanan Alibaba Cloud tempat sumber daya tersebut berada.

    cn-hangzhou-k
    Deleted

    boolean

    Menunjukkan apakah sumber daya dihapus. Nilai yang valid:

    • true

    • false

    true

    Contoh

    Respons sukses

    JSONformat

    {
  "Filters": [
    {
      "Key": "RegionId",
      "MatchType": "Equals",
      "Values": [
        "cn-hangzhou"
      ]
    }
  ],
  "MaxResults": 10,
  "NextToken": "eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****\t\n",
  "RequestId": "D696E6EF-3A6D-5770-801E-4982081FE4D0",
  "Resources": [
    {
      "AccountId": "151266687691****",
      "CreateTime": "2021-06-30T09:20:08Z",
      "ExpireTime": "2021-07-30T09:20:08Z",
      "IpAddressAttributes": [
        {
          "IpAddress": "192.168.1.2",
          "NetworkType": "Public",
          "Version": "Ipv4"
        }
      ],
      "IpAddresses": [
        "192.168.1.2"
      ],
      "RegionId": "cn-hangzhou",
      "ResourceGroupId": "rg-acfmzawhxxc****",
      "ResourceId": "vtb-bp11lbh452fr8940s****",
      "ResourceName": "group1",
      "ResourceType": "ACS::VPC::RouteTable",
      "Tags": [
        {
          "Key": "test_key",
          "Value": "test_value"
        }
      ],
      "ZoneId": "cn-hangzhou-k",
      "Deleted": true
    }
  ]
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 NoPermission You are not authorized to perform this operation.
    400 InvalidParameter.MaxResults The specified parameter MaxResults is not valid.
    400 InvalidParameter.Filter.ResourceType The specified parameter value of Filter.ResourceType is not valid.
    400 InvalidParameter.Filter.IpAddress The specified parameter Filter.n.IpAddress is not valid.
    400 InvalidParameter.Filter.Tag The specified parameter Filter.n.Tag is not valid.
    400 InvalidParameter.Filter.CreateTime The specified parameter Filter.n.CreateTime is not valid.
    409 InvalidParameter.SortCriterion.Key The specified parameter SortCriterion.Key is not valid.
    409 ExceedLimit.Filter The maximum length of Filters is exceeded.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.