ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

使用 AWS CLI 的 chime get-bot 命令查询 Amazon Chime 机器人详情

使用 AWS CLI 的 chime get-bot 命令查询 Amazon Chime 机器人详情 使用 AWS CLI 的 chime get-bot 命令查询 Amazon Chime 机器人详情【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cliaws chime get-bot是 AWS CLI 中用于查询 Amazon Chime 聊天机器人Bot详情的核心命令可一次性获取机器人的 ID、类型、显示名称、启用状态、邮箱、时间戳与安全令牌等完整信息。本文以awscli/examples/chime/get-bot.rst中的官方示例为主线结合本仓库内awscli/botocore/data/chime/2018-05-01/service-2.json的底层接口定义讲解命令用法、输出字段含义、错误处理与常见运维场景帮助你在 Enterprise 账户中安全高效地管理与排查机器人。命令概述与适用场景Amazon Chime 允许 Enterprise 账户管理员配置机器人Bot接口用于接收来自 Amazon Chime 的事件。get-bot命令对应 Chime REST API 的GetBot操作从源码模型文件 service-2.json 中可以确认其底层请求方式HTTP 方法GET请求 URI/accounts/{accountId}/bots/{botId}accountId与botId均通过 URL 路径传递成功响应码200接口文档说明检索指定机器人的详细信息如机器人邮箱地址、机器人类型、状态和显示名称见 service-2.json 中 GetBot 定义。典型适用场景包括部署或排障时核对某个机器人当前的启用/禁用状态与类型获取机器人的BotEmail与SecurityToken用于配置与 Chime 出站事件端点之间的认证对比CreatedTimestamp/UpdatedTimestamp判断机器人最近一次配置变更的时间与list-bots配合先列出账户下的全部机器人再对指定bot-id做精确查询。基本用法与参数说明get-bot需要两个必填参数required字段在 GetBotRequest 中定义参数位置说明--account-idURIAmazon Chime 账户 ID非空字符串对应路径中的accountId--bot-idURI机器人 ID非空字符串对应路径中的botId官方示例get-bot.rst命令如下aws chime get-bot \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --bot-id 123abcd4-5ef6-789g-0h12-34j56789012k命令输出JSON 格式{ Bot: { BotId: 123abcd4-5ef6-789g-0h12-34j56789012k, UserId: 123abcd4-5ef6-789g-0h12-34j56789012k, DisplayName: myBot (Bot), BotType: ChatBot, Disabled: false, CreatedTimestamp: 2019-09-09T18:05:56.749Z, UpdatedTimestamp: 2019-09-09T18:05:56.749Z, BotEmail: myBot-chimebotexample.com, SecurityToken: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY } }两个参数均为字符串类型的 ID可以使用aws chime list-accounts查询account-id使用aws chime list-bots --account-id 账户ID查询bot-id。输出字段逐项解读GetBotResponse仅包含一个Bot结构体见 GetBotResponse 定义其字段在 Bot 结构体 中定义如下字段类型含义BotIdString机器人 IDUserIdString机器人用户bot user的唯一 IDDisplayNameSensitiveString机器人显示名称示例中为myBot (Bot)即创建时名称后追加了(Bot)后缀BotTypeBotType枚举机器人类型当前枚举仅支持ChatBot见 BotTypeDisabledNullableBoolean为true时表示该机器人已停止运行CreatedTimestampIso8601Timestamp机器人创建时间ISO 8601 格式UpdatedTimestampIso8601Timestamp机器人最近更新时间ISO 8601 格式BotEmailSensitiveString机器人邮箱地址SecurityTokenSensitiveString用于 Amazon Chime 与出站事件端点之间认证的安全令牌需要注意DisplayName、BotEmail、SecurityToken在模型中都被标记为SensitiveString敏感字段。SecurityToken是机器人调用出站事件端点时的认证凭据涉及安全敏感信息请勿在日志或共享文档中明文留存。生命周期管理中的 get-bot 定位get-bot通常不是孤立使用的它与机器人生命周期的其他命令配合形成完整的管理闭环。仓库awscli/examples/chime/目录下提供了对应的官方示例可相互对照创建机器人aws chime create-bot --account-id 账户ID --display-name myBot --domain example.com。创建成功后返回的Bot结构与get-bot完全一致见 create-bot.rst其中DisplayName会自动带上(Bot)后缀BotEmail形如myBot-chimebotexample.com。查询机器人即本文讲解的get-bot用于核对创建结果或后续状态。更新/停用机器人aws chime update-bot --account-id 账户ID --bot-id 机器人ID --disabled可停止机器人运行返回结果中Disabled变为true见 update-bot.rst。此时再用get-bot查询即可确认停用是否生效。轮换安全令牌aws chime regenerate-security-token --account-id 账户ID --bot-id 机器人ID可重新生成SecurityToken见 regenerate-security-token.rst。令牌泄露或定期轮换后可用get-bot获取新令牌。错误处理与故障排查GetBot操作在 service-2.json 中声明了以下异常类型排查时可根据报错对症处理BadRequestException请求参数格式错误检查account-id与bot-id是否为有效的非空字符串。UnauthorizedClientException调用方未通过客户端级鉴权。ForbiddenException当前身份无权访问该账户下的机器人常见于 IAM 权限不足或使用了错误的凭证。NotFoundException指定的账户或机器人不存在通常是因为 ID 拼写错误或机器人已被删除。ThrottledClientException客户端请求被限流适当退避后重试。ServiceUnavailableException服务暂时不可用稍后重试。ServiceFailureException服务端内部故障。进阶建议与安全注意事项IAM 权限运行get-bot需要具备对 ChimeGetBot操作的权限。建议按最小权限原则仅在需要管理机器人时授予相应权限避免使用具有过宽权限的管理员凭证。凭证来源本仓库awscli支持通过环境变量、共享凭证文件~/.aws/credentials、IAM 角色等多种方式提供凭证命令执行时请确保当前环境已正确配置可访问目标 Chime 账户的凭证。输出格式化默认输出为 JSON。如需便于脚本解析的紧凑输出可追加--output json需要人工阅读时可使用--output table或--output text。敏感字段保护SecurityToken与BotEmail属于敏感信息建议在自动化脚本中避免将完整输出直接写入日志必要时配合--query仅提取所需字段例如aws chime get-bot \ --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \ --bot-id 123abcd4-5ef6-789g-0h12-34j56789012k \ --query Bot.{ID:BotId,Name:DisplayName,Disabled:Disabled,Type:BotType} \ --output table相关文档与进一步阅读命令官方示例get-bot.rstChime 服务接口模型含GetBot、Bot、GetBotRequest/Response定义service-2.json机器人生命周期配套示例create-bot.rst、update-bot.rst、regenerate-security-token.rst、list-bots.rstAmazon Chime 机器人详细概念、更新与认证机制可参见官方《Amazon Chime Developer Guide》中关于 Update Chat Bots 与 Authenticate Chat Bot Requests 的章节。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表