{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21047,"path":"integrate-applications/integration-hub/azure-vir-mach-spoke.md","title":"Microsoft Azure Virtual Machine Spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Microsoft Azure Virtual Machine Spoke\n\nManage the Microsoft Azure Virtual Machine \\(VM\\) from your ServiceNow instance.\n\n## Request apps on the Store\n\nVisit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).\n\n## Integration Hub subscription\n\nThis spoke requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf).\n\n## Spoke version\n\nThe Microsoft Azure Virtual Machine spoke v2.0.0 is the latest version. For version history of the spoke, see [Microsoft Azure Virtual Machine spoke release notes](https://www.servicenow.com/docs/r/store-release-notes/store-integrationhub-rn-microsoft-azure-virtual-machine.html).\n\n## Spoke dependencies\n\nIf you’re having trouble installing the app, ensure that these dependent plugins are installed:\n\n-   ServiceNow IntegrationHub Action Step - REST \\(com.glide.hub.action\\_step.rest\\)\n-   ServiceNow IntegrationHub Runtime \\(com.glide.hub.integration.runtime\\)\n-   ServiceNow Flow Designer - Dynamic Inputs \\(com.glide.hub.dynamic\\_inputs\\)\n-   Complex Object \\(com.glide.cobject\\)\n-   ServiceNow IntegrationHub Action Step - Get Connection Info \\(com.glide.hub.action\\_step.get\\_connection\\_info\\)\n-   ServiceNow IntegrationHub Action Template - Data Stream \\(com.glide.hub.action\\_type.datastream\\)\n-   Microsoft Azure Resource Management Spoke v2.0. After installing, you must configure the connection for the Microsoft Azure Resource Management Spoke v2.0 connection record to request OAuth tokens from the Microsoft Azure portal.\n\n**Note:** Some of these plugins are licensable features and require an appropriate license if used outside the spoke implementation. For information on licenses, contact your account manager.\n\n## Supported versions\n\nThis spoke was built for the Application Programming Interface \\(API\\) version 2024-03-01, but may be compatible with the later versions.\n\n## Spoke requirements\n\n-   Microsoft Azure Resource Management spoke \\(com.sn.ms.azure.resource.mgmt.spoke\\)\n-   Microsoft Azure Virtual Network spoke \\(com.sn.ms.azure.virtual.network.spoke\\)\n-   Microsoft Azure Managed Storage spoke \\(com.sn.ms.azure.managed.storage.spoke\\)\n\n## Spoke flows and subflows\n\nThis spoke has no flows or subflows.\n\n## Spoke actions\n\nThe Microsoft Azure Virtual Machine spoke provides actions to automate the Microsoft Azure Virtual Machine tasks when events occur in the ServiceNow instance. Available actions include:\n\n<table id=\"table_ejh_j5z_wlb\"><thead><tr><th>\n\nCategory\n\n</th><th>\n\nAction\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td rowspan=\"6\">\n\nImage Management\n\n</td><td>\n\nCreate Image from Virtual Machine\n\n</td><td>\n\nCreates an image from an existing virtual machine.\n\n</td></tr><tr><td>\n\nDelete Image\n\n</td><td>\n\nDeletes an image.**Note:** Use the Look up Operational Status of Resource' action from Azure Resource Management spoke to find the status of the operation.\n\n</td></tr><tr><td>\n\nLook up Image\n\n</td><td>\n\nRetrieves image information from a specified resource group.\n\n</td></tr><tr><td>\n\nLook up Images Stream by Resource Group\n\n</td><td>\n\nRetrieves the list of images under a Resource Group.\n\n</td></tr><tr><td>\n\nLook up Images Stream by Subscription ID\n\n</td><td>\n\nRetrieves the list of images in the subscription.\n\n</td></tr><tr><td>\n\nSet Tags on Image\n\n</td><td>\n\nSets the tags on image.**Note:** Use the Look up Operational Status of Resource' action from Azure Resource Management spoke to find the status of the operation.\n\n</td></tr><tr><td rowspan=\"16\">\n\nVirtual Machine Management\n\n</td><td>\n\nAttach Disk\n\n</td><td>\n\nAttaches data disk to the virtual machine.\n\n</td></tr><tr><td>\n\nCreate virtual machine.\n\n</td><td>\n\nCreates a virtual machine.\n\n</td></tr><tr><td>\n\nCreate Virtual Machine from Image\n\n</td><td>\n\nCreates virtual machines from an image.\n\n</td></tr><tr><td>\n\nDeallocate Virtual Machine\n\n</td><td>\n\nShuts down the virtual machine and releases the compute resources.\n\n</td></tr><tr><td>\n\nDelete Virtual Machine\n\n</td><td>\n\nDeletes a virtual machine.\n\n</td></tr><tr><td>\n\nDetach Disk\n\n</td><td>\n\nDetaches data disk from the virtual machine.**Note:** Use the Look up Operational Status of Resource' action from Azure Resource Management spoke to find the status of the operation.\n\n</td></tr><tr><td>\n\nGeneralize Virtual Machine\n\n</td><td>\n\nSets the OS state of the virtual machine to generalized.\n\n</td></tr><tr><td>\n\nLook up Virtual Machine\n\n</td><td>\n\nRetrieves information about a virtual machine.\n\n</td></tr><tr><td>\n\nLook up Virtual Machine Runtime Details\n\n</td><td>\n\nRetrieves the information about the run-time state of a virtual machine.\n\n</td></tr><tr><td>\n\nLook up Virtual Machines Stream by Resource Group\n\n</td><td>\n\nRetrieves the list of virtual machines under a Resource Group.\n\n</td></tr><tr><td>\n\nLook up Virtual Machines Stream by Subscription ID\n\n</td><td>\n\nRetrieves all virtual machines in the specified subscription.\n\n</td></tr><tr><td>\n\nPower Off Virtual Machine\n\n</td><td>\n\nPowers off a virtual machine or stops it.\n\n</td></tr><tr><td>\n\nRedeploy Virtual Machine\n\n</td><td>\n\nShuts down the virtual machine, moves it to a new node, and powers it back on.\n\n</td></tr><tr><td>\n\nResize Virtual Machine\n\n</td><td>\n\nResizes the specified virtual machine. **Note:** This operation can take a while to complete.\n\n</td></tr><tr><td>\n\nRestart Virtual Machine\n\n</td><td>\n\nRestarts a virtual machine.\n\n</td></tr><tr><td>\n\nStart Virtual Machine\n\n</td><td>\n\nStarts a virtual machine.\n\n</td></tr><tr><td>\n\nVirtual Machine Image Resource Management\n\n</td><td>\n\nLook up Virtual Machine Image\n\n</td><td>\n\nGets a virtual machine image.\n\n</td></tr></tbody>\n</table>## Connection and credential alias requirements\n\nIntegration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.\n\n## Set up the Microsoft Azure Virtual Machine Spoke\n\nTo execute the actions of the Microsoft Azure Virtual Machine Spoke, you must first install and configure the Microsoft Azure Resource Management Spoke. No separate configuration of the Microsoft Azure Virtual Machine Spoke is necessary. To view the procedure to set up the Microsoft Azure Resource Management Spoke, see [Set up the Microsoft Azure Resource Management spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-res-mngmt.md).\n\n"}}