Skip to main content

Retrieve an on-premises ONTAP system

GET /onprem/working-environments/{workingEnvironmentId}

Retrieves an on-premises ONTAP system.

Parameters

Name Type In Required Description

fields

Expands

query

False

workingEnvironmentId

string

path

True

Error

Status: Default, Default response
Name Type Required Description

publicId

string

True

tenantId

string

False

description

string

False

name

string

False

discoverUserEmail

string

False

location

string

False

reservedSize

Capacity

False

status

StatusProperties

False

interClusterLifs

array[InterClusterLif]

True

cronJobSchedules

array[CronJobSchedule]

True

svms

array[Svm]

True

snapshotPolicies

array[SnapshotPolicy]

True

replicationProperties

ReplicationProperties

False

clusterProperties

OnPremClusterProperties

False

ontapClusterProperties

OnPremClusterProperties

False

workingEnvironmentType

string

False

cloudSyncProperties

CloudSyncProperties

False

actionsRequired

array[ActionRequired]

True

capacityFeatures

OnPremCapacityFeatures

False

aff

boolean

False

cbsProperties

CbsPropertiesWithReason

False

complianceProperties

CloudComplianceStatusResponse

False

monitoringProperties

MonitoringStatusResponse

False
Example error response 
{
  "publicId": "string",
  "tenantId": "string",
  "description": "string",
  "name": "string",
  "discoverUserEmail": "string",
  "location": "string",
  "status": {
    "status": "string",
    "message": "string",
    "extendedFailureReason": "string"
  },
  "interClusterLifs": [
    {
      "name": "string",
      "address": "string",
      "port": "string",
      "node": "string",
      "status": "string"
    }
  ],
  "cronJobSchedules": [
    {
      "name": "string",
      "description": "string",
      "months": [
        "string"
      ],
      "days": [
        "string"
      ],
      "weekDays": [
        "string"
      ],
      "hours": [
        "string"
      ],
      "minutes": [
        "string"
      ]
    }
  ],
  "svms": [
    {}
  ],
  "snapshotPolicies": [
    {
      "name": "string",
      "schedules": [
        {}
      ],
      "description": "string"
    }
  ],
  "replicationProperties": {
    "peers": [
      "string"
    ],
    "replicationTargets": [
      "string"
    ]
  },
  "clusterProperties": {
    "clusterAddress": "string",
    "ontapVersion": "string",
    "clusterName": "string",
    "serialNumber": "string",
    "systemId": "string",
    "licenses": [
      "string"
    ],
    "systemManagerUrl": "string",
    "clusterUuid": "string",
    "nodeModels": [
      "string"
    ],
    "lifs": [
      {}
    ]
  },
  "ontapClusterProperties": {
    "clusterAddress": "string",
    "ontapVersion": "string",
    "clusterName": "string",
    "serialNumber": "string",
    "systemId": "string",
    "licenses": [
      "string"
    ],
    "systemManagerUrl": "string",
    "clusterUuid": "string",
    "nodeModels": [
      "string"
    ],
    "lifs": [
      {}
    ]
  },
  "workingEnvironmentType": "string",
  "cloudSyncProperties": {
    "status": {
      "status": "string",
      "failureMessage": "string"
    },
    "dataBrokerProperties": {
      "id": "string",
      "name": "string",
      "dataBrokerPlacement": {
        "vpcId": "string",
        "subnetId": "string",
        "instanceType": "string",
        "instanceId": "string",
        "keyPair": "string"
      }
    },
    "s3Location": "string",
    "relationships": [
      {
        "volumeName": "string",
        "svmName": "string",
        "relationshipStatus": "string",
        "s3Location": "string",
        "id": "string",
        "failureMessage": "string"
      }
    ]
  },
  "actionsRequired": [
    {}
  ],
  "capacityFeatures": {
    "objectStoreConfigExtended": {
      "objectStoreConfig": {
        "objectStoreName": "string",
        "s3Name": "string",
        "server": "string",
        "providerType": "string"
      },
      "tierLevel": "string"
    }
  },
  "cbsProperties": {
    "cbsBackupStatus": "string",
    "cbsRules": [
      {
        "snapmirrorLabel": "string"
      }
    ],
    "objectStoreName": "string",
    "providerSpecific": {
      "azureRgName": "string",
      "gcpProjectId": "string",
      "gcpRegion": "string"
    },
    "cbsPolicyName": "string",
    "ipSpace": "string",
    "region": "string",
    "providerAccountName": "string",
    "exclusionReason": "string"
  },
  "complianceProperties": {
    "scanStatus": "string",
    "complianceStatus": {
      "scanStatus": {
        "volumes": [
          {
            "name": "string",
            "status": "string",
            "error": "string"
          }
        ]
      }
    },
    "lastDeploymentError": "string",
    "complianceBackupStatus": "string"
  },
  "monitoringProperties": {
    "monitoringStatus": "string",
    "monitoringInfo": {
      "averageLatency": {
        "unit": "string"
      },
      "storageAverageThroughput": {
        "unit": "string"
      },
      "node1AverageThroughput": {
        "unit": "string"
      },
      "node2AverageThroughput": {
        "unit": "string"
      }
    },
    "tenantUrl": "string"
  }
}

Definitions

See Definitions

Expand

Name Type Required Description

name

string

False

Expands

Name Type Required Description

raw

string

True

expands

array[Expand]

True

Capacity

Name Type Required Description

size

number

True

unit

string

True

FailureCauses

Name Type Required Description

invalidOntapCredentials

boolean

True

noCloudProviderConnection

boolean

False

invalidCloudProviderCredentials

boolean

False

StatusProperties

Name Type Required Description

status

string

False

message

string

False

failureCauses

FailureCauses

False

extendedFailureReason

string

False

InterClusterLif

Name Type Required Description

name

string

False

address

string

False

port

string

False

node

string

False

status

string

False

isPeered

boolean

False

CronJobSchedule

Name Type Required Description

name

string

False

description

string

False

months

array[string]

True

days

array[string]

False

weekDays

array[string]

False

hours

array[string]

False

minutes

array[string]

False

Value

Svm

Name Type Required Description

name

string

False

state

string

False

allowedProtocols

array[Value]

True

language

string

False

allowedAggregates

array[string]

False

ver3Enabled

boolean

True

ver4Enabled

boolean

True

PolicySchedule

Name Type Required Description

frequency

string

True

retention

integer

True

SnapshotPolicy

Name Type Required Description

name

string

True

schedules

array[PolicySchedule]

True

description

string

True

ReplicationProperties

Name Type Required Description

peers

array[string]

False

replicationTargets

array[string]

False

LifResponse

Name Type Required Description

ip

string

True

netmask

string

True

lifType

string

True

dataProtocols

array[string]

True

nodeName

string

True

privateIp

boolean

True

OnPremClusterProperties

Name Type Required Description

clusterAddress

string

False

ontapVersion

string

False

clusterName

string

False

serialNumber

string

False

systemId

string

False

isSnapmirrorLicenseExists

boolean

False

licenses

array[string]

False

systemManagerUrl

string

False

location

Value

False

clusterUuid

string

False

nodeModels

array[string]

False

lifs

array[LifResponse]

False

isAff

boolean

False

aggregateCount

integer

False

volumeCount

integer

False

sanOptimized

boolean

False

disaggregated

boolean

False

CloudSyncStatus

Name Type Required Description

status

string

False

failureMessage

string

False

DataBrokerPlacement

Name Type Required Description

vpcId

string

False

subnetId

string

False

instanceType

string

False

instanceId

string

False

keyPair

string

False

DataBrokerProperties

Name Type Required Description

id

string

False

name

string

False

dataBrokerPlacement

DataBrokerPlacement

False

CloudSyncRelationship

Name Type Required Description

volumeName

string

False

svmName

string

False

relationshipStatus

string

False

s3Location

string

False

id

string

False

progress

integer

False

failureMessage

string

False

CloudSyncProperties

Name Type Required Description

isSynced

boolean

False

status

CloudSyncStatus

False

dataBrokerProperties

DataBrokerProperties

False

s3Location

string

False

relationships

array[CloudSyncRelationship]

False

RaidInfoForEvAggregate

Name Type Required Description

numOfDisks

integer

True

diskSize

Capacity

True

ElasticVolumeQuoteInfo

Name Type Required Description

totalCapacityToAdd

Capacity

False

addedCapacityToExistingEvDisks

Capacity

False

newRaidForEvInfo

array[RaidInfoForEvAggregate]

False

totalEvDisks

integer

False

VolumeMoveParameters

Name Type Required Description

volumeName

string

False

svmName

string

False

targetAggregateName

string

False

isNewTargetAggregate

boolean

False

homeNode

string

False

OntapLicenseType

Name Type Required Description

type

string

False

name

string

False

description

string

False

subName

string

False

subDescription

string

False

capacity_limit

string

False

platformLicenseRequired

boolean

False

default

boolean

False

capacityLimit

Capacity

True

ChangeLicenseParameters

Name Type Required Description

newLicenseType

OntapLicenseType

False

newInstanceType

string

False

InstanceNameIdAndType

Name Type Required Description

instanceName

string

False

instanceType

string

False

instanceId

string

False

DisksDetails

Name Type Required Description

numberOfDisks

integer

False

diskSize

Capacity

False

diskType

string

False

ResourcesToDelete

Name Type Required Description

instanceNameAndType

array[InstanceNameIdAndType]

False

numberOfDisksAndDiskSize

array[DisksDetails]

False

VolumeInfo

Name Type Required Description

volumeName

string

False

svmName

string

False

newCapacity

Capacity

False

ActionRequiredParameters

Name Type Required Description

aggregateName

string

True

numOfDisks

integer

True

totalCapacity

Capacity

True

evCapacityDetails

ElasticVolumeQuoteInfo

False

volumeNames

array[string]

True

maxCapacity

Capacity

True

licenseExpiryDate

integer

True

serialNumber

string

True

volumeMoveParameters

VolumeMoveParameters

False

workingEnvironmentId

string

True

licenseParameters

ChangeLicenseParameters

False

resourcesToDelete

ResourcesToDelete

False

instances

array[InstanceNameIdAndType]

True

moreInfo

string

False

providerVolumeType

string

False

volumeInfo

VolumeInfo

False

currentInstanceType

string

False

isComposite

boolean

True

isCapacityBased

boolean

True

ActionRequired

Name Type Required Description

actionType

string

True

parameters

ActionRequiredParameters

True

severity

string

True

ObjectStoreConfigInfo

Name Type Required Description

objectStoreName

string

False

s3Name

string

False

usedSpace

Capacity

False

server

string

False

providerType

string

False

ExtendedObjectStoreConfigInfo

Name Type Required Description

objectStoreConfig

ObjectStoreConfigInfo

False

tierLevel

string

False

OnPremCapacityFeatures

Name Type Required Description

objectStoreConfigExtended

ExtendedObjectStoreConfigInfo

False

performanceTierUsedCapacity

Capacity

False

inactiveUserData

Capacity

False

rawCapacity

Capacity

False

fiveYearSavings

number

False

CbsSchedule

Name Type Required Description

snapmirrorLabel

string

False

snapshotsToKeep

integer

False

ProviderSpecific

Name Type Required Description

azureRgName

string

False

gcpProjectId

string

False

gcpRegion

string

False

CbsPropertiesWithReason

Name Type Required Description

cbsBackupStatus

string

False

cbsRules

array[CbsSchedule]

False

numberOfBackedUpVolumes

integer

False

objectStoreName

string

False

providerSpecific

ProviderSpecific

False

cbsPolicyName

string

False

usedCapacity

Capacity

False

ipSpace

string

False

region

string

False

providerAccountName

string

False

exclusionReason

string

False

scopeId

ComplianceScanStatusVolumeResponse

Name Type Required Description

name

string

False

status

string

False

error

string

False

scopeId

scopeId

False

ComplianceScanStatusResponse

Name Type Required Description

scanned

integer

False

notScanned

integer

False

volumes

array[ComplianceScanStatusVolumeResponse]

False

ComplianceExtendedStatusResponse

Name Type Required Description

sensitivePersonalHits

integer

False

personalHits

integer

False

nonSensitiveHits

integer

False

scanStatus

ComplianceScanStatusResponse

False

CloudComplianceStatusResponse

Name Type Required Description

scanStatus

string

False

complianceStatus

ComplianceExtendedStatusResponse

False

lastDeploymentError

string

False

complianceBackupStatus

string

False

KpiUnitValue

Name Type Required Description

value

number

False

unit

string

False

MonitoringInfo

Name Type Required Description

averageIops

number

False

averageLatency

KpiUnitValue

False

storageAverageThroughput

KpiUnitValue

False

node1AverageThroughput

KpiUnitValue

False

node2AverageThroughput

KpiUnitValue

False

MonitoringStatusResponse

Name Type Required Description

monitoringStatus

string

False

monitoringInfo

MonitoringInfo

False

tenantUrl

string

False