Tüm Ürünler
Search

Bu Ürün

    :ModifyCloudAssistantSettings

    Belge Merkezi

    :ModifyCloudAssistantSettings

    Son Güncelleme:Oct 02, 2026

    Cloud Assistant hizmet yapılandırmalarını değiştirir.

    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

    ecs:ModifyCloudAssistantSettings

    update

    *ServiceSettings

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

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    Bölge kimliği.

    cn-hangzhou
    SettingType

    string

    Yes

    Hizmet yapılandırma türü. Geçerli değerler:

    • SessionManagerDelivery: Oturum işlem günlüğü teslimi.

    • InvocationDelivery: Görev yürütme günlüğü teslimi.

    • AgentUpgradeConfig: Cloud Assistant Agent yükseltme yapılandırması.

    • SessionManagerConfig: Cloud Assistant SessionManager yapılandırması.

    SessionManagerDelivery
    OssDeliveryConfig

    object

    No

    OSS teslim yapılandırması.

    BucketName

    string

    No

    OSS bucket'ının adı.

    example-bucket
    Enabled

    boolean

    No

    OSS'ye teslimin etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer: false.

    false
    EncryptionAlgorithm

    string

    No

    OSS şifreleme algoritması. Geçerli değerler:

    • AES256

    • SM4

    AES256
    EncryptionKeyId

    string

    No

    Şifreleme yöntemi KMS olarak ayarlandığında müşteri ana anahtarı (CMK) kimliği.

    a807****7a70e
    EncryptionType

    string

    No

    OSS şifreleme yöntemi. Geçerli değerler:

    • Inherit: Bucket'ın şifreleme yöntemini devralır.

    • OssManaged: OSS tarafından yönetilen şifrelemeyi kullanır.

    • KMS: KMS tabanlı şifrelemeyi kullanır.

    Inherit
    Prefix

    string

    No

    OSS bucket'ının dizin öneki. Kısıtlamalar:

    • Önek uzunluğu 254 karakteri aşamaz.

    • Önek eğik çizgi (/) veya ters eğik çizgi () ile başlayamaz.

    Not

    Not: Dizin öneki gerekmediğini belirtmek için boş bir dize ("") iletin. Daha önce bir önek ayarlanmışsa ve artık gerekli değilse, temizlemek için boş bir dize ("") iletin.

    sessionmanager/audit
    SlsDeliveryConfig

    object

    No

    Simple Log Service (SLS) teslim yapılandırması.

    Enabled

    boolean

    No

    SLS'ye teslimin etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer: false.

    false
    LogstoreName

    string

    No

    SLS Logstore'unun adı.

    example-logstore
    ProjectName

    string

    No

    SLS projesinin adı.

    example-project
    AgentUpgradeConfig

    object

    No

    Cloud Assistant Agent yükseltme yapılandırması.

    AllowedUpgradeWindow

    array

    No

    Yükseltmelere izin verilen zaman pencerelerinin listesi. Zaman, dakikaya kadar belirtilebilir. Varsayılan saat dilimi UTC'dir.

    Zaman pencereleri arasındaki aralık 1 saatten az olamaz.

    Biçim: başlangıç saati (HH:mm)-bitiş saati (HH:mm).

    Örneğin, [ "02:00-03:00", "05:00-06:00" ] UTC saat diliminde her gün 02:00 ile 03:00 arası ve 05:00 ile 06:00 arası yükseltmelere izin verildiğini gösterir.

    string

    No

    Yükseltmelere izin verilen zaman pencerelerinin listesi. Zaman, dakikaya kadar belirtilebilir. Varsayılan saat dilimi UTC'dir.

    Zaman pencereleri arasındaki aralık 1 saatten az olamaz.

    Biçim: başlangıç saati (HH:mm)-bitiş saati (HH:mm).

    Örneğin, [ "02:00-03:00", "05:00-06:00" ] UTC saat diliminde her gün 02:00 ile 03:00 arası ve 05:00 ile 06:00 arası yükseltmelere izin verildiğini gösterir.

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

    boolean

    No

    Cloud Assistant Agent'ın başlangıçta hemen sürüm güncellemelerini denetleyip denetlemeyeceğini ve yükseltmeleri gerçekleştirip gerçekleştirmeyeceğini belirtir. Varsayılan değer: true.

    Bu ayar yalnızca Cloud Assistant Agent sürümü aşağıdaki sürümlerden daha eski olmadığında etkili olur:

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    true
    DisableUpgrade

    boolean

    No

    Cloud Assistant Agent'ın güncellemeleri denetlemesini ve gerçekleştirmesini engelleyip engellemeyeceğini belirtir. Varsayılan değer: false.

    Bu ayar yalnızca Cloud Assistant Agent sürümü aşağıdaki sürümlerden daha eski olmadığında etkili olur:

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    false
    Enabled

    boolean

    No

    Özel Agent yükseltme yapılandırmasının etkinleştirilip etkinleştirilmeyeceğini belirtir. false olarak ayarlanırsa, her 30 dakikada bir yükseltme denemesi yapma varsayılan davranışı korunur.

    Varsayılan değer: false.

    true
    TimeZone

    string

    No

    İzin verilen yükseltme zaman pencereleri için saat dilimi. Varsayılan saat dilimi UTC'dir. Saat dilimi aşağıdaki iki biçimde belirtilebilir:

    • Tam saat dilimi adı: Asia/Shanghai veya America/Los_Angeles gibi.

    • Greenwich Ortalama Zamanı'ndan GMT sapması: GMT+8:00 veya GMT-7:00 gibi. Saat değeri için baştaki sıfırlar desteklenmez.

    Asia/Shanghai
    ResourceUsageConfig

    object

    No

    Cloud Assistant kaynak kullanımı yapılandırması. Bu ayar yalnızca Cloud Assistant Agent sürümü aşağıdaki sürümlerden daha eski olmadığında etkili olur:

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    CpuLimit

    integer

    No

    Cloud Assistant Agent ana işlemi için izin verilen maksimum CPU kullanımı.

    • Birim: yüzde.

    • Geçerli değerler: 10 ile 95 arası.

    • Varsayılan değer: 20.

    20
    KeepScriptFile

    boolean

    No

    Komut yürütme işlemi tamamlandıktan sonra betik dosyasının Cloud Assistant dizininde tutulup tutulmayacağını belirtir. Varsayılan değer: false.

    false
    LogFileCountLimit

    integer

    No

    Tutulacak maksimum Cloud Assistant günlük dosyası sayısı.

    • Varsayılan değer: 30.

    • Minimum değer: 7.

    • Maksimum değer: 365.

    30
    LogSizeLimit

    string

    No

    Tek bir Cloud Assistant günlük dosyasının boyut sınırı. Birimi belirtmeniz gerekir (B|KB|MB).

    • Varsayılan değer: 100MB.

    • Minimum değer: 10MB.

    • Maksimum değer: 1024MB.

    10MB
    MemoryLimit

    string

    No

    Cloud Assistant Agent ana işlemi için izin verilen maksimum bellek kullanımı. Birimi belirtmeniz gerekir (B|KB|MB).

    • Varsayılan değer: 50MB.

    • Minimum değer: 35MB.

    • Maksimum değer: 1024MB.

    50MB
    OverloadLimit

    integer

    No

    CPU veya bellek kaynakları kullanımının sınırı aşabileceği maksimum ardışık kez sayısı. Bu sınıra ulaşıldığında, Cloud Assistant Agent çalışmayı otomatik olarak durdurur.

    • Varsayılan değer: 3.

    • Minimum değer: 3.

    3
    SessionManagerConfig

    object

    No

    Cloud Assistant oturum özelliği yapılandırması.

    SessionManagerEnabled

    boolean

    No

    Cloud Assistant oturum özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • true: Etkin.

    • false: Devre dışı.

    Dikkat edilecek hususlar:

    • Oturum özelliğini etkinleştirmek veya devre dışı bırakmak tüm bölgelerde etkili olur.

    true

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    İstek kimliği.

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

    Examples

    Success response

    JSON format

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

    Error codes

    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 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.
    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.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.