Iot Hub Resource - List Keys
IoT ハブのセキュリティ メタデータを取得します。 詳細については、「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 パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
resource
|
path | True |
string |
IoT ハブを含むリソース グループの名前。 |
resource
|
path | True |
string |
IoT ハブの名前。 |
subscription
|
path | True |
string |
サブスクリプションの識別子です。 |
api-version
|
query | True |
string |
API のバージョン。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
これは同期操作です。 本文には、IoT ハブ エンドポイントへのアクセスに使用できるキーを含む、共有アクセス ポリシーの JSON でシリアル化された配列が含まれています。 |
|
Other Status Codes |
DefaultErrorResponse |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
例
IotHubResource_ListKeys
要求のサンプル
応答のサンプル
{
"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"
}
]
}
定義
名前 | 説明 |
---|---|
Access |
共有アクセス ポリシーに割り当てられたアクセス許可。 |
Error |
エラーの詳細。 |
Shared |
IoT ハブの共有アクセス ポリシーのプロパティ。 |
Shared |
次のリンクを含む共有アクセス ポリシーの一覧。 |
AccessRights
共有アクセス ポリシーに割り当てられたアクセス許可。
名前 | 型 | 説明 |
---|---|---|
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
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラー コード。 |
details |
string |
エラーの詳細です。 |
httpStatusCode |
string |
HTTP 状態コード。 |
message |
string |
エラー メッセージ。 |
SharedAccessSignatureAuthorizationRule
IoT ハブの共有アクセス ポリシーのプロパティ。
名前 | 型 | 説明 |
---|---|---|
keyName |
string |
共有アクセス ポリシーの名前。 |
primaryKey |
string |
主キー。 |
rights |
共有アクセス ポリシーに割り当てられたアクセス許可。 |
|
secondaryKey |
string |
セカンダリ キー。 |
SharedAccessSignatureAuthorizationRuleListResult
次のリンクを含む共有アクセス ポリシーの一覧。
名前 | 型 | 説明 |
---|---|---|
nextLink |
string |
次のリンク。 |
value |
共有アクセス ポリシーの一覧。 |