set_certificate
Configure SSL/TLS certificates for websites to enable HTTPS encryption and secure data transmission between users and servers.
Instructions
Configures whether to enable certificates and update certificate information for a website.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| siteId | Yes | The website ID. Reference Value Source: list_sites | |
| name | No | The name of the certificate. | |
| casId | No | The ID of the cloud certificate. | |
| type | Yes | The type of certificate. Possible values: - cas (Cloud Certificate) - upload (Custom Upload Certificate) | |
| certificate | No | The content of the certificate. | |
| privateKey | No | The private key of the certificate. | |
| region | No | The region. | |
| id | No | The ID of the certificate. |
Implementation Reference
- src/tools/site/certificate.ts:193-202 (handler)The handler function that implements the core logic of the 'set_certificate' tool by calling the underlying API service.export const set_certificate = async (request: CallToolRequest) => { const res = await api.setCertificate( request.params.arguments as SetCertificateRequest, ); return { content: [{ type: 'text', text: JSON.stringify(res) }], success: true, }; };
- src/tools/site/certificate.ts:13-61 (schema)The Tool schema definition including name, description, and inputSchema for 'set_certificate'.export const SET_CERTIFICATE_TOOL: Tool = { name: 'set_certificate', description: 'Configures whether to enable certificates and update certificate information for a website.', inputSchema: { type: 'object', properties: { siteId: { type: 'number', description: 'The website ID. Reference Value Source: list_sites', examples: ['123456****'], }, name: { type: 'string', description: 'The name of the certificate.', }, casId: { type: 'number', description: 'The ID of the cloud certificate.', }, type: { type: 'string', description: 'The type of certificate. Possible values: - cas (Cloud Certificate) - upload (Custom Upload Certificate)', enum: ['cas', 'upload'], }, certificate: { type: 'string', description: 'The content of the certificate.', }, privateKey: { type: 'string', description: 'The private key of the certificate.', }, region: { type: 'string', description: 'The region.', example: 'cn-hangzhou', }, id: { type: 'string', description: 'The ID of the certificate.', example: '30001303', }, }, required: ['siteId', 'type'], annotations: {}, }, };
- src/tools/list-esa-function.ts:143-150 (registration)Registration of the SET_CERTIFICATE_TOOL schema in the CERTIFICATE_LIST array, which is later included in the full ESA_OPENAPI_LIST.export const CERTIFICATE_LIST = [ SET_CERTIFICATE_TOOL, APPLY_CERTIFICATE_TOOL, GET_CERTIFICATE_TOOL, DELETE_CERTIFICATE_TOOL, LIST_CERTIFICATES_TOOL, GET_CERTIFICATE_QUOTA_TOOL, ];
- src/tools/list-esa-function.ts:164-208 (registration)Maps the 'set_certificate' handler function to the esaHandlers object for tool dispatching.export const esaHandlers: ToolHandlers = { site_active_list, site_match, site_route_list, site_record_list, routine_create, routine_code_commit, routine_delete, routine_list, routine_get, routine_code_deploy, routine_route_list, deployment_delete, route_create, route_delete, route_update, route_get, er_record_create, er_record_delete, er_record_list, html_deploy, create_site, update_site_pause, get_site_pause, create_site_mx_record, create_site_ns_record, create_site_txt_record, create_site_cname_record, create_site_a_or_aaaa_record, update_record, list_records, get_record, delete_record, update_ipv6, get_ipv6, update_managed_transform, get_managed_transform, set_certificate, apply_certificate, get_certificate, delete_certificate, list_certificates, get_certificate_quota, list_sites, };
- src/utils/service.ts:498-507 (helper)The underlying API service method called by the tool handler to perform the setCertificate operation.setCertificate(params: SetCertificateRequest) { const request = new SetCertificateRequest(params); return this.callApi( this.client.setCertificate.bind(this.client) as ApiMethod< SetCertificateRequest, SetCertificateResponse >, request, ); }