All Products
Search

This Product

    Resource Orchestration Service:RegisterResourceType

    Document Center

    Resource Orchestration Service:RegisterResourceType

    Last Updated:Jun 10, 2026

    Membuat tipe sumber daya baru, atau membuat versi baru untuk tipe sumber daya yang sudah ada.

    Deskripsi operasi

    • Versions increase from v1.

    • If you create a new resource type, v1 is used as the default version of the resource type. You can call the SetResourceType operation to change the default version of a resource type.

    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

    ros:RegisterResourceType

    create

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    EntityType

    string

    Yes

    Tipe entitas. Tetapkan nilai ke Module.

    Valid values:

    • Module :

      Module.

    Module
    ResourceType

    string

    Yes

    Tipe sumber daya.

    MODULE::MyOrganization::MyService::MyUsecase
    TemplateBody

    string

    No

    Struktur yang berisi badan template. Badan template harus sepanjang 1 hingga 524.288 byte. Badan template digunakan sebagai konten modul. Jika panjang badan template melebihi batas atas, disarankan untuk menambahkan parameter ke badan permintaan HTTP POST untuk mencegah kegagalan permintaan yang disebabkan oleh URL yang terlalu panjang.

    Catatan

    • Parameter ini hanya berlaku ketika EntityType diatur ke Module.

    • Anda hanya dapat menentukan salah satu dari parameter TemplateBody dan TemplateURL.

    {"ROSTemplateFormatVersion":"2015-09-01"}
    TemplateURL

    string

    No

    URL file yang berisi badan template. URL harus mengarah ke template yang terletak di server web HTTP atau HTTPS atau di bucket Object Storage Service (OSS), seperti oss://ros/template/demo atau oss://ros/template/demo?RegionId=cn-hangzhou. Badan template dapat sepanjang hingga 524.288 byte. Badan template digunakan sebagai konten modul.

    Catatan

    • Jika Anda tidak menentukan ID wilayah bucket OSS, nilai RegionId yang digunakan.

    • Parameter ini hanya berlaku ketika EntityType diatur ke Module.

    • Anda hanya dapat menentukan salah satu dari parameter TemplateBody dan TemplateURL.

    URL dapat sepanjang hingga 1.024 byte.

    oss://ros-template/demo
    Description

    string

    No

    Deskripsi tipe sumber daya. Deskripsi dapat sepanjang hingga 512 karakter.

    It is a demo.
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda.
    Token dapat sepanjang hingga 64 karakter, dan dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).
    Untuk informasi lebih lanjut, lihat Memastikan idempotensi.

    123e4567-e89b-12d3-a456-42665544****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    B288A0BE-D927-4888-B0F7-B35EF84B6E6F
    RegistrationId

    string

    The ID of the registration record. You can call the ListResourceTypeRegistrations operation to query registration records.

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
  "RegistrationId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.