创建应用身份

接口描述

本接口用于创建应用。

权限说明

调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：

• 完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
• 运维操作千帆大模型平台预测服务的权限：QianfanServiceOperateAccessPolicy
• 只读访问千帆大模型平台预测服务的权限：QianfanServiceReadAccessPolicy

鉴权说明

调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。

请求结构

POST /v2/application?Action=CreateApplication HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json

{
    "name": "app1_created_by_api",
    "description": "管控api创建app"
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

• Query参数

• Body参数

响应头域

除公共头域外，无其它特殊头域。

响应参数

result说明

请求示例

# 替换下列示例中的Authorization值
curl --location 'https://qianfan.baidubce.com/v2/application?Action=CreateApplication' \
--header 'Authorization: bce-auth-v1/047ab24*****b42a4d2e3e28b1ac/2025-04-24T05:03:37Z/18000/host/6ee35c7a9633a7faed591088e53df*****b9b91699fdf890ea5f5ad41' \
--header 'Content-Type: application/json' \
--data '{
    "name": "app1_created_by_api",
    "description": "管控api创建app"
}'

响应示例

{
    "requestId": "9579f628-e847-4f0c-b370-5761d40be9ba",
    "result": {
        "appId": "app-JR***1Lr"
    }
}

错误码

若请求错误，服务器将返回的JSON文本包含以下参数：

例如错误返回：

{
    "requestId":"6ba7b810-xxxc04fd430c8",
    "code":"AccessDenied",
    "message":"Access denied."
}

更多错误码，请查看错误码说明。