Az Azure-irányítópultok szerkezete
Ez a dokumentum végigvezeti egy Azure-irányítópult szerkezetén, példaként az alábbi irányítópultot használva:
Mivel a megosztott Azure-irányítópultok erőforrások, ez az irányítópult JSON-ként jelenhet meg. Az irányítópult JSON-ábrázolását az Exportálás, majd a Letöltés lehetőséget választva töltheti le a Azure Portal.
A következő JSON a fent látható irányítópultot jelöli.
{
{
"properties": {
"lenses": {
"0": {
"order": 0,
"parts": {
"0": {
"position": {
"x": 0,
"y": 0,
"colSpan": 3,
"rowSpan": 2
},
"metadata": {
"inputs": [],
"type": "Extension/HubsExtension/PartType/MarkdownPart",
"settings": {
"content": {
"settings": {
"content": "## Azure Virtual Machines Overview\r\nNew team members should watch this video to get familiar with Azure Virtual Machines.",
"markdownUri": null
}
}
}
}
},
"1": {
"position": {
"x": 3,
"y": 0,
"colSpan": 8,
"rowSpan": 4
},
"metadata": {
"inputs": [],
"type": "Extension/HubsExtension/PartType/MarkdownPart",
"settings": {
"content": {
"settings": {
"content": "This is the team dashboard for the test VM we use on our team. Here are some useful links:\r\n\r\n1. [Create a Linux virtual machine](https://docs.microsoft.com/azure/virtual-machines/linux/quick-create-portal)\r\n1. [Create a Windows virtual machine](https://docs.microsoft.com/azure/virtual-machines/windows/quick-create-portal)\r\n1. [Create a virtual machine scale set](https://docs.microsoft.com/azure/virtual-machine-scale-sets/quick-create-portal)",
"title": "Test VM Dashboard",
"subtitle": "Contoso",
"markdownUri": null
}
}
}
}
},
"2": {
"position": {
"x": 0,
"y": 2,
"colSpan": 3,
"rowSpan": 2
},
"metadata": {
"inputs": [],
"type": "Extension/HubsExtension/PartType/VideoPart",
"settings": {
"content": {
"settings": {
"src": "https://www.youtube.com/watch?v=rOiSRkxtTeU",
"autoplay": false
}
}
}
}
},
"3": {
"position": {
"x": 0,
"y": 4,
"colSpan": 11,
"rowSpan": 3
},
"metadata": {
"inputs": [
{
"name": "queryInputs",
"value": {
"timespan": {
"duration": "PT1H"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1",
"chartType": 0,
"metrics": [
{
"name": "Percentage CPU",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
]
}
}
],
"type": "Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart",
"settings": {}
}
},
"4": {
"position": {
"x": 0,
"y": 7,
"colSpan": 3,
"rowSpan": 2
},
"metadata": {
"inputs": [
{
"name": "queryInputs",
"value": {
"timespan": {
"duration": "PT1H"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1",
"chartType": 0,
"metrics": [
{
"name": "Disk Read Operations/Sec",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
},
{
"name": "Disk Write Operations/Sec",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
]
}
}
],
"type": "Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart",
"settings": {}
}
},
"5": {
"position": {
"x": 3,
"y": 7,
"colSpan": 3,
"rowSpan": 2
},
"metadata": {
"inputs": [
{
"name": "queryInputs",
"value": {
"timespan": {
"duration": "PT1H"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1",
"chartType": 0,
"metrics": [
{
"name": "Disk Read Bytes",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
},
{
"name": "Disk Write Bytes",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
]
}
}
],
"type": "Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart",
"settings": {}
}
},
"6": {
"position": {
"x": 6,
"y": 7,
"colSpan": 3,
"rowSpan": 2
},
"metadata": {
"inputs": [
{
"name": "queryInputs",
"value": {
"timespan": {
"duration": "PT1H"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1",
"chartType": 0,
"metrics": [
{
"name": "Network In Total",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
},
{
"name": "Network Out Total",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
]
}
}
],
"type": "Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart",
"settings": {}
}
},
"7": {
"position": {
"x": 9,
"y": 7,
"colSpan": 2,
"rowSpan": 2
},
"metadata": {
"inputs": [
{
"name": "id",
"value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
],
"type": "Extension/HubsExtension/PartType/ResourcePart",
"asset": {
"idInputName": "id",
"type": "VirtualMachine"
}
}
}
}
}
},
"metadata": {
"model": {
"timeRange": {
"value": {
"relative": {
"duration": 24,
"timeUnit": 1
}
},
"type": "MsPortalFx.Composition.Configuration.ValueTypes.TimeRange"
}
}
}
},
"name": "Simple VM Dashboard",
"type": "Microsoft.Portal/dashboards",
"location": "INSERT LOCATION",
"tags": {
"hidden-title": "Simple VM Dashboard"
},
"apiVersion": "2015-08-01-preview"
}
Gyakori erőforrás-tulajdonságok
Bontsuk le a JSON vonatkozó szakaszait. A gyakori erőforrás-tulajdonságok a fenti példa végén jelennek meg. Ezek a tulajdonságok minden Azure-erőforrástípusban meg vannak osztva. Ezek nem kapcsolódnak kifejezetten az irányítópult tartalmához.
ID (Azonosító)
Az ID
az irányítópult Azure-erőforrás-azonosítóját jelöli, az Azure-erőforrások elnevezési konvencióktól függően. Amikor a portál létrehoz egy irányítópultot, általában guid formában választ ki egy azonosítót, de bármilyen érvényes nevet használhat az irányítópult programozott létrehozásakor.
Amikor exportál egy irányítópultot a Azure Portal, a id
mező nem lesz benne. Ha új irányítópultot hoz létre a mezőt tartalmazó id
JSON-fájl importálásával, a rendszer figyelmen kívül hagyja az értéket, és minden új irányítópulthoz új azonosítóértéket rendel.
Name
Az irányítópulthoz használt erőforrásnév, amelyet Azure Portal használ.
Típus
Minden irányítópult típusa Microsoft.Portal/dashboards
.
Hely
A többi erőforrástól eltérően az irányítópultok nem rendelkeznek futtatókörnyezeti összetevővel. Az irányítópultok esetében a "location" az irányítópult JSON-ábrázolásait tároló elsődleges földrajzi helyet jelöli. Az értéknek az egyik olyan helykódnak kell lennie, amely lekérhető az előfizetések erőforrás locations API-jának használatával.
Címkék
A címkék az Azure-erőforrások egyik gyakori funkciója, amellyel tetszőleges névértékpárok alapján rendszerezheti az erőforrást. Az irányítópultok egy speciális címkét tartalmaznak, amelynek a neve hidden-title
. Ha az irányítópulton fel van töltve ez a tulajdonság, akkor a rendszer ezt az értéket használja az irányítópult megjelenítendő neveként a portálon. Ez a címke lehetővé teszi, hogy átnevezhető megjelenítendő nevet adjon az irányítópultnak
Tulajdonságok
A properties objektum két tulajdonságot tartalmaz, lenses
és metadata
. A lenses
tulajdonság információkat tartalmaz az irányítópult csempéiről. A metadata
tulajdonság a lehetséges jövőbeli funkciók számára van fenntartva.
Lencsék
A lenses
tulajdonság tartalmazza az irányítópultot. A példában szereplő objektívobjektum egyetlen "0" tulajdonságot tartalmaz. A objektívek olyan csoportosítási koncepciók, amelyek jelenleg nincsenek implementálva. Egyelőre az összes irányítópulton ez az egyetlen "0" tulajdonság található a lencseobjektumon.
Részek
A "0" alatt lévő objektum két tulajdonságot tartalmaz, order
és parts
. order
Jelenleg mindig 0 értékre van állítva. A parts
tulajdonság egy objektumot tartalmaz, amely meghatározza az irányítópult egyes részeit (más néven csempéket).
Az parts
objektum minden részhez tartalmaz egy tulajdonságot, ahol a tulajdonság neve egy szám. A szám nem jelentős.
Minden egyes részobjektum tartalmazza a és metadata
a position
elemet.
Pozíció
A position
tulajdonság a rész méret- és helyadatait tartalmazza, a , y
a rowSpan
és colSpan
a értékben x
kifejezve. Az értékek a rácsegységek szempontjából vannak. Ezek a rácsegységek akkor jelennek meg, ha az irányítópult testreszabási módban van az itt látható módon.
Ha például azt szeretné, hogy egy csempe szélessége két rácsegység, egy rácsegység magassága és egy hely legyen az irányítópult bal felső sarkában, akkor a pozícióobjektum a következőképpen néz ki:
position: { x: 0, y: 0, rowSpan: 2, colSpan: 1 }
Metaadatok
Minden rész rendelkezik metaadat-tulajdonságkal. Egy objektumnak csak egy kötelező tulajdonsága van: type
. Ez a sztring jelzi a portálnak, hogy melyik csempetípust szeretné megjeleníteni. A példa irányítópultja az alábbi típusú csempéket használja:
Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart
– Monitorozási metrikák megjelenítésére szolgálExtension[azure]/HubsExtension/PartType/MarkdownPart
– Testre szabott markdown-tartalmak, például szöveg vagy képek megjelenítésére szolgál, listák, hivatkozások stb. alapszintű formázásával.Extension[azure]/HubsExtension/PartType/VideoPart
– A YouTube-ról, a Channel 9-ről és bármilyen más típusú videóról készült videók megjelenítésére szolgál, amelyek HTML videócímkében működnek.
Minden egyes alkatrésztípus saját konfigurációs lehetőségekkel rendelkezik. A lehetséges konfigurációs tulajdonságok neve inputs
, settings
, és asset
.
Bevitelek
A bemeneti objektum általában olyan információkat tartalmaz, amelyek egy csempét egy erőforráspéldányhoz kötnek.
Példánk MetricsChartPart
mindegyikében egyetlen bemenet található, amely kifejezi a virtuális gép Azure-erőforrás-azonosítóját, valamint a megjelenített adatokkal kapcsolatos információkat. Itt látható például a inputs
csempe objektuma, amely a Network In Total és a Network Out Total metrikákat jeleníti meg.
"inputs":
[
{
"name": "queryInputs",
"value": {
"timespan": {
"duration": "PT1H"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1",
"chartType": 0,
"metrics": [
{
"name": "Network In Total",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
},
{
"name": "Network Out Total",
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SimpleWinVMResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
}
]
}
}
]
Beállítások
A beállítások objektum egy rész konfigurálható elemeit tartalmazza. A minta irányítópulton a Markdown-rész beállításokat használ az egyéni Markdown-tartalmak tárolására, valamint egy konfigurálható címet és alcímet.
"settings": {
"content": {
"settings": {
"content": "This is the team dashboard for the test VM we use on our team. Here are some useful links:\r\n\r\n1. [Create a Linux virtual machine](https://docs.microsoft.com/azure/virtual-machines/linux/quick-create-portal)\r\n1. [Create a Windows virtual machine](https://docs.microsoft.com/azure/virtual-machines/windows/quick-create-portal)\r\n1. [Create a virtual machine scale set](https://docs.microsoft.com/azure/virtual-machine-scale-sets/quick-create-portal)",
"title": "Test VM Dashboard",
"subtitle": "Contoso"
}
}
}
Hasonlóképpen, a videócsempe saját beállításaival rendelkezik, amelyek a lejátszandó videóra mutató mutatót, egy automatikus lejátszási beállítást és opcionális címadatokat tartalmaznak.
"settings": {
"content": {
"settings": {
"src": "https://www.youtube.com/watch?v=rOiSRkxtTeU",
"autoplay": false
}
}
}
Objektum
Az első osztályú kezelhető portálobjektumokhoz (más néven objektumokhoz) kötött csempék az objektumon keresztül fejezik ki ezt a asset
kapcsolatot. A példa irányítópultján a virtuálisgép-csempe tartalmazza ezt az eszközleírást. A idInputName
tulajdonság közli a portállal, hogy az azonosító bemenete tartalmazza az objektum egyedi azonosítóját, ebben az esetben az erőforrás-azonosítót. A legtöbb Azure-erőforrástípus rendelkezik a portálon definiált objektumokkal.
"asset": { "idInputName": "id", "type": "VirtualMachine" }
Következő lépések
- Megtudhatja, hogyan hozhat létre irányítópultot a Azure Portal vagy programozott módon.
- Megtudhatja, hogyan jeleníthet meg egyéni tartalmakat az Azure-irányítópultokon a Markdown-csempék használatával.
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: