你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
ServiceClient.Create 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
Create(String, AzureSasCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions) |
使用调用方根据需要提供并刷新的共享访问签名创建 ServiceClient。 |
Create(String, TokenCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions) |
创建 ServiceClient,在 Azure Active Directory (AAD) 中使用标识进行身份验证。 |
Create(String, AzureSasCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)
使用调用方根据需要提供并刷新的共享访问签名创建 ServiceClient。
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
参数
- hostName
- String
IoT 中心主机名。
- credential
- AzureSasCredential
用于生成 SAS 令牌以在 IoT 中心进行身份验证的凭据。 请参阅 AzureSasCredential。
- transportType
- TransportType
指定是使用 Amqp 还是 Amqp_WebSocket_Only 传输。
- transportSettings
- ServiceClientTransportSettings
指定服务客户端的AMQP_WS和 HTTP 代理设置。
- options
- ServiceClientOptions
允许在初始化期间配置服务客户端实例的选项。
返回
ServiceClient 实例。
注解
用户可能希望构建自己的共享访问签名 (SAS) 令牌,而不是将共享密钥提供给 SDK,并让 SDK 管理签名和续订。 对象 AzureSasCredential 向 SDK 授予对 SAS 令牌的访问权限,而调用方可以根据需要使用 Update(String) 方法更新它。
适用于
Create(String, TokenCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)
创建 ServiceClient,在 Azure Active Directory (AAD) 中使用标识进行身份验证。
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
参数
- hostName
- String
IoT 中心主机名。
- credential
- TokenCredential
用于在 IoT 中心进行身份验证的 Azure Active Directory 凭据。 请参见TokenCredential
- transportType
- TransportType
指定是使用 Amqp 还是 Amqp_WebSocket_Only 传输。
- transportSettings
- ServiceClientTransportSettings
指定服务客户端的AMQP_WS和 HTTP 代理设置。
- options
- ServiceClientOptions
允许在初始化期间配置服务客户端实例的选项。
返回
ServiceClient 实例。
注解
有关使用 派生实例进行身份验证的选项的详细信息 TokenCredential,请参阅 https://docs.microsoft.com/dotnet/api/overview/azure/identity-readme。 有关使用 Azure Active Directory 配置 IoT 中心的详细信息,请参阅 https://docs.microsoft.com/azure/iot-hub/iot-hub-dev-guide-azure-ad-rbac