Freigeben über


DigitalTwinsClient.InvokeComponentCommandAsync Methode

Definition

Rufen Sie einen Befehl für eine Komponente eines digitalen Zwillings auf.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.InvokeDigitalTwinCommandResponse> InvokeComponentCommandAsync (string digitalTwinId, string componentName, string commandName, Microsoft.Azure.Devices.InvokeDigitalTwinCommandOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member InvokeComponentCommandAsync : string * string * string * Microsoft.Azure.Devices.InvokeDigitalTwinCommandOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.InvokeDigitalTwinCommandResponse>
override this.InvokeComponentCommandAsync : string * string * string * Microsoft.Azure.Devices.InvokeDigitalTwinCommandOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.InvokeDigitalTwinCommandResponse>
Public Overridable Function InvokeComponentCommandAsync (digitalTwinId As String, componentName 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.

componentName
String

Der Komponentenname, unter dem der Befehl definiert ist.

commandName
String

Der befehl, der aufgerufen werden soll.

requestOptions
InvokeDigitalTwinCommandOptions

Die optionalen Einstellungen für diese Anforderung.

cancellationToken
CancellationToken

Der cancellationToken.

Gibt zurück

Die Aufrufantwort für serialisierte Anwendungen/JSON-Befehle, die Befehlsantwort status Code und die Anforderungs-ID.

Ausnahmen

Wenn das bereitgestellte digitalTwinId oder oder componentNamecommandName null ist.

Wenn das bereitgestellte digitalTwinId oder oder componentNamecommandName leer oder leer ist oder leer ist.

Wird ausgelöst, wenn IoT Hub auf die Anforderung mit einem nicht erfolgreichen status-Code reagiert 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 wie Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung fehlschlägt.

Wenn die bereitgestellte cancellationToken kündigung angefordert hat.

Gilt für: