All Products
Search

This Product

    Elastic Compute Service:ModifyCloudAssistantSettings

    Document Center

    Elastic Compute Service:ModifyCloudAssistantSettings

    Last Updated:Jun 12, 2026

    Memodifikasi konfigurasi layanan Cloud Assistant.

    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

    ecs:ModifyCloudAssistantSettings

    update

    *ServiceSettings

    acs:ecs:{#regionId}:{#accountId}:servicesettings/{#servicesettingId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region.

    cn-hangzhou
    SettingType

    string

    Yes

    Tipe konfigurasi layanan. Nilai yang valid:

    • SessionManagerDelivery: Pengiriman catatan operasi sesi.

    • InvocationDelivery: Pengiriman catatan eksekusi tugas.

    • AgentUpgradeConfig: Konfigurasi peningkatan Cloud Assistant Agent.

    • SessionManagerConfig: Konfigurasi SessionManager Cloud Assistant.

    SessionManagerDelivery
    OssDeliveryConfig

    object

    No

    Informasi konfigurasi pengiriman OSS.

    Enabled

    boolean

    No

    Menentukan apakah akan mengaktifkan pengiriman ke OSS. Nilai default: false.

    false
    BucketName

    string

    No

    Nama bucket OSS.

    example-bucket
    Prefix

    string

    No

    Prefiks direktori dari bucket OSS. Batasannya adalah sebagai berikut:

    • Panjangnya tidak boleh melebihi 254 karakter.

    • Tidak boleh diawali dengan garis miring (/) atau garis miring terbalik ().

    Catatan: Memasukkan "" menunjukkan bahwa tidak diperlukan prefiks direktori. Jika sebelumnya Anda telah menetapkan prefiks dan tidak lagi memerlukannya, masukkan "" untuk menghapusnya.

    sessionmanager/audit
    EncryptionType

    string

    No

    Tipe enkripsi OSS. Nilai yang valid:

    • Inherit: Mewarisi dari bucket.

    • OssManaged: Dikelola sepenuhnya oleh OSS.

    • KMS: Enkripsi KMS.

    Inherit
    EncryptionAlgorithm

    string

    No

    Algoritma enkripsi OSS. Nilai yang valid:

    • AES256

    • SM4

    AES256
    EncryptionKeyId

    string

    No

    ID customer master key (CMK) pengguna ketika tipe enkripsi adalah KMS.

    a807****7a70e
    SlsDeliveryConfig

    object

    No

    Informasi konfigurasi pengiriman SLS.

    Enabled

    boolean

    No

    Menentukan apakah akan mengaktifkan pengiriman ke SLS. Nilai default: false

    false
    ProjectName

    string

    No

    Nama proyek SLS.

    example-project
    LogstoreName

    string

    No

    Nama Logstore SLS.

    example-logstore
    AgentUpgradeConfig

    object

    No

    Konfigurasi peningkatan Cloud Assistant Agent.

    Enabled

    boolean

    No

    Menentukan apakah akan mengaktifkan konfigurasi peningkatan Agent kustom. Jika diatur ke false, sistem akan mencoba untuk meningkatkan setiap 30 menit secara default.

    Nilai default: false.

    true
    AllowedUpgradeWindow

    array

    No

    Daftar jendela waktu di mana peningkatan diizinkan. Jendela dapat ditentukan hingga menit dan secara default menggunakan zona waktu UTC.

    Interval setiap jendela waktu tidak boleh kurang dari 1 jam.

    Format: Waktu mulai (HH:mm)-Waktu selesai (HH:mm).

    Contohnya, [ "02:00-03:00", "05:00-06:00" ] menunjukkan bahwa peningkatan diizinkan setiap hari dari pukul 02:00 hingga 03:00 dan dari pukul 05:00 hingga 06:00 dalam zona waktu UTC.

    string

    No

    Daftar jendela waktu di mana peningkatan diizinkan. Jendela dapat ditentukan hingga menit dan secara default menggunakan zona waktu UTC.

    Interval setiap jendela waktu tidak boleh kurang dari 1 jam.

    Format: Waktu mulai (HH:mm)-Waktu selesai (HH:mm).

    Contohnya, [ "02:00-03:00", "05:00-06:00" ] menunjukkan bahwa peningkatan diizinkan setiap hari dari pukul 02:00 hingga 03:00 dan dari pukul 05:00 hingga 06:00 dalam zona waktu UTC.

    [ "02:00-03:00", "05:00-06:00" ]
    TimeZone

    string

    No

    Zona waktu untuk jendela peningkatan yang diizinkan. Default adalah UTC. Zona waktu mendukung dua format berikut:

    • Nama zona waktu lengkap: seperti Asia/Shanghai (Waktu Tiongkok/Shanghai) atau America/Los_Angeles (Waktu AS/Los Angeles).

    • Offset zona waktu relatif terhadap Greenwich Mean Time: seperti GMT+8:00 (UTC+8) atau GMT-7:00 (UTC-7). Angka nol di depan tidak didukung di bagian jam.

    Asia/Shanghai
    BootstrapUpgrade

    boolean

    No

    Menentukan apakah akan segera memeriksa versi dan melakukan pembaruan ketika Cloud Assistant Agent dimulai. Nilai default: true.

    Ini hanya berlaku ketika versi Cloud Assistant Agent setidaknya:

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    true
    DisableUpgrade

    boolean

    No

    Menentukan apakah akan mencegah Cloud Assistant Agent memeriksa dan melakukan pembaruan. Nilai default: false.

    Ini hanya berlaku ketika versi Cloud Assistant Agent setidaknya:

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    false
    ResourceUsageConfig

    object

    No

    Konfigurasi penggunaan resource Cloud Assistant. Ini hanya berlaku ketika versi Cloud Assistant Agent setidaknya:

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    CpuLimit

    integer

    No

    Batas maksimum penggunaan CPU yang diizinkan untuk proses utama Cloud Assistant Agent.

    • Satuan: persentase.

    • Nilai yang valid: 10-95.

    • Nilai default: 20.

    20
    MemoryLimit

    string

    No

    Batas maksimum penggunaan memori yang diizinkan untuk proses utama Cloud Assistant Agent. Satuan harus ditentukan (B|KB|MB).

    • Nilai default: 50MB.

    • Nilai minimum: 35MB.

    • Nilai maksimum: 1024MB.

    50MB
    OverloadLimit

    integer

    No

    Jumlah maksimum berapa kali berturut-turut penggunaan resource CPU atau memori dapat melampaui batas. Ketika batas ini tercapai, Cloud Assistant Agent secara otomatis dihentikan.

    • Nilai default: 3.

    • Nilai minimum: 3.

    3
    LogFileCountLimit

    integer

    No

    Jumlah maksimum file log Cloud Assistant yang akan disimpan.

    • Default: 30.

    • Nilai minimum: 7.

    • Nilai maksimum: 365.

    30
    LogSizeLimit

    string

    No

    Batas ukuran untuk satu file log Cloud Assistant. Satuan harus ditentukan (B|KB|MB).

    • Nilai default: 100MB.

    • Nilai minimum: 10MB.

    • Nilai maksimum: 1024MB.

    10MB
    KeepScriptFile

    boolean

    No

    Menentukan apakah akan mempertahankan file skrip di direktori Cloud Assistant setelah eksekusi perintah selesai. Nilai default: false.

    false
    SessionManagerConfig

    object

    No

    Konfigurasi fitur sesi Cloud Assistant.

    SessionManagerEnabled

    boolean

    No

    Sakelar untuk fitur sesi Cloud Assistant. Nilai yang valid:

    • true: Aktifkan.

    • false: Nonaktifkan.

    Catatan:

    • Mengaktifkan atau menonaktifkan fitur sesi berlaku di semua region.

    true

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 ResourceBusy.SlrCreation The ServiceLinkedRole is still being created or has not taken effect yet. Please try again later.
    400 InvalidParameter.SettingType The specified parameter SettingType is not valid.
    400 InvalidParameter.OssEncryptionType The specified parameter OssDeliveryConfig.EncryptionType is not valid.
    400 InvalidParameter.OssEncryptionAlgorithm The specified parameter OssDeliveryConfig.EncryptionAlgorithm is not valid.
    400 InvalidParameter.OssEncryptionKeyId The specified parameter OssDeliveryConfig.EncryptionKeyId is not valid.
    400 InvalidParameter.OssBucketName The specified parameter OssDeliveryConfig.BucketName is not valid.
    400 InvalidParameter.OssPrefix The specified parameter OssDeliveryConfig.Prefix is not valid.
    400 InvalidOssBucketName.InOtherRegion The specified parameter OssDeliveryConfig.BucketName is in another region.
    400 InvalidParameter.SlsProjectName The specified parameter SlsDeliveryConfig.ProjectName is not valid.
    400 InvalidParameter.SlsLogstoreName The specified parameter SlsDeliveryConfig.LogstoreName is not valid.
    400 InvalidParameter.AllowedUpgradeWindow The specified parameter AgentUpgradeConfig.AllowedUpgradeWindow is not valid.
    400 InvalidAllowedUpgradeWindow.DurationTooShort The duration of the specified parameter AgentUpgradeConfig.AllowedUpgradeWindow cannot be less than one hour.
    400 InvalidParameter.TimeZone The specified parameter AgentUpgradeConfig.TimeZone is not valid.
    400 InvalidAllowedUpgradeWindow.Required The specified parameter AgentUpgradeConfig.AllowedUpgradeWindow is required.
    400 InvalidParameter.CpuLimit The specified parameter CpuLimit is not valid.
    400 InvalidParameter.MemoryLimit The specified parameter MemoryLimit is not valid.
    400 InvalidParameter.OverloadLimit The specified parameter OverloadLimit is not valid.
    400 InvalidParameter.LogFileCountLimit The specified parameter LogFileCountLimit is not valid.
    400 InvalidParameter.LogSizeLimit The specified parameter LogSizeLimit is not valid.
    500 InternalError An error occurred when you dispatched the request.
    403 InvalidOssBucketName.AccessDenied The error message returned by the OSS API is: %s
    403 CreateServiceLinkedRole.NoPermission You do not have permission to create ServiceLinkedRole.
    403 InvalidOperation.OssEncryptionUnsupported The configuration of OSS Encryption is not supported.
    403 InvalidAllowedUpgradeWindow.CountLimitExceeded The count of the parameter AgentUpgradeConfig.AllowedUpgradeWindow exceeds the limit of 5.
    403 InvalidOperation.SessionManagerDeliveryUnsupported The delivery configuration of Session Manager is not supported.
    403 InvalidDisableUpgrade.Conflict The parameter DisableUpgrade cannot be specified with parameter BootstrapUpgrade.
    404 InvalidSlsProjectName.NotFound The specified parameter SlsDeliveryConfig.ProjectName does not exist.
    404 InvalidSlsLogstoreName.NotFound The specified parameter SlsDeliveryConfig.LogstoreName does not exist.
    404 InvalidOssBucketName.NotFound The specified parameter OssDeliveryConfig.BucketName does not exist.
    404 InvalidRegionId.NotFound The specified parameter RegionId does not exist.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.