すべてのプロダクト
Search

このプロダクト

    Elastic Compute Service:ModifyCloudAssistantSettings

    ドキュメントセンター

    Elastic Compute Service:ModifyCloudAssistantSettings

    最終更新日:Sep 20, 2026

    クラウドアシスタントサービスの構成を変更します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ecs:ModifyCloudAssistantSettings

    update

    *ServiceSettings

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    リージョン ID。

    cn-hangzhou
    SettingType

    string

    必須

    サービス構成のタイプ。有効な値:

    • SessionManagerDelivery: 会話操作ログの log delivery。

    • InvocationDelivery: タスク実行ログの log delivery。

    • AgentUpgradeConfig: クラウドアシスタントエージェントのスペックアップ構成。

    • SessionManagerConfig: クラウドアシスタント SessionManager の構成。

    SessionManagerDelivery
    OssDeliveryConfig

    object

    任意

    OSS 配信構成。

    BucketName

    string

    任意

    OSS バケットの名前。

    example-bucket
    Enabled

    boolean

    任意

    OSS への配信を有効にするかどうかを指定します。デフォルト値: false。

    false
    EncryptionAlgorithm

    string

    任意

    OSS の暗号化アルゴリズム。有効な値:

    • AES256

    • SM4

    AES256
    EncryptionKeyId

    string

    任意

    暗号化メソッドが KMS にセットされている場合のカスタマーマスターキー (CMK) ID。

    a807****7a70e
    EncryptionType

    string

    任意

    OSS の暗号化メソッド。有効な値:

    • Inherit: バケットの暗号化メソッドを継承します。

    • OssManaged: OSS 管理の暗号化を使用します。

    • KMS: KMS ベースの暗号化を使用します。

    Inherit
    Prefix

    string

    任意

    OSS バケットのディレクトリプレフィックス。制約事項:

    • プレフィックスの長さは 254 文字を超えることはできません。

    • プレフィックスの先頭を転送スラッシュ (/) またはバックスラッシュ () にすることはできません。

    説明

    注: ディレクトリプレフィックスが必須ではないことを示すには、空の文字列 ("") を渡します。以前にプレフィックスがセットされており、不要になった場合は、空の文字列 ("") を渡してクリアします。

    sessionmanager/audit
    SlsDeliveryConfig

    object

    任意

    Simple Log Service (SLS) サービスの配信構成。

    Enabled

    boolean

    任意

    SLS への配信を有効にするかどうかを指定します。 デフォルト値: false。

    false
    LogstoreName

    string

    任意

    SLS Logstore の名前。

    example-logstore
    ProjectName

    string

    任意

    SLS プロジェクトの名前。

    example-project
    AgentUpgradeConfig

    object

    任意

    クラウドアシスタントエージェントのスペックアップ構成。

    AllowedUpgradeWindow

    array

    任意

    スペックアップが許可される時間ウィンドウのリスト。時間は分単位まで停止で指定できます。デフォルトのタイムゾーンは協定世界時 (UTC) です。

    時間ウィンドウ間の間隔は 1 時間未満にすることはできません。

    初期化: 開始時刻 (HH:mm)-終了時刻 (HH:mm)。

    例: [ "02:00-03:00", "05:00-06:00" ] これは、協定世界時 (UTC) タイムゾーンで、毎日 02:00 から 03:00、および 05:00 から 06:00 にスペックアップが許可されることを示します。

    string

    任意

    スペックアップが許可される時間ウィンドウのリスト。時間は分単位まで停止で指定できます。デフォルトのタイムゾーンは協定世界時 (UTC) です。

    時間ウィンドウ間の間隔は 1 時間未満にすることはできません。

    初期化: 開始時刻 (HH:mm)-終了時刻 (HH:mm)。

    例: [ "02:00-03:00", "05:00-06:00" ] これは、協定世界時 (UTC) タイムゾーンで、毎日 02:00 から 03:00、および 05:00 から 06:00 にスペックアップが許可されることを示します。

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

    boolean

    任意

    クラウドアシスタントエージェントが起動時にバージョン更新を確認し、すぐにスペックアップを実行するかどうかを指定します。デフォルト値: true。

    このセットは、クラウドアシスタントエージェントのバージョンが以下のバージョン以降の場合にのみ効果があります。

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    true
    DisableUpgrade

    boolean

    任意

    クラウドアシスタントエージェントによる更新の確認と実行を防止するかどうかを指定します。デフォルト値: false。

    このセットは、クラウドアシスタントエージェントのバージョンが以下のバージョン以降の場合にのみ効果があります。

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    false
    Enabled

    boolean

    任意

    カスタムエージェントスペックアップ構成を有効にするかどうかを指定します。false にセットすると、30 分ごとにスペックアップを試行するというデフォルトの動作が維持されます。

    デフォルト値: false。

    true
    TimeZone

    string

    任意

    許可されたスペックアップ時間ウィンドウのタイムゾーン。デフォルトのタイムゾーンは協定世界時 (UTC) です。 タイムゾーンは、次の 2 つの初期化で指定できます。

    • 完全なタイムゾーン名: Asia/Shanghai や America/Los_Angeles など。

    • グリニッジ標準時からの GMT オフセット: GMT+8:00 や GMT-7:00 など。時間値の先頭にゼロは使用できません。

    Asia/Shanghai
    ResourceUsageConfig

    object

    任意

    クラウドアシスタントのリソース使用量構成。このセットは、クラウドアシスタントエージェントのバージョンが以下のバージョン以降の場合にのみ効果があります。

    • Windows: 2.1.4.1065

    • Linux: 2.2.4.1065

    CpuLimit

    integer

    任意

    クラウドアシスタントエージェントのメインプロセスに許可される CPU 使用量の最大値。

    • 単位: パーセント。

    • 有効な値: 10～95。

    • デフォルト値: 20。

    20
    KeepScriptFile

    boolean

    任意

    コマンド実行の完了後、クラウドアシスタントディレクトリにスクリプトファイルを保持するかどうかを指定します。 デフォルト値: false。

    false
    LogFileCountLimit

    integer

    任意

    保持するクラウドアシスタントログファイルの最大数。

    • デフォルト値: 30。

    • 最小値: 7。

    • 最大値: 365。

    30
    LogSizeLimit

    string

    任意

    単一のクラウドアシスタントログファイルのサイズ制限。単位 (B|KB|MB) を指定する必要があります。

    • デフォルト値: 100MB。

    • 最小値: 10MB。

    • 最大値: 1024MB。

    10MB
    MemoryLimit

    string

    任意

    クラウドアシスタントエージェントのメインプロセスに許可される最大メモリ使用量。単位 (B|KB|MB) を指定する必要があります。

    • デフォルト値: 50MB。

    • 最小値: 35MB。

    • 最大値: 1024MB。

    50MB
    OverloadLimit

    integer

    任意

    CPU またはメモリリソースの使用量が制限を連続して超える最大回数。この制限に達すると、クラウドアシスタントエージェントは自動的に停止します。

    • デフォルト値: 3。

    • 最小値: 3。

    3
    SessionManagerConfig

    object

    任意

    クラウドアシスタントの会話特徴構成。

    SessionManagerEnabled

    boolean

    任意

    クラウドアシスタントの会話特徴を有効にするかどうかを指定します。有効な値:

    • true: 有効。

    • false: 無効。

    注意事項:

    • 会話特徴の有効化または無効化は、すべてのリージョンで効果があります。

    true

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID

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

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    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. 指定された SettingType パラメーターは無効です。
    400 InvalidParameter.OssEncryptionType The specified parameter OssDeliveryConfig.EncryptionType is not valid. 指定された OssDeliveryConfig.EncryptionType パラメーターは無効です。
    400 InvalidParameter.OssEncryptionAlgorithm The specified parameter OssDeliveryConfig.EncryptionAlgorithm is not valid. 指定された OssDeliveryConfig.EncryptionAlgorithm パラメーターは無効です。
    400 InvalidParameter.OssEncryptionKeyId The specified parameter OssDeliveryConfig.EncryptionKeyId is not valid. 指定された OssDeliveryConfig.EncryptionKeyId パラメーターは無効です。
    400 InvalidParameter.OssBucketName The specified parameter OssDeliveryConfig.BucketName is not valid. 指定された OssDeliveryConfig.BucketName パラメーターは無効です。
    400 InvalidParameter.OssPrefix The specified parameter OssDeliveryConfig.Prefix is not valid. 指定された OssDeliveryConfig.Prefix パラメーターは無効です。
    400 InvalidOssBucketName.InOtherRegion The specified parameter OssDeliveryConfig.BucketName is in another region. OssDeliveryConfig.BucketName で指定された OSS バケットは別のリージョンにあります。
    400 InvalidParameter.SlsProjectName The specified parameter SlsDeliveryConfig.ProjectName is not valid. 指定された SlsDeliveryConfig.ProjectName パラメーターは無効です。
    400 InvalidParameter.SlsLogstoreName The specified parameter SlsDeliveryConfig.LogstoreName is not valid. 指定された SlsDeliveryConfig.LogstoreName パラメーターは無効です。
    400 InvalidParameter.AllowedUpgradeWindow The specified parameter AgentUpgradeConfig.AllowedUpgradeWindow is not valid. 指定された AgentUpgradeConfig.AllowedUpgradeWindow パラメーターは無効です。
    400 InvalidAllowedUpgradeWindow.DurationTooShort The duration of the specified parameter AgentUpgradeConfig.AllowedUpgradeWindow cannot be less than one hour. AllowedUpgradeWindow パラメーターの間隔は 30 分より短くすることはできません。
    400 InvalidParameter.TimeZone The specified parameter AgentUpgradeConfig.TimeZone is not valid. 指定された AgentUpgradeConfig.TimeZone パラメーターは無効です。
    400 InvalidAllowedUpgradeWindow.Required The specified parameter AgentUpgradeConfig.AllowedUpgradeWindow is required. カスタムエージェントスペックアップ構成パラメーターを有効にする場合、AgentUpgradeConfig.AllowedUpgradeWindow は必須です。
    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. 現在のサービスでは、OSS 暗号化方式の設定はサポートされていません。
    403 InvalidAllowedUpgradeWindow.CountLimitExceeded The count of the parameter AgentUpgradeConfig.AllowedUpgradeWindow exceeds the limit of 5. AgentUpgradeConfig.AllowedUpgradeWindow パラメーターの数が上限の 5 を超えています。
    403 InvalidOperation.SessionManagerDeliveryUnsupported The delivery configuration of Session Manager is not supported. Session Manager の配信構成の有効化はサポートされていません。
    403 InvalidDisableUpgrade.Conflict The parameter DisableUpgrade cannot be specified with parameter BootstrapUpgrade.
    404 InvalidSlsProjectName.NotFound The specified parameter SlsDeliveryConfig.ProjectName does not exist. 指定された SLS プロジェクトは存在しません。
    404 InvalidSlsLogstoreName.NotFound The specified parameter SlsDeliveryConfig.LogstoreName does not exist. 指定された SLS Logstore は存在しません。
    404 InvalidOssBucketName.NotFound The specified parameter OssDeliveryConfig.BucketName does not exist. 指定された OSS バケットは存在しません。
    404 InvalidRegionId.NotFound The specified parameter RegionId does not exist. 指定された RegionId は存在しません。このリージョンでプロダクトが利用可能かどうかを確認してください。

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。