All Products
Search

This Product

    Serverless App Engine:TagResources

    Document Center

    Serverless App Engine:TagResources

    Last Updated:Jun 11, 2026

    Menambahkan satu atau beberapa tag ke Sumber daya 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

    sae:TagResources

    *全部资源

    *

    		 None None

    Sintaks permintaan

    POST /tags HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    ID wilayah.

    cn-beijing
    ResourceType

    string

    Yes

    Jenis Sumber daya. Hanya aplikasi yang didukung.

    application
    Tags

    string

    No

    Pasangan kunci-nilai tag. Parameter ini wajib diisi kecuali Anda menentukan parameter ResourceIds. Aturan berikut berlaku:

    • key: Kunci tag. Panjang kunci harus 1 hingga 128 karakter.

    • value: Nilai tag. Panjang nilai harus 1 hingga 128 karakter.

    Tag bersifat case-sensitive. Jika Anda menentukan beberapa tag, tag akan dibuat dan diikat ke Sumber daya yang ditentukan. Untuk satu Sumber daya, setiap kunci tag harus unik. Jika Anda menentukan kunci tag yang sudah ada untuk suatu Sumber daya, operasi akan memperbarui nilai tag yang ada.

    Kunci tag tidak boleh diawali dengan aliyun atau acs: dan tidak boleh mengandung http:// atau https://.

    [{"key":"k1","value":"v1"}]
    ResourceIds

    string

    Yes

    ID Sumber daya. Anda dapat menentukan hingga 50 ID Sumber daya dalam array JSON. Parameter ini wajib diisi kecuali Anda menentukan parameter Tags.

    ["d42921c4-5433-4abd-8075-0e536f8b****"]

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The data returned.

    RequestId

    string

    The request ID.

    91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
    Message

    string

    The additional information returned.

    • If the request is successful, success is returned.

    • If the request fails, a specific error code is returned.

    success
    TraceId

    string

    The trace ID that you can use to query the details of the request.

    0a98a02315955564772843261e****
    Data

    boolean

    Indicates whether the operation was successful.

    true
    ErrorCode

    string

    The error code.

    • This parameter is returned only if the request fails.

    • For more information, see the Error codes section in this topic.

    Code

    string

    The HTTP status code. Valid values:

    • 2xx: The request was successful.

    • 3xx: The request was redirected.

    • 4xx: A request error occurred.

    • 5xx: A server error occurred.

    200
    Success

    boolean

    Indicates whether the tags were added to the resources. Valid values:

    • true: The tags were added.

    • false: The tags failed to be added.

    true

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": true,
  "ErrorCode": "",
  "Code": "200",
  "Success": true
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 Duplicate.TagKey The TagKey contains duplicate keys.
    400 InvalidParameter.TagKey The specified TagKey is invalid.
    400 InvalidParameter.TagValue The specified TagValue is invalid.
    400 Missing.TagKey You must specify TagKey.
    400 NumberExceed.Tags The maximum number of tags is exceeded.
    400 InvalidResourceType.NotFound The specified resource type is not supported.
    400 InvalidParameter.Obviously The specified parameter is invalid {%s}.
    400 NumberExceed.ResourceIds The number of resource IDs cannot exceed 50.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.