Contents

Pré-requisitos

Autenticar

Atualizando marcas de conta

Atualizando a partir da exibição de lista

Pré-requisitos

Autenticar

Marcação de uma organização

1. Documentos API abertos para organizações

2. Identifique a organização que deseja atualizar.

4. Atualizar as marcas da organização

Marcação de um dispositivo registrado

1. Documentos API abertos para dispositivos registrados

2. Identificar o dispositivo registrado que precisa ser atualizado

3. Usar a API PATCH para atualizar marcas

Introduction

Este documento descreverá as etapas necessárias para adicionar tags no Cisco Intersight na IU e via API. Atualmente, o portal da Web do Intersight não oferece suporte à marcação de todos os objetos (consulte CSCvs33046), no entanto, quase todos os objetos podem ser etiquetados também através da API.

Requirements

- Acesso de nível de administrador à conta

- Acesso aos terminais da API (se estiver usando a API) Por exemplo: iam.Ponto de extremidade da conta

Atualizando marcas por meio da interface do usuário do Cisco Intersight

Pré-requisitos

Autenticar

Verifique se você está autenticado na conta na qual deseja atualizar objetos. Assegure-se de fazer logon como uma função de administrador de conta. Clicar no nome na parte superior direita deve mostrar o Nome da conta atual, ID da conta, E-mail e função.

Atualizando marcas de conta

1. No Intersight, selecione a engrenagem e as configurações:

2. No painel de configurações, verifique se a guia Detalhes da conta está selecionada e pressione o botão Configurar:

3. Na entrada Set Tags (Definir marcas), insira as marcas que desejar:

Note: Se a marca não tiver sido usada antes na conta, ela não aparecerá como uma previsão, tudo bem, basta pressionar Enter depois de digitar sua marca. A marca deve ser inserida em "chave: value" (valor), por exemplo, acima inserimos:

AutoRMAEmail: kmccabe2@cisco.com,sttardy@cisco.com

Isso criará uma marca com uma chave de AutoRMAEmail e um valor de kmccabe2@cisco.com,sttardy@cisco.com .

4. Depois de pressionar enter, clique em salvar:

6. As marcas agora estão visíveis na conta:

Atualizando a partir da exibição de lista

Muitos objetos exibidos em uma exibição de lista no Intersight podem ser marcados. Por exemplo, servidores, clusters, interconexões de estrutura, chassi etc.

Observe que: Se você estiver usando tags para a configuração do recurso RMA pró-ativo, nenhum dos itens (Servidor, Interconexões de estrutura, etc.) que suportem a marcação na interface do usuário que não sejam as Contas (discutido acima) será honrado. Não use as etapas abaixo para configurar as marcas de RMA proativas.

1. Na exibição de lista fornecida, selecione as entradas que deseja marcar:

2. Pressione o botão de marca (ao lado dos três períodos):

3. Insira marcas na caixa de diálogo:

Note: Se a marca não tiver sido usada antes na conta, ela não aparecerá como uma previsão, tudo bem, basta pressionar Enter depois de digitar sua marca. A marca deve ser inserida em "chave: value" (valor), por exemplo, acima inserimos Location (Local): RTP . Isso criará uma marca com uma chave de Local e um valor de RTP.

4. Depois de pressionar Enter, clique em salvar:

Atualizando marcas por meio da API

Pré-requisitos

Autenticar

Os administradores que desejam marcar a conta devem estar conectados ao Intersight. Quando conectado, o canto superior direito da tela deve mostrar o nome do administrador, como mostrado na imagem abaixo.

Os administradores que não estão conectados nele verão Entrar em vez do nome, como mostrado na imagem abaixo.

Além disso, os administradores devem ser autenticados na conta apropriada que contém os objetos a serem marcados. Clicar no nome na parte superior direita deve mostrar o Nome da conta atual, ID da conta, E-mail e função.

Marcação de uma organização

1. Documentos API abertos para organizações

Navegue até a página api doc para Organizações.

Note: Se estiver usando o Connected Virtual Appliance, navegue para https://[FQDN do appliance]/apidocs/apirefs/Organization/Organizations/model/

2. Identifique a organização que deseja atualizar.

Consulte o Guia de Consulta API do Intersight para referência.

Os usuários podem simplesmente usar o endpoint GET para listar todas as organizações sem parâmetros. Se houver muitas organizações em sua conta para visualizar facilmente uma saída, os usuários podem usar um parâmetro de consulta $select para limitar os campos mostrados, mas certifique-se de incluir Marcas na instrução $select, por exemplo:

Na saída da API, o campo que precisamos é o campo Moid, este é um identificador exclusivo para esta organização em entrevistas e será usado na próxima etapa, também precisamos obter todas as marcas que estão lá para a próxima etapa.

4. Atualizar as marcas da organização

Vamos aproveitar o endpoint da API PATCH da Organização. A partir daqui, usaremos o MOID coletado antes no campo de entrada do modem e as marcas coletadas antes no campo de corpo.

Importante: certifique-se de que não está a utilizar a API DELETE, uma vez que esta ação eliminará a sua organização.

O corpo da chamada PATCH de exemplo acima:

{"Tags":[{"Key":"AutoRMAEmail","Value":"joe@somedomain.com"}]}

Qualquer marca existente que esteja no registro pode ser adicionada à matriz de marcas.

Observe que: se você estiver seguindo este procedimento para configurar a RMA proativa, os endereços de e-mail aqui devem ser correlativos a uma conta CCO.

Marcação de um dispositivo registrado

1. Documentos API abertos para dispositivos registrados

Navegue até a página de documentos da API para Dispositivos registrados

Note: Se estiver usando o Connected Virtual Appliance, navegue para https://[FQDN do appliance]/apidocs/apirefs/asset/DeviceRegistrations/model/em vez disso

2. Identificar o dispositivo registrado que precisa ser atualizado

Consulte o Guia de Consulta da API do Intersight para obter referência

Uma das maneiras mais fáceis de consultar é por nome de host, para fazer isso, uma consulta pode ser feita como:

DeviceHostname eq 'F340-21-22-UCS4'

Aproveitando $filter e $select, vemos uma saída mais gerenciável:

3. Usar a API PATCH para atualizar marcas

Extraia todas as marcas que já estão no dispositivo registrado, bem como o modelo do dispositivo. Nagivar até o endpoint PATCH, cole no Moid na entrada do moid superior Por exemplo:

O corpo da chamada PATCH de exemplo acima:

{"Tags":[{"Key":"AutoRMAEmail","Value":"joe@somedomain.com"}]}

Qualquer marca existente que esteja no registro pode ser adicionada à matriz de marcas.

Observe que: se você estiver seguindo este procedimento para configurar a RMA proativa, os endereços de e-mail aqui devem ser correlativos a uma conta CCO.