在Cisco Intersight資源上配置標籤

簡介

本文檔介紹向Cisco Intersight資源新增標籤所需的步驟。

背景資訊

標籤是可用於CIsco Intersight中的資源的鍵/值後設資料的通用部分。這些資源可能因伺服器終端、帳戶等而異。

作為使用者，標籤可用於對CIsco Intersight資源進行分組，從而允許根據這些標籤值查詢資源。

在思科，有多種程式依賴思科Intersight資源標籤來啟用/禁用特定功能。有關這些特性和功能的詳細資訊，請參閱特定程式的文檔。

帳戶資源標籤

需求

• 要修改的帳戶的帳戶管理員角色
• 對iam.Account API終結點的訪問

通過UI登入時，按一下UI右上角的配置檔案選單以顯示登入的帳戶和角色。

通過使用者介面

1. 按一下Services Selector
2. 選擇「系統」

3.從設定>帳戶詳細資訊檢視中，按一下「配置」。

4.在「Configure Account Settings」彈出視窗中，可以提交key:value對以新增新標籤。

5.輸入後，按一下「Configure」以提交

 必須使用「key:value」格式輸入標籤。例如，我們輸入以下內容：

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

這將在「帳戶」資源上建立一個標籤，其鍵為AutoRMAEmail，值為kmccabe2@cisco.com,sttardy@cisco.com。

註：新增網路新標籤時，自動幫助程式預測不會顯示任何選項。輸入與文檔完全相同的新網路標籤，然後點選enter以提交。

6.可以從Account Details檢視驗證配置的標籤

通過API

1. HTTP GET the iam.Account resource，以查詢要更新的特定帳戶資源(AccountMoid)的Moid。應記錄要保留的任何現有標籤。

GET /api/v1/iam/Accounts

RESPONSE:
{
  "ObjectType": "iam.Account.List",
  "Results": [
    {
      "AccountMoid": "5eb2e1e47564612d307xxxxx",
      "Moid": "5eb2e1e47564612d307xxxxx",
      ...snip...
      "Tags": [{
        "Key":"existingKey",
        "Value":"existingVal"
      }]
    }]
}

2. HTTP POST特定的iam.Account資源（按Moid），並在請求負載中包括新的和現有的標籤。

注意：如果帳戶資源具有現有標籤，則這些標籤必須包含在POST中才能保留。如果它們未包括在POST中，則它們將從帳戶資源中刪除。

POST /api/v1/iam/Accounts/5eb2e1e47564612d307xxxxx

PAYLOAD:
{
    "Tags": [{
        "Key": "existingKey",
        "Value": "existingVal"
    }, { 
        "Key": "ACIProactive", 
        "Value": "brvarney@cisco.com"
     }]
}

基礎結構服務資源標籤

通過UI清單檢視

可以標籤通過基礎設施服務顯示在清單檢視中的資源。例如，伺服器、集群、交換矩陣互聯、機箱等。

注意:主動RMA不支援通過基礎設施服務資源標籤啟用的任何功能。請勿使用下列步驟配置主動式RMA標籤。

1.在清單檢視中，選中要標籤的資源的覈取方塊

2.按省略號旁邊的標籤按鈕

3.在「設定共享標籤」彈出視窗中，輸入要應用於所有選定對象的key:value標籤

4.按一下「保存」以提交

註：新增網路新標籤時，自動幫助程式預測不會顯示任何選項。輸入與文檔完全相同的新網路標籤，然後點選enter以提交。

組織資源標籤

通過API

1.面向組織的開放式API文檔

導航到「組織」的api文檔頁面。

注意：如果使用連線的虛擬裝置，請改為導航到https://[裝置的FQDN]/apidocs/apirefs/organization/Organizations/model/R

2.確定要更新的組織。

請參閱Intersight API查詢指南以獲取參考。

使用者只需使用GET端點列出所有不帶引數的組織。如果您的帳戶中有太多組織，無法在一個輸出中輕鬆檢視，則使用者可以使用$select查詢引數來限制顯示的欄位，但請確保在$select語句中包括標籤，例如：

從API輸出中，我們需要的是Moid欄位，這是此組織內部的唯一識別符號，將在下一步中使用，我們還需要獲取位於此處的任何標籤進行下一步。

3.根據「組織」模式使用組織補丁API終結點更新組織的標籤。確保重新輸入在正文欄位中收集的現有標籤，否則這些標籤將被刪除。

上面的PATCH呼叫示例的正文：

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

註冊的所有現有標籤都可以新增到標籤陣列中。

請注意：如果您要按照此步驟配置主動RMA，則此處的電子郵件地址需要與CCO帳戶相關。

裝置註冊資源標籤

通過API

1.針對註冊裝置的開放API文檔

導航到Registered Devices（已註冊裝置）的API doc頁面

如果使用連線的虛擬裝置，請改為導航到https://[裝置的FQDN]/apidocs/apirefs/asset/DeviceRegistrations/model/

2.識別需要更新的註冊裝置

請參閱Intersight API查詢指南以獲取參考

最簡單的查詢方法之一是按主機名進行查詢，為此，可以按如下方式建立查詢：

DeviceHostname eq 'F340-21-22-UCS4'

利用$filter和$select我們看到了更易於管理的輸出：

3.使用PATCH API更新標籤

提取已註冊裝置上的任何標籤以及裝置的型號。向PATCH端點新增註釋，在頂部moid條目的Moid中貼上例如：

上面的PATCH呼叫示例的正文：

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

註冊的所有現有標籤都可以新增到標籤陣列中。

請注意：如果您要按照以下步驟配置主動RMA，則需要使用有效的思科帳戶使用者名稱/CCO ID註冊此處的電子郵件地址。