Freigeben über


DigitalTwinsClient.InvokeCommandAsync Methode

Definition

Rufen Sie einen Befehl für einen digitalen Zwilling auf.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.InvokeDigitalTwinCommandResponse> InvokeCommandAsync (string digitalTwinId, string commandName, Microsoft.Azure.Devices.InvokeDigitalTwinCommandOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member InvokeCommandAsync : string * string * Microsoft.Azure.Devices.InvokeDigitalTwinCommandOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.InvokeDigitalTwinCommandResponse>
override this.InvokeCommandAsync : string * string * Microsoft.Azure.Devices.InvokeDigitalTwinCommandOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.InvokeDigitalTwinCommandResponse>
Public Overridable Function InvokeCommandAsync (digitalTwinId As String, commandName As String, Optional requestOptions As InvokeDigitalTwinCommandOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of InvokeDigitalTwinCommandResponse)

Parameter

digitalTwinId
String

Die ID des digitalen Zwillings.

commandName
String

Der aufzurufende Befehl.

requestOptions
InvokeDigitalTwinCommandOptions

Die optionalen Einstellungen für diese Anforderung.

cancellationToken
CancellationToken

Das cancellationToken.The cancellationToken.

Gibt zurück

Die aufrufantwort für serialisierte anwendung/json-befehle, die Befehlsantwort status Code und die Anforderungs-ID.

Ausnahmen

Wenn das bereitgestellte digitalTwinId oder commandName null ist.

Wenn der bereitgestellte digitalTwinId oder commandName leer oder Leerzeichen ist.

Wird ausgelöst, wenn IoT Hub auf die Anforderung mit einem nicht erfolgreichen status-Code geantwortet hat. Wenn beispielsweise die bereitgestellte Anforderung gedrosselt wurde, IotHubServiceException wird mit ThrottlingException ausgelöst. Eine vollständige Liste möglicher Fehlerfälle finden Sie unter IotHubServiceErrorCode.

Wenn die HTTP-Anforderung aufgrund eines zugrunde liegenden Problems fehlschlägt, z. B. Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung.

Wenn der bereitgestellte cancellationToken einen Abbruch angefordert hat.

Gilt für: