接口描述
本接口(CreateSAMLProvider)用于创建 SAML 身份提供商。
请求域名:cam.api.qcloud.com
请求方式:HTTP POST
输入参数
参数名称 | 必选 | 类型 | 描述 |
name | 是 | String | SAML 身份提供商名称。 |
desc | 是 | String | 身份提供商描述。 |
SAMLMetadataDocument | 是 | String | SAML 身份提供商元数据文档。需要以 Base64 编码,支持最大数据为 64KB。 |
备注:若IdP元数据文档超过最大限制,可删除元数据XML文档中除IDPSSODescriptor外的其他XML节点。例如:
<?xml version="1.0" encoding="utf-8"?><EntityDescriptor><IDPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">......</IDPSSODescriptor></EntityDescriptor>
输出参数
参数名称 | 类型 | 描述 |
name | String | SAML 身份提供商名称。 |
SAMLProviderArn | String | SAML 身体提供商访问描述名称。 |
示例
创建一个名称为 IdP 的 SAML 身份提供商。
输入示例:
POST /v2/index.php HTTP/1.1Host: cam.api.qcloud.comAccept: */*Content-Length: 3927Content-Type: application/x-www-form-urlencodedAction=CreateSAMLProvider&name=idp&SAMLMetadataDocument=U0FNTE1ldGFkYXRhRG9jdW1lbnQ&desc=descriptor&<公共请求参数>
输出示例:
{"code": 0,"message": "","codeDesc": "Success","data": {"name": "idp","SAMLProviderArn": "qcs::cam::uin/798950673:saml-provider/idp"}}
错误码
错误码 | 描述 |
InvalidParameter.ProviderAlreadyExist | 身份提供商已存在。 |
InvalidParameter. SAMLMetadataDocument | SAML 身份提供商元数据文档错误。 |
InvalidParameter.ProviderMaxLimit | 身份提供商达到上限。 |