Unisphere för PowerMax 10.x: Så här hämtar du mått på enhetsnivå via RESTAPI

I den här artikeln beskrivs hur du samlar in mätvärden på enhetsnivå via REST API till Unisphere för PowerMax 10.x-instanser.

Varje RESTAPI-samtal behöver tre saker:

• En URL
• En samtalstyp
• En nyttolast

Om du vill samla in volymmått är URL:en:

• https://< IPorFQDN:>8443/univmax/restapi/performance/volym/mått

Samtalstypen är: POST
Nyttolasten är strukturerad på följande sätt för JSON: (För XML, se avsnittet "Ytterligare information")

{
"systemId": "000xxxxxxxxx",
"volumeStartRange": "xxxxx",
"volumeEndRange": "xxxxx",
"dataFormat": "Maximum",
"endDate":xxxxxxxxxxxxxx,
"metrics": [
"metric1",
"metric2",
"metric3",
"etc"
],
"startDate": xxxxxxxxxxxxxxx
}

Varje fält har krav. Detta gäller för alla anrop som använder dessa fält: 

• "systemId" kräver de fullständiga 12 siffrorna i matrisens serienummer och måste anges inom citattecken.
• "volumeStartRange" och "volumeEndRange" kräver båda det 5-siffriga enhets-ID:t och det måste vara inom citattecken. (Ja, du kan ha fler än en.)
• "dateFormat" kan vara Maximum eller Average, även inom citattecken.
• "startDate" och "endDate" är EPOCH-tidsstämpeln i millisekunder (detta omfattar datum och tid).
• "Mätvärden" Du kan ange flera mätvärden, men de måste vara inom citattecken och avgränsade med kommatecken.

Genom att ha en giltig URL, anropstyp och nyttolast har du ett giltigt anrop. För volymmått finns det dock ytterligare begränsningar för enheten på serverdelen:

• Volymen måste vara i en SG.
• SG måste vara i en MV.
• SG måste finnas i måttsamlingslistan "Lagringsgrupp i realtid" i systemregistreringar.
• Sökvägen för att lägga till en SG i realtid är: Inställningar >Föreställning>Systemregistrering> Klicka på Urklipp

• Slutligen KAN tidsintervallet INTE vara mer än 60 minuter.
  • När du skapar dina EPOCK-tider i millisekunder ska du se till att start- och slutdatumen inte är mer än 60 minuter från varandra. 
  • Vi rekommenderar att du gör ett mindre tidsfönster, till exempel fem minuter, under samtalstestningen. 

När alla begränsningar är uppfyllda kan du köra anropet och få en HTTP 200-svarskod med enhetsmåtten:

 

Här är ytterligare information som kan behövas:

XML-nyttolastformat för måttanrop på enhetsnivå:

<volumeParam xmlns="http://www.emc.com/em/2012/07/univmax/restapi/performance">
  <startDate>...</startDate>
  <endDate>...</endDate>
  <systemId>...</systemId>
  <volumeStartRange>...</volumeStartRange>
  <volumeEndRange>...</volumeEndRange>
  <commaSeparatedStorageGroupList>...</commaSeparatedStorageGroupList>
  <dataFormat>...</dataFormat>
  <metrics>...</metrics>
</volumeParam>

Om du vill se alla större ändringar med 10.x kan du läsa följande: what-s-new-in-powermax-rest-api

För RESTAPI kan dokumentationen som är specifik för din Unisphere-version samlas in med hjälp av följande steg. Den här dokumentationen kan hjälpa dig att hitta vad som behövs för anrop och nyttolaststrukturen. 

1. Ladda ned RESTAPI-dokumentfilen genom att gå till:
   • https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs (på engelska)
   • UNIVMAX_IP är IP-adressen och UNIVMAX_PORT är porten för värden som kör Unisphere.
2. Flytta filen till den plats där du vill behålla dokumentationen.
3. Extrahera innehållet i .zip-filen.
4. Leta efter filen med namnet "index.html" i listan över uppackade filer.
5. Öppna "index.html":
   • Kom ihåg var filen finns eftersom det är så du kommer åt dokumentationen.
   • Det bör öppna ett fönster i din webbläsare.

När du skapar den här KB-artikeln är möjliga mått på enhetsnivå:

EPOCH-tidsstämplar kan genereras på andra webbplatser som EPOCHconverter. 
Tänk på att det här INTE är en Dell-webbplats, så Dell har ingen kontroll över dess funktioner eller support.