Todos los productos
Search
Centro de documentos

:QueryReceiverByParam

Última actualización: Sep 03, 2026

Consulta de una lista de destinatarios

Descripción

Esta operación consulta una lista de destinatarios.

Parámetros de solicitud

Nombre

Tipo

Obligatorio

Descripción

Action

String

Sí

Parámetro obligatorio. Establezca el valor en QueryReceiverByParam.

PageSize

Integer

No

Número de entradas por página. Valor predeterminado: 10.

PageNo

Integer

No

Número de página actual.

KeyWord

String

No

Palabras clave. De forma predeterminada, se devuelve toda la información.

Status

Integer

No

Estado de entrega. Si deja este parámetro vacío, se devuelven los destinatarios en todos los estados.

Para obtener más información sobre otros parámetros de solicitud, consulte Common request parameters.

Parámetros de respuesta

Nombre

Tipo

Descripción

data

Array

Detalles de la lista de destinatarios.

NextStart

String

Se usa para la paginación. Si hay más resultados disponibles, establezca el parámetro NextStart con este valor en la siguiente solicitud.

PageSize

Integer

Número de entradas mostradas por página.

RequestId

String

ID de la solicitud.

TotalCount

Integer

Número total de entradas.

data

Nombre

Tipo

Descripción

ReceiverId

String

ID de la lista de destinatarios.

ReceiversName

String

Nombre de la lista de destinatarios.

Count

String

Número total de direcciones de destinatarios.

ReceiversAlias

String

Alias de la lista de destinatarios.

Desc

String

Descripción.

ReceiversStatus

String

Estado de la lista. 0: Cargando. 1: Carga completada.

CreateTime

String

Hora de creación de la lista. Por ejemplo: 2021-09-28T16:40:35Z.

UtcCreateTime

Long

Marca de tiempo UNIX. Por ejemplo: 1632818435.

Ejemplos

Ejemplo de solicitud

http(s)://dm.aliyuncs.com/?Action=QueryReceiverByParam
&KeyWord=''
&Status=''
&PageNo=''
&PageSize=''
&<Common request parameters>

Ejemplo de respuesta exitosa

Formato JSON

{
  "TotalCount": 9,
  "RequestId": "E6603A47-F1B4-39E2-A773-87A72F3779C4",
  "data": {
    "receiver": [
      {
        "ReceiversStatus": 0,
        "ReceiverId": "079984cfc696ce1b5bed3a43d2e6f97a",
        "Desc": "List 2",
        "UtcCreateTime": 1628816320,
        "ReceiversName": "234235",
        "CreateTime": "2021-08-13T08:58:40Z",
        "ReceiversAlias": "test@example.net",
        "Count": 1
      }
    ]
  }
}