Todos los productos
Search
Centro de documentos

Direct Mail:ConfigSetCreate

Última actualización: Sep 01, 2026

Crea un conjunto de configuración. Puede crear hasta 100 conjuntos de configuración.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dm:ConfigSetCreate

create

*All Resource

*

Ninguna Ninguna

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

Name

string

No

El nombre del conjunto de configuración. Este parámetro es obligatorio. El nombre puede tener hasta 50 caracteres y debe ser único.

XXX

IpPoolId

string

No

El ID del pool de IP para asociar. Este parámetro es opcional.

XXX

Description

string

No

La descripción. La descripción puede tener hasta 50 caracteres.

XXX

IsPublicChannelBackoff

boolean

No

Especifica si se debe recurrir al canal público para el envío cuando el pool de IP dedicadas asociado presenta problemas.

  • true (recurrir): El sistema excluye las IP dedicadas que actualmente están limitadas o incluidas en una lista negra por el proveedor de buzones de destino durante cada intento de entrega, y utiliza preferentemente las IP disponibles restantes en el pool. Cuando todas las IP del pool están limitadas o incluidas en una lista negra por el proveedor de buzones, el sistema cambia automáticamente al canal público para garantizar las tasas de éxito de entrega. Una vez que se levanta la limitación o la inclusión en la lista negra, el sistema reanuda automáticamente el uso de las IP dedicadas.

  • false (no recurrir): Solo se utiliza el pool de IP dedicadas asociado para el envío. Cuando las IP del pool están limitadas o incluidas en una lista negra, el sistema continúa utilizando estas IP para la entrega, lo que puede causar fallos o retrasos en la entrega. Sin embargo, esto garantiza que las IP de envío sean siempre sus IP dedicadas.

ValidationOption

object

No

Las opciones de validación de direcciones.

Enabled

boolean

No

Especifica si se debe habilitar la función de validación de direcciones.

  • true: Habilitada. Esto equivale al modo BASIC_ONLY de la operación ValidateEmail.

  • false: Deshabilitada.

ForbiddenStatusList

array

No

La lista de estados principales de validación de direcciones de destinatario que se deben bloquear. Antes del envío, el sistema prevalida la dirección del destinatario. Los correos electrónicos cuyo estado principal de validación coincida con una entrada de esta lista se rechazan.

string

No

El estado principal de validación de direcciones de destinatario que se debe bloquear. Valores válidos:

  • INVALID: La dirección no es válida o no existe.

  • CATCH_ALL: La dirección es una dirección catch-all. Cualquier buzón bajo el dominio puede recibir correos electrónicos y no se puede confirmar la existencia real de la dirección.

  • DO_NOT_MAIL: La dirección puede recibir correos electrónicos, pero no se recomienda para el envío, como cuentas de rol o buzones desechables.

  • UNKNOWN: No se puede proporcionar el resultado de la validación.

Si se pasa un valor desconocido, se devuelve un error InvalidParameter.

INVALID

ForbiddenSubStatusList

array

No

La lista de subestados de validación de direcciones de destinatario que se deben bloquear. Esto proporciona un control de bloqueo más detallado que los estados principales. Surte efecto como una unión con ForbiddenStatusList, lo que significa que un correo electrónico se bloquea si coincide con cualquiera de las dos listas.

string

No

El subestado de validación de direcciones que se debe bloquear. Valores válidos:

  • NO_DNS_ENTRIES: Dirección no válida. No existen registros DNS.

  • MISSPELLED: Dirección no válida. La dirección está mal escrita.

  • DOES_NOT_ACCEPT_MAIL: Dirección no válida. El servidor de correo no acepta correos electrónicos.

  • MAILBOX_NOT_EXISTS: Dirección no válida. El buzón no existe.

  • SYSTEM_ERROR: Estado desconocido. Ocurrió un error del sistema.

  • MX_FORWARD: Dirección anómala. Hay un reenvío MX configurado.

  • SYNTAX_INVALID: Dirección no válida. La dirección tiene un error de sintaxis.

  • ROLE_ACCOUNT: Dirección anómala. La dirección es una cuenta de rol, como role@, info@ o contact@.

  • SMTP_CONNECT_FAILED: Estado desconocido. Error al conectar con el servidor SMTP remoto.

  • DISABLED: Dirección no válida. El buzón está deshabilitado.

  • UNSPECIFIED: No especificado. Esto puede devolverse para estados válidos, catch-all o desconocidos.

  • IP_UNROUTABLE: Dirección no válida. La dirección IP del servidor de correo es inalcanzable.

  • GRAY_LIST: Estado desconocido. La dirección está en una lista gris.

  • MAILBOX_FULL: Dirección no válida. El buzón está lleno.

  • DISPOSABLE: Dirección anómala. La dirección es un buzón desechable en una lista negra.

  • TIMEOUT_EXCEEDED: Estado desconocido. Se ha excedido el tiempo de espera especificado.

Si se pasa un valor desconocido, se devuelve un error InvalidParameter.

DISPOSABLE

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

La respuesta.

RequestId

string

El ID de la solicitud.

XXX

Id

string

El ID del conjunto de configuración.

XXX

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "XXX",
  "Id": "XXX"
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.