Performance Manager Update Perf Interval

Performance Manager Update Perf Interval

Modifies VirtualCenter Server's built-in historical intervals, within certain limits.

Supported Modifications

key samplingPeriod length name level \[1\] enabled \[2\]
1 300 \[3\] 86400 \[4\] Past day 1 true
2 1800 604800 Past week 1 true
3 7200 2592000 Past month 1 true
4 86400 31536000 \[5\] Past year 1 true

[1]  The collection level for the historical intervals can be changed. However, the level specified for a lower-numbered interval cannot be smaller than that of a larger interval.
[2]  An interval can be disabled. By default, all four intervals are enabled. Disabling an interval disables all higher intervals. For example, disabling interval 3 (“Past month”) also disables interval 4 (“Past year”).
[3]  Can reduce this interval’s samplingPeriod from 5 minutes to 1, 2, or 3 minutes.
[4]  Can increase this interval’s length from 1 day to 2 or 3 days.
[5]  Can increase interval’s length from 1 year to 2 or 3 years.

See PerfInterval for information about the four default intervals for VirtualCenter Server.

Required privileges: Performance.ModifyIntervals

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/PerformanceManager/{moId}/UpdatePerfInterval
COPY
Path Parameters
string
moId
Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case PerformanceManager/{moId}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.


Request Body
UpdatePerfIntervalRequestType of type(s) application/json
Required
"UpdatePerfIntervalRequestType Object"
interval
Required

The historical interval being modified, a complete data object comprising values for PerfInterval.enabled, interval ID, PerfInterval.length of time to maintain statistics for this interval in the database, PerfInterval.level, PerfInterval.name, and PerfInterval.samplingPeriod properties.

Authentication
This operation uses the following authentication methods.
Responses
204

No Content

Operation doesn't return any data structure

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/PerformanceManager/{moId}/UpdatePerfInterval