Using automation with Virtual Machine Clouds

Atualizada: Agosto de 2014

Aplica-se a: Windows Azure Pack for Windows Server

You can use automation in Windows Azure Pack to orchestrate and integrate best-practice tasks to drive down the cost of datacenter operations, while improving the reliability of IT processes. You can integrate Service Management Automation with VM Clouds to trigger runbooks every time a specific event occurred in the VM Clouds infrastructure. The topic Register Service Management Automation for Virtual Machine Clouds provides instructions on how to associate VM Clouds with Service Management Automation. This topic provides instructions on how to associate Service Management Automation runbooks with events occurring in the context of VM Clouds. If you want to understand how VM Clouds integrates with Service Management Automation at an architectural level, see How is Service Provider Foundation associated with Service Management Automation?

For VM Clouds to trigger runbooks in Service Management Automation, the Service Management Automation web service certificate must be trusted on the computer running Service Provider Foundation.

  1. From the portal de gestão para administradores, click the VM Clouds tab.

  2. From the VM Clouds tab, click the Automation view.

  3. From the Automation view, from the command bar, click Add, and specify the following:

    1. For Action Category, select a VM Clouds object, an action on which triggers a Runbook. For the list of objects and the descriptions, see Objects that can be associated with runbooks.

    2. For the Action, select the action that must occur on the selected object for a Runbook to be triggered. Depending on the action category that you selected, the list of actions is populated with the available actions.

    3. For Runbook, select the Runbook that is triggered every time the specified action occurs on the selected object.

      For a Runbook to be available in this drop-down, it must include the “SPF” tag. For instructions on how to tag Runbooks, see Editing Runbook Properties. If you are using a non-Roman alphabet keyboard, repeat the following steps three times to include the “SPF” tag:

      1. Press and hold the ALT key.

      2. Press the + key on the number pad.

      3. Type the Unicode value 0053 for the letter S.

      4. Release the ALT key.

      5. Repeat these steps two more times by typing values 0050 (for P) and 0046 (for F).

    4. Select the Enable checkbox to enable the association between the object, the action, and the Runbook. This check box can be particularly useful in scenarios where you want the association between the runbooks and events in VM Clouds to come into effect at a later date or time.

    5. Click the check mark to save your changes.

In the portal de gestão, when you link an action with a runbook on the Automation tab in Virtual Machine Clouds you must choose the following:

  • An Action Category, such as an Administrator or Tenant, and can also include all resource providers such as usage and notifications.

  • Depending on the category you selected, select the Action. This selects the object whose actions, such as being deleted or updated, can be ascertained and associated with a runbook.

  • A Runbook to associate with the action.

The following sections list the objects and the CRUD (Create, Read, Update, and Delete) operations that trigger actions when accessed by web service calls using HTTPS, or when the tenant or administrator changes the state of an object using the portal de gestão para administradores, portal de gestão para inquilinos, or System Center 2012 R2 Virtual Machine Manager. For more information on the URLs that access these objects, see Service Management API and Service Provider Foundation URLs.

The subscription object represents a subscription that is created every time a tenant subscribes to a plan. It is triggered by the following actions:

  • CRUD actions: Create, Update, Delete

  • State actions: Activate, Suspend

The following table describes the objects accessed with the spfVMM.MicrosoftCompute prefix, and the operations that trigger an action on these objects.


Object Description CRUD actions State actions


A container for a VMRole. Multiple VM roles can be created under a CloudService.For tenants, a cloud service is created for every VMRole deployed using the portal de gestão para inquilinos.

APIs can create more than one VMRole within any given cloud service, and are not restricted to a one-to-one relationship as required when created by a tenant.

Create, Update, Delete


A child virtual machine within a VM role.


Restart, Shutdown, Start, Stop


A scalable tier for peer VM nodes.

Create, Update, Delete

Repair, Scale


The disks attached to a VMRole.

Create, Update, Delete

The following table describes the objects accessed with the spfAdmin prefix, and the operations that trigger an action on these objects.


Object Description CRUD operation State operations


a mapping between an event in the API and the associated automation.

Create, Update


A user role that maps to an SSU (self-service user) in VMM.

Create, Update, Delete


Any server running Service Provider Foundation.

Create, Update, Delete


A connection string for either a database connection or for a portal endpoint connection to an Operations Manager data warehouse.

Create, Delete


A logical scale unit for servers and instances of System Center components. Typically a stamp represents one VMM server.

Create, Update, Delete


A tenant.

Create, Update, Delete


A trusted party used for claims-based authentication.

Create, Delete


A virtual machine.


Pause, Restart, Resume, Shutdown, Start, Stop


A virtual machine role.



A gallery item object that encapsulates the template using which multi-node VM tiers can be created.


Publish, Unpublish

The following table describes the objects accessed with the spfVMM prefix, and the operations that trigger an action.


Object Description CRUD actions State actions


The border gateway protocol.

Create, Delete


The hardware profiles in VMM the define the hardware attributes of a virtual machine.



A task in VMM and indicates the status of operation in VMM.



A container of NATRule objects.

Create, Update, Delete


The inbound port-mapping rule for a VM network.

Create, Delete


The VMM RunAs Account.

Create, Update, Delete


A VMM service.

Create, Update, Delete


a VMM service template



A VMM static IP address pool.

Create, Delete


A VMM user role. A user role can be self-service user, tenant admin, or administrator. This object can be used for applying permissions and scopes.

Create, Update, Delete


A VMM virtual disk drive.

Create, Delete


A VMM virtual DVD drive

Create, Update, Delete


A standalone virtual machine.

Update, Delete


A VMM virtual network adapter (vNIC).

Create, Update, Delete


A VMM virtual SCSI adapter.

Create, Delete


A VMM checkpoint

Create, Update, Delete


A VM network or a virtual network. A virtual machine is connected to a VM network using a virtual network adapter (vNIC).

Update, Delete


a VMM network gateway. A gateway allows border gateway protocol, NAT, and VPN to be configured on a VM network.

Create, Update, Delete


a VM subnet and defines subnet ranges within a VM network

Create, Delete


A VMM virtual machine template used to create virtual machines.



A VMM VPN connection. This is mapped to the site-to-site VPN connection in the portal. It allows virtual machines on a VM network to connect remotely to another site.

Create, Update, Delete


A VMM VPN network route. Routes allow virtual machines on a VM network to be able to locate other computers on the remote network on the other end of the VPN connection.

Create, Delete

Consulte Também