Todos los productos
Search
Centro de documentos

Domain Names:QueryDomainList

Última actualización: Sep 03, 2026

Consulta los nombres de dominio en su cuenta de Alibaba Cloud con paginación.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Puede invocar esta operación en OpenAPI Explorer, que genera dinámicamente código de ejemplo para diferentes SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action

String

Sí

QueryDomainList

La operación a ejecutar. Establezca el valor en QueryDomainList.

EndExpirationDate

Long

No

1522080000000

Fin del intervalo de tiempo para consultar nombres de dominio por fecha de vencimiento. Especifique una marca de tiempo UNIX en milisegundos. Solo se admite precisión diaria.

StartExpirationDate

Long

No

1522080000000

Inicio del intervalo de tiempo para consultar nombres de dominio por fecha de vencimiento. Especifique una marca de tiempo UNIX en milisegundos. Solo se admite precisión diaria.

UserClientIp

String

No

127.0.0.1

La dirección IP del cliente. Establezca el valor en 127.0.0.1.

Lang

String

No

en

Idioma en el que el sistema devuelve el mensaje de error. Valores válidos:

  • zh: chino

  • en: inglés

Valor predeterminado: en.

QueryType

String

No

1

Categoría de los nombres de dominio que desea consultar. Valores válidos:

  • 1: nombres de dominio pendientes de renovación

  • 2: nombres de dominio pendientes de redención

StartRegistrationDate

Long

No

1522080000000

Inicio del intervalo de tiempo para consultar nombres de dominio por fecha de registro. Especifique una marca de tiempo UNIX en milisegundos. Solo se admite precisión diaria.

EndRegistrationDate

Long

No

1522080000000

Fin del intervalo de tiempo para consultar nombres de dominio por fecha de registro. Especifique una marca de tiempo UNIX en milisegundos. Solo se admite precisión diaria.

DomainName

String

No

example.com

Nombre de dominio que se va a buscar.

OrderByType

String

No

ASC

Orden de clasificación de la información de los nombres de dominio. Valores válidos:

  • ASC: orden ascendente

  • DESC: orden descendente

    Nota

    Valor predeterminado: DESC.

OrderKeyType

String

No

RegistrationDate

Campo por el cual ordenar los nombres de dominio. Valores válidos:

  • RegistrationDate: los nombres de dominio se ordenan por fecha de registro.

  • ExpirationDate: los nombres de dominio se ordenan por fecha de vencimiento.

Nota

Si no se especifica, los nombres de dominio se ordenan según la hora en que se agregaron a la base de datos de la autoridad de verificación.

ProductDomainType

String

No

New gTLD

Tipo de nombres de dominio. Valores válidos:

  • New gTLD: nuevos nombres de dominio genéricos de nivel superior

  • gTLD: nombres de dominio genéricos de nivel superior

  • ccTLD: nombres de dominio de nivel superior con código de país

PageNum

Integer

Sí

1

Número de página que se va a devolver.

PageSize

Integer

Sí

10

Número de entradas por página.

DomainGroupId

String

No

123456

ID del grupo de nombres de dominio.

Ccompany

String

No

administrator

Nombre del titular del nombre de dominio.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

PrePage

Boolean

false

Indica si existe una página anterior.

CurrentPageNum

Integer

0

Número de la página devuelta.

RequestId

String

B7AB5469-5E38-4AA9-A920-C65B7A9C8E6E

ID de la solicitud.

PageSize

Integer

5

Número de entradas por página.

TotalPageNum

Integer

1

Número total de páginas devueltas.

Data

Array of Domain

Nombres de dominio devueltos.

Domain

DomainAuditStatus

String

FAILED

Estado de la verificación de nombre real para el nombre de dominio. Valores válidos:

  • FAILED: la verificación de nombre real falló.

  • SUCCEED: la verificación de nombre real fue exitosa.

  • NONAUDIT: no se ha realizado la verificación de nombre real.

  • AUDITING: la información de la verificación de nombre real está en revisión.

DomainGroupId

String

123456

ID del grupo de nombres de dominio.

Remark

String

Test

Observaciones sobre el nombre de dominio.

DomainGroupName

String

Test group

Nombre del grupo de nombres de dominio.

RegistrationDate

String

Nov 02,2017 04:00:45

Fecha y hora en que se registró el nombre de dominio.

InstanceId

String

ST20151102120031118

ID de instancia del nombre de dominio.

DomainName

String

example.com

Nombre de dominio buscado.

ExpirationDatestatus

String

1

Indica si el nombre de dominio ha vencido. Valores válidos:

  • 1: el nombre de dominio no ha vencido.

  • 2: el nombre de dominio ha vencido.

ExpirationDate

String

Nov 02,2019 04:00:45

Fecha y hora en que vence el nombre de dominio.

RegistrantType

String

1

Tipo de registro del nombre de dominio. Valores válidos:

  • 1: registrado por un individuo

  • 2: registrado por una empresa

ExpirationDateLong

Long

1522080000000

Fecha de vencimiento del nombre de dominio. Este valor es una marca de tiempo UNIX en milisegundos.

ExpirationCurrDateDiff

Integer

-30

Número de días desde la fecha actual hasta la fecha de vencimiento del nombre de dominio.

Premium

Boolean

true

Indica si el nombre de dominio es premium.

RegistrationDateLong

Long

1522080000000

Fecha de registro del nombre de dominio. Este valor es una marca de tiempo UNIX en milisegundos.

ProductId

String

2a

ID del producto.

DomainStatus

String

3

Estado del nombre de dominio. Valores válidos:

  • 1: el nombre de dominio necesita renovación.

  • 2: el nombre de dominio necesita redención.

  • 3: el nombre de dominio está en estado normal.

DomainType

String

gTLD

Tipo del nombre de dominio. Valores válidos:

  • New gTLD

  • gTLD

  • ccTLD

TotalItemNum

Integer

1

Número total de nombres de dominio devueltos.

NextPage

Boolean

false

Indica si existe una página siguiente.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=QueryDomainList
&PageNum=1
&PageSize=10
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version='1.0' encoding='UTF-8'?>
<QueryDomainListResponse>
    <Data>
        <Domain>
            <ExpirationDate>Nov 02,2019 04:00:45</expirationDate>
            <InstanceId>ST20151102120031118</SaleId>
            <RegistrationDate>Nov 02,2017 04:00:45</registrationDate>
            <DomainName>example.com</DomainName>
            <DomainType>gTLD</domainType>
        </Domain>
    </Data>
    <TotalItemNum>1</TotalItemNum>
    <PageSize>5</PageSize>
    <CurrentPageNum>0</CurrentPageNum>
    <RequestId>B7AB5469-5E38-4AA9-A920-C65B7A9C8E6E</RequestId>
    <PrePage>false</PrePage>
    <TotalPageNum>1</TotalPageNum>
    <NextPage>false</NextPage>
</QueryDomainListResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Data" : {
    "Domain" : [ {
      "ExpirationDate" : "Nov 02,2019 04:00:45",
      "InstanceId" : "ST2015110212003800001928",
      "RegistrationDate" : "Nov 02,2017 04:00:45",
      "DomainName" : "fds234sdf.net",
      "DomainType" : "gTLD"
    } ]
  },
  "TotalItemNum" : 1,
  "PageSize" : 5,
  "CurrentPageNum" : 0,
  "RequestId" : "77F90DA6-89AB-4074-80F3-E595CB57DF98",
  "PrePage" : false,
  "TotalPageNum" : 1,
  "NextPage" : false
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.