ModifyDomainCertificate

1. API Description

This interface is used to modify the SSL certificate of an accelerated domain name.

Preparation

• Create Certificate: If the certificate to be modified has not been uploaded, you need to first call CreateCertificate to upload the certificate and key.

Notes

• This interface is asynchronous. After the interface returns successfully, the operation of creating or modifying the accelerated domain has not yet been completed. During this period, the status of the accelerated domain will be Deploying. You can query the status of the accelerated domain by calling the DescribeCdnDomains interface. If the domain status changes from Deploying (deploying) to Deployed (deployed successfully), the deployment is successful; Failed indicates that the configuration failed.

2. Request Parameters

The following request parameter list includes only the necessary parameters for the interface

Parameter Name	Required	Type	Description
domainId	Yes	String	Accelerated domain Id
certificateId	Yes	String	Certificate Id This parameter can be obtained from the certificateId field in the return value of DescribeCertificates.

3. Output Parameters

Parameter Name	Type	Description
requestId	String	Unique request ID, returned with each request. Provide this requestId when locating issues.

4. Code Example

Example

1. Modify the SSL certificate of the accelerated domain

POST / HTTP/1.1
Host: console.zenlayer.com/api/v2/cdn
Content-Type: application/json
X-ZC-Action: ModifyDomainCertificate
<Common Request Params>

Request:
{
    "domainId": "domainIdxxxxx",
    "certificateId": "f0864***66c6fa"
}


Response:
{
    "requestId": "TEEFDCA5B-76FB-4E91-A18E-DF7F5D2CE41F",
}

5. Error Codes

The following includes error codes encountered in business logic. For other error codes, see Common Error Codes.

HTTP Status Code	Error Code	Description
404	INVALID_DOMAIN_NOT_FOUND	The specified accelerated domain does not exist.
403	DOMAIN_OPERATION_NO_PERMISSION	Operation denied due to lack of permission.
400	CERT_NOT_MATCH_DOMAIN_OR_EXPIRED	Certificate expired or does not match the domain.
404	INVALID_CERTIFICATE_NOT_FOUND	The specified certificate was not found.