Cisco Intersightリソースでのタグの設定

はじめに

このドキュメントでは、Cisco Intersightリソースにタグを追加するために必要な手順について説明します。

背景説明

タグは、Cisco Intersight内のリソースに適用できるキー/値メタデータの一般的な部分です。これらのリソースは、サーバのエンドポイントやアカウントなど、さまざまです。

ユーザは、タグを使用してCisco Intersightリソースをグループ化できます。このグループ化により、これらのタグ値に基づいてリソースのクエリーを実行できます。

シスコ内には、特定の機能セットを有効または無効にするためにCisco Intersightリソースタグに依存するさまざまなプログラムがあります。これらの機能の詳細については、各プログラムのマニュアルを参照してください。

アカウントリソースタグ

要件

• 変更するアカウントのアカウント管理者ロール
• iam.Account APIエンドポイントへのアクセス

UI経由でログインした場合、UIの右上にあるプロファイルメニューをクリックして、ログインしたアカウントとロールを表示します。

UIを使用

1. サービスセレクタをクリックします。
2. 「システム」を選択します。

3. 「設定」 > 「アカウントの詳細」ビューで、「設定」をクリックします。

4. 「アカウント設定の構成」ポップアップから、key:valueペアを送信して新しいタグを追加できます。

5.入力したら、「設定」をクリックして送信します

 タグは「key:value」形式で入力する必要があります。たとえば、上記では次のように入力しました。

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

これにより、AutoRMAEmailのキーと値kmccabe2@cisco.com,sttardy@cisco.comを持つタグがアカウントリソースに作成されます。

注:net-newタグを追加すると、自動ヘルパー予測にはオプションが表示されません。文書化されているとおりにnet-newタグを正確に入力し、enterキーを押して送信します。

6.設定されたタグは、アカウント詳細ビューから検証できます

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リストビューを使用する

インフラストラクチャサービスを介してリストビューに表示されるリソースにタグを付けることができます。たとえば、サーバ、クラスタ、ファブリックインターコネクト、シャーシなどです。

注:Proactive RMAでは、インフラストラクチャサービスリソースタグで有効にされた機能はサポートされていません。Proactive RMAタグの設定には、次の手順は使用しないでください。

1.リストビューで、タグを付けるリソースのチェックボックスをオンにします

2.省略記号の横にあるタグボタンを押します

3. 「Set Shared Tags」ポップアップ内で、選択したすべてのオブジェクトに適用されるkey:valueタグを入力します

4. 「保存」を押して送信します

注:net-newタグを追加すると、自動ヘルパー予測にはオプションが表示されません。文書化されているとおりにnet-newタグを正確に入力し、enterキーを押して送信します。

組織リソースタグ

APIを使用

1.組織向けオープンAPIドキュメント

組織のAPIドキュメントページに移動します。

注：Connected Virtual Applianceを使用している場合は、代わりにhttps://[FQDN of appliance]/apidocs/apirefs/organization/Organizations/model/に移動します

2.更新する組織を識別します。

詳細については、『Intersight API Query Guide』を参照してください。

ユーザはGETエンドポイントを使用するだけで、パラメータを指定せずにすべての組織を一覧表示できます。アカウント内の組織が多すぎて1つの出力で簡単に表示できない場合は、$selectクエリパラメーターを使用して表示するフィールドを制限できますが、$selectステートメントには次のようにタグを含める必要があります。

API出力から、必要なフィールドはMoidフィールドです。これは、intersight内のこの組織の一意の識別子であり、次の手順で使用されます。次の手順で、そこに存在するタグを取得する必要があります。

3.組織のMoidに対して組織のPATCH APIエンドポイントで組織のタグを更新します。bodyフィールドに収集された既存のタグを再入力してください。そうしないと、タグは削除されます。

上記のサンプルPATCH呼び出しの本文：

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

登録済みのタグにある既存のタグは、タグの配列に追加できます。

注：この手順に従ってProactive RMAを設定する場合、ここに記載されている電子メールアドレスはCCOアカウントに対応している必要があります。

デバイス登録リソースタグ

APIを使用

1.登録済みデバイスのAPIドキュメントを開く

登録済みデバイスのAPIドキュメントページに移動します。

接続仮想アプライアンスを使用している場合は、代わりにhttps://[FQDN of appliance]/apidocs/apirefs/asset/DeviceRegistrations/model/に移動します

2.更新が必要な登録済みデバイスの特定

詳細については、『Intersight API Query Guide』を参照してください

最も簡単な問い合わせ方法の1つはhostnameです。これを行うには、次のような問い合わせを作成します。

DeviceHostname eq 'F340-21-22-UCS4'

$filterと$selectを使用すると、より管理しやすい出力が表示されます。

3. PATCH APIを使用してタグを更新する

登録済みデバイスおよびデバイスのMOIDにすでに存在するタグを抽出します。PATCHエンドポイントにNagivateし、トップモイドエントリのモイドに貼り付けます。次に例を示します。

上記のサンプルPATCH呼び出しの本文：

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

登録済みのタグにある既存のタグは、タグの配列に追加できます。

注：この手順に従ってProactive RMAを設定する場合は、有効なシスコアカウントユーザ名/CCO IDを使用して、ここに記載されている電子メールアドレスを登録する必要があります。