Contents

Introduction

Prerequisites

Requirements

Componentes Utilizados

Informações de Apoio

Solicitações de API da conta da Intersight SaaS ou da Intersight Appliance

Etapas da Visão Geral

Descomissionar/recomissionar um servidor

Cancelar Atribuição do Perfil de Servidor

Remover servidor

Solucionar problemas de ações por meio do API Explorer no Console do dispositivo

Reinicializar o Controlador de Gerenciamento CIMC de um Servidor

Reinicializar um módulo de I/O (IOM)

Informações Relacionadas

Introduction

Este documento descreve as solicitações de API que podem ser úteis em momentos de contenção quando certas ações em servidores não podem ser executadas através da interface do usuário.

Contribuição de Luis Uribe Rojas, engenheiro do Cisco TAC e Justin Pierce, líder técnico.

Prerequisites

Requirements

A Cisco recomenda que você tenha conhecimento destes tópicos:

- Intersight

- Servidores Unified Computing System (UCS)

- IMM (Intersight Managed Mode, modo gerenciado de supervisão)

- Interface de programação de aplicativos (API)

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

- Interconexão em malha Cisco UCS 6454, firmware 4.2(1m)

- Servidor blade UCSB-B200-M5, firmware 4.2(1a)

- Software como serviço (SaaS) da Intersight

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Informações de Apoio

A Cisco Intersight oferece uma API RESTful baseada em nuvem para gerenciar destinos conectados à Intersight em vários data centers. Os serviços de infraestrutura da Cisco Intersight incluem a implantação, o monitoramento, o gerenciamento e o suporte para infraestruturas físicas e virtuais.

Em situações em que determinadas ações nos servidores gerenciados Intersight não podem ser executadas através da interface do usuário (UI) do Intersight, seja porque as opções estão esmaecidas ou o acesso à UI não está disponível, as solicitações de API podem ser uma alternativa útil.

Solicitações de API da conta da Intersight SaaS ou da Intersight Appliance

Etapas da Visão Geral

Os próximos exemplos seguem uma estrutura consistente, embora os valores e parâmetros específicos usados possam variar. Este é um breve resumo das etapas envolvidas:

Faça login na conta da Intersight.

Em um ambiente SaaS, em um navegador, navegue para Referência de API e faça login com sua conta.

Observação: para um ambiente de dispositivo, como o Intersight Connected Virtual Appliance (CVA) ou o Intersight Private Virtual Appliance (PVA) Em um navegador, navegue até https://<Appliance-Hostname>/apidocs/apirefs e faça login com as credenciais do dispositivo.

1. Procure a solicitação de API de que você precisa e use um GET chamada filtrada com valores de campo conhecidos, como Número de série, Perfil do servidor, Nome do servidor, Moid do dispositivo, etc.

2. Use o PATCH ligar para a Ação correspondente para executar a tarefa necessária

Dica: em Parâmetros de consulta, certifique-se de usar as mesmas letras exatas para Exemplos de chave e valor para evitar erros.

No guia de referência de API, é útil revisar a Response Model para obter a sintaxe apropriada e todas as ações suportadas que podem ser usadas no payload de uma chamada. Por exemplo, de  /api/v1/compute/BladeIdentities/, as ações de administração suportadas são None, Decommission, Recommission, Reack, Remove,e Replace. Este modelo é usado em todo este documento.

Descomissionar/recomissionar um servidor

No documento de referência da API de Intersight, procure o compute/BladeIdentities , selecione o primeiro GET e insira os parâmetros de consulta necessários.

Este exemplo usa estes parâmetros:

Chave

Valor

Uso

$filter

Serial Eq 'FLM2402001A'

Para filtrar a saída para o servidor com o número de série fornecido.

$select

Moid

Para selecionar os valores a serem exibidos nesse objeto. O valor exibido é o Moid do servidor.

Aplique a PATCH ligue com a ação necessária. Este exemplo usa:

{"AdminAction":"Decommission"}

Dica: se a rerecomendação for necessária, use {"AdminAction":"Recommission"}.

Cancelar Atribuição do Perfil de Servidor

Procure a solicitação Server/Profiles, selecione a primeira chamada GET e insira os parâmetros de consulta necessários.

Este exemplo usa estes parâmetros:

Chave

Valor

Uso

$filter

Name Eq 'UCSX-Server-boot-SAN'

Para filtrar a saída para o perfil de servidor que tem o nome inserido.

$select

Moid,Nome

Para selecionar o(s) valor(es) a ser(em) exibido(s) nesse objeto. Nesse caso

Aplique a chamada PATCH com a ação necessária. Este exemplo usa:

{"Action":"Unassign"}

Remover servidor

No documento de referência da API Intersight, procure a solicitação compute/BladeIdentities e selecione a primeira GET , em seguida, insira os Parâmetros de consulta necessários.

Este exemplo usa estes parâmetros:

Chave

Valor

Uso

$filter

Serial Eq 'FLM2402001A'

Para filtrar a saída somente para o servidor com o número de série fornecido.

$select

Moid

Para selecionar os valores a serem exibidos nesse objeto. O valor exibido é o Moid do servidor.

Aplique a chamada PATCH com a ação necessária. Este exemplo usa:

{"AdminAction":"Remove"}

Aviso: esta solicitação resulta na remoção do servidor do Inventário. Para adicionar o servidor de volta ao inventário do domínio, uma nova descoberta é necessária. Isso pode ser acionado por meio de uma reinstalação física do servidor ou por uma tarefa de redescoberta de chassi.

Solucionar problemas de ações por meio do API Explorer no Console do dispositivo

O Console do dispositivo permite monitorar a integridade de seus dispositivos e o status da conexão deles com o Intersight. Você pode gerar pacotes de suporte técnico que contenham informações de diagnóstico para solucionar e analisar problemas. Além disso, o console do dispositivo inclui a capacidade de iniciar o API Explorer para executar operações baseadas em Redfish™ em servidores.

Caso a conectividade seja perdida entre a Intersight ou o equipamento, o API Explorer no Console do dispositivo também pode ser usado para executar algumas ações básicas de solução de problemas.

1) Abra o console do dispositivo, navegue até um dos endereços IP de interconexão de estrutura e selecione a guia Inventário.

2) Navegue até o dispositivo específico que precisa de solução de problemas, selecione os três pontos à direita dele e selecione Launch API Explorer. O API Explorer é iniciado somente para esse dispositivo, e nenhum outro.

Reinicializar o Controlador de Gerenciamento CIMC de um Servidor

Inicie o API Explorer para o servidor:

Digite CIMC em {ManagerID} e aplique um POST Managers/{ManagerId}/Actions/Manager.Reset chamar e adicionar o tipo de redefinição.

Este exemplo usa:

{"ResetType": "ForceRestart"}

Reinicializar um módulo de I/O (IOM)

Inicie o API Explorer do IOM:

Digite CMC em {ManagerID} e aplique um POST Managers/{ManagerId}/Actions/Manager.Reset chamar e adicionar o Tipo de Redefinição. Este exemplo usa:

{"ResetType": "ForceRestart"}

Para reinicializar uma IOM de mesmo nível noManagerID}, insira PeerCMC com a mesma chamada de antes.

Informações Relacionadas

Visão geral da API Intersight

Visão geral do console do dispositivo