根据空间名获取空间信息

最近更新时间: 2026-10-12 00:11:05

1. 接口描述

接口请求域名： cic.api3.fincloud.tencent.com。

根据空间名获取空间信息

默认接口请求频率限制：20次/秒。

接口更新时间：2024-12-25 16:08:59。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：GetZoneDetail
Version 是 否 String 公共参数，本接口取值：2021-03-31
Region 是 否 String 公共参数，地域信息本接口不需要传递此参数。
ZoneName 是 是 String 空间名，必须全局唯一。包含小写字母、数字和短划线（-）。不能以短划线（-）开头或结尾，且不能有两个连续的短划线（-）。长度：2~64 个字符。
示例值： zone_name

3. 输出参数

参数名称 类型 描述
ServiceStatus String 服务开启状态，Disabled代表未开通，Enabled代表已开通
示例值： Enabled
SSOStatus String SSO登陆开启状态。Disabled代表未开启，Enabled代表已开启
示例值： Enabled
IdpLoginUrl String SSO登陆开启时的IDP登陆URL
示例值： ttp://www.okta.com/exke***
IdpEntityID String idp entity ID。
示例值： http://www.okta.com/exk***
SAMLRequest String sp向idp发送的认证请求。
示例值： PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTg***
ZoneId String 空间ID。z-前缀开头，后面是12位随机数字/小写字母
示例值： z-2d8shd8***
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
FailedOperation.DBOperationError
FailedOperation.IdentityCenterNotOpen
FailedOperation.IdentityProviderNotConfigured

5. 示例

示例1 获取空间详情

输入示例

{
    "ZoneName": "testwu"
}

输出示例

{
  "Response": {
    "IdpLoginUrl": "https://dev-42274036.okta.com/app/dev-42274036_cic_1/exkhgbc2nobsgP7ic5d7/sso/saml",
    "IdpEntityID": "http://www.okta.com/exkhgbc2nobsgP7ic5d7",
    "RequestId": "12567360-3d7a-4517-8f88-595e910041dd",
    "SAMLRequest": "PEF1dGhuUmVxdWVzdCB4bWxucz0idXJuOm9hc2lzOm5hbWVzOnRjOlNBTUw6Mi4wOnByb3RvY29sIiBJc3N1ZUluc3RhbnQ9IjIwMjQtMDYtMDJUMTM6NDU6MzkuMzUxWiIgSUQ9ImlkLTFmMzQ0ZTA2NDU3N2U2ZDA0OTg4YmExMjBlOWE4M2Y2MjJjZWJmZDEiIFZlcnNpb249IjIuMCIgRGVzdGluYXRpb249Imh0dHBzOi8vZGV2LTQyMjc0MDM2Lm9rdGEuY29tL2FwcC9kZXYtNDIyNzQwMzZfY2ljXzEvZXhraGdiYzJub2JzZ1A3aWM1ZDcvc3NvL3NhbWwiIENvbnNlbnQ9IiIgQXNzZXJ0aW9uQ29uc3VtZXJTZXJ2aWNlSW5kZXg9IiIgQXNzZXJ0aW9uQ29uc3VtZXJTZXJ2aWNlVVJMPSJodHRwczovL3RlbmNlbnRjbG91ZHNzby5jb20vc2FtbC9hY3MvMDlkNWZmMzQtNWFjOC00ODM3LThjZDItYmVlZmVhYjFmMTU3IiBQcm90b2NvbEJpbmRpbmc9InVybjpvYXNpczpuYW1lczp0YzpTQU1MOjIuMDpiaW5kaW5nczpIVFRQLVBPU1QiIEF0dHJpYnV0ZUNvbnN1bWluZ1NlcnZpY2VJbmRleD0iIiBQcm92aWRlck5hbWU9IiI+PElzc3VlciB4bWxucz0idXJuOm9hc2lzOm5hbWVzOnRjOlNBTUw6Mi4wOmFzc2VydGlvbiIgTmFtZVF1YWxpZmllcj0iIiBTUE5hbWVRdWFsaWZpZXI9IiIgRm9ybWF0PSJ1cm46b2FzaXM6bmFtZXM6dGM6U0FNTDoyLjA6bmFtZWlkLWZvcm1hdDplbnRpdHkiIFNQUHJvdmlkZWRJRD0iIj5odHRwczovL3RlbmNlbnRjbG91ZHNzby5jb20vc2FtbC9zcC96LXZmdDM4cDJocTh0cTwvSXNzdWVyPjxOYW1lSURQb2xpY3kgeG1sbnM9InVybjpvYXNpczpuYW1lczp0YzpTQU1MOjIuMDpwcm90b2NvbCIgRm9ybWF0PSJ1cm46b2FzaXM6bmFtZXM6dGM6U0FNTDoyLjA6bmFtZWlkLWZvcm1hdDp0cmFuc2llbnQiIEFsbG93Q3JlYXRlPSJ0cnVlIj48L05hbWVJRFBvbGljeT48L0F1dGhuUmVxdWVzdD4=",
    "SSOStatus": "Enabled",
    "ServiceStatus": "Enabled",
    "ZoneId": "z-vft38p2hq8tq"
  }
}