Unisphere for PowerMax 10.x: Slik får du målinger på enhetsnivå via RESTAPI

Denne artikkelen beskriver hvordan du samler inn måledata på enhetsnivå via REST API til Unisphere for PowerMax 10.x-forekomster.

Hvert RESTAPI-kall trenger tre ting:

• En URL-adresse
• En anropstype
• En nyttelast

For å samle inn volumberegninger er nettadressen:

• https://< IPorFQDN:>8443/univmax/restapi/performance/volume/metrics

Anropstypen er: POST
Nyttelasten er strukturert som følger for JSON: (For XML, se delen "Tilleggsinformasjon")

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

Hvert felt har krav. Dette gjelder for alle samtaler som bruker disse feltene: 

• "systemId" krever hele 12 sifre i arrayets serienummer, og må stå i anførselstegn.
• Både "volumeStartRange" og "volumeEndRange" krever enhets-ID-en på 5 siffer, og den må stå i anførselstegn. (Ja, du kan ha mer enn én.)
• "dateFormat" kan være Maksimum eller Gjennomsnittlig, også i anførselstegn.
• "startDate" og "endDate" er EPOCH-tidsstempelet i millisekunder (dette dekker dato og klokkeslett).
• «Beregninger» Du kan føre opp flere beregninger, men de må stå i anførselstegn og være atskilt med komma.

Ved å ha en gyldig nettadresse, anropstype og nyttelast, har du et gyldig anrop. For volumberegninger er det imidlertid flere begrensninger for enheten på backend:

• Volumet må være i en SG.
• SG må være i en MV.
• SG må være i måledatainnsamlingslisten "Storage group real-time" i systemregistreringer.
• Banen for å legge til en SG i sanntid er: Innstillinger >Prestasjon>Systemregistrering> Klikk utklippstavlen

• Til slutt kan tidsintervallet IKKE være mer enn 60 minutter.
  • Når du bygger EPOCK-tidene dine i millisekunder, må du sørge for at start- og sluttdatoene ikke er mer enn 60 minutter fra hverandre. 
  • Det anbefales å bruke et mindre tidsvindu, for eksempel fem minutter, under samtaletestingen. 

Når alle begrensningene er oppfylt, kan du kjøre samtalen og få en HTTP 200-responskode med enhetsberegningene:

 

Her er litt tilleggsinformasjon som kan være nødvendig:

XML-nyttelastformat for målekall 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>

Hvis du vil se alle de viktigste endringene med 10.x, kan du se følgende: hva-er-nytt-i-powermax-rest-api

For RESTAPI kan dokumentasjonen som er spesifikk for Unisphere-versjonen din, samles inn ved hjelp av følgende trinn. Denne dokumentasjonen kan hjelpe deg med å finne det som trengs for samtaler og nyttelaststrukturen. 

1. Last ned RESTAPI-dokumentfilen ved å gå til:
   • https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs
   • UNIVMAX_IP er IP-adressen, og UNIVMAX_PORT er porten til verten som kjører Unisphere.
2. Flytt filen til plasseringen der du vil beholde dokumentasjonen.
3. Pakk ut innholdet i .zip-filen.
4. Se etter filen "index.html" i listen over utpakkede filer.
5. Åpne "index.html":
   • Husk hvor denne filen er, da dette er hvordan du får tilgang til dokumentasjonen.
   • Det skal åpne et vindu i nettleseren din.

Når du oppretter denne KB-artikkelen, er de mulige beregningene på enhetsnivå:

EPOCH-tidsstempler kan genereres på andre nettsteder som EPOCHconverter. 
Husk at dette IKKE er et Dell-nettsted, så Dell har ingen kontroll over funksjonaliteten eller støtten.