Meraki Dashboard APIには使用頻度が高い参照系のAPIがあるため、Meraki用語を構造的に整理しながらドキュメントへのリンク集のように整理しました。
Meraki用語のイメージ化
Meraki用語を構造的にイメージ化して表現すると下記のようになります。
Meraki Cloud Architecture
や Meraki Dashboard Organizational Structure
のドキュメントにもMeraki用語をイメージ化したものがありますが、筆者が作成したイメージ図はAPI利用観点での補足情報を追加しております。
使用頻度が高い参照系のMeraki Dashboard API
Meraki Dashboard APIでは操作の対象を特定するために、Organization ID (organizationId
), Network ID (networkId
), Serial Number (serial
)を引数に取るケースが多くなります。
筆者は新しく実装されたAPIでどのようなことが実現できるかを偶に調べる機会があり、その度に引数に与える情報を調べるのが手間になっていたので使用頻度が高いものをまとめました。
Get Organizations
Merakiアカウントに紐付くOrganizationの確認に利用します。Web UIではMSP (Managed Service Providers) Portalの画面に相当します。
https://developer.cisco.com/meraki/api-v1/#!get-organizations
GET /organizations
Get Organization Networks
Organizationに紐付くNetworkの確認に利用します。
https://developer.cisco.com/meraki/api-v1/#!get-organization-networks
GET /organizations/{organizationId}/networks
Get Organization Inventory Devices
Organizationに紐付くMerakiデバイスの確認に利用します。特にMerakiデバイスのSerial Number情報を確認するのに役に立ちます。 また、Merakiデバイスの所属先のNetworkを特定するのにも利用できます。
https://developer.cisco.com/meraki/api-v1/#!get-organization-inventory-devices
GET /organizations/{organizationId}/inventory/devices