# 智能体身份 ## 产品介绍 - [什么是智能体身份](https://support.huaweicloud.com/productdesc-agentidentity/agentidentity_01_0001.md): 华为云智能体身份（Agent Identity）专门为 Agent 提供安全身份标识、安全凭证管理、细粒度访问控制的云服务，让智能体能够安全地调用各类第三方外部工具和华为云服务资源。 - [产品优势](https://support.huaweicloud.com/productdesc-agentidentity/agentidentity_01_0002.md): 作为专门为Agent（智能体）打造的云原生安全与权限架构，Agent Identity的核心优势在于解决Agent在从“演示原型”迈向“企业级生产部署”时面临的身份混淆、凭据泄露与越权风险。 - [应用场景](https://support.huaweicloud.com/productdesc-agentidentity/agentidentity_01_0003.md): 场景描述：DevOps监控、数据同步、后台任务处理等自动化Agent，需要自主访问云资源或内部系统。核心价值：为Agent赋予独立的工作负载身份，安全获取访问华为云服务（如OBS）或内部API的凭证，所有操作有清晰审计，避免使用共享密钥带来的权限失控和追溯困难问题。 - [权限管理](https://support.huaweicloud.com/productdesc-agentidentity/agentidentity_01_0004.md): 如果您需要对华为云上购买的Agent Identity资源，为企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全的控制华为云资源的访问。 - [约束与限制](https://support.huaweicloud.com/productdesc-agentidentity/agentidentity_01_0005.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [与其他服务的关系](https://support.huaweicloud.com/productdesc-agentidentity/agentidentity_01_0006.md): Agent Identity需要与其他云服务协同工作，各服务之间的关系如表1所示。 - [基本概念](https://support.huaweicloud.com/productdesc-agentidentity/agentidentity_01_0007.md): 工作负载身份（workload Identity）是专门为AI Agent 打造的“数字身份证”。它为Agent赋予独立的安全身份，解决的是Agent“从哪来（入站合法性）、能干什么（出站凭据与权限）、出了事找谁（可追溯性）”的根本问题。它是实现企业级、生产可用的Agentic AI架构中最底层的安全基石。 ## 用户指南 - [通过IAM身份策略授予使用Agent Identity的权限](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0002.md): 如果您需要对您所拥有的Agent Identity进行身份策略的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），通过IAM，您可以：根据企业的业务组织，在您的账号中，给企业中不同职能部门的员工创建用户或用户组，让员工拥有唯一安全凭证，并使用Agent Identity资源。 - [工作负载身份概述](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0004.md): 工作负载身份是指AI智能体在运行、调用服务、访问资源、执行跨系统交互等工作负载场景中，用于标识自身身份、完成权限校验、实现安全交互的核心凭证体系，是保障智能体资源访问安全、权限精细化管控、交互行为可追溯的核心基础。 - [创建工作负载身份](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0006.md): 工作负载身份可为AI智能体等程序载体提供独立可信的机器身份，实现消除静态密钥风险、精细化权限隔离、全链路操作审计、多环境统一身份管控能力。若业务存在智能体承接用户交互或后台自动调度，程序需访问云资源、内部接口、第三方工具，且有安全合规治理需求时，需创建工作负载身份并配套身份提供商，搭建可信访问链路。 - [查看工作负载身份](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0007.md): 工作负载身份创建成功后，您可以进入工作负载身份详情中查看工作负载身份的详细信息。 - [修改工作负载身份](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0009.md): 当原有业务场景发生变化时，可以根据需要修改工作负载身份。修改工作负载身份后会变更智能体鉴权逻辑，可能会导致访问不可用，请谨慎操作。仅API Key认证类型和OAuth 2.0认证类型的工作负载身份支持修改。 - [删除工作负载身份](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0010.md): 在智能体平台日常权限治理中，针对已下线、停用、废弃的智能体，需执行工作负载身份删除操作。业务迭代下线、智能体版本升级替换、临时测试智能体任务结束后，对应的旧版工作负载身份会处于闲置状态，长期留存易造成身份台账冗余、权限边界混乱。闲置的无效身份存在被复用、非法调用的安全风险，违反权限最小化治理规范。 - [出站身份概述](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0012.md): 出站身份（Outbound Identity）是智能体身份体系中与入站身份相对的一类身份形态。入站身份解决“谁来调用Agent”的认证与授权问题；出站身份则解决“Agent代表谁、以什么凭据去访问下游资源”的问题。Agent完成入站认证后，在调用第三方服务、云服务或内部工具时，需要以合法且受控的身份出示凭据，这一身份即出站身份。 - [创建出站身份](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0013.md): 当智能体需要主动向外发起网络请求、调用外部业务接口或访问下游服务时，需配置专属出站身份。默认状态下智能体无对外访问身份，无法完成合规出站通信。运维人员可在管理界面为单智能体或批量智能体创建出站身份，绑定对应的访问主体信息。 - [修改出站身份](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0014.md): 当智能体出站调用的访问凭据或授权配置发生变化时，您需要修改出站身份。常见场景如下：凭证更换：API Key泄露或到期轮转，需重新生成并更新访问凭据。权限调整：出站调用的授权范围变更，需修改使用的IAM信任委托。合作方信息变更：对接的提供商信息发生调整，需重新配置提供商信息。修改后，新配置立即生效，原凭据随即失效。 - [删除出站身份](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0015.md): 当智能体不再需要向外部服务发起出站调用，或现有出站身份无法满足业务要求时，您需要删除出站身份。例如，智能体停止对外调用导致出站身份不再使用、需要更换智能体的认证类型或提供商类型、访问凭据泄露需重新配置，以及与第三方平台或云服务商的合作终止等场景。 - [为出站身份设置标签](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0016.md): 出站身份支持通过标签进行标识和分类管理。当您需要按业务、部门或环境等维度对出站身份进行分组管理，或在成本核算、权限控制、资源检索等场景下快速识别出站身份时，可为出站身份设置标签。例如，为不同业务线创建的出站身份分别添加对应标签，便于成本统计和运维定位。设置标签后，您可以通过标签筛选出站身份，并基于标签进行批量管理。 - [策略集概述](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0018.md): 智能体身份策略集是用于统一管理智能体出站身份访问策略的配置集合。策略集通过集中定义访问规则，将智能体对外部服务的调用行为纳入统一管控，实现对越权访问的预防、异常调用的发现以及安全事件的审计追溯。您可以将策略集绑定到指定实例，主要为凭证库。绑定后，策略集规则即对通过该凭证库发起的出站调用生效。 - [创建策略集](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0019.md): 当您需要对智能体的出站调用进行安全管控，或需要为指定凭证库配置差异化的访问控制规则时，您需要创建策略集。例如，限制凭证库仅允许访问特定目标服务、为不同业务线设置不同的调用权限，或先以观察模式验证策略规则后再切换为拦截模式等场景。创建策略集后，您可以将策略集绑定到凭证库等实例，策略规则随即对绑定实例的出站调用生效。 - [创建策略](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0020.md): 当您需要对凭证库中凭据的访问行为进行管控，或现有策略无法满足业务访问需求时，您需要创建策略。例如，限制凭据仅允许访问特定目标服务、设置凭据可执行的操作范围，或按不同业务线配置差异化的访问规则等场景。创建策略时，您可以通过效果、主体范围、主体类型、资源范围、资源类型、操作范围和条件等要素配置访问规则，并使用 Cedar 编辑器完成编写。 - [编辑策略](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0021.md): 当策略集中某条策略的访问规则不再满足业务需求时，您可以编辑该策略。例如，凭证可访问的目标服务或操作范围发生变化、需要收窄或扩大授权范围，或调整策略的生效条件等场景。编辑策略时，您可以通过Cedar编辑器修改效果、主体范围、资源范围、操作范围和条件等要素。编辑完成后，新规则立即生效，建议先以观察模式验证策略效果后再切换为拦截模式。 - [将实例绑定至策略集](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0022.md): 创建策略集后，策略规则需要绑定至实例后方可生效。当您需要将策略集的访问控制规则应用到指定凭证库，或需要为不同业务、不同安全等级的凭证库应用差异化的策略集时，您需要将策略集绑定至对应实例。例如，新增凭证库后为其绑定已有策略集，或业务安全要求变化时调整凭证库绑定的策略集。 - [将实例从策略集解绑](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0023.md): 当策略集不再适用于指定实例，或实例的访问管控方式需要调整时，您需要将实例从策略集解绑。例如，实例对应的业务发生变化、访问管控已迁移至其他策略集，或实例即将下线时，可先解绑策略集，再重新绑定其他策略集或删除实例。解绑后，策略集的规则不再对该实例的出站调用生效，该实例恢复为未绑定策略集的状态。 - [删除策略集](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0024.md): 当不再需要使用策略集时，您可以删除策略集。例如，访问管控需求已取消、策略规则已迁移至其他策略集，或绑定的实例已全部解绑时，可将策略集删除。删除前，请先解绑该策略集绑定的实例，确保相关出站调用已迁移至其他策略集或不再受管控。删除后，策略集及其包含的策略规则将不可恢复。返回策略集列表，查看到目标策略集不存在，则表示策略集删除成功。 - [删除策略](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0025.md): 当策略集中的某条策略不再适用或无需继续管控时，您可以删除该策略。例如，凭证的访问需求发生变化、策略规则配置有误需重新配置，或策略集中存在冗余策略需简化规则时，可将对应策略删除。删除前，请确认该策略管控的访问需求已取消，或已由策略集中的其他策略覆盖。删除后，该策略立即失效，策略集中剩余的策略继续生效。 - [为策略集设置标签](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0026.md): 策略集支持通过标签进行标识和分类管理。当您需要按业务、部门或环境等维度对策略集进行分组管理，或在成本核算、权限控制、资源检索等场景下快速识别策略集时，可为策略集设置标签。例如，为不同业务线使用的策略集分别添加对应标签，便于成本统计和运维定位。设置标签后，您可以通过标签筛选策略集，并基于标签进行批量管理。添加标签单击左上角的编辑标签。 - [凭证库概述](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0028.md): 智能体身份凭证库是智能体身份体系中用于集中管理出站访问凭据的实例，是出站身份认证与访问控制的基础设施。智能体对外部服务发起调用所需的各类凭据，如 OAuth 客户端的访问令牌、API Key 以及 IAM 委托的临时凭证等，均由凭证库统一存储和维护。通过凭证库，您可以将凭据的创建、存储、轮换和审计纳入统一管理，避免凭据散落在业务配置中。 - [为凭证库设置标签](https://support.huaweicloud.com/usermanual-agentidentity/agentidentity_03_0029.md): 凭证库支持通过标签进行标识和分类管理。当您需要按业务、部门或环境等维度对凭证库进行分组管理，或在成本核算、权限控制、资源检索等场景下快速识别凭证库时，可为凭证库设置标签。例如，为不同业务线使用的凭证库分别添加对应标签，便于成本统计和运维定位。设置标签后，您可以通过标签筛选凭证库，并基于标签进行批量管理。添加标签单击左上角的编辑标签。 ## API参考 - [使用前必读](https://support.huaweicloud.com/api-agentidentity/agentidentity_04_0001.md): 华为云智能体身份（Agent Identity）专门为Agent提供安全身份标识、安全凭证管理、细粒度访问控制的云服务，让智能体能够安全地调用各类第三方外部工具和华为云服务资源。智能体身份提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 - [API概览](https://support.huaweicloud.com/api-agentidentity/agentidentity_04_0002.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [构造请求](https://support.huaweicloud.com/api-agentidentity/agentidentity_04_0004.md): 本节介绍REST API请求的组成，以调用AgentIdentity服务的创建工作负载身份接口说明如何调用API。该API用于在AgentIdentity中注册一个工作负载身份，工作负载身份是Agent的身份标识，承载入站验证规则与出站凭证配置，用于Agent访问其他服务时进行身份认证与权限校验。 - [认证鉴权](https://support.huaweicloud.com/api-agentidentity/agentidentity_04_0005.md): 调用接口仅支持一种认证鉴权方式。AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。AK/SK既可以使用永久访问密钥中的AK/SK，也可以使用临时访问密钥中的AK/SK，区别是临时访问密钥需要额外携带“X-Security-Token”Http Header头。 - [返回结果](https://support.huaweicloud.com/api-agentidentity/agentidentity_04_0006.md): 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于创建工作负载身份接口，如果调用后返回状态码为“201”，则表示请求成功。对应请求消息头，响应同样也有消息头，如“Content-type”。 - [创建工作负载访问令牌（不以用户身份操作）](https://support.huaweicloud.com/api-agentidentity/CreateWorkloadAccessToken.md): 创建工作负载访问令牌（不以用户身份操作）。POST /v1/workload-access-token状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500创建工作负载访问令牌。状态码：200请参见错误码。 - [使用JWT创建工作负载访问令牌（以用户身份操作）](https://support.huaweicloud.com/api-agentidentity/CreateWorkloadAccessTokenForJwt.md): 使用JWT令牌为以用户身份操作的代理工作负载获取工作负载访问令牌。POST /v1/workload-access-token-for-jwt状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500使用JWT创建工作负载访问令牌。状态码：200请参见错误码。 - [使用用户ID创建工作负载访问令牌（以用户身份操作）](https://support.huaweicloud.com/api-agentidentity/CreateWorkloadAccessTokenForUserId.md): 使用用户ID为以用户身份操作的代理工作负载获取工作负载访问令牌。POST /v1/workload-access-token-for-user-id状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500使用用户ID创建工作负载访问令牌。状态码：200请参见错误码。 - [确认 OAuth 2.0 令牌的用户认证会话](https://support.huaweicloud.com/api-agentidentity/CompleteResourceTokenAuth.md): 确认用户认证会话以获取资源的OAuth2.0令牌。POST /v1/resource-token-auth/complete状态码：200无状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500确认OAuth2.0令牌的用户认证会话。无请参见错误码。 - [获取与指定资源凭证提供者关联的API密钥](https://support.huaweicloud.com/api-agentidentity/GetResourceApiKey.md): 获取与指定资源凭证提供者关联的API密钥。POST /v1/api-key状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500从资源凭证提供商获取API密钥。状态码：200请参见错误码。 - [从资源凭证提供商处获取 OAuth 2.0 令牌](https://support.huaweicloud.com/api-agentidentity/GetResourceOauth2Token.md): 使用配置的流程返回指定资源的OAuth2.0令牌。POST /v1/oauth2/token状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500从资源凭证提供商获取OAuth2.0令牌。状态码：200请参见错误码。 - [从STS凭证提供商获取STS凭证](https://support.huaweicloud.com/api-agentidentity/GetResourceStsToken.md): 从指定的STS凭证提供商获取临时STS凭证。POST /v1/sts/token状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500从STS凭证提供商获取STS凭证。状态码：200请参见错误码。 - [OAuth 2.0 推送授权请求（PAR）标准的授权 API](https://support.huaweicloud.com/api-agentidentity/Oauth2Authorize.md): 遵循RFC 9126 PAR规范的核心OAuth2授权端点，仅通过request_uri参数接受授权请求以触发用户授权流程。GET /v1/oauth2/authorize无状态码：400状态码：404状态码：500无无请参见错误码。 - [OAuth 2.0 标准授权回调 API](https://support.huaweicloud.com/api-agentidentity/Oauth2Callback.md): OAuth2重定向回调端点，用于在用户同意/拒绝后接收授权结果。GET /v1/oauth2/callback/{credential_provider_id}无无无无请参见错误码。 - [创建API密钥凭证提供商](https://support.huaweicloud.com/api-agentidentity/CreateApiKeyCredentialProvider.md): 创建一个新的API密钥凭证提供商。POST /v1/api-key-credential-providers状态码：201状态码：400状态码：403状态码：409创建API密钥凭证提供商。状态码：201请参见错误码。 - [查询API密钥凭证提供商列表](https://support.huaweicloud.com/api-agentidentity/ListApiKeyCredentialProviders.md): 查询当前账号下的API密钥凭证提供商列表。支持分页查询，可通过limit和marker参数控制返回结果的数量和起始位置。GET /v1/api-key-credential-providers无状态码：200状态码：400查询API密钥凭证提供商列表。 - [查询API密钥凭证提供商详情](https://support.huaweicloud.com/api-agentidentity/GetApiKeyCredentialProvider.md): 查询API密钥凭证提供商详情。GET /v1/api-key-credential-providers/{credential_provider_name}无状态码：200状态码：400状态码：404查询API密钥凭证提供商详情。状态码：200请参见错误码。 - [更新API密钥凭证提供商](https://support.huaweicloud.com/api-agentidentity/UpdateApiKeyCredentialProvider.md): 更新指定API密钥凭证提供商的API密钥。PUT /v1/api-key-credential-providers/{credential_provider_name}状态码：200状态码：400状态码：404状态码：409更新API密钥凭证提供商的API密钥。状态码：200请参见错误码。 - [删除API密钥凭证提供商](https://support.huaweicloud.com/api-agentidentity/DeleteApiKeyCredentialProvider.md): 删除指定的API密钥凭证提供商。DELETE /v1/api-key-credential-providers/{credential_provider_name}无状态码：204无状态码：400状态码：404删除API密钥凭证提供商。无请参见错误码。 - [创建OAuth2凭证提供商](https://support.huaweicloud.com/api-agentidentity/CreateOauth2CredentialProvider.md): 创建一个新的OAuth2凭证提供商。POST /v1/oauth2-credential-providers状态码：201状态码：400状态码：404状态码：409状态码：429创建Microsoft OAuth2凭证提供商。状态码：201请参见错误码。 - [查询OAuth2凭证提供商列表](https://support.huaweicloud.com/api-agentidentity/ListOauth2CredentialProviders.md): 查询当前账号下的OAuth2凭证提供商列表。支持分页查询，可通过limit和marker参数控制返回结果的数量和起始位置。GET /v1/oauth2-credential-providers无状态码：200状态码：400查询OAuth2凭证提供商列表。 - [查询OAuth2凭证提供商详情](https://support.huaweicloud.com/api-agentidentity/GetOauth2CredentialProvider.md): 查询OAuth2凭证提供商详情。GET /v1/oauth2-credential-providers/{credential_provider_name}无状态码：200状态码：400状态码：404查询OAuth2凭证提供商详情。状态码：200请参见错误码。 - [更新OAuth2凭证提供商](https://support.huaweicloud.com/api-agentidentity/UpdateOauth2CredentialProvider.md): 更新指定的OAuth2凭证提供商。PUT /v1/oauth2-credential-providers/{credential_provider_name}状态码：200状态码：400状态码：404状态码：409状态码：429更新OAuth2凭证提供商的client_secret和tenant_id。状态码：200请参见错误码。 - [删除OAuth2凭证提供商](https://support.huaweicloud.com/api-agentidentity/DeleteOauth2CredentialProvider.md): 删除指定的OAuth2凭证提供商。DELETE /v1/oauth2-credential-providers/{credential_provider_name}无状态码：204无状态码：400状态码：404状态码：409状态码：429删除OAuth2凭证提供商。无请参见错误码。 - [创建STS凭证提供商](https://support.huaweicloud.com/api-agentidentity/CreateStsCredentialProvider.md): 创建一个新的STS凭证提供商。POST /v1/sts-credential-providers状态码：201状态码：400状态码：403状态码：409创建STS凭证提供商。状态码：201请参见错误码。 - [查询STS凭证提供商列表](https://support.huaweicloud.com/api-agentidentity/ListStsCredentialProviders.md): 查询当前账号下的STS凭证提供商列表。支持分页查询，可通过limit和marker参数控制返回结果的数量和起始位置。GET /v1/sts-credential-providers无状态码：200状态码：400查询STS凭证提供商列表。 - [查询STS凭证提供商详情](https://support.huaweicloud.com/api-agentidentity/GetStsCredentialProvider.md): 查询STS凭证提供商详情。GET /v1/sts-credential-providers/{credential_provider_name}无状态码：200状态码：400状态码：404查询STS凭证提供商详情。状态码：200请参见错误码。 - [更新STS凭证提供商](https://support.huaweicloud.com/api-agentidentity/UpdateStsCredentialProvider.md): 更新指定的STS凭证提供商。PUT /v1/sts-credential-providers/{credential_provider_name}状态码：200状态码：400状态码：404状态码：409更新STS凭证提供商的agency_urn和标签。状态码：200请参见错误码。 - [删除STS凭证提供商](https://support.huaweicloud.com/api-agentidentity/DeleteStsCredentialProvider.md): 删除指定的STS凭证提供商。DELETE /v1/sts-credential-providers/{credential_provider_name}无状态码：204无状态码：400状态码：404删除STS凭证提供商。无请参见错误码。 - [创建工作负载身份](https://support.huaweicloud.com/api-agentidentity/CreateWorkloadIdentity.md): 创建一个新的工作负载身份。工作负载身份用于为工作负载（如Agent运行时）提供统一的身份标识，支持配置自定义JWT、IAM、API Key等多种授权方式，实现对入站请求的身份验证和授权。POST /v1/workload-identities状态码：201状态码：400状态码：409创建使用自定义JWT授权的工作负载身份。 - [查询工作负载身份列表](https://support.huaweicloud.com/api-agentidentity/ListWorkloadIdentities.md): 查询当前账号下的工作负载身份列表。支持分页查询，可通过limit和marker参数控制返回结果的数量和起始位置。GET /v1/workload-identities无状态码：200状态码：400查询工作负载身份列表。GET https://{endpoint}/v1/workload-identities查询工作负载身份列表。 - [查询工作负载身份详情](https://support.huaweicloud.com/api-agentidentity/GetWorkloadIdentity.md): 根据工作负载身份名称查询指定工作负载身份的详细信息，包括名称、URN、授权类型、创建者、标签等。GET /v1/workload-identities/{workload_identity_name}无状态码：200状态码：400状态码：404查询工作负载身份详情。状态码：200请参见错误码。 - [更新工作负载身份](https://support.huaweicloud.com/api-agentidentity/UpdateWorkloadIdentity.md): 更新指定工作负载身份的配置信息，包括OAuth2回调地址、授权配置和标签等。PUT /v1/workload-identities/{workload_identity_name}状态码：200状态码：400状态码：403状态码：404状态码：409更新工作负载身份的OAuth2回调地址和API Key授权配置。 - [删除工作负载身份](https://support.huaweicloud.com/api-agentidentity/DeleteWorkloadIdentity.md): 删除指定的工作负载身份。删除后，该工作负载身份将不再可用，与之关联的授权配置也将一并删除。DELETE /v1/workload-identities/{workload_identity_name}无状态码：204无状态码：400状态码：403状态码：404状态码：409删除工作负载身份。无请参见错误码。 - [查询工作负载身份的授权配置](https://support.huaweicloud.com/api-agentidentity/GetWorkloadIdentityAuthorizerConfiguration.md): 查询指定工作负载身份的授权配置信息，包括授权类型和具体的授权配置（如自定义JWT配置或API Key配置）。GET /v1/workload-identities/{workload_identity_name}/authorizer-configuration无状态码：200状态码：400状态码：404查询工作负载身份的授权配置。 - [查询令牌保管库详情](https://support.huaweicloud.com/api-agentidentity/GetTokenVault.md): 查询令牌保管库详情。GET /v1/token-vaults/{token_vault_id}无状态码：200状态码：400状态码：404查询令牌保管库详情。状态码：200请参见错误码。 - [更新令牌保管库配置](https://support.huaweicloud.com/api-agentidentity/UpdateTokenVault.md): 更新令牌保管库配置，包括KMS和策略集设置。PUT /v1/token-vaults/{token_vault_id}状态码：200状态码：400状态码：404为TokenVault绑定策略集。状态码：200请参见错误码。 - [创建策略集](https://support.huaweicloud.com/api-agentidentity/CreatePolicyEngine.md): 创建一个新的策略集。POST /v1/policy-engines状态码：201状态码：400状态码：409创建策略集。状态码：201请参见错误码。 - [查询策略集列表](https://support.huaweicloud.com/api-agentidentity/ListPolicyEngines.md): 查询策略集列表。支持按类型过滤，可通过limit和marker参数控制返回结果的数量和起始位置。GET /v1/policy-engines无状态码：200状态码：400查询策略集列表。GET https://{endpoint}/v1/policy-engines查询策略集列表。按类型过滤查询策略集列表。 - [查询策略集详情](https://support.huaweicloud.com/api-agentidentity/GetPolicyEngine.md): 查询策略集详情。GET /v1/policy-engines/{policy_engine_id}无状态码：200状态码：400状态码：404无状态码：200请参见错误码。 - [更新策略集](https://support.huaweicloud.com/api-agentidentity/UpdatePolicyEngine.md): 更新策略集的描述和标签。PUT /v1/policy-engines/{policy_engine_id}状态码：200状态码：400状态码：404状态码：409更新策略集的描述和标签。状态码：200请参见错误码。 - [删除策略集](https://support.huaweicloud.com/api-agentidentity/DeletePolicyEngine.md): 删除指定的策略集。DELETE /v1/policy-engines/{policy_engine_id}无状态码：204无状态码：400状态码：404状态码：409删除策略集。无请参见错误码。 - [查询策略集关联的实体列表](https://support.huaweicloud.com/api-agentidentity/ListPolicyEngineAttachments.md): 查询指定策略集关联的实体（网关和令牌保管库）列表。支持分页查询，可通过limit和marker参数控制返回结果的数量和起始位置。GET /v1/policy-engines/{policy_engine_id}/attachments无状态码：200状态码：400状态码：404查询策略集关联的实体列表。 - [在指定策略集中创建策略](https://support.huaweicloud.com/api-agentidentity/CreatePolicy.md): 在指定策略集中创建策略。POST /v1/policy-engines/{policy_engine_id}/policies状态码：202状态码：400状态码：404在指定策略集中创建策略。状态码：202请参见错误码。 - [查询策略列表](https://support.huaweicloud.com/api-agentidentity/ListPolicies.md): 查询策略列表。GET /v1/policy-engines/{policy_engine_id}/policies无状态码：200状态码：400查询策略列表。GET https://{endpoint}/v1/policy-engines/{policy_engine_id}/policies查询策略列表。分页查询策略列表。 - [查询策略详情](https://support.huaweicloud.com/api-agentidentity/GetPolicy.md): 查询策略详情。GET /v1/policy-engines/{policy_engine_id}/policies/{policy_id}无状态码：200状态码：400状态码：404查询策略详情。状态码：200请参见错误码。 - [更新策略](https://support.huaweicloud.com/api-agentidentity/UpdatePolicy.md): 更新策略。PUT /v1/policy-engines/{policy_engine_id}/policies/{policy_id}状态码：202状态码：400状态码：404更新策略的描述和定义。状态码：202请参见错误码。 - [删除策略](https://support.huaweicloud.com/api-agentidentity/DeletePolicy.md): 删除指定的策略。DELETE /v1/policy-engines/{policy_engine_id}/policies/{policy_id}无状态码：202状态码：400状态码：404状态码：409删除策略。状态码：202请参见错误码。 - [查询项目标签列表](https://support.huaweicloud.com/api-agentidentity/ListTags.md): 查询项目下某资源类型的所有标签，按key聚合去重。GET /v1/{resource_type}/tags无状态码：200状态码：400状态码：403查询项目标签列表。GET https://{endpoint}/v1/{resource_type}/tags查询项目标签列表。分页查询项目标签列表。 - [查询资源标签](https://support.huaweicloud.com/api-agentidentity/ListTagsForResource.md): 查询指定资源的标签列表。GET /v1/{resource_type}/{resource_id}/tags无状态码：200状态码：400状态码：403状态码：404查询资源标签。状态码：200请参见错误码。 - [查询资源实例列表](https://support.huaweicloud.com/api-agentidentity/ListResourcesByTag.md): 根据标签过滤条件查询资源实例列表。POST /v1/{resource_type}/resource-instances/filter状态码：200状态码：400状态码：403根据标签过滤条件查询资源实例列表。状态码：200请参见错误码。 - [查询资源实例数量](https://support.huaweicloud.com/api-agentidentity/CountResourcesByTag.md): 根据标签过滤条件查询资源实例数量。POST /v1/{resource_type}/resource-instances/count状态码：200状态码：400状态码：403根据标签过滤条件查询资源实例数量。状态码：200请参见错误码。 - [向指定资源添加标签](https://support.huaweicloud.com/api-agentidentity/TagResource.md): 向指定资源添加标签。POST /v1/{resource_type}/{resource_id}/tags/create状态码：204无状态码：400状态码：403状态码：404向指定资源添加标签。无请参见错误码。 - [从指定资源中删除标签](https://support.huaweicloud.com/api-agentidentity/UntagResource.md): 从指定资源中删除标签。POST /v1/{resource_type}/{resource_id}/tags/delete状态码：204无状态码：400状态码：403状态码：404从指定资源中删除标签。无请参见错误码。 - [查询身份提供商](https://support.huaweicloud.com/api-agentidentity/ListIdentityProviders.md): 查询身份提供商列表。GET /v1/identity-providers无状态码：200查询身份提供商列表。状态码：200请参见错误码。 - [配置Agent身份并获取访问令牌](https://support.huaweicloud.com/api-agentidentity/agentidentity_04_0009.md): 场景描述在企业办公自动化场景中，AI Agent需要访问员工的Microsoft数据，以便自动处理邮件分类、文件整理等任务，这涉及到复杂的OAuth 2.0授权流程。本示例展示如何通过AgentIdentity简化Agent访问Microsoft的开发复杂度，让开发者无需关心OAuth 2.0的底层细节。总体思路1. - [权限和授权项说明](https://support.huaweicloud.com/api-agentidentity/agentidentity_04_0011.md): 如果您需要对您所拥有的AgentIdentity进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），如果账号所具备的权限功能已经能满足您的要求，您可以跳过本章节，不影响您使用RGC服务的其他功能。 - [身份策略授权参考](https://support.huaweicloud.com/api-agentidentity/Permission.md): 云服务在IAM预置了常用的权限，称为系统身份策略。如果IAM系统身份策略无法满足授权要求，管理员可以根据各服务支持的授权项，创建IAM自定义身份策略来进行精细的访问控制，IAM自定义身份策略是对系统身份策略的扩展和补充。 - [状态码](https://support.huaweicloud.com/api-agentidentity/agentidentity_04_0013.md): 状态码如表1所示 - [错误码](https://support.huaweicloud.com/api-agentidentity/ErrorCode.md): 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTP 请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便我们尽快帮您解决问题。