ConfigurationsClient.SetAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Devices

Ensamblado:

Microsoft.Azure.Devices.dll

Paquete:

Microsoft.Azure.Devices v2.0.0-preview002

reemplace los campos mutables del registro de configuración.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.Configuration> SetAsync (Microsoft.Azure.Devices.Configuration configuration, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);

abstract member SetAsync : Microsoft.Azure.Devices.Configuration * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Configuration>
override this.SetAsync : Microsoft.Azure.Devices.Configuration * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Configuration>

Public Overridable Function SetAsync (configuration As Configuration, Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Configuration)

Parámetros

configuration

Configuration

Objeto de configuración con campos reemplazados.

onlyIfUnchanged

Boolean

Si es false, esta operación se realizará incluso si la identidad del dispositivo proporcionada tiene una ETag obsoleta. Si es true, la operación iniciará una IotHubServiceException excepción con PreconditionFailed si la configuración proporcionada tiene una ETag obsoleta. Una ETag actualizada se puede recuperar mediante GetAsync(String, CancellationToken).

cancellationToken

CancellationToken

Token que permite cancelar la operación.

Devoluciones

Task<Configuration>

Objeto de configuración con ETags reemplazados.

Excepciones

ArgumentNullException

Se produce cuando el proporcionado configuration es NULL.

IotHubServiceException

Se produce si IoT Hub respondió a la solicitud con un código de estado no correcto. Por ejemplo, si se ha limitado la solicitud proporcionada, IotHubServiceException se produce con ThrottlingException . Para obtener una lista completa de posibles casos de error, vea IotHubServiceErrorCode.

HttpRequestException

Si se produce un error en la solicitud HTTP debido a un problema subyacente, como la conectividad de red, el error dns o la validación del certificado de servidor.

OperationCanceledException

Si el token de cancelación proporcionado ha solicitado la cancelación.