ServiceClient.Create Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.ServiceClientPublic 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 ServiceClientParâ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
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.ServiceClientPublic 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 ServiceClientParâ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
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
Azure SDK for .NET