DescribeServerCertificates - Server Load Balancer: Central de Documentação do Alibaba Cloud

Consulta os certificados de servidor em uma região.

Descrição da operação

Nota

Por motivos de segurança, apenas as impressões digitais e os nomes dos certificados de servidor são retornados. O conteúdo dos certificados de servidor e das chaves privadas não é retornado.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

slb:DescribeServerCertificates

list

*ServerCertificate

acs:slb:{#regionId}:{#AccountId}:certificate/*

slb:tag

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	A região onde a instância CLB está implantada. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente. Nota Se o endpoint da região selecionada for slb.aliyuncs.com, você deve especificar `RegionId`.	cn-hangzhou
ServerCertificateId	string	Não	O ID do certificado de servidor.	12315790*******_166f8204689_1714763408_709981430
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-atstuj3rtop****
Tag	array<object>	Não	As tags.
	object	Não	As tags.
Key	string	Não	A chave da tag do recurso. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag deve ter de 1 a 64 caracteres e não pode começar com `aliyun` ou `acs:`. A chave da tag não pode conter `http://` ou `https://`.	test
Value	string	Não	O valor da tag do recurso. Você pode especificar até 20 valores de tag. O valor da tag não pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode começar com `acs:` ou `aliyun`. O valor da tag não pode conter `http://` ou `https://`.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	365F4154-92F6-4AE4-92F8-7FF34B540710
ServerCertificates	object
ServerCertificate	array<object>	Os certificados de servidor.
	array<object>
CreateTimeStamp	integer	The timestamp when the server certificate was uploaded.	1504147745000
AliCloudCertificateName	string	The name of the server certificate from Alibaba Cloud Certificate Management Service.	testcertkey
ExpireTime	string	The time when the server certificate expires.	2023-01-26T23:59:59Z
CreateTime	string	The time when the server certificate was uploaded.	2021-08-31T02:49:05Z
ServerCertificateId	string	The server certificate ID.	123157********_166f8204689_1714763408_709981430-cn-east-hangzhou-02
ExpireTimeStamp	integer	The timestamp when the server certificate expires.	15041477450
RegionId	string	The region ID of the server certificate.	cn-hangzhou
ServerCertificateName	string	The name of the server certificate.	slb
Fingerprint	string	The fingerprint of the server certificate.	68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d
CommonName	string	The domain name of the server certificate. The domain name is specified in the `CommonName` field.	www.example.com
ResourceGroupId	string	The resource group ID.	rg-atstuj3rtop****
IsAliCloudCertificate	integer	Indicates whether the server certificate is from Alibaba Cloud Certificate Management Service. Valid values: 1: yes 0: no	0
AliCloudCertificateId	string	The ID of the server certificate from Alibaba Cloud Certificate Management Service.	7309********_15d97e7709a_71445759hr_789289731
Tags	object
Tag	array<object>	The tags.
	object	The tag value.
TagValue	string	The tag value.	1
TagKey	string	The tag keys of the resource.	test
SubjectAlternativeNames	object
SubjectAlternativeName	array	The alternative domain names of the server certificate. The alternative domain names are specified in the Subject Alternative Name field of the server certificate.
	string	The alternative domain names of the server certificate. The alternative domain names are specified in the `Subject Alternative Name` field of the server certificate.	["demo.aliyundoc.com","example.aliyundoc.com"]

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "ServerCertificates": {
    "ServerCertificate": [
      {
        "CreateTimeStamp": 1504147745000,
        "AliCloudCertificateName": "testcertkey",
        "ExpireTime": "2023-01-26T23:59:59Z",
        "CreateTime": "2021-08-31T02:49:05Z",
        "ServerCertificateId": "123157********_166f8204689_1714763408_709981430-cn-east-hangzhou-02",
        "ExpireTimeStamp": 15041477450,
        "RegionId": "cn-hangzhou",
        "ServerCertificateName": "slb",
        "Fingerprint": "68:08:1a:f8:2c:97:69:a3:a1:e6:16:41:4b:ca:4f:5d:ee:a5:ef:0d",
        "CommonName": "www.example.com",
        "ResourceGroupId": "rg-atstuj3rtop****",
        "IsAliCloudCertificate": 0,
        "AliCloudCertificateId": "7309********_15d97e7709a_71445759hr_789289731",
        "Tags": {
          "Tag": [
            {
              "TagValue": "1",
              "TagKey": "test"
            }
          ]
        },
        "SubjectAlternativeNames": {
          "SubjectAlternativeName": [
            "[\"demo.aliyundoc.com\",\"example.aliyundoc.com\"]"
          ]
        }
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Abs.ServerCertificateIdAndResourceGroupId.MissMatch	ServerCertificateId or ResourceGroupId miss match.
400	LocationServiceTimeout	Location service connection timeout. Please try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.