Struct StackSettings 

pub struct StackSettings {
    pub deployment_model: Option<DeploymentModel>,
    pub domains: Option<DomainSettings>,
    pub heartbeats: Option<HeartbeatsMode>,
    pub network: Option<NetworkSettings>,
    pub telemetry: Option<TelemetryMode>,
    pub updates: Option<UpdatesMode>,
}

User-customizable deployment settings specified at deploy time.

These settings are provided by the customer via CloudFormation parameters, Terraform attributes, CLI flags, or Helm values. They customize how the agent is deployed and what capabilities are enabled.

Key distinction: StackSettings is user-customizable, while ManagementConfig is platform-derived (from the Agent Manager’s ServiceAccount).

JSON schema

{
 "description": "User-customizable deployment settings specified at deploy time.\n\nThese settings are provided by the customer via CloudFormation parameters,\nTerraform attributes, CLI flags, or Helm values. They customize how the\nagent is deployed and what capabilities are enabled.\n\n**Key distinction**: StackSettings is user-customizable, while ManagementConfig\nis platform-derived (from the Agent Manager's ServiceAccount).",
 "type": "object",
 "properties": {
   "deploymentModel": {
     "description": "Deployment model: push (Agent Manager) or pull (Operator).\nDefault: Push for cloud platforms.\nKubernetes and Local platforms only support Pull.",
     "allOf": [
       {
         "$ref": "#/components/schemas/DeploymentModel"
       }
     ]
   },
   "domains": {
     "description": "Domain configuration (future).",
     "oneOf": [
       {
         "type": "null"
       },
       {
         "allOf": [
           {
             "$ref": "#/components/schemas/DomainSettings"
           }
         ]
       }
     ]
   },
   "heartbeats": {
     "description": "How heartbeat health checks are handled.\n- off: No heartbeat permissions\n- on: Heartbeat enabled (default)",
     "allOf": [
       {
         "$ref": "#/components/schemas/HeartbeatsMode"
       }
     ]
   },
   "network": {
     "description": "Network configuration for the stack (VPC/VNet settings).\nIf `None`, an isolated VPC with NAT is auto-created when the stack has resources\nthat require networking (e.g., containers). Set explicitly to customize:\n`UseDefault` for the provider's default network (fast, dev/test only),\n`Create` for an isolated VPC with managed NAT (production), or `ByoVpc*`\nto reference an existing customer-managed VPC.",
     "oneOf": [
       {
         "type": "null"
       },
       {
         "allOf": [
           {
             "$ref": "#/components/schemas/NetworkSettings"
           }
         ]
       }
     ]
   },
   "telemetry": {
     "description": "How telemetry (logs, metrics, traces) is handled.\n- off: No telemetry permissions\n- auto: Telemetry flows automatically (default)\n- approval-required: Telemetry waits for explicit approval",
     "allOf": [
       {
         "$ref": "#/components/schemas/TelemetryMode"
       }
     ]
   },
   "updates": {
     "description": "How updates are delivered.\n- auto: Updates deploy automatically (default)\n- approval-required: Updates wait for explicit approval",
     "allOf": [
       {
         "$ref": "#/components/schemas/UpdatesMode"
       }
     ]
   }
 }
}

Fields

deployment_model: Option<DeploymentModel>

Deployment model: push (Agent Manager) or pull (Operator). Default: Push for cloud platforms. Kubernetes and Local platforms only support Pull.

domains: Option<DomainSettings>

Domain configuration (future).

heartbeats: Option<HeartbeatsMode>

How heartbeat health checks are handled.

• off: No heartbeat permissions
• on: Heartbeat enabled (default)

network: Option<NetworkSettings>

Network configuration for the stack (VPC/VNet settings). If None, an isolated VPC with NAT is auto-created when the stack has resources that require networking (e.g., containers). Set explicitly to customize: UseDefault for the provider’s default network (fast, dev/test only), Create for an isolated VPC with managed NAT (production), or ByoVpc* to reference an existing customer-managed VPC.

telemetry: Option<TelemetryMode>

How telemetry (logs, metrics, traces) is handled.

• off: No telemetry permissions
• auto: Telemetry flows automatically (default)
• approval-required: Telemetry waits for explicit approval

updates: Option<UpdatesMode>

How updates are delivered.

• auto: Updates deploy automatically (default)
• approval-required: Updates wait for explicit approval

Implementations

impl StackSettings

pub fn builder() -> StackSettings

Trait Implementations

impl Clone for StackSettings

fn clone(&self) -> StackSettings

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StackSettings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for StackSettings

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for StackSettings

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&StackSettings> for StackSettings

fn from(value: &StackSettings) -> Self

Converts to this type from the input type.

impl From<StackSettings> for StackSettings

fn from(value: StackSettings) -> Self

Converts to this type from the input type.

impl Serialize for StackSettings

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<StackSettings> for StackSettings

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: StackSettings) -> Result<Self, ConversionError>

Performs the conversion.