CreateService
最近更新时间: 2025-10-20 17:06:00
1. 接口描述
接口请求域名： apigateway.api3.fincloud.tencent.cn。
本接口（CreateService）用于创建服务。 API 网关使用的最大单元为服务，每个服务中可创建多个 API 接口。每个服务有一个默认域名供客户调用，用户也可绑定自定义域名到此服务中。
默认接口请求频率限制：20次/秒。
接口更新时间：2021-11-23 12:10:29。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：CreateService |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-08-08 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| ServiceName | 是 | 否 | String | 用户自定义的服务名称。 |
| ServiceDesc | 否 | 否 | String | 用户自定义的服务描述。 |
| Protocol | 是 | 否 | String | 服务的前端请求类型。如 http、https、http&https。 |
| ExclusiveSetName | 否 | 否 | String | 独立集群名称，用于指定创建服务所在的独立集群。 |
| NetTypes | 否 | 否 | Array of String | 网络类型列表，用于指定支持的访问类型，INNER为内网访问，OUTER为外网访问。默认为OUTER。 |
| IpVersion | 否 | 否 | String | IP版本号，支持IPv4和IPv6，默认为IPv4。 |
| SetServerName | 否 | 否 | String | 集群名称。保留字段，tsf serverlss类型使用。 |
| AppIdType | 否 | 否 | String | 用户类型。保留类型，serverless用户使用。 |
| Tags | 否 | 否 | Array of Tag | 标签。 |
| InstanceId | 否 | 否 | String | 独享实例id |
| ProjectId | 否 | 否 | String | 项目ID |
| TceArch | 否 | 否 | String | CPU架构，可选项[arm, x86] |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| ServiceId | String | 服务唯一ID。 |
| ServiceName | String | 用户自定义服务名称。 |
| ServiceDesc | String | 用户自定义服务描述。 |
| OuterSubDomain | String | 外网默认域名。 |
| InnerSubDomain | String | vpc内网默认域名。 |
| CreatedTime | Datetime_iso | 服务创建时间。按照 ISO8601 标准表示，并且使用 UTC 时间。格式为：YYYY-MM-DDThh:mm:ssZ。 |
| NetTypes | String | 网络类型列表，INNER为内网访问，OUTER为外网访问。 |
| IpVersion | String | IP版本号。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| ResourceNotFound | 资源不存在。 |
| InvalidParameterValue | 参数取值错误。 |
| InvalidParameter.FormatError | 参数格式错误。 |
| LimitExceeded.IpStrategyLimitExceeded | IP策略数量超出限制。 |
| MissingParameter | 缺少参数错误。 |
| InternalError | 内部错误。 |
| InternalError.OssException | oss内部请求错误，请稍后重试。若无法解决，请联系智能客服或提交工单。 |
| UnauthorizedOperation.UncertifiedUser | 用户未实名制。 |
| InternalError.VpcException | vpc内部请求错误，请稍后重试。若无法解决，请联系智能客服或提交工单。 |
| ResourceInUse | 资源被占用。 |
| AuthFailure | CAM签名/鉴权错误。 |
| RequestLimitExceeded | 请求的次数超过了频率限制。 |
| ResourceInsufficient | 资源不足。 |
| LimitExceeded | 超过配额限制。 |
| DryRunOperation | DryRun 操作，代表请求将会是成功的，只是多传了 DryRun 参数。 |
| FailedOperation | 操作失败。 |
| FailedOperation.TagBindServiceError | 标签绑定服务失败。 |
| InvalidParameterValue.ParameterValueLimitExceeded | 参数个数超过限制。 |
| InvalidParameterValue.InvalidRegion | 地域错误。 |
| InternalError.CauthException | CAuth内部请求错误，请稍后重试。若无法解决，请联系智能客服或提交工单。 |
| LimitExceeded.ServiceCountLimitExceeded | 服务数量超过限制，请删除服务或提升限额后重试。 |
| UnsupportedOperation.InvalidAction | 接口错误。 |
| FailedOperation.InstanceNotExist | 实例不存在，或者无效状态。 |