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)

System.Object
  Microsoft.WindowsAzure.ServiceRuntime.RoleInstance

public abstract class RoleInstance

NameDescription
System_CAPS_pubpropertyFaultDomain

Gets an integer value that indicates the fault domain in which the role instance is running.

System_CAPS_pubpropertyId

Gets the instance identifier (ID) of the role instance.

System_CAPS_pubpropertyInstanceEndpoints

Gets the set of endpoints that are associated with the role instance.

System_CAPS_pubpropertyRole

Gets the Role object that is associated with the role instance.

System_CAPS_pubpropertyUpdateDomain

Gets an integer value that indicates the update domain in which the role instance is running.

System_CAPS_pubpropertyVirtualIPGroups

NameDescription
System_CAPS_pubmethodEquals(Object)

(Inherited from Object.)

System_CAPS_protmethodFinalize()

(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

(Inherited from Object.)

System_CAPS_pubmethodGetType()

(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

(Inherited from Object.)

System_CAPS_pubmethodToString()

(Inherited from Object.)

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.

Return to top
Show: