内容

はじめに

背景説明

アカウントリソースタグ

要件

UIを使用

APIを使用

インフラストラクチャサービスリソースタグ

uiリストビューを使用する

組織リソースタグ

APIを使用

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

APIを使用

はじめに

このドキュメントでは、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を使用して、ここに記載されている電子メールアドレスを登録する必要があります。