CreateAutoScalingConfigurationDetails

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/oracle/main/json-schema/oracle-create-auto-scaling-configuration-details-schema.json",
  "title": "CreateAutoScalingConfigurationDetails",
  "description": "Creation details for an autoscaling configuration.\n",
  "x-generated": "2026-10-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/oracle-autoscaling-api-openapi.yml#/components/schemas/CreateAutoScalingConfigurationDetails",
  "properties": {
    "compartmentId": {
      "description": "The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment containing the autoscaling configuration.\n",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "coolDownInSeconds": {
      "description": "For threshold-based autoscaling policies, this value is the minimum period of time to wait between scaling actions.\nThe cooldown period gives the system time to stabilize before rescaling. The minimum value is 300 seconds, which\nis also the default. The cooldown period starts when the instance pool reaches the running state.\n\nFor schedule-based autoscaling policies, this value is not used.\n",
      "minimum": 0,
      "type": "integer"
    },
    "definedTags": {
      "additionalProperties": {
        "additionalProperties": {
          "description": "The value of the tag. Only the String type is supported.\n",
          "type": "object"
        },
        "description": "Key-value pair representing a defined tag key and value, scoped to a namespace.\n\nExample: `{\"CostCenter\": \"42\"}`\n",
        "type": "object"
      },
      "description": "Defined tags for this resource. Each key is predefined and scoped to a\nnamespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm).\n\nExample: `{\"Operations\": {\"CostCenter\": \"42\"}}`\n",
      "type": "object"
    },
    "displayName": {
      "description": "A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.\n",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "freeformTags": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "Free-form tags for this resource. Each tag is a simple key-value pair with no\npredefined name, type, or namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm).\n\nExample: `{\"Department\": \"Finance\"}`\n",
      "type": "object"
    },
    "isEnabled": {
      "description": "Whether the autoscaling configuration is enabled.",
      "type": "boolean"
    },
    "policies": {
      "items": {
        "$ref": "#/$defs/CreateAutoScalingPolicyDetails"
      },
      "type": "array"
    },
    "resource": {
      "$ref": "#/$defs/Resource"
    }
  },
  "required": [
    "compartmentId",
    "policies",
    "resource"
  ],
  "type": "object",
  "$defs": {
    "Capacity": {
      "description": "Capacity limits for the instance pool.\n",
      "properties": {
        "initial": {
          "description": "For a threshold-based autoscaling policy, this value is the initial number of instances to launch in the instance pool\nimmediately after autoscaling is enabled. After autoscaling retrieves performance metrics, the number of\ninstances is automatically adjusted from this initial number to a number that is based on the limits that\nyou set.\n\nFor a schedule-based autoscaling policy, this value is the target pool size to scale to when executing the schedule\nthat's defined in the autoscaling policy.\n",
          "minimum": 0,
          "type": "integer"
        },
        "max": {
          "description": "For a threshold-based autoscaling policy, this value is the maximum number of instances the instance pool is allowed\nto increase to (scale out).\n\nFor a schedule-based autoscaling policy, this value is not used.\n",
          "minimum": 0,
          "type": "integer"
        },
        "min": {
          "description": "For a threshold-based autoscaling policy, this value is the minimum number of instances the instance pool is allowed\nto decrease to (scale in).\n\nFor a schedule-based autoscaling policy, this value is not used.\n",
          "minimum": 0,
          "type": "integer"
        }
      },
      "type": "object"
    },
    "CreateAutoScalingPolicyDetails": {
      "description": "Creation details for an autoscaling policy. You can create the following types of autoscaling policies:\n\n- **Schedule-based:** Autoscaling events take place at the specific times that you schedule.\n- **Threshold-based:** An autoscaling action is triggered when a performance metric meets\nor exceeds a threshold.\n\nAn autoscaling configuration can either have multiple schedule-based autoscaling policies, or one\nthreshold-based autoscaling policy.\n",
      "properties": {
        "capacity": {
          "$ref": "#/$defs/Capacity",
          "description": "The capacity requirements of the autoscaling policy."
        },
        "displayName": {
          "description": "A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.\n",
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        },
        "isEnabled": {
          "default": true,
          "description": "Whether the autoscaling policy is enabled.",
          "type": "boolean"
        },
        "policyType": {
          "description": "The type of autoscaling policy.",
          "maxLength": 100,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "policyType"
      ],
      "type": "object"
    },
    "Resource": {
      "description": "A resource that is managed by an autoscaling configuration. The only supported type is `instancePool`.\n\nEach instance pool can have one autoscaling configuration.\n",
      "properties": {
        "id": {
          "description": "The [OCID](/Content/General/Concepts/identifiers.htm) of the resource that is managed by the autoscaling configuration.\n",
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        },
        "type": {
          "description": "The type of resource.",
          "maxLength": 100,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "type",
        "id"
      ]
    }
  }
}