Partilhar via

ServiceClient.Create Método

  • Referência

Definição

Namespace:
Microsoft.Azure.Devices
Assembly:
Microsoft.Azure.Devices.dll
Pacote:
Microsoft.Azure.Devices v1.38.1

Sobrecargas

Create(String, AzureSasCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)

Cria o ServiceClient usando uma assinatura de acesso compartilhado fornecida e atualizada conforme necessário pelo chamador.
Create(String, TokenCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)

Cria o ServiceClient, autenticando-se usando uma identidade no AAD (Azure Active Directory).

Create(String, AzureSasCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)

Cria o ServiceClient usando uma assinatura de acesso compartilhado fornecida e atualizada conforme necessário pelo chamador.

public static Microsoft.Azure.Devices.ServiceClient Create (string hostName, Azure.AzureSasCredential credential, Microsoft.Azure.Devices.TransportType transportType = Microsoft.Azure.Devices.TransportType.Amqp, Microsoft.Azure.Devices.ServiceClientTransportSettings transportSettings = default, Microsoft.Azure.Devices.ServiceClientOptions options = default);
static member Create : string * Azure.AzureSasCredential * Microsoft.Azure.Devices.TransportType * Microsoft.Azure.Devices.ServiceClientTransportSettings * Microsoft.Azure.Devices.ServiceClientOptions -> Microsoft.Azure.Devices.ServiceClient
Public Shared Function Create (hostName As String, credential As AzureSasCredential, Optional transportType As TransportType = Microsoft.Azure.Devices.TransportType.Amqp, Optional transportSettings As ServiceClientTransportSettings = Nothing, Optional options As ServiceClientOptions = Nothing) As ServiceClient

Parâmetros

hostName
String

Nome do host do Hub IoT.

credential
AzureSasCredential

Credencial que gera um token SAS para autenticar com o Hub IoT. Consulte AzureSasCredential.

transportType
TransportType

Especifica se o transporte amqp ou Amqp_WebSocket_Only é usado.

transportSettings
ServiceClientTransportSettings

Especifica as configurações de proxy HTTP e AMQP_WS para o cliente de serviço.

options
ServiceClientOptions

As opções que permitem a configuração da instância do cliente de serviço durante a inicialização.

Retornos

ServiceClient

Uma instância do ServiceClient.

Comentários

Os usuários podem querer criar seus próprios tokens SAS (assinatura de acesso compartilhado) em vez de dar a chave compartilhada ao SDK e permitir que ele gerencie a assinatura e a renovação. O AzureSasCredential objeto fornece ao SDK acesso ao token SAS, enquanto o chamador pode atualizá-lo conforme necessário usando o Update(String) método .

Aplica-se a

Create(String, TokenCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)

Cria o ServiceClient, autenticando-se usando uma identidade no AAD (Azure Active Directory).

public static Microsoft.Azure.Devices.ServiceClient Create (string hostName, Azure.Core.TokenCredential credential, Microsoft.Azure.Devices.TransportType transportType = Microsoft.Azure.Devices.TransportType.Amqp, Microsoft.Azure.Devices.ServiceClientTransportSettings transportSettings = default, Microsoft.Azure.Devices.ServiceClientOptions options = default);
static member Create : string * Azure.Core.TokenCredential * Microsoft.Azure.Devices.TransportType * Microsoft.Azure.Devices.ServiceClientTransportSettings * Microsoft.Azure.Devices.ServiceClientOptions -> Microsoft.Azure.Devices.ServiceClient
Public Shared Function Create (hostName As String, credential As TokenCredential, Optional transportType As TransportType = Microsoft.Azure.Devices.TransportType.Amqp, Optional transportSettings As ServiceClientTransportSettings = Nothing, Optional options As ServiceClientOptions = Nothing) As ServiceClient

Parâmetros

hostName
String

Nome do host do Hub IoT.

credential
TokenCredential

Credenciais do Azure Active Directory para autenticar com o Hub IoT. Veja TokenCredential

transportType
TransportType

Especifica se o transporte amqp ou Amqp_WebSocket_Only é usado.

transportSettings
ServiceClientTransportSettings

Especifica as configurações de proxy HTTP e AMQP_WS para o cliente de serviço.

options
ServiceClientOptions

As opções que permitem a configuração da instância do cliente de serviço durante a inicialização.

Retornos

ServiceClient

Uma instância do ServiceClient.

Comentários

Para obter mais informações sobre as opções de autenticação usando uma instância derivada do TokenCredential, consulte https://docs.microsoft.com/dotnet/api/overview/azure/identity-readme. Para obter mais informações sobre como configurar o Hub IoT com o Azure Active Directory, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-dev-guide-azure-ad-rbac

Aplica-se a