RoleEnvironmentTopologyChange Class

Article
08/18/2015

Represents a change to the topology of a role.

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

Inheritance Hierarchy

System.Object
Microsoft.WindowsAzure.ServiceRuntime.RoleEnvironmentChange
Microsoft.WindowsAzure.ServiceRuntime.RoleEnvironmentTopologyChange

Syntax

public class RoleEnvironmentTopologyChange : RoleEnvironmentChange, 
    IEquatable<RoleEnvironmentTopologyChange>

public ref class RoleEnvironmentTopologyChange : RoleEnvironmentChange, 
    IEquatable<RoleEnvironmentTopologyChange^>

type RoleEnvironmentTopologyChange = 
    class
        inherit RoleEnvironmentChange
        interface IEquatable<RoleEnvironmentTopologyChange>
    end

Public Class RoleEnvironmentTopologyChange
    Inherits RoleEnvironmentChange
    Implements IEquatable(Of RoleEnvironmentTopologyChange)

Properties

	Name	Description
	RoleName	Gets the name of the role for which the topology is changing.

Methods

	Name	Description
	Equals(Object)	Determines whether the specified object is equal to the current object.(Overrides Object.Equals(Object).)
	Equals(RoleEnvironmentTopologyChange)	Determines whether the specified RoleEnvironmentTopologyChange object is equal to the current object.
	Finalize()	(Inherited from Object.)
	GetHashCode()	Retrieves the hash code that corresponds to the current object.(Overrides Object.GetHashCode().)
	GetType()	(Inherited from Object.)
	MemberwiseClone()	(Inherited from Object.)
	ToString()	(Inherited from Object.)

Remarks

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.

Note

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.

Important

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.