目录

简介

背景信息

帐户资源标记

要求

通过用户界面

通过API

基础设施服务资源标记

通过UI列表视图

组织资源标签

通过API

设备注册资源标签

通过API

简介

本文档介绍向Cisco Intersight资源添加标签所需的步骤。

背景信息

标记是可用于Cisco Intersight中的资源的密钥/值元数据的通用部分。这些资源可能因服务器终端、帐户等而异。

作为用户，标记可用于对Cisco Intersight资源进行分组，从而允许根据这些标记值查询资源。

在思科内部，有多种程序依赖Cisco Intersight资源标签来启用/禁用特定功能集。有关这些特性和功能的详细信息，请参阅特定程序的文档。

帐户资源标记

要求

- 要修改的帐户的帐户管理员角色

- 对iam.Account API终结点的访问

通过UI登录时，点击UI右上角的配置文件菜单以显示登录的Account和Role。

通过用户界面

1. 点击服务选择器

2. 选择“System”

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.可以从“帐户详细信息”视图验证配置的标记

通过API

1. HTTP GET 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 the specific iam.Account resource by Moid and include the new and existing Tags in the request payload。

注意：如果帐户资源具有现有标记，则必须将其包括在POST中才能保留。如果POST中未包含这些帐户，则会从Account Resource中删除它们。

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/。

2.确定要更新的组织。

请参阅Intersight API查询指南以获取参考。

用户只需使用GET端点列出所有不带参数的组织。如果您的帐户中有太多组织，无法在一个输出中轻松查看，用户可以使用$select查询参数限制显示的字段，但请确保在$select语句中包括标记，例如：

从API输出中，我们需要的是模块字段，这是该组织在见到的唯一标识符，将在下一步中使用，我们还需要获取在下一步操作中位于的任何标记。

3.使用组织补丁API终结点更新组织标签，以对抗组织模式。确保重新输入在正文字段中收集的现有标签，否则这些标签将被删除。

上述PATCH调用示例的主体：

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

注册的所有现有标签都可以添加到标签阵列中。

请注意：如果您按照此步骤配置主动RMA，则此处的电子邮件地址需要与CCO帐户相关。

设备注册资源标签

通过API

1.注册设备的开放式API文档

导航到已注册设备的API文档页

如果使用连接的虚拟设备，请导航至https://[设备的FQDN]/apidocs/apirefs/asset/DeviceRegistrations/model/restead

2.确定需要更新的注册设备

请参阅Intersight API查询指南以获取参考

最简单的查询方法之一是按主机名进行查询，为此，可按如下方式创建查询：

DeviceHostname eq 'F340-21-22-UCS4'

利用$filter和$select，我们可以看到更易于管理的输出：

3.使用PATCH API更新标记

提取已注册设备上的所有标签以及设备的型号。向PATCH endpoint进行重命名，粘贴在顶部moid条目中的Moid例如：

上述PATCH调用示例的主体：

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

注册的所有现有标签都可以添加到标签阵列中。

请注意：如果您正在按照此步骤配置主动RMA，则需要使用有效的思科帐户用户名/CCO ID注册此处的邮件地址。