SALES: 1-800-867-1380

RoleInstance Class

Updated: December 6, 2013

Represents an instance of a role.

Namespace: Microsoft.WindowsAzure.ServiceRuntime
Assembly: Microsoft.WindowsAzure.ServiceRuntime (in Microsoft.WindowsAzure.ServiceRuntime.dll)

public ref class RoleInstance abstract

A hosted service in Azure can be defined to contain web roles, worker roles, and VM roles. A role is a component of an application that performs specific functionality. A role instance is a running copy of the role in Azure or the Azure Compute Emulator. Roles are defined in the service model for the hosted service. For more information, see Setting Up a Hosted Service for Azure.

The following code example shows how to retrieve information about role instances:

foreach (var role in RoleEnvironment.Roles) 
   foreach (var roleInstance in role.Value.Instances)      
      Trace.WriteLine("Role Instance ID: " + roleInstance.Id, "Information");
      foreach (RoleInstanceEndpoint instanceEndpoint in roleInstance.InstanceEndpoints.Values) 
         Trace.WriteLine("Instance endpoint IP address and port: " + instanceEndpoint.IPEndpoint, "Information"); 
      Trace.WriteLine("Role instance fault domain: " + roleInstance.FaultDomain, "Information");
      Trace.WriteLine("Role for the instance: " + roleInstance.Role.Name, "Information");
      Trace.WriteLine("Role instance update domain: " + roleInstance.UpdateDomain, "Information");


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Development Platforms

Windows Vista, Windows 7 and Windows Server 2008

Target Platforms

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2014 Microsoft