DescribeCertificates - Web Application Firewall: Central de Documentação do Alibaba Cloud

Consulta os certificados SSL associados a um nome de domínio no Web Application Firewall (WAF), incluindo detalhes como Common Name, período de validade e Subject Alternative Names (SANs).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeCertificates	Operação a ser executada. Defina o valor como DescribeCertificates.
Domain	String	Não	www.example.com	Nome de domínio adicionado ao WAF.
InstanceId	String	Sim	waf_elasticity-cn-0xldbqt****	ID da instância do WAF. Para obter o ID da instância, chame a operação DescribeInstanceInfo.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	D7861F61-5B61-46CE-A47C-6B19160D5EB0	ID da solicitação.
Certificates	Array		Certificados SSL associados ao nome de domínio.
CertificateId	Long	2329260	ID do certificado SSL.
CertificateName	String	CertName	Nome do certificado SSL.
CommonName	String	*.example.com	Nome de domínio associado ao certificado SSL.
IsUsing	Boolean	false	Indica se o certificado SSL está em uso pelo nome de domínio. Valores válidos: true (em uso) e false (não está em uso).
EndTime	Long	1971273600000	Horário de expiração do certificado SSL. O valor é um timestamp UNIX em milissegundos.
Sans	List	["*.example.com"]	Subject Alternative Names (SANs) do certificado SSL. Os SANs correspondem aos nomes de domínio protegidos pelo WAF associados a este certificado.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DescribeCertificates
&Domain=www.example.com
&InstanceId=waf_elasticity-cn-0xldbqt****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeCertificatesResponse>
    <Certificates>
        <Sans>*.example.com</Sans>
        <CertificateId>2329260</CertificateId>
        <CertificateName>CertName</CertificateName>
        <IsUsing>true</IsUsing>
        <CommonName>*.example.com</CommonName>
    </Certificates>
    <RequestId>D7861F61-5B61-46CE-A47C-6B19160D5EB0</RequestId>
</DescribeCertificatesResponse>

Formato JSON

{
    "Certificates": [
        {
            "Sans": [
                "*.example.com"
            ],
            "CertificateId": 2329260,
            "CertificateName": "CertName",
            "IsUsing": true,
            "CommonName": "*.example.com"
        }
    ],
    "RequestId": "D7861F61-5B61-46CE-A47C-6B19160D5EB0"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros da API.