Megosztás a következőn keresztül:


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:

Képernyőkép egy minta irányítópultról a Azure Portal.

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 metadataa position elemet.

Pozíció

A position tulajdonság a rész méret- és helyadatait tartalmazza, a , ya rowSpanés colSpana értékben xkifejezve. 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.

Képernyőkép egy irányítópult rácsegységéről a Azure Portal.

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:

  1. Extension/Microsoft_Azure_Monitoring/PartType/MetricsChartPart – Monitorozási metrikák megjelenítésére szolgál
  2. Extension[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.
  3. 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