delete_certificate

Remove SSL/TLS certificates from websites managed through ESA services to maintain security compliance and manage certificate lifecycles.

Instructions

Deletes a certificate for a website.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`siteId`	Yes	The website ID, which can be obtained by calling the ListSites operation. Example: 1234567890123
`id`	Yes	The ID of the certificate. Example: 30001303

Implementation Reference

src/tools/site/certificate.ts:226-235 (handler)

The handler function for the 'delete_certificate' tool. It extracts arguments, calls api.deleteCertificate, and returns the JSON stringified response.

export const delete_certificate = async (request: CallToolRequest) => {
  const res = await api.deleteCertificate(
    request.params.arguments as DeleteCertificateRequest,
  );

  return {
    content: [{ type: 'text', text: JSON.stringify(res) }],
    success: true,
  };
};

src/tools/site/certificate.ts:116-135 (schema)

The tool definition including name, description, and input schema for 'delete_certificate'.

export const DELETE_CERTIFICATE_TOOL: Tool = {
  name: 'delete_certificate',
  description: 'Deletes a certificate for a website.',
  inputSchema: {
    type: 'object',
    properties: {
      siteId: {
        type: 'number',
        description:
          'The website ID, which can be obtained by calling the ListSites operation. Example: 1234567890123',
      },
      id: {
        type: 'string',
        description: 'The ID of the certificate. Example: 30001303',
      },
    },
    required: ['siteId', 'id'],
    annotations: {},
  },
};

src/tools/list-esa-function.ts:143-150 (registration)

Registration of DELETE_CERTIFICATE_TOOL in the CERTIFICATE_LIST array, which is 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)

Registration of the delete_certificate handler function in the esaHandlers object.

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:531-540 (helper)

The API wrapper method deleteCertificate used by the tool handler to interact with the Alibaba Cloud ESA service.

deleteCertificate(params: DeleteCertificateRequest) {
  const request = new DeleteCertificateRequest(params);
  return this.callApi(
    this.client.deleteCertificate.bind(this.client) as ApiMethod<
      DeleteCertificateRequest,
      DeleteCertificateResponse
    >,
    request,
  );
}

ESA MCP Server