Todos os produtos
Search
Central de documentação

:ListCustomDomains

Última atualização: Oct 19, 2026

Obtém uma lista de nomes de domínio personalizados.

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

fc:ListCustomDomains

list

*Todos os recursos.

*

Nenhuma Nenhuma

Sintaxe da solicitação

GET /2023-03-30/custom-domains HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

prefix

string

Não

O prefixo do nome de domínio.

foo

nextToken

string

Não

O token de início de paginação.

MTIzNCNhYmM=

limit

integer

Não

O número de nomes de domínio personalizados a serem retornados.

10

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

ListCustomDomainOutput

A lista de nomes de domínio personalizados.

Exemplos

Resposta de sucesso

JSON formato

{
  "customDomains": [
    {
      "accountId": "186851234023****",
      "apiVersion": "2023-03-30",
      "authConfig": {
        "authInfo": "{}",
        "authType": "anonymous"
      },
      "certConfig": {
        "certName": "my-cert",
        "certificate": "PEM format",
        "privateKey": "PEM format"
      },
      "corsConfig": {
        "allowCredentials": true,
        "allowHeaders": [
          ""
        ],
        "allowMethods": [
          ""
        ],
        "allowOrigins": [
          ""
        ],
        "exposeHeaders": [
          ""
        ],
        "maxAge": 3600
      },
      "createdTime": "2023-03-30T08:02:19Z",
      "domainName": "example.com",
      "isE2B": false,
      "lastModifiedTime": "2023-03-30T08:02:19Z",
      "protocol": "HTTP",
      "routeConfig": {
        "routes": [
          {
            "functionName": "myFunction",
            "methods": [
              "GET"
            ],
            "path": "/api/*",
            "qualifier": "myAlias",
            "rewriteConfig": {
              "equalRules": [
                {
                  "match": "/old",
                  "replacement": "/new"
                }
              ],
              "regexRules": [
                {
                  "match": "^/api/.+?/(.*)",
                  "replacement": "/api/v2/$1"
                }
              ],
              "wildcardRules": [
                {
                  "match": "/api/*",
                  "replacement": "/$1"
                }
              ]
            }
          }
        ]
      },
      "subdomainCount": "1",
      "tlsConfig": {
        "cipherSuites": [
          "TLS_RSA_WITH_RC4_128_SHA"
        ],
        "maxVersion": "TLSv1.3",
        "minVersion": "TLSv1.2"
      },
      "wafConfig": {
        "enableWAF": true
      }
    }
  ],
  "nextToken": "next_domain_name"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.