Introducción

Este documento describirá los pasos necesarios para agregar etiquetas en Cisco Intersight tanto en la interfaz de usuario como a través de la API. Actualmente, el portal web de Intersight no admite el etiquetado de todos los objetos (consulte CSCvs33046); sin embargo, casi todos los objetos también se pueden etiquetar a través de la API.

Requirements 

• Acceso de nivel de administrador a la cuenta
• Acceso a los terminales de la API (si se utiliza la API); por ejemplo, terminal iam.Account

Actualización de Etiquetas a través de la interfaz de usuario de Cisco Intersight

Requisitos previos

Autenticar

Asegúrese de que está autenticado en la cuenta en la que desea actualizar los objetos. Asegúrese de que ha iniciado sesión como administrador de cuentas. Al hacer clic en el nombre de la parte superior derecha, se deben mostrar el Nombre de cuenta actual, ID de cuenta, Correo electrónico y Función.

Actualización de las etiquetas de cuenta

1. Dentro de Intersight seleccione el engranaje y la configuración:

2. En el panel de configuración, asegúrese de que la ficha Detalles de cuenta esté seleccionada y pulse el botón Configurar:

3. En la entrada Set Tags (Establecer etiquetas), introduzca las etiquetas que desee:

Nota: Si la etiqueta no se ha utilizado anteriormente en la cuenta, no aparecerá como una predicción, esto está bien, simplemente pulse Intro después de introducir su etiqueta. La etiqueta debe introducirse en "key: formato de valor", por ejemplo, antes hemos introducido:

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

Esto creará una etiqueta con una clave de AutoRMAEmail y un valor de kmccabe2@cisco.com,sttardy@cisco.com .

4. Después de pulsar Intro, haga clic en Guardar:

6. Las etiquetas ahora están visibles en la cuenta:

Actualizar desde la vista de lista

Muchos objetos que se muestran en una vista de lista en Intersight pueden etiquetarse. Por ejemplo, servidores, clústeres, Fabric Interconnects, chasis, etc.

Tenga en cuenta lo siguiente: Si utiliza etiquetas para la configuración de la función de RMA proactiva, no se aceptará ninguno de los elementos (Servidor, Fabric Interconnects, etc.) que admitan el etiquetado en la interfaz de usuario que no sean las cuentas (mencionadas anteriormente). No utilice los siguientes pasos para la configuración de etiquetas RMA proactivas.

1. En la vista de lista dada, seleccione las entradas que desea etiquetar:

2. Pulse el botón de etiqueta (junto a los tres puntos):

3. Introduzca etiquetas en el cuadro de diálogo:

Nota: Si la etiqueta no se ha utilizado anteriormente en la cuenta, no aparecerá como una predicción, esto está bien, simplemente pulse Intro después de introducir su etiqueta. La etiqueta debe introducirse en "key: formato de valor", por ejemplo, antes hemos especificado Location: RTP . Esto creará una etiqueta con una clave de ubicación y un valor de RTP.

4. Después de pulsar Intro, haga clic en Guardar:

Actualización de etiquetas a través de la API

Requisitos previos

Autenticar

Los administradores que deseen etiquetar la cuenta deben iniciar sesión en Intersight. Cuando haya iniciado sesión, la esquina superior derecha de la pantalla debe mostrar el nombre del administrador como se muestra en la siguiente imagen.

Los administradores que no hayan iniciado sesión verán Iniciar sesión en lugar de su nombre, como se muestra en la siguiente imagen.

Además, los administradores deben autenticarse en la cuenta adecuada que contiene los objetos que se van a etiquetar. Al hacer clic en el nombre de la parte superior derecha, se deben mostrar el Nombre de cuenta actual, ID de cuenta, Correo electrónico y Función.

Etiquetado de una organización

1. Documentos API abiertos para organizaciones

Navegue hasta la página de documentación de api para Organizaciones.

Nota: Si utiliza Connected Virtual Appliance, navegue a https://[FQDN del dispositivo]/apidocs/apirefs/organization/Organizations/model/ en su lugar

2. Identifique la organización que desea actualizar.

Consulte la Guía de consulta de la API de Intersight para obtener información.

Los usuarios pueden utilizar simplemente el terminal GET para enumerar todas las organizaciones sin parámetros. Si hay demasiadas organizaciones en su cuenta para ver fácilmente en un resultado, los usuarios pueden utilizar un parámetro de consulta $select para limitar los campos mostrados, pero asegúrese de incluir Etiquetas en la instrucción $select, por ejemplo:

Desde el resultado de la API el campo que necesitamos es el campo Moid, este es un identificador único para esta organización en perspectiva y se usará en el siguiente paso, también necesitamos obtener cualquier etiqueta que esté ahí para el siguiente paso.

4. Actualizar las etiquetas de la organización

Vamos a aprovechar el terminal Organization PATCH API. A partir de aquí, vamos a utilizar el MOID recopilado antes en el campo de entrada de moid, y las etiquetas reunidas antes en el campo de cuerpo.

Importante: asegúrese de que no utiliza la API DELETE, ya que se eliminará su organización.

El cuerpo de la llamada PATCH de muestra anterior:

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

Las etiquetas existentes que se encuentren en el registro se pueden agregar a la matriz de etiquetas.

Tenga en cuenta lo siguiente: si sigue este procedimiento para configurar la RMA proactiva, las direcciones de correo electrónico de aquí deben ser correlativas a una cuenta CCO.

Etiquetado de un dispositivo registrado

1. Abrir documentos API para dispositivos registrados

Acceda a la página de documentación de API para dispositivos registrados

Nota: Si utiliza Connected Virtual Appliance, navegue a https://[FQDN del dispositivo]/apidocs/apirefs/asset/DeviceRegistrations/model/ en su lugar

2. Identificar el dispositivo registrado que debe actualizarse

Consulte la Guía de Consulta de API de Intersight para obtener información

Una de las maneras más sencillas de consultar es por nombre de host, para hacerlo, una consulta se podría diseñar de la siguiente manera:

DeviceHostname eq 'F340-21-22-UCS4'

Aprovechando $filter y $select, vemos un resultado más manejable:

3. Utilice la API PATCH para actualizar etiquetas

Extraiga las etiquetas que ya estén en el dispositivo registrado, así como el motor del dispositivo. Vaciar al punto final PATCH, pegar en el Moid en la entrada moid superior Por ejemplo:

El cuerpo de la llamada PATCH de muestra anterior:

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

Las etiquetas existentes que se encuentren en el registro se pueden agregar a la matriz de etiquetas.

Tenga en cuenta lo siguiente: si sigue este procedimiento para configurar la RMA proactiva, las direcciones de correo electrónico de aquí deben ser correlativas a una cuenta CCO.