Tags

Tags and Tag Types

Cisco UCS Central uses tags to allow users to group objects outside of the Organization or Domain Group structures. You can use the following types of tags:

  • System-defined tags—Tags that are defined by Cisco UCS Central. This includes the Maintenance Group tag, the Operating System for HCR tag, and the Adapter Driver for HCR tag.

  • User-defined tags—Tags that are created by users but have specific values.

  • Basic tags—Free text tags that can allow any value.

From the Tag Management page in the GUI, you can view all Tag Types that have been created in Cisco UCS Central. However, you can view only the Tags that are associated with an object and are in active use at any given time.

Creating Tag Types

You can add tags to policies, logical resources such as service profiles and ID pools, and physical inventory components such as domains or servers.

Note

Only users with the Tag permission can create tag types.

Procedure
     Command or ActionPurpose
    Step 1UCSC # connect policy-mgr   Enters policy manager mode.  
    Step 2UCSC(policy-mgr) #scope fabric  

    Scopes into the fabric interconnect.

     
    Step 3 UCSC(policy-mgr) /fabric # scope tag-mgmt  

    Scopes into tag management.

     
    Step 4UCSC(policy-mgr) /fabric/tag-mgmt # create tag-type tag-type-name  

    Creates the tag type.

     
    Step 5 UCSC(policy-mgr) /fabric/tag-mgmt/tag-type/tag-item # set {color | descr | restricted {yes|no}}   (Optional)

    Sets the following for the tag type:

    • Color—Sets the color for the tag display.
      Note   

      You must enter color in hex code.

    • Description—Allows user to enter a description.

    • Restriction—Yes | No

      • No—Does not restrict the tag. Allows you to enter any text to the tag.

      • Yes—Restricts the tag to a predefined list. You can create a list of values, or add additional values to an existing list of values. When you assign the tag, you choose one of the values from the list.

     
    Step 6 UCSC(policy-mgr) /fabric/tag-mgmt/tag-type/tag-item # commit-buffer  

    Commits the transaction to the system.

     

    The following example shows how to create a tag and set options for it: 

    UCSC# connect policy-mgr
UCSC(policy-mgr)# scope fabric
UCSC(policy-mgr) /fabric # scope tag-mgmt
UCSC(policy-mgr) /fabric/tag-mgmt # create tag-type USA 
UCSC(policy-mgr) /fabric/tag-mgmt/tag-type # set color 722607
UCSC(policy-mgr) /fabric/tag-mgmt/tag-type # set descr 'USA updates'
UCSC(policy-mgr) /fabric/tag-mgmt/tag-type # set restricted no
UCSC(policy-mgr) /fabric/tag-mgmt/tag-type/tag-item # commit-buffer

    Creating Tag Values

    Procedure
       Command or ActionPurpose
      Step 1UCSC # connect policy-mgr   Enters policy manager mode.  
      Step 2UCSC(policy-mgr) #scope fabric  

      Scopes into the fabric interconnect.

       
      Step 3 UCSC(policy-mgr) /fabric # scope tag-mgmt  

      Scopes into tag management.

       
      Step 4 UCSC(policy-mgr) /fabric/tag-mgmt # scope tag-type tag-type  

      Scopes into a specific tag type.

       
      Step 5 UCSC(policy-mgr) /fabric/tag-mgmt/tag-type/tag-item # create tag-item tag-name  

      Creates a new tag value.

       
      Step 6 UCSC(policy-mgr) /fabric/tag-mgmt/tag-type/tag-item # commit-buffer  

      Commits the transaction to the system.

       

      The following example shows how to create tag values: 

      UCSC# connect policy-mgr
UCSC(policy-mgr)# scope fabric
UCSC(policy-mgr) /fabric # scope tag-mgmt
UCSC(policy-mgr) /fabric/tag-mgmt # show tag-type
Tag Type:
    Name                      Color      System Defined Multiple Restricted
    ------------------------- ---------- -------------- -------- ----------
    Adapter Driver for HCR    049fd9     Yes            Yes      Yes
    Basic                     5bc0de     Yes            Yes      No
    Geographic                5bc0de     No             Yes      No
    Maintenance Group         049fd9     Yes            No       Yes
    Operating System for HCR  049fd9     Yes            No       Yes
UCSC(policy-mgr) /fabric/tag-mgmt # scope tag-type 'Maintenance Group' 
UCSC(policy-mgr) /fabric/tag-mgmt/tag-type # create tag-item FW_Update
UCSC(policy-mgr) /fabric/tag-mgmt/tag-type/tag-item # commit-buffer

      Viewing Tags

      Procedure
         Command or ActionPurpose
        Step 1UCSC # connect policy-mgr   Enters policy manager mode.  
        Step 2UCSC(policy-mgr) #scope fabric  

        Scopes into the fabric interconnect.

         
        Step 3 UCSC(policy-mgr) /fabric # scope tag-mgmt  

        Scopes into tag management.

         
        Step 4 UCSC(policy-mgr) /fabric/tag-mgmt # show tag-type  

        Displays all tag types.

         
        Step 5 UCSC(policy-mgr) /fabric/tag-mgmt # scope tag-type 'tag-type'  

        Scopes into a specific tag type.

         
        Step 6 UCSC(policy-mgr) /fabric/tag-mgmt/tag-type # show tag-item  

        Displays the values for the selected tag.

         

        The following example shows how to view maintenance group tags: 

        UCSC# connect policy-mgr
UCSC(policy-mgr)# scope fabric
UCSC(policy-mgr) /fabric # scope tag-mgmt
UCSC(policy-mgr) /fabric/tag-mgmt # show tag-type
Tag Type:
    Name                      Color      System Defined Multiple Restricted
    ------------------------- ---------- -------------- -------- ----------
    Adapter Driver for HCR    049fd9     Yes            Yes      Yes
    Basic                     5bc0de     Yes            Yes      No
    Geographic                5bc0de     No             Yes      No
    Maintenance Group         049fd9     Yes            No       Yes
    Operating System for HCR  049fd9     Yes            No       Yes
UCSC(policy-mgr) /fabric/tag-mgmt # scope tag-type 'Maintenance Group' 
UCSC(policy-mgr) /fabric/tag-mgmt/tag-type # show tag-item
Tag Item:
    Value
    -----
    tag1
    tag2
    tag3
    tag4