MENU
      putScheduledUpdateGroupAction

        putScheduledUpdateGroupAction


        Article summary

        Overview

        Creates or updates scheduled scaling actions for the specified auto scaling group.
        If the same scheduled action already exists, this API request updates it; if the same scheduled action does not exist, it creates a new one.
        There are two types of schedules: one-time schedule and recurrent schedule.
        To create a one-time schedule, specify startTime and do not specify recurrenceInKST. To create a recurrent schedule, specify recurrenceInKST.
        At least one of minSize, desiredCapacity and maxSize must be specified.
        Then, the auto scaling group’s properties associated with the specified parameters mentioned before are updated.
        Even if the minSize, desiredCapacity or maxSize is changed, the following condition must be satisfied: Min size <= Desired Capacity <= max size.
        Otherwise, the properties are not updated as the schedule is not applied.

        Request

        Request parameters

        ParameterRequiredTypeLimitationsDescription
        autoScalingGroupNameYStringMin: 1
        Max: 255
        Name of the Auto Scaling group to get
        scheduledActionNameYStringMin: 1
        Max: 255
        Scheduled scaling action name
        It must be unique within the specified Auto Scaling group.
        If the same scheduled action already exists, this API request updates it; if the same scheduled action does not exist, it creates a new one.
        desiredCapacityConditionalStringMin: 1, Max: 30It is desired capacity, which is the number of server instances that belong to the Auto Scaling group.
        It must be greater than or equal to the current minSize and less than or equal to the current maxSize of the Auto Scaling group.
        minSizeConditionalStringMin: 1, Max: 30Minimum size. It is at least 0 and less than or equal to the maxSize.
        maxSizeConditionalStringMin: 1, Max: 30Maximum size
        startTimeConditionalDateyyyy-MM-dd’T’HH:mm:ssZRequired if recurrenceInKST (recurrence schedule configuration) does not exist.
        Format: yyyy-MM-dd'T'HH:mm:ssZ
        Example) 2018-07-25T17:50:00+0900
        endTimeNDateyyyy-MM-dd’T’HH:mm:ssZRequired if recurrenceInKST (recurrence schedule configuration) does not exist.
        Format: yyyy-MM-dd'T'HH:mm:ssZ
        Example) 2018-07-25T17:50:00+0900
        recurrenceInKSTNString-Recurrence schedule configuration
        Specify the value in crontab format.
        Specify the minute, hour, day of month, month and day of week fields, using a space as a delimiter.
        Valid values for each field are as follows:
        Minute: 0-59
        Hour: 0-23
        Day of month: 1-31
        Month: 1-12 (or names of months in English)
        Day of week: 0-7 (0 or 7 is Sunday, or names of the days of the week in English)
        You can use asterisk('*'), which means all the values from the start to the end. See the examples below.
        Example 1: Every hour on the hour: 0 * * * *
        Example 2: On every Saturday, at 16:30: 30 16 * * 6
        Example 3: On the first day of every month, at midnight: 0 0 1 * *
        Example 4: On January 1st of every year, at midnight: 0 0 1 Jan *

        Response

        Response body

        Examples

        Request example

        {AUTOSCALILNG_API_URL}/putScheduledUpdateGroupAction
        ?autoScalingGroupName=asg-0212
        &desiredCapacity=3
        &scheduledActionName=sa-0303
        &startTime=2014-03-05T10%3A00%3A00%2B0900
        HTTP

        Response example

        <putScheduledUpdateGroupActionResponse>
           <requestId>948b7bc1-47e6-4d5c-a71d-e85622ab16ef</requestId>
           <returnCode>0</returnCode>
           <returnMessage>success</returnMessage>
           <totalRows>1</totalRows>
           <scheduledUpdateGroupActionList>
              <scheduledUpdateGroupAction>
                 <autoScalingGroupName>asg-0212</autoScalingGroupName>
                 <scheduledActionName>sa-0303</scheduledActionName>
                 <desiredCapacity>3</desiredCapacity>
                 <startTime>2014-03-05T10:00:00+0900</startTime>
                 <recurrenceInKST />
              </scheduledUpdateGroupAction>
           </scheduledUpdateGroupActionList>
        </putScheduledUpdateGroupActionResponse>
        XML

        Error codes

        Errors that may occur while using this action are listed below. For information on common errors, refer to NAVER Cloud Platform API.

        HTTP response codeReturn codeReturn message
        40050100The named Auto Scaling group or launch configuration already exists.
        40050130The quota for capacity groups or launch configurations for this customer has already been reached.

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.