RoleEnvironmentTopologyChange Class


Represents a change to the topology of a role.

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

Inheritance Hierarchy



public class RoleEnvironmentTopologyChange : RoleEnvironmentChange, 
public ref class RoleEnvironmentTopologyChange : RoleEnvironmentChange, 
type RoleEnvironmentTopologyChange = 
        inherit RoleEnvironmentChange
        interface IEquatable<RoleEnvironmentTopologyChange>
Public Class RoleEnvironmentTopologyChange
    Inherits RoleEnvironmentChange
    Implements IEquatable(Of RoleEnvironmentTopologyChange)


Name Description
System_CAPS_pubproperty RoleName

Gets the name of the role for which the topology is changing.


Name Description
System_CAPS_pubmethod Equals(Object)

Determines whether the specified object is equal to the current object.(Overrides Object.Equals(Object).)

System_CAPS_pubmethod Equals(RoleEnvironmentTopologyChange)

Determines whether the specified RoleEnvironmentTopologyChange object is equal to the current object.

System_CAPS_protmethod Finalize()

(Inherited from Object.)

System_CAPS_pubmethod GetHashCode()

Retrieves the hash code that corresponds to the current object.(Overrides Object.GetHashCode().)

System_CAPS_pubmethod GetType()

(Inherited from Object.)

System_CAPS_protmethod MemberwiseClone()

(Inherited from Object.)

System_CAPS_pubmethod ToString()

(Inherited from Object.)


The topology refers to the number of instances and the number of endpoints that are defined for a role. For more information about service definitions, see Windows Azure Service Definition Schema.


At least one internal endpoint must be defined for a role in order to raise a RoleEnvironmentTopologyChange. For more information about defining endpoints, see Enable Communication for Role Instances in Windows Azure.


It is highly recommended that you configure the cloud service to run at least two instances of the role. When you deploy two or more role instances in different fault and upgrade domains, your Internet facing roles have external connectivity at least 99.95% of the time. For more information, see Service Level Agreements.

Thread Safety

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

See Also

Microsoft.WindowsAzure.ServiceRuntime Namespace

Return to top