通过Intersight API请求排除IMM服务器上的操作故障

简介

本文档介绍API请求，当无法通过UI对服务器执行某些操作时，这些请求在争用时非常有用。

作者：思科TAC工程师Luis Uribe Rojas和技术主管Justin Pierce。

先决条件

要求

Cisco 建议您了解以下主题：

• Intersight
• 统一计算系统(UCS)服务器
• Intersight管理模式(IMM)
• 应用编程接口(API)

使用的组件

本文档中的信息基于以下软件和硬件版本：

• Cisco UCS 6454交换矩阵互联，固件4.2(1m)
• UCSB-B200-M5刀片服务器，固件4.2(1a)
• Intersight软件即服务(SaaS)

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

背景信息

Cisco Intersight提供一个基于云的RESTful API，用于管理多个数据中心内与Intersight相连的目标。Cisco Intersight基础设施服务包括对物理和虚拟基础设施的部署、监控、管理和支持。

如果无法通过Intersight的用户界面(UI)在Intersight托管服务器上执行某些操作，则由于选项灰显或对UI的访问不可用，API请求可能是有用的替代方法。

来自Intersight SaaS或Intersight设备帐户的API请求

概述步骤

下面的示例遵循一致的结构，但使用的具体参数和值可能会有所不同。以下是相关步骤的摘要：

登录到Intersight帐户。

对于SaaS环境，请在浏览器中导航到API参考，然后使用您的帐户登录。

注意：对于设备环境，如Intersight连接虚拟设备(CVA)或Intersight专用虚拟设备(PVA)。在浏览器中，导航到https://<Appliance-Hostname>/apidocs/apirefs并使用设备凭证登录。

1. 查找所需的API请求，并使用使用已知字段值（如序列号、服务器配置文件、服务器名称、设备Moid等）过滤的GET呼叫。
2. 使用PATCH呼叫和对应的操作执行所需的任务

提示：在查询参数上，请确保对键和值示例使用相同的精确字母以避免错误。

在《API参考指南》中，查看Response Model选项卡很有用，以了解正确的语法和可在呼叫的有效负载中使用的所有支持的操作。例如，从/api/v1/compute/BladeIdentities/,支持的管理操作包括None、Decommission、Recommission、ReackRemove和Replace。本文档通篇使用这种模型。

停用/重新启用服务器

在Intersight API参考文档中，查找compute/BladeIdentities请求，选择第一个GET调用，然后输入所需的查询参数。

本示例使用以下参数：

使用所需操作应用PATCH呼叫。本示例使用：

 {"AdminAction":"Decommission"}

提示：如果需要重新授权，请使用{"AdminAction"："Recommission"}。

提示：对于IMM中的机架集成服务器和机箱，可发出类似操作。查找compute/RackUnitIdentities和equipment/ChassisIdentities API调用。

取消分配服务器配置文件

查找Server/Profiles请求并选择第一个GET 调用，然后输入所需的查询参数。

本示例使用以下参数：

通过所需的操作应用PATCH调用。本示例使用：

{"Action":"Unassign"}

删除服务器

在Intersight API参考文档中，查找compute/BladeIdentities请求并选择第一个GET调用，然后输入所需的查询参数。

本示例使用以下参数：

通过所需的操作应用PATCH调用。本示例使用：

{"AdminAction":"Remove"} 

警告：此请求会导致从资产中删除服务器。要将服务器重新添加到域的资产中，需要执行新发现。可以通过物理重新安装服务器或执行机箱重新发现任务来触发此功能。

重新启动服务器的IMC

在Intersight API参考文档中，查找compute/ServerSettings请求，选择第一个GET调用，然后输入所需的查询参数。

本示例使用以下参数：

{"AdminPowerState":"Reboot"}

警告：此请求将导致相关服务器的IMC流量重新启动，预计在重新引导管理控制器后会看到浅层发现工作流。

通过设备控制台中的API资源管理器排除操作故障

设备控制台允许您监控设备的运行状况以及它们与Intersight的连接状态。您可以生成包含诊断信息的技术支持捆绑包，以便进行故障排除和分析。此外，设备控制台还能够启动API Explorer以在服务器上执行基于Redfish™的操作。

如果Intersight或设备之间失去连接，还可以使用设备控制台中的API Explorer执行某些基本故障排除操作。

1)打开设备控制台，导航到交换矩阵互联IP地址之一，然后选择Inventory（资产）选项卡。

2)导航到需要排除故障的特定设备，选择设备右侧的三个点并选择Launch API Explorer。API Explorer仅针对该设备启动，其他设备均无法启动。

重新启动服务器的CIMC管理控制器

启动服务器的API资源管理器：

在{ManagerID}中键入CIMC并应用POST Managers/{ManagerId}/Actions/Manager.Reset调用并添加重置类型。

本示例使用：

{"ResetType": "ForceRestart"}

重新启动I/O模块(IOM)

启动IOM的API资源管理器：

在{ManagerID}中键入CMC并应用POST Managers/{ManagerId}/Actions/Manager.Reset调用并添加重置类型。本示例使用：

{"ResetType": "ForceRestart"}

要在{ManagerID}字段中重新启动对等IOM，请输入PeerCMC并发出与之前相同的呼叫。

相关信息

Intersight API概述

设备控制台概述