Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/intersight-thermal-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
description: 'Cisco Intersight is a management platform delivered as a service with embedded analytics for your Cisco and
3rd party IT infrastructure. This platform offers an intelligent level of management that enables
IT organizations to analyze, simplify, and automate their environments in more advanced ways than the prior
generations of tools. Cisco Intersight provides an integrated and intuitive management experience for
resources in the traditional data center as well as at the edge. With flexible deployment options to address
complex security needs, getting started with Intersight is quick and easy.
Cisco Intersight has deep integration with Cisco UCS and HyperFlex systems allowing for remote deployment,
configuration, and ongoing maintenance. The model-based deployment works for a single system in a remote
location or hundreds of systems in a data center and enables rapid, standardized configuration and deployment.
It also streamlines maintaining those systems whether you are working with small or very large configurations.
The Intersight OpenAPI document defines the complete set of properties that are returned in the
HTTP response. From that perspective, a client can expect that no additional properties are returned,
unless these properties are explicitly defined in the OpenAPI document.
However, when a client uses an older version of the Intersight OpenAPI document, the server may
send additional properties because the software is more recent than the client. In that case, the client
may receive properties that it does not know about.
Some generated SDKs perform a strict validation of the HTTP response body against the OpenAPI document.
This document was created on 2026-08-07T06:46:04Z.'
version: 1.0.11-20260807064027971
title: Cisco Intersight Server Thermal API
license:
name: Apache License, Version 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
contact:
name: Intersight API support
url: https://intersight.com/help
email: intersight@cisco.com
x-provenance:
method: harvested
authored_by: Cisco Intersight
harvested_by: API Evangelist
harvested_on: '2026-08-19'
first_party: true
provider_published: true
source_host: cdn.intersight.com
note: Cisco publishes the full Intersight OpenAPI 3.0.2 anonymously from its CDN (27.5MB master document; 3,963 operations / 2,448 paths / 5,612 schemas) plus 11 per-service documents covering 100% of the master's paths. Byte-identity reconfirmed 2026-08-19 by SHA-256. Note intersight.com itself is a soft-404 farm — the contract is on the CDN, not the app host.
x-evidence:
- type: source
url: https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-openapi-v3-1.0.11-20260807064027971.json
- type: source
url: https://intersight.com/apidocs/apirefs/
servers:
- url: https://{server}
variables:
server:
default: intersight.com
description: The Intersight URL for the cloud-based infrastructure management APIs.
tags:
- name: thermal
paths:
/api/v1/thermal/Policies:
get:
tags:
- thermal
summary: Read a 'thermal.Policy' resource.
operationId: GetThermalPolicyList
security:
- cookieAuth: []
- http_signature: []
- oAuth2:
- PRIVSET.Account Administrator
- PRIVSET.Manage Server Profiles
- PRIVSET.Manage Unified Edge Profiles
- PRIVSET.Read-Only
- PRIVSET.Read-only Thermal policies
- PRIVSET.View Server Profiles
- PRIVSET.View Unified Edge Profiles
- READ.thermal.Policy
- ROLE.Account Administrator
- ROLE.Read-Only
parameters:
- $ref: '#/components/parameters/filterParam'
- $ref: '#/components/parameters/orderbyParam'
- $ref: '#/components/parameters/topParam'
- $ref: '#/components/parameters/skipParam'
- $ref: '#/components/parameters/selectParam'
- $ref: '#/components/parameters/expandParam'
- $ref: '#/components/parameters/applyParam'
- $ref: '#/components/parameters/countParam'
- $ref: '#/components/parameters/inlinecountParam'
- $ref: '#/components/parameters/atParam'
- $ref: '#/components/parameters/tagsParam'
responses:
'200':
description: List of 'thermal.Policy' resources for the given filter criteria
headers:
Set-Cookie:
$ref: '#/components/headers/Set-Cookie'
x-starship-traceid:
$ref: '#/components/headers/x-starship-traceid'
Content-Disposition:
$ref: '#/components/headers/Content-Disposition'
Content-Length:
$ref: '#/components/headers/Content-Length'
content:
application/json:
schema:
$ref: '#/components/schemas/thermal.Policy.Response'
text/csv:
schema:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/CsvFile
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
schema:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/ExcelFile
'400':
$ref: '#/components/responses/http_status_400'
'401':
$ref: '#/components/responses/http_status_401'
'403':
$ref: '#/components/responses/http_status_403'
'404':
$ref: '#/components/responses/http_status_404'
default:
$ref: '#/components/responses/default'
post:
tags:
- thermal
summary: Create a 'thermal.Policy' resource.
operationId: CreateThermalPolicy
security:
- cookieAuth: []
- http_signature: []
- oAuth2:
- CREATE.thermal.Policy
- PRIVSET.Account Administrator
- PRIVSET.Create, clone and edit Thermal policies
- PRIVSET.Manage Server Profiles
- PRIVSET.Manage Unified Edge Profiles
- ROLE.Account Administrator
parameters:
- $ref: '#/components/parameters/IfMatch'
- $ref: '#/components/parameters/IfNoneMatch'
requestBody:
description: The 'thermal.Policy' resource to create.
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/thermal.Policy'
responses:
'200':
description: The HTTP 200 status response code indicates that the request has succeeded and the 'thermal.Policy' resource was created as requested. The 'thermal.Policy' resource is created before this response is sent back and the resource is returned in the body of the message.
headers:
Set-Cookie:
$ref: '#/components/headers/Set-Cookie'
x-starship-traceid:
$ref: '#/components/headers/x-starship-traceid'
content:
application/json:
schema:
$ref: '#/components/schemas/thermal.Policy'
links:
GetThermalPolicyByMoid:
operationId: GetThermalPolicyByMoid
parameters:
Moid: $response.body#/Moid
description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/thermal/Policies/{Moid}'.
GetIamAccountByMoid:
$ref: '#/components/links/GetIamAccountByMoid'
GetIamDomainGroupByMoid:
$ref: '#/components/links/GetIamDomainGroupByMoid'
'400':
$ref: '#/components/responses/http_status_400'
'401':
$ref: '#/components/responses/http_status_401'
'403':
$ref: '#/components/responses/http_status_403'
'404':
$ref: '#/components/responses/http_status_404'
default:
$ref: '#/components/responses/default'
/api/v1/thermal/Policies/{Moid}:
get:
tags:
- thermal
summary: Read a 'thermal.Policy' resource.
operationId: GetThermalPolicyByMoid
security:
- cookieAuth: []
- http_signature: []
- oAuth2:
- PRIVSET.Account Administrator
- PRIVSET.Manage Server Profiles
- PRIVSET.Manage Unified Edge Profiles
- PRIVSET.Read-Only
- PRIVSET.Read-only Thermal policies
- PRIVSET.View Server Profiles
- PRIVSET.View Unified Edge Profiles
- READ.thermal.Policy
- ROLE.Account Administrator
- ROLE.Read-Only
parameters:
- $ref: '#/components/parameters/moidParam'
- $ref: '#/components/parameters/selectParam'
- $ref: '#/components/parameters/expandParam'
- $ref: '#/components/parameters/atParam'
responses:
'200':
description: An instance of the 'thermal.Policy' resource.
headers:
Set-Cookie:
$ref: '#/components/headers/Set-Cookie'
x-starship-traceid:
$ref: '#/components/headers/x-starship-traceid'
Content-Disposition:
$ref: '#/components/headers/Content-Disposition'
Content-Length:
$ref: '#/components/headers/Content-Length'
content:
application/json:
schema:
$ref: '#/components/schemas/thermal.Policy'
text/csv:
schema:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/CsvFile
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
schema:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/ExcelFile
links:
GetThermalPolicyByMoid:
operationId: GetThermalPolicyByMoid
parameters:
Moid: $response.body#/Moid
description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/thermal/Policies/{Moid}'.
GetIamAccountByMoid:
$ref: '#/components/links/GetIamAccountByMoid'
GetIamDomainGroupByMoid:
$ref: '#/components/links/GetIamDomainGroupByMoid'
'400':
$ref: '#/components/responses/http_status_400'
'401':
$ref: '#/components/responses/http_status_401'
'403':
$ref: '#/components/responses/http_status_403'
'404':
$ref: '#/components/responses/http_status_404'
default:
$ref: '#/components/responses/default'
post:
tags:
- thermal
summary: Update a 'thermal.Policy' resource.
operationId: UpdateThermalPolicy
security:
- cookieAuth: []
- http_signature: []
- oAuth2:
- PRIVSET.Account Administrator
- PRIVSET.Edit Thermal policies
- PRIVSET.Manage Server Profiles
- PRIVSET.Manage Unified Edge Profiles
- ROLE.Account Administrator
- UPDATE.thermal.Policy
parameters:
- $ref: '#/components/parameters/moidParam'
- $ref: '#/components/parameters/IfMatch'
requestBody:
description: The 'thermal.Policy' resource to update.
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/thermal.Policy'
application/json-patch+json:
schema:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/PatchDocument
responses:
'200':
description: The HTTP 200 status response code indicates that the request has succeeded and the 'thermal.Policy' resource was modified as requested. The 'thermal.Policy' resource is modified before this response is sent back and the resource is returned in the body of the message.
headers:
Set-Cookie:
$ref: '#/components/headers/Set-Cookie'
x-starship-traceid:
$ref: '#/components/headers/x-starship-traceid'
content:
application/json:
schema:
$ref: '#/components/schemas/thermal.Policy'
links:
GetThermalPolicyByMoid:
operationId: GetThermalPolicyByMoid
parameters:
Moid: $response.body#/Moid
description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/thermal/Policies/{Moid}'.
GetIamAccountByMoid:
$ref: '#/components/links/GetIamAccountByMoid'
GetIamDomainGroupByMoid:
$ref: '#/components/links/GetIamDomainGroupByMoid'
'400':
$ref: '#/components/responses/http_status_400'
'401':
$ref: '#/components/responses/http_status_401'
'403':
$ref: '#/components/responses/http_status_403'
'404':
$ref: '#/components/responses/http_status_404'
default:
$ref: '#/components/responses/default'
patch:
tags:
- thermal
summary: Update a 'thermal.Policy' resource.
operationId: PatchThermalPolicy
security:
- cookieAuth: []
- http_signature: []
- oAuth2:
- PRIVSET.Account Administrator
- PRIVSET.Edit Thermal policies
- PRIVSET.Manage Server Profiles
- PRIVSET.Manage Unified Edge Profiles
- ROLE.Account Administrator
- UPDATE.thermal.Policy
parameters:
- $ref: '#/components/parameters/moidParam'
- $ref: '#/components/parameters/IfMatch'
requestBody:
description: The 'thermal.Policy' resource to update.
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/thermal.Policy'
application/json-patch+json:
schema:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/PatchDocument
responses:
'200':
description: The HTTP 200 status response code indicates that the request has succeeded and the 'thermal.Policy' resource was patched as requested. The 'thermal.Policy' resource is patched before this response is sent back and the resource is returned in the body of the message.
headers:
Set-Cookie:
$ref: '#/components/headers/Set-Cookie'
x-starship-traceid:
$ref: '#/components/headers/x-starship-traceid'
content:
application/json:
schema:
$ref: '#/components/schemas/thermal.Policy'
links:
GetThermalPolicyByMoid:
operationId: GetThermalPolicyByMoid
parameters:
Moid: $response.body#/Moid
description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/thermal/Policies/{Moid}'.
GetIamAccountByMoid:
$ref: '#/components/links/GetIamAccountByMoid'
GetIamDomainGroupByMoid:
$ref: '#/components/links/GetIamDomainGroupByMoid'
'400':
$ref: '#/components/responses/http_status_400'
'401':
$ref: '#/components/responses/http_status_401'
'403':
$ref: '#/components/responses/http_status_403'
'404':
$ref: '#/components/responses/http_status_404'
default:
$ref: '#/components/responses/default'
delete:
tags:
- thermal
summary: Delete a 'thermal.Policy' resource.
operationId: DeleteThermalPolicy
security:
- cookieAuth: []
- http_signature: []
- oAuth2:
- DELETE.thermal.Policy
- PRIVSET.Account Administrator
- PRIVSET.Delete Thermal policies
- PRIVSET.Manage Server Profiles
- PRIVSET.Manage Unified Edge Profiles
- ROLE.Account Administrator
parameters:
- $ref: '#/components/parameters/moidParam'
responses:
'200':
description: Resource has been deleted successfully.
headers:
Set-Cookie:
$ref: '#/components/headers/Set-Cookie'
x-starship-traceid:
$ref: '#/components/headers/x-starship-traceid'
'400':
$ref: '#/components/responses/http_status_400'
'401':
$ref: '#/components/responses/http_status_401'
'403':
$ref: '#/components/responses/http_status_403'
'404':
$ref: '#/components/responses/http_status_404'
default:
$ref: '#/components/responses/default'
/api/v1/thermal/PolicyInventories:
get:
tags:
- thermal
summary: Read a 'thermal.PolicyInventory' resource.
operationId: GetThermalPolicyInventoryList
security:
- cookieAuth: []
- http_signature: []
- oAuth2:
- PRIVSET.Account Administrator
- PRIVSET.Manage Server Profiles
- PRIVSET.Manage Unified Edge Profiles
- PRIVSET.Read-Only
- PRIVSET.Read-only Thermal policies
- PRIVSET.View Server Profiles
- PRIVSET.View Unified Edge Profiles
- READ.thermal.PolicyInventory
- ROLE.Account Administrator
- ROLE.Read-Only
parameters:
- $ref: '#/components/parameters/filterParam'
- $ref: '#/components/parameters/orderbyParam'
- $ref: '#/components/parameters/topParam'
- $ref: '#/components/parameters/skipParam'
- $ref: '#/components/parameters/selectParam'
- $ref: '#/components/parameters/expandParam'
- $ref: '#/components/parameters/applyParam'
- $ref: '#/components/parameters/countParam'
- $ref: '#/components/parameters/inlinecountParam'
- $ref: '#/components/parameters/atParam'
- $ref: '#/components/parameters/tagsParam'
responses:
'200':
description: List of 'thermal.PolicyInventory' resources for the given filter criteria
headers:
Set-Cookie:
$ref: '#/components/headers/Set-Cookie'
x-starship-traceid:
$ref: '#/components/headers/x-starship-traceid'
Content-Disposition:
$ref: '#/components/headers/Content-Disposition'
Content-Length:
$ref: '#/components/headers/Content-Length'
content:
application/json:
schema:
$ref: '#/components/schemas/thermal.PolicyInventory.Response'
text/csv:
schema:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/CsvFile
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
schema:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/ExcelFile
'400':
$ref: '#/components/responses/http_status_400'
'401':
$ref: '#/components/responses/http_status_401'
'403':
$ref: '#/components/responses/http_status_403'
'404':
$ref: '#/components/responses/http_status_404'
default:
$ref: '#/components/responses/default'
/api/v1/thermal/PolicyInventories/{Moid}:
get:
tags:
- thermal
summary: Read a 'thermal.PolicyInventory' resource.
operationId: GetThermalPolicyInventoryByMoid
security:
- cookieAuth: []
- http_signature: []
- oAuth2:
- PRIVSET.Account Administrator
- PRIVSET.Manage Server Profiles
- PRIVSET.Manage Unified Edge Profiles
- PRIVSET.Read-Only
- PRIVSET.Read-only Thermal policies
- PRIVSET.View Server Profiles
- PRIVSET.View Unified Edge Profiles
- READ.thermal.PolicyInventory
- ROLE.Account Administrator
- ROLE.Read-Only
parameters:
- $ref: '#/components/parameters/moidParam'
- $ref: '#/components/parameters/selectParam'
- $ref: '#/components/parameters/expandParam'
- $ref: '#/components/parameters/atParam'
responses:
'200':
description: An instance of the 'thermal.PolicyInventory' resource.
headers:
Set-Cookie:
$ref: '#/components/headers/Set-Cookie'
x-starship-traceid:
$ref: '#/components/headers/x-starship-traceid'
Content-Disposition:
$ref: '#/components/headers/Content-Disposition'
Content-Length:
$ref: '#/components/headers/Content-Length'
content:
application/json:
schema:
$ref: '#/components/schemas/thermal.PolicyInventory'
text/csv:
schema:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/CsvFile
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
schema:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/ExcelFile
links:
GetThermalPolicyInventoryByMoid:
operationId: GetThermalPolicyInventoryByMoid
parameters:
Moid: $response.body#/Moid
description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/thermal/PolicyInventories/{Moid}'.
GetIamAccountByMoid:
$ref: '#/components/links/GetIamAccountByMoid'
GetIamDomainGroupByMoid:
$ref: '#/components/links/GetIamDomainGroupByMoid'
'400':
$ref: '#/components/responses/http_status_400'
'401':
$ref: '#/components/responses/http_status_401'
'403':
$ref: '#/components/responses/http_status_403'
'404':
$ref: '#/components/responses/http_status_404'
default:
$ref: '#/components/responses/default'
components:
schemas:
thermal.PolicyInventory.Response:
description: "The response body of a HTTP GET request for the 'thermal.PolicyInventory' resource.\nThe value may be one of the following types.\n1. When 'tag' is specified in the URL query, the response schema\n is a summary of the tag usage.\n1. When '$apply' is specified in the URL query, the response schema\n is dynamically-generated schema based on the $apply value.\n1. When '$count' is specified in the URL query, the response is\n a simple object providing the count of the resources.\n1. In all other cases, the response is a list of 'thermal.PolicyInventory' resources."
x-one-of-name: thermal.PolicyInventory.Response
oneOf:
- $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.DocumentCount
- $ref: '#/components/schemas/thermal.PolicyInventory.List'
- $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.AggregateTransform
- $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.TagSummary
discriminator:
propertyName: ObjectType
thermal.Policy.Response:
description: "The response body of a HTTP GET request for the 'thermal.Policy' resource.\nThe value may be one of the following types.\n1. When 'tag' is specified in the URL query, the response schema\n is a summary of the tag usage.\n1. When '$apply' is specified in the URL query, the response schema\n is dynamically-generated schema based on the $apply value.\n1. When '$count' is specified in the URL query, the response is\n a simple object providing the count of the resources.\n1. In all other cases, the response is a list of 'thermal.Policy' resources."
x-one-of-name: thermal.Policy.Response
oneOf:
- $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.DocumentCount
- $ref: '#/components/schemas/thermal.Policy.List'
- $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.AggregateTransform
- $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.TagSummary
discriminator:
propertyName: ObjectType
thermal.PolicyInventory:
title: Thermal
description: 'The Thermal Policy is a reusable policy for managing the thermal and fan control settings of a server or chassis.
#### Purpose
The purpose of this policy is to allow administrators to define a cooling strategy for their hardware. By selecting a specific fan control mode, they can balance the trade-offs between cooling performance, power consumption, and acoustic noise to best suit the operating environment and workload requirements.
#### Key Concepts
- **Fan Control Mode:** The core of the policy is the fanControlMode setting, which offers several presets (e.g., Balanced, Low Power, Maximum Cooling, Acoustic) to dictate fan speed behavior.
- **Chassis and Server Application:** The policy can be applied to both Server Profiles and Chassis Profiles, allowing for consistent thermal management at both the individual server and chassis levels.
- **Platform-Specific Options:** The available fan control modes can vary depending on the server or chassis model (e.g., certain modes are exclusive to UCS X-Series).
- **Profile-Based Management:** As a policy object, it ensures that all devices associated with a profile adhere to the same thermal strategy.'
x-allOf-name: thermal.PolicyInventory
allOf:
- $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/policy.AbstractPolicyInventory
- type: object
description: Definition of the list of properties defined in 'thermal.PolicyInventory', excluding properties defined in parent classes.
required:
- ClassId
- ObjectType
properties:
ClassId:
description: 'The fully-qualified name of the instantiated, concrete type.
This property is used as a discriminator to identify the type of the payload
when marshaling and unmarshaling data.'
enum:
- thermal.PolicyInventory
default: thermal.PolicyInventory
x-enum-as-string: true
ObjectType:
description: 'The fully-qualified name of the instantiated, concrete type.
The value should be the same as the ''ClassId'' property.'
enum:
- thermal.PolicyInventory
default: thermal.PolicyInventory
x-enum-as-string: true
AggressiveCooling:
description: 'Sets the Aggressive Cooling to Enable/Disable.
* `Disabled` - Set the value to Disabled.
* `Enabled` - Set the value to Enabled.'
type: string
enum:
- Disabled
- Enabled
default: Disabled
readOnly: true
x-omitempty: true
FanControlMode:
description: 'Sets the Fan Control Mode. High Power, Maximum Power and Acoustic modes are supported only on the Cisco UCS C-Series servers and on the X-Series Chassis. Maximum cooling mode is only supported on Unified Edge platforms and Cisco UCS C-Series M7+ servers running firmware 4.3 (5.250001) or later. C480M5 does not support Acoustic mode.
* `Balanced` - The fans run faster when needed based on the heat generated by the server. When possible, the fans returns to the minimum required speed.
* `LowPower` - The Fans run at the minimum speed required to keep the server cool.
* `HighPower` - The fans are kept at higher speed to emphasizes performance over power consumption. This Mode is only supported for UCS X series Chassis.
* `MaximumPower` - The fans are always kept at maximum speed. This option provides the most cooling and consumes the most power. This Mode is only supported for UCS X series Chassis.
* `Acoustic` - The fan speed is reduced to reduce noise levels in acoustic-sensitive environments. This Mode is only supported for UCS X series Chassis.
* `MaximumCooling` - The fan speed is kept for maximum cooling. This mode is only supported for Cisco UCS C-Series server models M7 and above for server firmware 4.3 (5.250001) and later.'
type: string
enum:
- Balanced
- LowPower
- HighPower
- MaximumPower
- Acoustic
- MaximumCooling
default: Balanced
readOnly: true
x-omitempty: true
TargetMo:
$ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.BaseMo.Relationship
description: 'A reference to a moBaseMo resource.
When the $expand query parameter is specified, the referenced resource is returned inline.'
readOnly: true
thermal.Policy:
title: Thermal
description: 'The Thermal Policy is a reusable policy for managing the thermal and fan control settings of a server or chassis.
#### Purpose
The purpose of this policy is to allow administrators to define a cooling strategy for their hardware. By selecting a specific fan control mode, they can balance the trade-offs between cooling performance, power consumption, and acoustic noise to best suit the operating environment and workload requirements.
#### Key Concepts
- **Fan Control Mode:** The core of the policy is the fanControlMode setting, which offers several presets (e.g., Balanced, Low Power, Maximum Cooling, Acoustic) to dictate fan speed behavior.
- **Chassis and Server Application:** The policy can be applied to both Server Profiles and Chassis Profiles, allowing for consistent thermal management at both the individual server and chassis levels.
- **Platform-Specific Options:** The available fan control modes can vary depending on the server or chassis model (e.g., certain modes are exclusive to UCS X-Series).
- **Profile-Based Management:** As a policy object, it ensures that all devices associated with a profile adhere to the same thermal strategy.'
x-allOf-name: thermal.Policy
allOf:
- $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/policy.AbstractPolicy
- type: object
description: Definition of the list of properties defined in 'thermal.Policy', excluding properties defined in parent classes.
required:
- ClassId
- ObjectType
properties:
ClassId:
description: 'The fully-qualified name of the instantiated, concrete type.
This property is used as a discriminator to identify the type of the payload
when marshaling and unmarshaling data.'
enum:
- thermal.Policy
default: thermal.Policy
x-enum-as-string: true
ObjectType:
description: 'The fully-qualified name of the instantiated, concrete type.
The value should be the same as the ''ClassId'' property.'
enum:
- thermal.Policy
default: thermal.Policy
x-enum-as-string: true
FanControlMode:
description: 'Sets the Fan Control Mode. High Power, Maximum Power and Acoustic modes are supported only on the Cisco UCS C-Series servers and on the X-Series Chassis. Maximum cooling mode is only supported on Unified Edge platforms and Cisco UCS C-Series M7+ servers running firmware 4.3 (5.250001) or later. C480M5 does not support Acoustic mode.
* `Balanced` - The fans run faster when needed based on the heat generated by the server. When possible, the fans returns to the minimum required speed.
* `LowPower` - The Fans run at the minimum speed required to keep the server cool.
* `HighPower` - The fans are kept at higher speed to emphasizes performance over power consumption. This Mode is only supported for UCS X series Chassis.
* `MaximumPower` - The fans are always kept at maximum speed. This option provides the most cooling and consumes the most power. This Mode is only supported for UCS X series Chassis.
* `Acoustic` - The fan speed is reduced to reduce noise levels in acoustic-sensitive environments. This Mode is only supported for UCS X series Chassis.
* `MaximumCooling` - The fan speed is kept for maximum
# --- truncated at 32 KB (421 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/intersight/refs/heads/main/openapi/intersight-thermal-api-openapi.yml