From ed7a298def311fe2c3265e30293639fcf4355b87 Mon Sep 17 00:00:00 2001 From: Mohamed Enein <32403842+finiteattractor@users.noreply.github.com> Date: Tue, 7 Nov 2017 12:23:57 -0800 Subject: [PATCH] Adding new Automation API version (2017-05-15-preview) (#1953) * added extension properties to Get & GetNode * fix indentation * fix indentation * changed description text * Adding new API version (2017-05-15-preview). No other changes made (#2) Adding new API version (2017-05-15-preview). Only three new resources added and all others reference the previous version. - Added resources: - SoftwareUpdateConfiguration - SoftwareUpdateConfigurationRun - SoftwareUpdateConfigurationMachineRun - Validations: - Autorest azure validations passed - x-ms-examples validated with no errors * Updated tag in global configuration Updated tag in global configuration to use the latest api version as per azure PR review comment --- .../2015-10-31/definitions.json | 48 +- .../2017-05-15-preview/definitions.json | 631 ++++++++++++++++++ .../createSoftwareUpdateConfiguration.json | 163 +++++ .../deleteSoftwareUpdateConfiguration.json | 18 + .../getSoftwareUpdateConfigurationByName.json | 68 ++ .../listSoftwareUpdateConfigurations.json | 73 ++ .../listSoftwareUpdateConfigurationsByVm.json | 74 ++ ...wareUpdateConfigurationMachineRunById.json | 38 ++ ...oftwareUpdateConfigurationMachineRuns.json | 62 ++ ...reUpdateConfigurationMachineRunsByRun.json | 63 ++ ...getSoftwareUpdateConfigurationRunById.json | 35 + ...FailedSoftwareUpdateConfigurationRuns.json | 58 ++ .../listSoftwareUpdateConfigurationRuns.json | 57 ++ .../softwareUpdateConfiguration.json | 211 ++++++ ...softwareUpdateConfigurationMachineRun.json | 157 +++++ .../softwareUpdateConfigurationRun.json | 158 +++++ .../automation/resource-manager/readme.md | 30 +- 17 files changed, 1931 insertions(+), 13 deletions(-) create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/definitions.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/createSoftwareUpdateConfiguration.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/deleteSoftwareUpdateConfiguration.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/getSoftwareUpdateConfigurationByName.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/listSoftwareUpdateConfigurations.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/listSoftwareUpdateConfigurationsByVm.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/getSoftwareUpdateConfigurationMachineRunById.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/listSoftwareUpdateConfigurationMachineRuns.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/listSoftwareUpdateConfigurationMachineRunsByRun.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/getSoftwareUpdateConfigurationRunById.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/listFailedSoftwareUpdateConfigurationRuns.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/listSoftwareUpdateConfigurationRuns.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfiguration.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfigurationMachineRun.json create mode 100644 specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfigurationRun.json diff --git a/specification/automation/resource-manager/Microsoft.Automation/2015-10-31/definitions.json b/specification/automation/resource-manager/Microsoft.Automation/2015-10-31/definitions.json index 2e75f0754477..6dfcd87ea106 100644 --- a/specification/automation/resource-manager/Microsoft.Automation/2015-10-31/definitions.json +++ b/specification/automation/resource-manager/Microsoft.Automation/2015-10-31/definitions.json @@ -1446,6 +1446,13 @@ "etag": { "type": "string", "description": "Gets or sets the etag of the resource." + }, + "extensionHandler": { + "type": "array", + "description": "Gets or sets the list of extensionHandler properties for a Node.", + "items": { + "$ref": "#/definitions/DscNodeExtensionHandlerAssociationProperty" + } } }, "allOf": [ @@ -1529,6 +1536,19 @@ }, "description": "The dsc nodeconfiguration property associated with the entity." }, + "DscNodeExtensionHandlerAssociationProperty": { + "properties": { + "name": { + "type": "string", + "description": "Gets or sets the name of the extension handler." + }, + "version": { + "type": "string", + "description": "Gets or sets the version of the extension handler." + } + }, + "description": "The dsc extensionHandler property associated with the node" + }, "DscNodeListResult": { "properties": { "value": { @@ -2934,6 +2954,21 @@ }, "description": "The runbook property associated with the entity." }, + "scheduleFrequency": { + "type": "string", + "description": "Gets or sets the frequency of the schedule.", + "enum": [ + "OneTime", + "Day", + "Hour", + "Week", + "Month" + ], + "x-ms-enum": { + "name": "ScheduleFrequency", + "modelAsString": true + } + }, "ScheduleCreateOrUpdateProperties": { "properties": { "description": { @@ -2955,18 +2990,7 @@ }, "frequency": { "type": "string", - "description": "Gets or sets the frequency of the schedule.", - "enum": [ - "OneTime", - "Day", - "Hour", - "Week", - "Month" - ], - "x-ms-enum": { - "name": "ScheduleFrequency", - "modelAsString": true - } + "$ref": "#/definitions/scheduleFrequency" }, "timeZone": { "type": "string", diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/definitions.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/definitions.json new file mode 100644 index 000000000000..549ce0544676 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/definitions.json @@ -0,0 +1,631 @@ +{ + "swagger": "2.0", + "info": { + "title": "AutomationManagement", + "version": "2015-10-31" + }, + "host": "management.azure.com", + "schemes": [ + "https" + ], + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "paths": {}, + "definitions": { + "softwareUpdateConfigurationProperties": { + "description": "Software update configuration properties.", + "properties": { + "updateConfiguration": { + "description": "update specific properties for the Software update configuration", + "$ref": "#/definitions/updateConfiguration" + }, + "scheduleInfo": { + "description": "Schedule information for the Software update configuration", + "$ref": "../2015-10-31/definitions.json#/definitions/ScheduleProperties" + }, + "provisioningState": { + "type": "string", + "description": "Provisioning state for the software update configuration, which only appears in the response.", + "readOnly": true + }, + "error": { + "description": "detailes of provisioning error", + "$ref": "../2015-10-31/definitions.json#/definitions/ErrorResponse" + }, + "creationTime": { + "type": "string", + "description": "Creation time of theresource, which only appears in the response.", + "format": "date-time", + "readOnly": true + }, + "createdBy": { + "type": "string", + "description": "createdBy property, which only appears in the response.", + "readOnly": true + }, + "lastModifiedTime": { + "type": "string", + "description": "Last time resource was modified, which only appears in the response.", + "format": "date-time", + "readOnly": true + }, + "lastModifiedBy": { + "type": "string", + "description": "lastModifiedBy property, which only appears in the response.", + "readOnly": true + } + }, + "required": [ "updateConfiguration" ] + }, + + "softwareUpdateConfiguration": { + "x-ms-azure-resource": true, + "description": "Software update configuration properties.", + "type": "object", + "properties": { + "name": { + "readOnly": true, + "type": "string", + "description": "Resource name." + }, + "id": { + "readOnly": true, + "type": "string", + "description": "Resource Id." + }, + "type": { + "readOnly": true, + "type": "string", + "description": "Resource type" + }, + "properties": { + "x-ms-client-flatten": true, + "description": "Software update configuration properties.", + "$ref": "#/definitions/softwareUpdateConfigurationProperties" + } + }, + "required": [ "properties" ] + }, + + "softwareUpdateConfigurationListResult": { + "description": "result of listing all software update configuration", + "properties": { + "value": { + "description": "outer object returned when listing all software update configurations", + "type": "array", + "items": { + "$ref": "./definitions.json#/definitions/softwareUpdateConfigurationCollectionItem" + } + } + } + }, + + "collectionItemUpdateConfiguration": { + "description": "object returned when requesting a collection of software update configuration", + "properties": { + "azureVirtualMachines": { + "type": "array", + "description": "List of azure resource Ids for azure virtual machines targeted by the software update configuration.", + "items": { + "type": "string", + "description": "Azure Resource Manager Id for a virtual machine." + } + }, + "duration": { + "type": "string", + "format": "duration", + "description": "Maximum time allowed for the software update configuration run. Duration needs to be specified using the format PT[n]H[n]M[n]S as per ISO8601" + } + } + }, + + "softwareUpdateConfigurationCollectionItem": { + "description": "Software update configuration collection item properties.", + "type": "object", + "properties": { + "name": { + "readOnly": true, + "type": "string", + "description": "Name of the software update configuration." + }, + "id": { + "readOnly": true, + "type": "string", + "description": "Resource Id of the software update configuration" + }, + "properties": { + "x-ms-client-flatten": true, + "description": "Software update configuration properties.", + "$ref": "#/definitions/softwareUpdateConfigurationCollectionItemProperties" + } + }, + "required": [ "properties" ] + }, + + "softwareUpdateConfigurationCollectionItemProperties": { + "description": "Software update configuration collection item properties.", + "properties": { + "updateConfiguration": { + "description": "Update specific properties of the software update configuration.", + "$ref": "#/definitions/collectionItemUpdateConfiguration" + }, + "frequency": { + "description": "execution frequency of the schedule associated with the software update configuration", + "type":"string", + "$ref": "../2015-10-31/definitions.json#/definitions/scheduleFrequency" + }, + "startTime": { + "type": "string", + "format": "date-time", + "description": "the start time of the update." + }, + "creationTime": { + "type": "string", + "description": "Creation time of the software update configuration, which only appears in the response.", + "format": "date-time", + "readOnly": true + }, + "lastModifiedTime": { + "type": "string", + "description": "Last time software update configuration was modified, which only appears in the response.", + "format": "date-time", + "readOnly": true + }, + "provisioningState": { + "type": "string", + "description": "Provisioning state for the software update configuration, which only appears in the response.", + "readOnly": true + }, + "nextRun": { + "type": "string", + "format": "date-time", + "description": "ext run time of the update." + } + } + }, + + "operatingSystemType": { + "type": "string", + "description": "Target operating system for the software update configuration.", + "enum": [ + "Windows", + "Linux" + ], + "x-ms-enum": { + "modelAsString": false, + "name": "OperatingSystemType" + } + }, + + "updateConfiguration": { + "type": "object", + "description": "Update specifc properties of the software update configuration.", + "discriminator": "operatingSystem", + "properties": { + "operatingSystem": { + "description": "operating system of target machines", + "$ref": "#/definitions/operatingSystemType" + }, + "windows": { + "description": "Windows specific update configuration.", + "$ref": "#/definitions/WindowsProperties" + }, + "linux": { + "description": "Linux specific update configuration.", + "$ref": "#/definitions/LinuxProperties" + }, + "duration": { + "type": "string", + "format": "duration", + "description": "Maximum time allowed for the software update configuration run. Duration needs to be specified using the format PT[n]H[n]M[n]S as per ISO8601" + }, + "azureVirtualMachines": { + "type": "array", + "description": "List of azure resource Ids for azure virtual machines targeted by the software update configuration.", + "items": { + "type": "string", + "description": "Azure Resource Manager Id for a virtual machine." + } + }, + "nonAzureComputerNames": { + "type": "array", + "description": "List of names of non-azure machines targeted by the software update configuration.", + "items": { + "type": "string", + "description": "Name of Non-Azure OMS Computer." + } + } + }, + "required": [ "operatingSystem" ] + }, + + "WindowsProperties": { + "type": "object", + "description": "Windows specific update configuration.", + "properties": { + "includedUpdateClassifications": { + "description": "Update classification included in the software update configuration.", + "items": { + "type": "string", + "enum": [ + "Unclassified", + "Critical", + "Security", + "UpdateRollup", + "FeaturePack", + "ServicePack", + "Definition", + "Tools", + "Updates" + ], + "x-ms-enum": { + "name": "WindowsUpdateClasses", + "modelAsString": true + } + } + }, + "excludedKbNumbers": { + "type": "array", + "description": "KB numbers excluded from the software update configuration.", + "items": { + "type": "string" + } + } + } + }, + + "LinuxProperties": { + "type": "object", + "description": "Linux specific update configuration.", + "properties": { + "includedPackageClassifications": { + "description": "Update classifications included in the software update configuration.", + "type": "array", + "items": { + "type": "string", + "enum": [ + "Unclassified", + "Critical", + "Security", + "Other" + ] + }, + "x-ms-enum": { + "name": "LinuxUpdateClasses", + "modelAsString": true + } + }, + "excludedPackageNameMasks": { + "type": "array", + "description": "packages excluded from the software update configuration.", + "items": { + "type": "string" + } + } + } + }, + + "updateConfigurationNavigation": { + "description": "Software update configuration Run Navigation model.", + "type": "object", + "properties": { + "name": { + "description": "Name of the software update configuration triggered the software update configuration run", + "type": "string", + "readOnly": true + } + } + }, + + "jobNavigation": { + "description": "Software update configuration machine run job navigation properties.", + "type": "object", + "properties": { + "id": { + "description": "Id of the job associated with the software update configuration run", + "type": "string", + "readOnly": true + } + } + }, + + "softwareUpdateConfigurationRunListResult": { + "description": "result of listing all software update configuration runs", + "properties": { + "value": { + "description": "outer object returned when listing all software update configuration runs", + "type": "array", + "items": { + "$ref": "./definitions.json#/definitions/softwareUpdateConfigurationRun" + } + }, + "nextLink": { + "type": "string", + "description": "link to next page of results." + } + } + }, + + "softwareUpdateConfigurationRun": { + "description": "Software update configuration Run properties.", + "x-ms-azure-resource": false, + "type": "object", + "properties": { + "name": { + "readOnly": true, + "type": "string", + "description": "Name of the software update configuration run." + }, + "id": { + "readOnly": true, + "type": "string", + "description": "Resource Id of the software update configuration run" + }, + "properties": { + "x-ms-client-flatten": true, + "description": "Software update configuration Run properties.", + "$ref": "#/definitions/softwareUpdateConfigurationRunProperties" + } + } + }, + + "softwareUpdateConfigurationRunProperties": { + "description": "Software update configuration properties.", + "properties": { + "softwareUpdateConfiguration": { + "description": "software update configuration triggered this run", + "$ref": "#/definitions/updateConfigurationNavigation" + }, + "status": { + "type": "string", + "description": "Status of the software update configuration run.", + "readOnly": true + }, + "configuredDuration": { + "type": "string", + "description": "configured duration for the software update configuration run.", + "readOnly": true + }, + "osType": { + "type": "string", + "description": "Operating system target of the software update configuration triggered this run", + "readOnly": true + }, + "startTime": { + "type": "string", + "format": "date-time", + "description": "Etart time of the software update configuration run.", + "readOnly": true + }, + "endTime": { + "type": "string", + "format": "date-time", + "description": "End time of the software update configuration run.", + "readOnly": true + }, + "computerCount": { + "type": "integer", + "description": "Number of computers in the software update configuration run.", + "readOnly": true + }, + "failedCount": { + "type": "integer", + "description": "Number of computers with failed status.", + "readOnly": true + }, + "creationTime": { + "type": "string", + "description": "Creation time of theresource, which only appears in the response.", + "format": "date-time", + "readOnly": true + }, + "createdBy": { + "type": "string", + "description": "createdBy property, which only appears in the response.", + "readOnly": true + }, + "lastModifiedTime": { + "type": "string", + "description": "Last time resource was modified, which only appears in the response.", + "format": "date-time", + "readOnly": true + }, + "lastModifiedBy": { + "type": "string", + "description": "lastModifiedBy property, which only appears in the response.", + "readOnly": true + } + } + }, + + "softwareUpdateConfigurationMachineRunListResult": { + "description": "result of listing all software update configuration machine runs", + "properties": { + "value": { + "description": "outer object returned when listing all software update configuration machine runs", + "type": "array", + "items": { + "$ref": "./definitions.json#/definitions/softwareUpdateConfigurationMachineRun" + } + }, + "nextLink": { + "type": "string", + "description": "link to next page of results." + } + } + }, + + "updateConfigurationMachineRunProperties": { + "description": "Software update configuration machine run properties.", + "properties": { + "targetComputer": { + "type": "string", + "description": "name of the updated computer", + "readOnly": true + }, + "targetComputerType": { + "type": "string", + "description": "type of the updated computer.", + "readOnly": true + }, + "softwareUpdateConfiguration": { + "description": "software update configuration triggered this run", + "$ref": "#/definitions/updateConfigurationNavigation" + }, + "status": { + "type": "string", + "description": "Status of the software update configuration machine run.", + "readOnly": true + }, + "osType": { + "type": "string", + "description": "Operating system target of the software update configuration triggered this run", + "readOnly": true + }, + "correlationId": { + "type": "string", + "format": "uuid", + "description": "correlation id of the software update configuration machine run", + "readOnly": true + }, + "sourceComputerId": { + "type": "string", + "format": "uuid", + "description": "source computer id of the software update configuration machine run", + "readOnly": true + }, + "startTime": { + "type": "string", + "format": "date-time", + "description": "Start time of the software update configuration machine run.", + "readOnly": true + }, + "endTime": { + "type": "string", + "format": "date-time", + "description": "End time of the software update configuration machine run.", + "readOnly": true + }, + "configuredDuration": { + "type": "string", + "description": "configured duration for the software update configuration run.", + "readOnly": true + }, + "job": { + "description": "Job associated with the software update configuration machine run", + "$ref": "#/definitions/jobNavigation" + }, + "creationTime": { + "type": "string", + "description": "Creation time of theresource, which only appears in the response.", + "format": "date-time", + "readOnly": true + }, + "createdBy": { + "type": "string", + "description": "createdBy property, which only appears in the response.", + "readOnly": true + }, + "lastModifiedTime": { + "type": "string", + "description": "Last time resource was modified, which only appears in the response.", + "format": "date-time", + "readOnly": true + }, + "lastModifiedBy": { + "type": "string", + "description": "lastModifiedBy property, which only appears in the response.", + "readOnly": true + } + } + }, + "softwareUpdateConfigurationMachineRun": { + "description": "Software update configuration machine run model.", + "x-ms-azure-resource": false, + "type": "object", + "properties": { + "name": { + "readOnly": true, + "type": "string", + "description": "Name of the software update configuration machine run" + }, + "id": { + "readOnly": true, + "type": "string", + "description": "Resource Id of the software update configuration machine run" + }, + "properties": { + "x-ms-client-flatten": true, + "description": "Software update configuration machine run properties.", + "$ref": "#/definitions/updateConfigurationMachineRunProperties" + } + } + } + }, + "parameters": { + "subscriptionId": { + "name": "subscriptionId", + "description": "subscription id for tenant issuing the request.", + "type": "string", + "required": true, + "in": "path", + "format": "uuid" + }, + "resourceGroupName": { + "name": "resourceGroupName", + "description": "The name of the resource group within user's subscription.", + "type": "string", + "required": true, + "in": "path" + }, + "automationAccountName": { + "name": "automationAccountName", + "description": "The name of the automation account.", + "type": "string", + "required": true, + "in": "path", + "format": "uuid" + }, + "softwareUpdateConfigurationName": { + "name": "softwareUpdateConfigurationName", + "description": "The name of the software update configuration to be created.", + "type": "string", + "required": true, + "in": "path" + }, + "softwareUpdateConfigurationRunId": { + "name": "softwareUpdateConfigurationRunId", + "description": "The Id of the software update configuration run.", + "type": "string", + "required": true, + "in": "path", + "format": "uuid" + }, + "softwareUpdateConfigurationMachineRunId": { + "name": "softwareUpdateConfigurationMachineRunId", + "description": "The Id of the software update configuration machine run.", + "type": "string", + "required": true, + "in": "path", + "format": "uuid" + }, + "apiVersion": { + "name": "api-version", + "description": "The API version.", + "type": "string", + "required": true, + "in": "query" + }, + "clientRequestId": { + "name": "clientRequestId", + "description": "Identifies this specific client request.", + "type": "string", + "required": false, + "in": "header" + } + } +} diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/createSoftwareUpdateConfiguration.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/createSoftwareUpdateConfiguration.json new file mode 100644 index 000000000000..9752e1a8643e --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/createSoftwareUpdateConfiguration.json @@ -0,0 +1,163 @@ +{ + "parameters": { + "subscriptionId": "51766542-3ed7-4a72-a187-0c8ab644ddab", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "softwareUpdateConfigurationName": "testpatch", + "api-version": "2017-05-15-preview", + "parameters": { + "properties": { + "updateConfiguration": { + "operatingSystem": "Windows", + "duration": "PT2H0M", + "windows": { + "excludedKbNumbers": [ + "168934", + "168973" + ], + "includedUpdateClassifications": "Critical,Definition,FeaturePack,Security,ServicePack,Tools,UpdateRollup,Updates" + }, + "azureVirtualMachines": [ + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01", + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02", + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03" + ], + "nonAzureComputerNames": [ + "box1.contoso.com", + "box2.contoso.com" + ] + }, + "scheduleInfo": { + "frequency": "Hour", + "startTime": "2017-10-19T12:22:57+00:00", + "timeZone": "America/Los_Angeles", + "interval": 1, + "expiryTime": "2018-11-09T11:22:57+00:00", + "advancedSchedule": { + "weekDays": [ + "Monday", + "Thursday" + ] + } + } + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "name": "testpatch", + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch", + "properties": { + "updateConfiguration": { + "operatingSystem": "Windows", + "windows": { + "includedUpdateClassifications": "Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates", + "excludedKbNumbers": [ + "168934", + "168973" + ] + }, + "linux": {}, + "duration": "PT2H", + "azureVirtualMachines": [ + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01", + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02", + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03" + ], + "nonAzureComputerNames": [ + "box1.contoso.com", + "box2.contoso.com" + ] + }, + "scheduleInfo": { + "description": "", + "startTime": "2017-10-19T12:22:00-07:00", + "startTimeOffsetMinutes": -420.0, + "expiryTime": "2018-11-09T11:22:00-08:00", + "expiryTimeOffsetMinutes": -480.0, + "isEnabled": true, + "nextRun": "2017-10-19T12:22:00-07:00", + "nextRunOffsetMinutes": -420.0, + "interval": 1, + "frequency": "Week", + "creationTime": "2017-10-19T18:54:50.5233333+00:00", + "lastModifiedTime": "2017-10-19T18:54:50.5233333+00:00", + "timeZone": "America/Los_Angeles", + "advancedSchedule": {} + }, + "provisioningState": "Provisioning", + "error": {}, + "creationTime": "2017-10-19T18:54:50.5233333+00:00", + "createdBy": "adam@contoso.com", + "lastModifiedBy": "adam@contoso.com", + "lastModifiedTime": "2017-10-19T18:54:50.68+00:00" + } + } + }, + "201": { + "headers": {}, + "body": { + "name": "testpatch", + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch", + "properties": { + "updateConfiguration": { + "operatingSystem": "Windows", + "windows": { + "includedUpdateClassifications": "Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates", + "excludedKbNumbers": [ + "168934", + "168973" + ] + }, + "linux": {}, + "duration": "PT2H", + "azureVirtualMachines": [ + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01", + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02", + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03" + ], + "nonAzureComputerNames": [ + "box1.contoso.com", + "box2.contoso.com" + ] + }, + "scheduleInfo": { + "description": "", + "startTime": "2017-10-19T12:22:00-07:00", + "startTimeOffsetMinutes": -420.0, + "expiryTime": "2018-11-09T11:22:00-08:00", + "expiryTimeOffsetMinutes": -480.0, + "isEnabled": true, + "nextRun": "2017-10-19T12:22:00-07:00", + "nextRunOffsetMinutes": -420.0, + "interval": 1, + "frequency": "Week", + "creationTime": "2017-10-19T18:54:50.5233333+00:00", + "lastModifiedTime": "2017-10-19T18:54:50.5233333+00:00", + "timeZone": "America/Los_Angeles", + "advancedSchedule": null + }, + "provisioningState": "Provisioning", + "error": {}, + "creationTime": "2017-10-19T18:54:50.5233333+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-19T18:54:50.68+00:00" + } + } + }, + "400": { + "code": "BadRequest", + "message": "{\"Message\":\"The request is invalid.\",\"ModelState\":{\"softwareUpdateConfiguration.properties.scheduleInfo\":[\"The scheduleInfo field is required.\"]}}" + }, + "404": { + "code": "NotFound", + "message": "{\"Message\":\"Could not find the account. SubscriptionId: 51766542-3ed7-4a72-a187-0c8ab644ddab AccountName: myaccount\"}" + }, + "409": { + "code": "Conflict", + "message": "\"Software update configuration with the same name already exist.\"" + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/deleteSoftwareUpdateConfiguration.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/deleteSoftwareUpdateConfiguration.json new file mode 100644 index 000000000000..c2c96fa8e5d2 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/deleteSoftwareUpdateConfiguration.json @@ -0,0 +1,18 @@ +{ + "parameters": { + "subscriptionId": "51766542-3ed7-4a72-a187-0c8ab644ddab", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "softwareUpdateConfigurationName": "mypatch", + "api-version": "2017-05-15-preview", + "body": {} + }, + "responses": { + "200": {}, + "204": {}, + "404": { + "code": "NotFound", + "message": "{\"Message\":\"Could not find the account. SubscriptionId: 51766542-3ed7-4a72-a187-0c8ab644ddab AccountName: myaccount\"}" + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/getSoftwareUpdateConfigurationByName.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/getSoftwareUpdateConfigurationByName.json new file mode 100644 index 000000000000..ff5a8cc0a871 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/getSoftwareUpdateConfigurationByName.json @@ -0,0 +1,68 @@ +{ + "parameters": { + "subscriptionId": "51766542-3ed7-4a72-a187-0c8ab644ddab", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "softwareUpdateConfigurationName": "mypatch", + "api-version": "2017-05-15-preview", + "body": {} + }, + "responses": { + "200": { + "headers": {}, + "body": { + "name": "testpatch", + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch", + "properties": { + "updateConfiguration": { + "operatingSystem": "Windows", + "windows": { + "includedUpdateClassifications": "Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates", + "excludedKbNumbers": [ + "168934", + "168973" + ] + }, + "linux": {}, + "duration": "PT2H", + "azureVirtualMachines": [ + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01", + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02", + "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03" + ], + "nonAzureComputerNames": [ + "box1.contoso.com", + "box2.contoso.com" + ] + }, + "scheduleInfo": { + "description": "", + "startTime": "2017-10-19T12:22:00-07:00", + "startTimeOffsetMinutes": -420.0, + "expiryTime": "2018-11-09T11:22:00-08:00", + "expiryTimeOffsetMinutes": -480.0, + "isEnabled": true, + "nextRun": "2017-10-19T12:22:00-07:00", + "nextRunOffsetMinutes": -420.0, + "interval": 1, + "frequency": "Week", + "creationTime": "2017-10-19T18:54:50.5233333+00:00", + "lastModifiedTime": "2017-10-19T18:54:50.5233333+00:00", + "timeZone": "America/Los_Angeles", + "advancedSchedule": null + }, + "provisioningState": "Provisioning", + "createdBy": "eve@contoso.com", + "error": {}, + "creationTime": "2017-10-19T18:54:50.5233333+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-19T18:54:50.68+00:00" + } + } + }, + "404": { + "code": "NotFound", + "message": "Software update configuration not found" + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/listSoftwareUpdateConfigurations.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/listSoftwareUpdateConfigurations.json new file mode 100644 index 000000000000..cd091fe83ce6 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/listSoftwareUpdateConfigurations.json @@ -0,0 +1,73 @@ +{ + "parameters": { + "subscriptionId": "1a7d4044-286c-4acb-969a-96639265bf2e", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "api-version": "2017-05-15-preview", + "body": {} + }, + "responses": { + "200": { + "value": [ + { + "name": "testpatch-01", + "id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-01", + "properties": { + "updateConfiguration": { + "operatingSystem": "Windows", + "windows": { + "includedUpdateClassifications": "Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates", + "excludedKbNumbers": null + }, + "linux": null, + "duration": "PT2H", + "azureVirtualMachines": [ + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01", + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02", + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03" + ], + "nonAzureComputerNames": null + }, + "frequency": "Week", + "startTime": "2017-10-19T12:22:00-07:00", + "creationTime": "2017-10-19T18:54:50.5233333+00:00", + "lastModifiedTime": "2017-10-19T18:54:50.68+00:00", + "provisioningState": "Succeeded", + "nextRun": "2017-10-23T12:22:00-07:00" + } + }, + { + "name": "testpatch-02", + "id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-02", + "properties": { + "updateConfiguration": { + "operatingSystem": "Windows", + "windows": { + "includedUpdateClassifications": "Critical, FeaturePack", + "excludedKbNumbers":null + }, + "linux": null, + "duration": "PT2H30M", + "azureVirtualMachines": [ + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-04", + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-05", + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-06" + ], + "nonAzureComputerNames": null + }, + "frequency": "Hour", + "startTime": "2018-05-05T12:26:00-07:00", + "creationTime": "2017-08-11T21:52:02.7733333+00:00", + "lastModifiedTime": "2017-08-11T21:52:22.88+00:00", + "provisioningState": "Succeeded", + "nextRun":"2018-05-05T12:26:00-07:00" + } + } + ] + }, + "404": { + "code": "NotFound", + "message": "{\"Message\":\"Could not find the account. SubscriptionId: 1a7d4044-286c-4acb-969a-96639265bf2e AccountName: myaccount\"}" + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/listSoftwareUpdateConfigurationsByVm.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/listSoftwareUpdateConfigurationsByVm.json new file mode 100644 index 000000000000..8072728be128 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfiguration/listSoftwareUpdateConfigurationsByVm.json @@ -0,0 +1,74 @@ +{ + "parameters": { + "subscriptionId": "1a7d4044-286c-4acb-969a-96639265bf2e", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "$filter": "properties/updateConfiguration/azureVirtualMachines/any(m: m eq '/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01')", + "api-version": "2017-05-15-preview", + "body": {} + }, + "responses": { + "200": { + "value": [ + { + "name": "testpatch-01", + "id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-01", + "properties": { + "updateConfiguration": { + "operatingSystem": "Windows", + "windows": { + "includedUpdateClassifications": "Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates", + "excludedKbNumbers": null + }, + "linux": null, + "duration": "PT2H", + "azureVirtualMachines": [ + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01", + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02", + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03" + ], + "nonAzureComputerNames": null + }, + "frequency": "Week", + "startTime": "2017-10-19T12:22:00-07:00", + "creationTime": "2017-10-19T18:54:50.5233333+00:00", + "lastModifiedTime": "2017-10-19T18:54:50.68+00:00", + "provisioningState": "Succeeded", + "nextRun": "2017-10-23T12:22:00-07:00" + } + }, + { + "name": "testpatch-02", + "id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-02", + "properties": { + "updateConfiguration": { + "operatingSystem": "Windows", + "windows": { + "includedUpdateClassifications": "Critical, FeaturePack", + "excludedKbNumbers":null + }, + "linux": null, + "duration": "PT2H30M", + "azureVirtualMachines": [ + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01", + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-05", + "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-06" + ], + "nonAzureComputerNames": null + }, + "frequency": "Hour", + "startTime": "2018-05-05T12:26:00-07:00", + "creationTime": "2017-08-11T21:52:02.7733333+00:00", + "lastModifiedTime": "2017-08-11T21:52:22.88+00:00", + "provisioningState": "Succeeded", + "nextRun":"2018-05-05T12:26:00-07:00" + } + } + ] + }, + "404": { + "code": "NotFound", + "message": "Machine is not registered for Update Management. Assure that the machine is registered for Update Management. Machine Name(s) or Id(s): /subscriptions/637d11c3-e6a4-46cb-b32c-ee5b6dd9c68a/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/vm01." + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/getSoftwareUpdateConfigurationMachineRunById.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/getSoftwareUpdateConfigurationMachineRunById.json new file mode 100644 index 000000000000..a784f9b76340 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/getSoftwareUpdateConfigurationMachineRunById.json @@ -0,0 +1,38 @@ +{ + "parameters": { + "subscriptionId": "51766542-3ed7-4a72-a187-0c8ab644ddab", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "softwareUpdateConfigurationMachineRunId": "ca440719-34a4-4234-a1a9-3f84faf7788f", + "api-version": "2017-05-15-preview" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7788f", + "name": "ca440719-34a4-4234-a1a9-3f84faf7788f", + "properties": { + "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm", + "targetComputerType": "AzureVirtualMachines", + "softwareUpdateConfiguration": { "name": "mypatch" }, + "status": "Succeeded", + "osType": "Windows", + "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59", + "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e", + "startTime": "2017-10-23T02:33:30.7484961+00:00", + "endTime": "2017-10-23T02:33:36.4166667+00:00", + "configuredDuration": "PT2H", + "job": {}, + "creationTime": "2017-10-23T02:33:30.7484961+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00" + } + } + }, + "404": { + "code": "NotFound", + "message": "{\"Message\":\"Could not find the account. SubscriptionId: 51766542-3ed7-4a72-a187-0c8ab644ddab AccountName: myaccount\"}" + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/listSoftwareUpdateConfigurationMachineRuns.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/listSoftwareUpdateConfigurationMachineRuns.json new file mode 100644 index 000000000000..9a0a4af8a531 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/listSoftwareUpdateConfigurationMachineRuns.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "subscriptionId": "51766542-3ed7-4a72-a187-0c8ab644ddab", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "api-version": "2017-05-15-preview" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7788f", + "name": "ca440719-34a4-4234-a1a9-3f84faf7788f", + "properties": { + "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm", + "targetComputerType": "AzureVirtualMachines", + "softwareUpdateConfiguration": { "name": "mypatch" }, + "status": "Succeeded", + "osType": "Windows", + "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59", + "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e", + "startTime": "2017-10-23T02:33:30.7484961+00:00", + "endTime": "2017-10-23T02:33:36.4166667+00:00", + "configuredDuration": "PT2H", + "job": {}, + "creationTime": "2017-10-23T02:33:30.7484961+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00" + } + }, + { + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7789f", + "name": "ca440719-34a4-4234-a1a9-3f84faf7789f", + "properties": { + "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm2", + "targetComputerType": "AzureVirtualMachines", + "softwareUpdateConfiguration": { "name": "mypatch" }, + "status": "Succeeded", + "osType": "Windows", + "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59", + "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e", + "startTime": "2017-10-23T02:33:30.7484961+00:00", + "endTime": "2017-10-23T02:33:36.4166667+00:00", + "configuredDuration": "PT2H", + "job": {}, + "creationTime": "2017-10-23T02:33:30.7484961+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00" + } + } + ], + "nextLink": "https://management.azure.com:443/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns?api-version=2017-05-15-preview&_=1508725900015&$skip=100" + } + }, + "404": { + "code": "NotFound", + "message": "{\"Message\":\"Could not find the account. SubscriptionId: 51766542-3ed7-4a72-a187-0c8ab644ddab AccountName: myaccount\"}" + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/listSoftwareUpdateConfigurationMachineRunsByRun.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/listSoftwareUpdateConfigurationMachineRunsByRun.json new file mode 100644 index 000000000000..2f658386dc98 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationMachineRun/listSoftwareUpdateConfigurationMachineRunsByRun.json @@ -0,0 +1,63 @@ +{ + "parameters": { + "subscriptionId": "51766542-3ed7-4a72-a187-0c8ab644ddab", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "$filter": "$filter=properties/correlationId%20eq%200b943e57-44d3-4f05-898c-6e92aa617e59", + "api-version": "2017-05-15-preview" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7788f", + "name": "ca440719-34a4-4234-a1a9-3f84faf7788f", + "properties": { + "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm", + "targetComputerType": "AzureVirtualMachines", + "softwareUpdateConfiguration": { "name": "mypatch" }, + "status": "Succeeded", + "osType": "Windows", + "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59", + "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e", + "startTime": "2017-10-23T02:33:30.7484961+00:00", + "endTime": "2017-10-23T02:33:36.4166667+00:00", + "configuredDuration": "PT2H", + "job": {}, + "creationTime": "2017-10-23T02:33:30.7484961+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00" + } + }, + { + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationMachineRuns/ca440719-34a4-4234-a1a9-3f84faf7789f", + "name": "ca440719-34a4-4234-a1a9-3f84faf7789f", + "properties": { + "targetComputer": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Compute/virtualMachines/myvm2", + "targetComputerType": "AzureVirtualMachines", + "softwareUpdateConfiguration": { "name": "mypatch" }, + "status": "Succeeded", + "osType": "Windows", + "correlationId": "0b943e57-44d3-4f05-898c-6e92aa617e59", + "sourceComputerId": "3d3f24bf-7037-424e-bfba-aae3b9752f8e", + "startTime": "2017-10-23T02:33:30.7484961+00:00", + "endTime": "2017-10-23T02:33:36.4166667+00:00", + "configuredDuration": "PT2H", + "job": {}, + "creationTime": "2017-10-23T02:33:30.7484961+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-23T02:34:32.4366667+00:00" + } + } + ], + "nextLink": "https://management.azure.com:443/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns?api-version=2017-05-15-preview&_=1508725900015&$skip=100" + } + }, + "404": { + "code": "NotFound", + "message": "{\"Message\":\"Could not find the account. SubscriptionId: 51766542-3ed7-4a72-a187-0c8ab644ddab AccountName: myaccount\"}" + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/getSoftwareUpdateConfigurationRunById.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/getSoftwareUpdateConfigurationRunById.json new file mode 100644 index 000000000000..930d7bc1393d --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/getSoftwareUpdateConfigurationRunById.json @@ -0,0 +1,35 @@ +{ + "parameters": { + "subscriptionId": "51766542-3ed7-4a72-a187-0c8ab644ddab", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "softwareUpdateConfigurationRunId": "2bd77cfa-2e9c-41b4-a45b-684a77cfeca9", + "api-version": "2017-05-15-preview" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns/2bd77cfa-2e9c-41b4-a45b-684a77cfeca9", + "name": "2bd77cfa-2e9c-41b4-a45b-684a77cfeca9", + "properties": { + "softwareUpdateConfiguration": { "name": "mypatch" }, + "status": "Succeeded", + "configuredDuration": "PT2H", + "osType": "Windows", + "startTime": "2017-10-23T02:30:36.2401233+00:00", + "endTime": "2017-10-23T02:30:42.8466667+00:00", + "computerCount": 1, + "failedCount": 0, + "creationTime": "2017-10-23T02:30:36.2401233+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-23T02:31:39.3966667+00:00" + } + } + }, + "404": { + "code": "NotFound", + "message": "Software update configuration run not found" + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/listFailedSoftwareUpdateConfigurationRuns.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/listFailedSoftwareUpdateConfigurationRuns.json new file mode 100644 index 000000000000..613d7650d803 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/listFailedSoftwareUpdateConfigurationRuns.json @@ -0,0 +1,58 @@ +{ + "parameters": { + "subscriptionId": "51766542-3ed7-4a72-a187-0c8ab644ddab", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "softwareUpdateConfigurationRunId": "a2c7c4b8-55d6-4505-bea7-756e93b18a35", + "$filter": "properties/status%20eq%20'Failed'", + "api-version": "2017-05-15-preview" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns/2bd77cfa-2e9c-41b4-a45b-684a77cfeca9", + "name": "2bd77cfa-2e9c-41b4-a45b-684a77cfeca9", + "properties": { + "softwareUpdateConfiguration": { "name": "mypatch" }, + "status": "Failed", + "configuredDuration": "PT2H", + "osType": "Windows", + "startTime": "2017-10-23T02:30:36.2401233+00:00", + "endTime": "2017-10-23T02:30:42.8466667+00:00", + "computerCount": 1, + "failedCount": 0, + "creationTime": "2017-10-23T02:30:36.2401233+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-23T02:31:39.3966667+00:00" + } + }, + { + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns/5dabff55-9812-4a58-af16-b0cb1d9384e8", + "name": "5dabff55-9812-4a58-af16-b0cb1d9384e8", + "properties": { + "softwareUpdateConfiguration": { "name": "mypatch" }, + "status": "Failed", + "configuredDuration": "PT2H", + "osType": "Windows", + "startTime": "2017-10-23T01:33:01.8818952+00:00", + "endTime": "2017-10-23T01:33:08.1133333+00:00", + "computerCount": 1, + "failedCount": 0, + "creationTime": "2017-10-23T01:33:01.8818952+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-23T01:34:03.94+00:00" + } + } + ], + "nextLink": "https://management.azure.com:443/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/stas-wcus/softwareUpdateConfigurationRuns?api-version=2017-05-15-preview&_=1508725900015&$skip=100" + } + }, + "404": { + "code": "NotFound", + "message": "{\"Message\":\"Could not find the account. SubscriptionId: 51766542-3ed7-4a72-a187-0c8ab644ddab AccountName: myaccount\"}" + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/listSoftwareUpdateConfigurationRuns.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/listSoftwareUpdateConfigurationRuns.json new file mode 100644 index 000000000000..aa3c6f4a453c --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/examples/softwareUpdateConfigurationRun/listSoftwareUpdateConfigurationRuns.json @@ -0,0 +1,57 @@ +{ + "parameters": { + "subscriptionId": "51766542-3ed7-4a72-a187-0c8ab644ddab", + "resourceGroupName": "mygroup", + "automationAccountName": "myaccount", + "softwareUpdateConfigurationRunId": "a2c7c4b8-55d6-4505-bea7-756e93b18a35", + "api-version": "2017-05-15-preview" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns/2bd77cfa-2e9c-41b4-a45b-684a77cfeca9", + "name": "2bd77cfa-2e9c-41b4-a45b-684a77cfeca9", + "properties": { + "softwareUpdateConfiguration": { "name": "mypatch" }, + "status": "Succeeded", + "configuredDuration": "PT2H", + "osType": "Windows", + "startTime": "2017-10-23T02:30:36.2401233+00:00", + "endTime": "2017-10-23T02:30:42.8466667+00:00", + "computerCount": 1, + "failedCount": 0, + "creationTime": "2017-10-23T02:30:36.2401233+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-23T02:31:39.3966667+00:00" + } + }, + { + "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurationRuns/5dabff55-9812-4a58-af16-b0cb1d9384e8", + "name": "5dabff55-9812-4a58-af16-b0cb1d9384e8", + "properties": { + "softwareUpdateConfiguration": { "name": "mypatch" }, + "status": "Succeeded", + "configuredDuration": "PT2H", + "osType": "Windows", + "startTime": "2017-10-23T01:33:01.8818952+00:00", + "endTime": "2017-10-23T01:33:08.1133333+00:00", + "computerCount": 1, + "failedCount": 0, + "creationTime": "2017-10-23T01:33:01.8818952+00:00", + "lastModifiedBy": "", + "lastModifiedTime": "2017-10-23T01:34:03.94+00:00" + } + } + ], + "nextLink": "https://management.azure.com:443/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/stas-wcus/softwareUpdateConfigurationRuns?api-version=2017-05-15-preview&_=1508725900015&$skip=100" + } + }, + "404": { + "code": "NotFound", + "message": "{\"Message\":\"Could not find the account. SubscriptionId: 51766542-3ed7-4a72-a187-0c8ab644ddab AccountName: myaccount\"}" + } + } +} \ No newline at end of file diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfiguration.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfiguration.json new file mode 100644 index 000000000000..142a43cb555f --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfiguration.json @@ -0,0 +1,211 @@ +{ + "swagger": "2.0", + + "info": { + "title": "Update Management API", + "description": "APIs for managing software update configurations.", + "contact": { + "name": "Mohamed Enein" + }, + "version": "2017-05-15-preview" + }, + + "consumes": [ "application/json" ], + + "produces": [ "application/json" ], + + "schemes": [ "https" ], + + "host": "management.azure.com", + + "basePath": "/", + + "security": [ + { + "azure_auth": [ + "user_impersonation" + ] + } + ], + "securityDefinitions": { + "azure_auth": { + "type": "oauth2", + "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", + "flow": "implicit", + "description": "Azure Active Directory OAuth2 Flow", + "scopes": { + "user_impersonation": "impersonate your user account" + } + } + }, + + "paths": { + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurations/{softwareUpdateConfigurationName}": { + "parameters": [ + { + "$ref": "./definitions.json#/parameters/subscriptionId" + }, + { + "$ref": "./definitions.json#/parameters/resourceGroupName" + }, + { + "$ref": "./definitions.json#/parameters/automationAccountName" + }, + { + "$ref": "./definitions.json#/parameters/softwareUpdateConfigurationName" + }, + { + "$ref": "./definitions.json#/parameters/apiVersion" + }, + { + "$ref": "./definitions.json#/parameters/clientRequestId" + } + ], + + "put": { + "tags": [ "Software Update Configuration" ], + "description": "Create a new software update configuration with the name given in the URI.", + "externalDocs": { + "url": "http://aka.ms/azureautomationsdk/softwareupdateconfigurationoperations" + }, + "x-ms-examples": { + "Create software update configuration": { "$ref": "./examples/softwareUpdateConfiguration/createSoftwareUpdateConfiguration.json" } + }, + "operationId": "softwareUpdateConfigurations_Create", + "parameters": [ + { + "name": "parameters", + "description": "Request body.", + "required": true, + "in": "body", + "schema": { + "$ref": "./definitions.json#/definitions/softwareUpdateConfiguration" + } + } + ], + "responses": { + "200": { + "description": "Software update configuration with the same name and properties already exists.", + "schema": { + "$ref": "./definitions.json#/definitions/softwareUpdateConfiguration" + } + }, + "201": { + "description": "Software update configuration is created.", + "schema": { + "$ref": "./definitions.json#/definitions/softwareUpdateConfiguration" + } + }, + "400": { + "description": "Bad request." + }, + "404": { + "description": "Resource group or automation account does not exist." + }, + "409": { + "description": "A software update configuration with different properties and the same name already exist." + } + } + }, + + + "get": { + "tags": [ "Software Update Configuration" ], + "description": "Get a single software update configuration by name.", + "externalDocs": { + "url": "http://aka.ms/azureautomationsdk/softwareupdateconfigurationoperations" + }, + "x-ms-examples": { + "Get software update configuration by name": { "$ref": "./examples/softwareUpdateConfiguration/getSoftwareUpdateConfigurationByName.json" } + }, + "operationId": "softwareUpdateConfigurations_GetByName", + "responses": { + "200": { + "description": "A single software update configuration.", + "schema": { + "$ref": "./definitions.json#/definitions/softwareUpdateConfiguration" + } + }, + "404": { + "description": "Resource group, account, or software update configuration doesn't exist." + } + } + }, + + "delete": { + "tags": [ "Software Update Configuration" ], + "description": "delete a specific software update configuration.", + "externalDocs": { + "url": "http://aka.ms/azureautomationsdk/softwareupdateconfigurationoperations" + }, + "x-ms-examples": { + "Delete software update configuration": { "$ref": "./examples/softwareUpdateConfiguration/deleteSoftwareUpdateConfiguration.json" } + }, + "operationId": "softwareUpdateConfigurations_Delete", + "responses": { + "200": { + "description": "The software update configuration has been deleted." + }, + "204": { + "description": "The software update configuration does not exist." + }, + "404": { + "description": "Resource group, account, or software update configuration doesn't exist." + } + } + } + }, + + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurations": { + "parameters": [ + { + "$ref": "./definitions.json#/parameters/subscriptionId" + }, + { + "$ref": "./definitions.json#/parameters/resourceGroupName" + }, + { + "$ref": "./definitions.json#/parameters/automationAccountName" + }, + { + "$ref": "./definitions.json#/parameters/apiVersion" + }, + { + "$ref": "./definitions.json#/parameters/clientRequestId" + } + ], + + + "get": { + "tags": [ "Software Update Configuration" ], + "description": "Get all software update configurations for the account.", + "externalDocs": { + "url": "http://aka.ms/azureautomationsdk/softwareupdateconfigurationoperations" + }, + "x-ms-examples": { + "List software update configurations": { "$ref": "./examples/softwareUpdateConfiguration/listSoftwareUpdateConfigurations.json" }, + "List software update configurations Targeting a specific azure virtual machine": { "$ref": "./examples/softwareUpdateConfiguration/listSoftwareUpdateConfigurationsByVm.json" } + }, + "operationId": "softwareUpdateConfigurations_List", + "parameters": [ + { + "name": "$filter", + "in": "query", + "required": false, + "type": "string", + "description": "The filter to apply on the operation." + } + ], + "responses": { + "200": { + "description": "Return list of software update configurations.", + "$ref": "./definitions.json#/definitions/softwareUpdateConfigurationListResult" + }, + "404": { + "description": "Resource group, or account doesn't exist." + } + } + } + } + } +} diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfigurationMachineRun.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfigurationMachineRun.json new file mode 100644 index 000000000000..d541d974acc6 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfigurationMachineRun.json @@ -0,0 +1,157 @@ +{ + "swagger": "2.0", + + "info": { + "title": "Update Management API", + "description": "APIs for managing software update configurations.", + "contact": { + "name": "Mohamed Enein" + }, + "version": "2017-05-15-preview" + }, + + "consumes": [ "application/json" ], + + "produces": [ "application/json" ], + + "schemes": [ "https" ], + + "host": "management.azure.com", + + "basePath": "/", + + "security": [ + { + "azure_auth": [ + "user_impersonation" + ] + } + ], + "securityDefinitions": { + "azure_auth": { + "type": "oauth2", + "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", + "flow": "implicit", + "description": "Azure Active Directory OAuth2 Flow", + "scopes": { + "user_impersonation": "impersonate your user account" + } + } + }, + + "paths": { + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationsRuns/{softwareUpdateConfigurationMachineRunId}": { + "parameters": [ + { + "$ref": "./definitions.json#/parameters/subscriptionId" + }, + { + "$ref": "./definitions.json#/parameters/resourceGroupName" + }, + { + "$ref": "./definitions.json#/parameters/automationAccountName" + }, + { + "$ref": "./definitions.json#/parameters/softwareUpdateConfigurationMachineRunId" + }, + { + "$ref": "./definitions.json#/parameters/apiVersion" + }, + { + "$ref": "./definitions.json#/parameters/clientRequestId" + } + ], + + "get": { + "tags": [ "Software Update Configuration Machine Run" ], + "description": "Get a single software update configuration machine run by Id.", + "externalDocs": { + "url": "http://aka.ms/azureautomationsdk/softwareupdateconfigurationoperations" + }, + "x-ms-examples": { + "Get software update configuration machine run": { "$ref": "./examples/softwareUpdateConfigurationMachineRun/getSoftwareUpdateConfigurationMachineRunById.json" } + }, + "operationId": "softwareUpdateConfigurationMachineRuns_GetById", + "responses": { + "200": { + "description": "A single software update configuration machine run.", + "schema": { + "$ref": "./definitions.json#/definitions/softwareUpdateConfigurationMachineRun" + } + }, + "404": { + "description": "Resource group, account, or software update configuration machine run doesn't exist." + } + } + } + }, + + + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationMachineRuns": { + "parameters": [ + { + "$ref": "./definitions.json#/parameters/subscriptionId" + }, + { + "$ref": "./definitions.json#/parameters/resourceGroupName" + }, + { + "$ref": "./definitions.json#/parameters/automationAccountName" + }, + { + "$ref": "./definitions.json#/parameters/apiVersion" + }, + { + "$ref": "./definitions.json#/parameters/clientRequestId" + } + ], + + "get": { + "tags": [ "Software Update Configuration Machine Run" ], + "description": "Return list of software update configuration machine runs", + "externalDocs": { + "url": "http://aka.ms/azureautomationsdk/softwareupdateconfigurationoperations" + }, + "x-ms-examples": { + "List software update configuration machine runs": { "$ref": "./examples/softwareUpdateConfigurationMachineRun/listSoftwareUpdateConfigurationMachineRuns.json" }, + "List software update configuration machine runs for a specific software update configuration run": { "$ref": "./examples/softwareUpdateConfigurationMachineRun/listSoftwareUpdateConfigurationMachineRunsByRun.json" } + }, + "parameters": [ + { + "name": "$skip", + "in": "query", + "required": false, + "type": "string", + "description": "number of entries you skip before returning results" + }, + { + "name": "$top", + "in": "query", + "required": false, + "type": "string", + "description": "Maximum number of entries returned in the results collection" + }, + { + "name": "$filter", + "in": "query", + "required": false, + "type": "string", + "description": "The filter to apply on the operation. You can use the following filters: 'properties/osType', 'properties/status', 'properties/startTime', and 'properties/softwareUpdateConfiguration/name'" + } + ], + "operationId": "softwareUpdateConfigurationMachineRuns_List", + "responses": { + "200": { + "description": "Return list of software update configuration machine runs.", + "schema": { + "$ref": "./definitions.json#/definitions/softwareUpdateConfigurationMachineRunListResult" + } + }, + "404": { + "description": "Resource group, or account doesn't exist." + } + } + } + } + } +} diff --git a/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfigurationRun.json b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfigurationRun.json new file mode 100644 index 000000000000..5bbfef482ae0 --- /dev/null +++ b/specification/automation/resource-manager/Microsoft.Automation/2017-05-15-preview/softwareUpdateConfigurationRun.json @@ -0,0 +1,158 @@ +{ + "swagger": "2.0", + + "info": { + "title": "Update Management API", + "description": "APIs for managing software update configurations.", + "contact": { + "name": "Mohamed Enein" + }, + "version": "2017-05-15-preview" + }, + + "consumes": [ "application/json" ], + + "produces": [ "application/json" ], + + "schemes": [ "https" ], + + "host": "management.azure.com", + + "basePath": "/", + + "security": [ + { + "azure_auth": [ + "user_impersonation" + ] + } + ], + "securityDefinitions": { + "azure_auth": { + "type": "oauth2", + "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", + "flow": "implicit", + "description": "Azure Active Directory OAuth2 Flow", + "scopes": { + "user_impersonation": "impersonate your user account" + } + } + }, + + "paths": { + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationsRuns/{softwareUpdateConfigurationRunId}": { + "parameters": [ + { + "$ref": "./definitions.json#/parameters/subscriptionId" + }, + { + "$ref": "./definitions.json#/parameters/resourceGroupName" + }, + { + "$ref": "./definitions.json#/parameters/automationAccountName" + }, + { + "$ref": "./definitions.json#/parameters/softwareUpdateConfigurationRunId" + }, + { + "$ref": "./definitions.json#/parameters/apiVersion" + }, + { + "$ref": "./definitions.json#/parameters/clientRequestId" + } + ], + + "get": { + "tags": [ "Software Update Configuration Run" ], + "description": "Get a single software update configuration Run by Id.", + "externalDocs": { + "url": "http://aka.ms/azureautomationsdk/softwareupdateconfigurationrunoperations" + }, + "x-ms-examples": { + "Get software update configuration runs by Id": { "$ref": "./examples/softwareUpdateConfigurationRun/getSoftwareUpdateConfigurationRunById.json" } + }, + "operationId": "softwareUpdateConfigurationRuns_GetById", + "responses": { + "200": { + "description": "A single software update configuration Run.", + "schema": { + "$ref": "./definitions.json#/definitions/softwareUpdateConfigurationRun" + } + }, + "404": { + "description": "Resource group, account, or software update configuration doesn't exist." + } + } + } + }, + + + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationsRuns": { + "parameters": [ + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/resourceGroupName" + }, + { + "$ref": "#/parameters/automationAccountName" + }, + { + "$ref": "#/parameters/apiVersion" + }, + { + "$ref": "#/parameters/clientRequestId" + } + ], + + "get": { + "tags": [ "Software Update Configuration Run" ], + "description": "Return list of software update configuration runs", + "externalDocs": { + "url": "http://aka.ms/azureautomationsdk/softwareupdateconfigurationoperations" + }, + "x-ms-examples": { + "List software update configuration machine runs": { "$ref": "./examples/softwareUpdateConfigurationRun/listSoftwareUpdateConfigurationRuns.json" }, + "List software update configuration machine run with status equal to 'Failed'": { "$ref": "./examples/softwareUpdateConfigurationRun/listFailedSoftwareUpdateConfigurationRuns.json" } + }, + "parameters": [ + { + "name": "$skip", + "in": "query", + "required": false, + "type": "string", + "description": "number of entries you skip before returning results" + }, + { + "name": "$top", + "in": "query", + "required": false, + "type": "string", + "description": "Maximum number of entries returned in the results collection" + }, + { + "name": "$filter", + "in": "query", + "required": false, + "type": "string", + "description": "The filter to apply on the operation. You can use the following filters: 'properties/osType', 'properties/status', 'properties/startTime', and 'properties/softwareUpdateConfiguration/name'" + } + ], + "operationId": "softwareUpdateConfigurationRuns_List", + "responses": { + "200": { + "description": "Return list of software update configurations runs.", + "schema":{ + "$ref": "./definitions.json#/definitions/softwareUpdateConfigurationRunListResult" + } + }, + "404": { + "description": "Resource group, or account doesn't exist." + } + } + } + } + } + } + \ No newline at end of file diff --git a/specification/automation/resource-manager/readme.md b/specification/automation/resource-manager/readme.md index 5a61dee415b7..273bfda775dd 100644 --- a/specification/automation/resource-manager/readme.md +++ b/specification/automation/resource-manager/readme.md @@ -28,7 +28,7 @@ These are the global settings for the Automation API. title: AutomationClient description: Automation Client openapi-type: arm -tag: package-2015-10 +tag: package-2017-05-preview ``` @@ -59,6 +59,34 @@ input-file: ``` +### Tag: package-2017-05-preview + +These settings apply only when `--tag=package-2017-05-preview` is specified on the command line. + +``` yaml $(tag) == 'package-2017-05-preview' +input-file: +- Microsoft.Automation/2015-10-31/account.json +- Microsoft.Automation/2015-10-31/certificate.json +- Microsoft.Automation/2015-10-31/connection.json +- Microsoft.Automation/2015-10-31/connectionType.json +- Microsoft.Automation/2015-10-31/credential.json +- Microsoft.Automation/2015-10-31/definitions.json +- Microsoft.Automation/2015-10-31/dscCompilationJob.json +- Microsoft.Automation/2015-10-31/dscConfiguration.json +- Microsoft.Automation/2015-10-31/dscNode.json +- Microsoft.Automation/2015-10-31/dscNodeConfiguration.json +- Microsoft.Automation/2015-10-31/hybridRunbookWorkerGroup.json +- Microsoft.Automation/2015-10-31/job.json +- Microsoft.Automation/2015-10-31/jobSchedule.json +- Microsoft.Automation/2015-10-31/module.json +- Microsoft.Automation/2015-10-31/runbook.json +- Microsoft.Automation/2015-10-31/schedule.json +- Microsoft.Automation/2015-10-31/variable.json +- Microsoft.Automation/2015-10-31/webhook.json +- Microsoft.Automation/2017-05-15-preview/softwareUpdateConfiguration.json +- Microsoft.Automation/2017-05-15-preview/softwareUpdateConfigurationRun.json +- Microsoft.Automation/2017-05-15-preview/softwareUpdateConfigurationMachineRun.json +``` --- # Code Generation