ILoadBalancerService.AddNodeMetadataAsync Method

This API is preliminary and subject to change.

Updates the metadata associated with a load balancer node.

Namespace: net.openstack.Providers.Rackspace
Assembly: openstacknet (in openstacknet.dll) Version: 1.7.7+Branch.master.Sha.25d803f397c8693c2c13777ef6675f796f520f2c

Syntax

C++

Copy

Task<ReadOnlyCollection<LoadBalancerMetadataItem>> AddNodeMetadataAsync(
	LoadBalancerId loadBalancerId,
	NodeId nodeId,
	IEnumerable<KeyValuePair<string, string>> metadata,
	CancellationToken cancellationToken
)

Function AddNodeMetadataAsync ( 
	loadBalancerId As LoadBalancerId,
	nodeId As NodeId,
	metadata As IEnumerable(Of KeyValuePair(Of String, String)),
	cancellationToken As CancellationToken
) As Task(Of ReadOnlyCollection(Of LoadBalancerMetadataItem))

Task<ReadOnlyCollection<LoadBalancerMetadataItem^>^>^ AddNodeMetadataAsync(
	LoadBalancerId^ loadBalancerId, 
	NodeId^ nodeId, 
	IEnumerable<KeyValuePair<String^, String^>>^ metadata, 
	CancellationToken cancellationToken
)

abstract AddNodeMetadataAsync : 
        loadBalancerId : LoadBalancerId * 
        nodeId : NodeId * 
        metadata : IEnumerable<KeyValuePair<string, string>> * 
        cancellationToken : CancellationToken -> Task<ReadOnlyCollection<LoadBalancerMetadataItem>>

Parameters

loadBalancerId: Type: net.openstack.Providers.Rackspace.Objects.LoadBalancers.LoadBalancerId
The load balancer ID. This is obtained from LoadBalancer.Id.
nodeId: Type: net.openstack.Providers.Rackspace.Objects.LoadBalancers.NodeId
The load balancer node ID. This is obtained from Node.Id.
metadata: Type: System.Collections.Generic.IEnumerable<KeyValuePair<String, String>>
A collection of metadata items to associate with the node.
cancellationToken: Type: System.Threading.CancellationToken
The CancellationToken that the task will observe.

Return Value

Type: Task<ReadOnlyCollection<LoadBalancerMetadataItem>>
A Task object representing the asynchronous operation. When the operation completes successfully, the Result property will contain a a collection of LoadBalancerMetadataItem objects describing the updated metadata associated with the load balancer node.

Exceptions

Exception	Condition
ArgumentNullException	If loadBalancerId is null. -or- If nodeId is null. -or- If metadata is null.
ArgumentException	If metadata contains a pair whose Key is null or empty, or whose Value is is null.
WebException	If the REST request does not return successfully.

Exception

Condition

ArgumentNullException

If loadBalancerId is null.

-or-

If nodeId is null.

-or-

If metadata is null.

ArgumentException

If metadata contains a pair whose Key is null or empty, or whose Value is is null.

WebException

If the REST request does not return successfully.