Tüm Ürünler
Search

Bu Ürün

    :ListTagResources

    Belge Merkezi

    :ListTagResources

    Son Güncelleme:Oct 09, 2026

    Bir veya daha fazla Edge Node Service (ENS) kaynağına bağlı etiketleri sorgular. Şu anda yalnızca örnek kaynakları desteklenmektedir.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ens:ListTagResources

    list

    *Tüm kaynaklar.

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ResourceType

    string

    Yes

    Kaynak türü. Geçerli değerler: instance (örnek).

    Valid values:

    • vswitch :

      vSwitch.

    • armserver :

      ARM sunucusu.

    • disk :

      Bulut diski.

    • instance :

      ENS örneği.

    • natgateway :

      NAT ağ geçidi.

    • eip :

      EIP.

    • network :

      Ağ.

    instance
    ResourceId

    array

    No

    Kaynak kimliği. N için geçerli değerler: 1 ile 50 arası.\n\nResourceId ve Tag parametrelerinden en az birini belirtmeniz gerekir. Aksi takdirde, MissingParameter.ResourceIdsOrTags hatası döndürülür.

    string

    No

    Kaynak kimliği.

    i-t252vwg7cib00ky8g0q
    NextToken

    string

    No

    Sonraki sorgu için belirteç.

    153ba0bbb2be03f84eb48b699f0a4123
    Tag

    array<object>

    No

    Etiket listesi.\n\nResourceId ve Tag parametrelerinden en az birini belirtmeniz gerekir. Aksi takdirde, MissingParameter.ResourceIdsOrTags hatası döndürülür.

    object

    No

    Kaynağın etiketi.

    Key

    string

    No

    Örneğin etiket anahtarı. N için geçerli değerler: 1 ile 20 arası.\n\n- Etiket anahtarı aliyun, acs:, http:// veya https:// ile başlayamaz.\n- Etiket anahtarı en fazla 64 karakter uzunluğunda olabilir.\n- Etiket anahtarı boş bir dize olamaz.

    team
    Value

    string

    No

    Konunun etiket değeri. Key ve Value parametrelerinin her ikisini de belirtmeli veya hiçbirini belirtmemelisiniz. Her ikisi de belirtilirse sistem konuları etikete göre filtreler. Hiçbiri belirtilmezse tüm konular sorgulanır.\n\n- N için geçerli değerler: 1 ile 20 arası.\n- Etiket değeri boş bir dize olabilir.\n- Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz ya da http:// veya https:// içeremez.

    tagValue

    Response elements

    Element

    Type

    Description

    Example

    object

    Yanıt şeması.

    RequestId

    string

    İstek kimliği.

    C78D9B61-69D8-5655-A312-A15DA5EA5D5E
    TagResources

    array<object>

    Etiketlenmiş kaynaklar koleksiyonu.

    object

    Kaynağın etiketleri.

    ResourceId

    string

    İlişkili kaynağın kimliği.

    i-5zy93g7z1hnkdmav84joxyzgn
    ResourceType

    string

    Kaynak türü.

    instance
    TagKey

    string

    Örneğin etiket anahtarı.

    test_tag_key-2
    TagValue

    string

    Etiket değeri.

    CLUSTER
    NextToken

    string

    Sonraki sorgu için belirteç.

    abcfeg368547ccdef

    Examples

    Success response

    JSON format

    {
  "RequestId": "C78D9B61-69D8-5655-A312-A15DA5EA5D5E",
  "TagResources": [
    {
      "ResourceId": "i-5zy93g7z1hnkdmav84joxyzgn",
      "ResourceType": "instance",
      "TagKey": "test_tag_key-2",
      "TagValue": "CLUSTER"
    }
  ],
  "NextToken": "abcfeg368547ccdef"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 CallInterface Call Interface Happen Error. API işlemi çağrılırken bir hata oluştu.
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.
    403 NoPermission The operator is not permission for this operate

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.