Iot Hub Resource - List Keys
IoT hub'ına yönelik güvenlik meta verilerini alın. Daha fazla bilgi için, bkz. https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-security.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/listkeys?api-version=2023-06-30
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
resource
|
path | True |
string |
IoT hub'ını içeren kaynak grubunun adı. |
resource
|
path | True |
string |
IoT hub'ının adı. |
subscription
|
path | True |
string |
Abonelik tanımlayıcısı. |
api-version
|
query | True |
string |
API sürümü. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Bu zaman uyumlu bir işlemdir. Gövde, IoT hub uç noktalarına erişmek için kullanabileceğiniz anahtarlar da dahil olmak üzere JSON serileştirilmiş bir paylaşılan erişim ilkeleri dizisi içerir. |
|
Other Status Codes |
DefaultErrorResponse |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
IotHubResource_ListKeys
Örnek isteği
Örnek yanıt
{
"value": [
{
"keyName": "iothubowner",
"primaryKey": "<primaryKey>",
"secondaryKey": "<secondaryKey>",
"rights": "RegistryWrite, ServiceConnect, DeviceConnect"
},
{
"keyName": "service",
"primaryKey": "<primaryKey>",
"secondaryKey": "<secondaryKey>",
"rights": "ServiceConnect"
},
{
"keyName": "device",
"primaryKey": "<primaryKey>",
"secondaryKey": "<secondaryKey>",
"rights": "DeviceConnect"
},
{
"keyName": "registryRead",
"primaryKey": "<primaryKey>",
"secondaryKey": "<secondaryKey>",
"rights": "RegistryRead"
},
{
"keyName": "registryReadWrite",
"primaryKey": "<primaryKey>",
"secondaryKey": "<secondaryKey>",
"rights": "RegistryWrite"
}
]
}
Tanımlar
Name | Description |
---|---|
Access |
Paylaşılan erişim ilkesine atanan izinler. |
Error |
Hata ayrıntıları. |
Shared |
IoT hub paylaşılan erişim ilkesinin özellikleri. |
Shared |
Bir sonraki bağlantıya sahip paylaşılan erişim ilkelerinin listesi. |
AccessRights
Paylaşılan erişim ilkesine atanan izinler.
Name | Tür | Description |
---|---|---|
DeviceConnect |
string |
|
RegistryRead |
string |
|
RegistryRead, DeviceConnect |
string |
|
RegistryRead, RegistryWrite |
string |
|
RegistryRead, RegistryWrite, DeviceConnect |
string |
|
RegistryRead, RegistryWrite, ServiceConnect |
string |
|
RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect |
string |
|
RegistryRead, ServiceConnect |
string |
|
RegistryRead, ServiceConnect, DeviceConnect |
string |
|
RegistryWrite |
string |
|
RegistryWrite, DeviceConnect |
string |
|
RegistryWrite, ServiceConnect |
string |
|
RegistryWrite, ServiceConnect, DeviceConnect |
string |
|
ServiceConnect |
string |
|
ServiceConnect, DeviceConnect |
string |
ErrorDetails
Hata ayrıntıları.
Name | Tür | Description |
---|---|---|
code |
string |
Hata kodu. |
details |
string |
Hata ayrıntıları. |
httpStatusCode |
string |
HTTP durum kodu. |
message |
string |
Hata iletisi. |
SharedAccessSignatureAuthorizationRule
IoT hub paylaşılan erişim ilkesinin özellikleri.
Name | Tür | Description |
---|---|---|
keyName |
string |
Paylaşılan erişim ilkesinin adı. |
primaryKey |
string |
Birincil anahtar. |
rights |
Paylaşılan erişim ilkesine atanan izinler. |
|
secondaryKey |
string |
İkincil anahtar. |
SharedAccessSignatureAuthorizationRuleListResult
Bir sonraki bağlantıya sahip paylaşılan erişim ilkelerinin listesi.
Name | Tür | Description |
---|---|---|
nextLink |
string |
Sonraki bağlantı. |
value |
Paylaşılan erişim ilkelerinin listesi. |