IIotHubResourceOperations.CreateOrUpdateWithHttpMessagesAsync(String, String, IotHubDescription, String, Dictionary<String,List<String>>, CancellationToken) Method

Definition

Create or update the metadata of an IoT hub.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.Management.IotHub.Models.IotHubDescription>> CreateOrUpdateWithHttpMessagesAsync (string resourceGroupName, string resourceName, Microsoft.Azure.Management.IotHub.Models.IotHubDescription iotHubDescription, string ifMatch = null, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = null, System.Threading.CancellationToken cancellationToken = null);
abstract member CreateOrUpdateWithHttpMessagesAsync : string * string * Microsoft.Azure.Management.IotHub.Models.IotHubDescription * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.Management.IotHub.Models.IotHubDescription>>

Parameters

resourceGroupName
System.String

The name of the resource group that contains the IoT hub.

resourceName
System.String

The name of the IoT hub.

iotHubDescription
IotHubDescription

The IoT hub metadata and security metadata.

ifMatch
System.String

ETag of the IoT Hub. Do not specify for creating a brand new IoT Hub. Required to update an existing IoT Hub.

customHeaders
System.Collections.Generic.Dictionary<System.String,System.Collections.Generic.List<System.String>>

The headers that will be added to request.

cancellationToken
System.Threading.CancellationToken

The cancellation token.

Returns

System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<IotHubDescription>>

Exceptions

Thrown when the operation returned an invalid status code

Thrown when unable to deserialize the response

Thrown when a required parameter is null

Remarks

Create or update the metadata of an Iot hub. The usual pattern to modify a property is to retrieve the IoT hub metadata and security metadata, and then combine them with the modified values in a new body to update the IoT hub.

Applies to