Microsoft.ComputeSchedule (preview:2025-04-15)

2025/08/15 • 1 updated methods

ScheduledActionExtension_ListByVms (updated)
Description :  List ScheduledActionResources resources by parent
Reference :  Link ¶

⚶ Changes

{
  "#id": "ScheduledActionExtension_ListByVms",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "@added_649c87a98d184d4a9e1acd59f774d7ef": {
                  "#name": "resourceNotificationSettings",
                  "Description": "The notification settings for the scheduled action at a resource level. Resource level notification settings are scope to specific resources only and submitted through attach requests.",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "The information about notifications to be send to about upcoming operations.",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "destination",
                        "Description": "Where the notification should be sent. For email, it should follow email format.",
                        "Required": true,
                        "Type": "string"
                      },
                      {
                        "#name": "type",
                        "Description": "Type of notification to be sent.",
                        "Enum": [
                          [
                            "Email",
                            "Notify through e-mail"
                          ]
                        ],
                        "Required": true,
                        "Type": "string"
                      },
                      {
                        "#name": "language",
                        "Description": "The language the notification should be sent on.",
                        "Enum": [
                          [
                            "en-us",
                            "American english language"
                          ]
                        ],
                        "Required": true,
                        "Type": "string"
                      },
                      {
                        "#name": "disabled",
                        "Description": "Tells if the notification is enabled or not.",
                        "Required": false,
                        "Type": "boolean"
                      }
                    ]
                  }
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /{resourceUri}/providers/Microsoft.ComputeSchedule/associatedScheduledActions
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
resourceUri:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The ScheduledActionResources items on this page ,
Required: True ,
}
[
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
resourceType:
{
Description: The type of resource the scheduled action is targeting ,
Enum:
{
VirtualMachine: Resources defined are Virtual Machines ,
VirtualMachineScaleSet: Resources defined are Virtual Machines Scale Sets ,
}
,
Required: True ,
}
enum ,
actionType:
{
Description: The action the scheduled action should perform in the resources ,
Enum:
{
Start: Perform a start action on the specified resources ,
Deallocate: Perform a deallocate action on the specified resources ,
Hibernate: Perform hibernate and deallocate on the specified resources ,
}
,
Required: True ,
}
enum ,
startTime:
{
Description: The time which the scheduled action is supposed to start running ,
Format: date-time ,
Required: True ,
}
string ,
endTime:
{
Description: The time when the scheduled action is supposed to stop scheduling ,
Format: date-time ,
Required: False ,
}
string ,
schedule:
{
Description: The schedule the scheduled action is supposed to follow ,
Required: True ,
}
{
scheduledTime:
{
Description: The time the scheduled action is supposed to run on ,
Format: time ,
Required: True ,
}
string ,
timeZone:
{
Description: The timezone the scheduled time is specified on ,
Required: True ,
}
string ,
requestedWeekDays:
{
Description: The week days the scheduled action is supposed to run on ,
Required: True ,
}
[
string ,
]
,
requestedMonths:
{
Description: The months the scheduled action is supposed to run on ,
Required: True ,
}
[
string ,
]
,
requestedDaysOfTheMonth:
{
Description: The days of the month the scheduled action is supposed to run on. If empty, it means it will run on every day of the month. ,
Required: True ,
}
[
integer ,
]
,
executionParameters:
{
Description: The execution parameters the scheduled action is supposed to follow ,
Required: False ,
}
{
optimizationPreference:
{
Description: Details that could optimize the user's request ,
Enum:
{
Cost: Optimize while considering cost savings ,
Availability: Optimize while considering availability of resources ,
CostAvailabilityBalanced: Optimize while considering a balance of cost and availability ,
}
,
Required: False ,
}
enum ,
retryPolicy:
{
Description: Retry policy the user can pass ,
Required: False ,
}
{
retryCount:
{
Description: Retry count for user request ,
Format: int32 ,
Required: False ,
}
integer ,
retryWindowInMinutes:
{
Description: Retry window in minutes for user request ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
deadlineType:
{
Description: The type of deadline the scheduled action is supposed to follow for the schedule. If no value is passed, it will default to InitiateAt. ,
Enum:
{
Unknown: Default value of Unknown. ,
InitiateAt: Initiate the operation at the given deadline. ,
CompleteBy: Complete the operation by the given deadline. ,
}
,
Required: False ,
}
enum ,
}
,
notificationSettings:
{
Description: The notification settings for the scheduled action ,
Required: True ,
}
[
{
destination:
{
Description: Where the notification should be sent. For email, it should follow email format. ,
Required: True ,
}
string ,
type:
{
Description: Type of notification to be sent. ,
Enum:
{
Email: Notify through e-mail ,
}
,
Required: True ,
}
enum ,
language:
{
Description: The language the notification should be sent on. ,
Enum:
{
en-us: American english language ,
}
,
Required: True ,
}
enum ,
disabled:
{
Description: Tells if the notification is enabled or not. ,
Required: False ,
}
boolean ,
}
,
]
,
disabled:
{
Description: Tell if the scheduled action is disabled or not ,
Required: False ,
}
boolean ,
provisioningState:
{
Description: The status of the last provisioning operation performed on the resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Deleting: Resource is being deleted. ,
}
,
Required: False ,
}
enum ,
resourceNotificationSettings:
{
Description: The notification settings for the scheduled action at a resource level. Resource level notification settings are scope to specific resources only and submitted through attach requests. ,
Required: False ,
}
[
{
destination:
{
Description: Where the notification should be sent. For email, it should follow email format. ,
Required: True ,
}
string ,
type:
{
Description: Type of notification to be sent. ,
Enum:
{
Email: Notify through e-mail ,
}
,
Required: True ,
}
enum ,
language:
{
Description: The language the notification should be sent on. ,
Enum:
{
en-us: American english language ,
}
,
Required: True ,
}
enum ,
disabled:
{
Description: Tells if the notification is enabled or not. ,
Required: False ,
}
boolean ,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}