All Products
Search

This Product

    Elastic Compute Service:ModifyCloudAssistantSettings

    Document Center

    Elastic Compute Service:ModifyCloudAssistantSettings

    Last Updated:Sep 20, 2026

    Mengubah konfigurasi layanan Asisten Cloud.

    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

    *Pengaturan layanan.

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah.

    cn-hangzhou
    SettingType

    string

    Yes

    Tipe konfigurasi layanan. Nilai valid:

    • SessionManagerDelivery: Pengiriman log operasi sesi.

    • InvocationDelivery: Pengiriman log eksekusi tugas.

    • AgentUpgradeConfig: Konfigurasi peningkatan Agen Asisten Cloud.

    • SessionManagerConfig: Konfigurasi SessionManager Asisten Cloud.

    SessionManagerDelivery
    OssDeliveryConfig

    object

    No

    Konfigurasi pengiriman OSS.

    BucketName

    string

    No

    Nama bucket OSS.

    example-bucket
    Enabled

    boolean

    No

    Apakah akan mengaktifkan pengiriman ke OSS. Nilai default: false.

    false
    EncryptionAlgorithm

    string

    No

    Algoritma enkripsi OSS. Nilai valid:

    • AES256

    • SM4

    AES256
    EncryptionKeyId

    string

    No

    ID customer master key (CMK) saat metode enkripsi diatur ke KMS.

    a807****7a70e
    EncryptionType

    string

    No

    Metode enkripsi OSS. Nilai valid:

    • Inherit: Mewarisi metode enkripsi bucket.

    • OssManaged: Menggunakan enkripsi yang dikelola OSS.

    • KMS: Menggunakan enkripsi berbasis KMS.

    Inherit
    Prefix

    string

    No

    Awalan direktori bucket OSS. Batasan:

    • Panjang awalan tidak boleh melebihi 254 karakter.

    • Awalan tidak boleh diawali dengan garis miring (/) atau garis miring terbalik (\).

    Catatan

    Catatan: Kirim string kosong ("") untuk menunjukkan bahwa awalan direktori tidak diperlukan. Jika awalan sebelumnya telah diatur dan tidak lagi diperlukan, kirim string kosong ("") untuk menghapusnya.

    sessionmanager/audit
    SlsDeliveryConfig

    object

    No

    Konfigurasi pengiriman Simple Log Service (SLS).

    Enabled

    boolean

    No

    Apakah akan mengaktifkan pengiriman ke SLS. Nilai default: false.

    false
    LogstoreName

    string

    No

    Nama penyimpanan log SLS.

    example-logstore
    ProjectName

    string

    No

    Nama proyek SLS.

    example-project
    AgentUpgradeConfig

    object

    No

    Konfigurasi peningkatan Agen Asisten Cloud.

    AllowedUpgradeWindow

    array

    No

    Daftar jendela pengatur waktu saat peningkatan diizinkan. Pengatur waktu dapat ditentukan hingga menit. Zona pengatur waktu default adalah UTC.

    Interval antarjendela pengatur waktu tidak boleh kurang dari 1 jam.

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

    Sebagai contoh, [ "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 di zona pengatur waktu UTC.

    string

    No

    Daftar jendela pengatur waktu saat peningkatan diizinkan. Pengatur waktu dapat ditentukan hingga menit. Zona pengatur waktu default adalah UTC.

    Interval antarjendela pengatur waktu tidak boleh kurang dari 1 jam.

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

    Sebagai contoh, [ "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 di zona pengatur waktu UTC.

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

    boolean

    No

    Apakah Agen Asisten Cloud akan memeriksa pembaruan versi dan melakukan peningkatan segera saat startup. Nilai default: true.

    Pengaturan ini hanya berlaku saat versi Agen Asisten Cloud tidak lebih lama dari versi berikut:

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    true
    DisableUpgrade

    boolean

    No

    Apakah akan mencegah Agen Asisten Cloud memeriksa dan melakukan pembaruan. Nilai default: false.

    Pengaturan ini hanya berlaku saat versi Agen Asisten Cloud tidak lebih lama dari versi berikut:

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    false
    Enabled

    boolean

    No

    Apakah akan mengaktifkan konfigurasi peningkatan Agen kustom. Jika diatur ke false, perilaku default untuk mencoba peningkatan setiap 30 menit akan dipertahankan.

    Nilai default: false.

    true
    TimeZone

    string

    No

    Zona pengatur waktu untuk jendela peningkatan pengatur waktu yang diizinkan. Zona pengatur waktu default adalah UTC. Zona pengatur waktu dapat ditentukan dalam dua format berikut:

    • Nama zona pengatur waktu lengkap: seperti Asia/Shanghai atau America/Los_Angeles.

    • Offset GMT dari Greenwich Mean Time: seperti GMT+8:00 atau GMT-7:00. Angka nol di depan tidak didukung untuk nilai jam.

    Asia/Shanghai
    ResourceUsageConfig

    object

    No

    Konfigurasi penggunaan sumber daya Asisten Cloud. Pengaturan ini hanya berlaku saat versi Agen Asisten Cloud tidak lebih lama dari versi berikut:

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    CpuLimit

    integer

    No

    Penggunaan CPU maksimum yang diizinkan untuk proses utama Agen Asisten Cloud.

    • Unit: persentase.

    • Nilai valid: 10 hingga 95.

    • Nilai default: 20.

    20
    KeepScriptFile

    boolean

    No

    Apakah akan mempertahankan file skrip di direktori Asisten Cloud setelah eksekusi perintah selesai. Nilai default: false.

    false
    LogFileCountLimit

    integer

    No

    Jumlah maksimum file log Asisten Cloud yang akan dipertahankan.

    • Nilai default: 30.

    • Nilai minimum: 7.

    • Nilai maksimum: 365.

    30
    LogSizeLimit

    string

    No

    Batas ukuran satu file log Asisten Cloud. Anda harus menentukan unit (B|KB|MB).

    • Nilai default: 100MB.

    • Nilai minimum: 10MB.

    • Nilai maksimum: 1024MB.

    10MB
    MemoryLimit

    string

    No

    Penggunaan memori maksimum yang diizinkan untuk proses utama Agen Asisten Cloud. Anda harus menentukan unit (B|KB|MB).

    • Nilai default: 50MB.

    • Nilai minimum: 35MB.

    • Nilai maksimum: 1024MB.

    50MB
    OverloadLimit

    integer

    No

    Jumlah maksimum berturut-turut pengatur waktu penggunaan sumber daya CPU atau memori yang dapat melebihi batas. Saat batas ini tercapai, Agen Asisten Cloud akan berhenti berjalan secara otomatis.

    • Nilai default: 3.

    • Nilai minimum: 3.

    3
    SessionManagerConfig

    object

    No

    Konfigurasi fitur sesi Asisten Cloud.

    SessionManagerEnabled

    boolean

    No

    Apakah akan mengaktifkan fitur sesi Asisten Cloud. Nilai valid:

    • true: Diaktifkan.

    • false: Dinonaktifkan.

    Catatan:

    • Mengaktifkan atau menonaktifkan fitur sesi berlaku di semua wilayah.

    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. Parameter SettingType yang ditentukan tidak valid.
    400 InvalidParameter.OssEncryptionType The specified parameter OssDeliveryConfig.EncryptionType is not valid. Parameter OssDeliveryConfig.EncryptionType yang ditentukan tidak valid.
    400 InvalidParameter.OssEncryptionAlgorithm The specified parameter OssDeliveryConfig.EncryptionAlgorithm is not valid. Parameter OssDeliveryConfig.EncryptionAlgorithm yang ditentukan tidak valid.
    400 InvalidParameter.OssEncryptionKeyId The specified parameter OssDeliveryConfig.EncryptionKeyId is not valid. Parameter OssDeliveryConfig.EncryptionKeyId yang ditentukan tidak valid.
    400 InvalidParameter.OssBucketName The specified parameter OssDeliveryConfig.BucketName is not valid. Parameter OssDeliveryConfig.BucketName yang ditentukan tidak valid.
    400 InvalidParameter.OssPrefix The specified parameter OssDeliveryConfig.Prefix is not valid. Parameter OssDeliveryConfig.Prefix yang ditentukan tidak valid.
    400 InvalidOssBucketName.InOtherRegion The specified parameter OssDeliveryConfig.BucketName is in another region. Bucket OSS yang ditentukan oleh OssDeliveryConfig.BucketName berada di wilayah yang berbeda.
    400 InvalidParameter.SlsProjectName The specified parameter SlsDeliveryConfig.ProjectName is not valid. Parameter SlsDeliveryConfig.ProjectName yang ditentukan tidak valid.
    400 InvalidParameter.SlsLogstoreName The specified parameter SlsDeliveryConfig.LogstoreName is not valid. Parameter SlsDeliveryConfig.LogstoreName yang ditentukan tidak valid. Parameter ini merujuk ke penyimpanan log.
    400 InvalidParameter.AllowedUpgradeWindow The specified parameter AgentUpgradeConfig.AllowedUpgradeWindow is not valid. Parameter AgentUpgradeConfig.AllowedUpgradeWindow yang ditentukan tidak valid.
    400 InvalidAllowedUpgradeWindow.DurationTooShort The duration of the specified parameter AgentUpgradeConfig.AllowedUpgradeWindow cannot be less than one hour. Interval parameter AllowedUpgradeWindow tidak boleh lebih pendek dari setengah jam.
    400 InvalidParameter.TimeZone The specified parameter AgentUpgradeConfig.TimeZone is not valid. Parameter AgentUpgradeConfig.TimeZone yang ditentukan tidak valid.
    400 InvalidAllowedUpgradeWindow.Required The specified parameter AgentUpgradeConfig.AllowedUpgradeWindow is required. Saat Anda mengaktifkan konfigurasi peningkatan agen kustom, AgentUpgradeConfig.AllowedUpgradeWindow wajib diisi.
    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. Terjadi error internal. Coba lagi.
    403 InvalidParameterCharacter The specified parameter %s contains illegal characters.
    403 InvalidOssBucketName.AccessDenied The error message returned by the OSS API is: %s
    403 CreateServiceLinkedRole.NoPermission You do not have permission to create ServiceLinkedRole. Anda tidak memiliki izin untuk membuat peran terkait layanan.
    403 InvalidOperation.OssEncryptionUnsupported The configuration of OSS Encryption is not supported. Layanan saat ini tidak mendukung pengaturan metode enkripsi OSS.
    403 InvalidAllowedUpgradeWindow.CountLimitExceeded The count of the parameter AgentUpgradeConfig.AllowedUpgradeWindow exceeds the limit of 5. Jumlah parameter AgentUpgradeConfig.AllowedUpgradeWindow melebihi batas 5.
    403 InvalidOperation.SessionManagerDeliveryUnsupported The delivery configuration of Session Manager is not supported. Mengaktifkan konfigurasi pengiriman Session Manager tidak didukung.
    403 InvalidDisableUpgrade.Conflict The parameter DisableUpgrade cannot be specified with parameter BootstrapUpgrade.
    404 InvalidSlsProjectName.NotFound The specified parameter SlsDeliveryConfig.ProjectName does not exist. Proyek SLS yang ditentukan tidak ada.
    404 InvalidSlsLogstoreName.NotFound The specified parameter SlsDeliveryConfig.LogstoreName does not exist. Penyimpanan log SLS yang ditentukan tidak ada.
    404 InvalidOssBucketName.NotFound The specified parameter OssDeliveryConfig.BucketName does not exist. Bucket OSS yang ditentukan tidak ada.
    404 InvalidRegionId.NotFound The specified parameter RegionId does not exist. RegionId yang ditentukan tidak ada. Periksa apakah produk tersedia di wilayah ini.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.