Tous les produits
Search
Centre de documentation

:ConfigSetCreate

Dernière mise à jour :Aug 31, 2026

Crée un ensemble de configuration. Vous pouvez créer jusqu'à 100 ensembles de configuration.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

dm:ConfigSetCreate

create

*Toutes les ressources.

*

Aucune Aucune

Syntaxe de la requête

POST  HTTP/1.1

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Name

string

Non

Le nom de l'ensemble de configuration. Ce paramètre est obligatoire. Le nom peut comporter jusqu'à 50 caractères et doit être unique.

XXX

IpPoolId

string

Non

L'identifiant du pool d'adresses IP à associer. Ce paramètre est facultatif.

XXX

Description

string

Non

La description. La description peut comporter jusqu'à 50 caractères.

XXX

IsPublicChannelBackoff

boolean

Non

Indique s'il faut basculer vers le canal public pour l'envoi lorsque le pool d'adresses IP dédiées associé rencontre des problèmes.

  • true (basculement) : le système exclut les adresses IP dédiées qui sont actuellement limitées ou mises sur liste noire par le fournisseur de messagerie cible lors de chaque tentative de remise, et utilise de préférence les adresses IP disponibles restantes dans le pool. Lorsque toutes les adresses IP du pool sont limitées ou mises sur liste noire par le fournisseur de messagerie, le système bascule automatiquement vers le canal public pour garantir les taux de réussite de la remise. Une fois la limitation ou la mise sur liste noire levée, le système reprend automatiquement l'utilisation des adresses IP dédiées.

  • false (pas de basculement) : seul le pool d'adresses IP dédiées associé est utilisé pour l'envoi. Lorsque les adresses IP du pool sont limitées ou mises sur liste noire, le système continue d'utiliser ces adresses IP pour la remise, ce qui peut entraîner des échecs ou des retards de remise. Cependant, cela garantit que les adresses IP d'envoi sont toujours vos adresses IP dédiées.

ValidationOption

object

Non

Les options de validation d'adresse.

Enabled

boolean

Non

Indique si la fonctionnalité de validation d'adresse doit être activée.

  • true : activée. Cela équivaut au mode BASIC_ONLY de l'opération ValidateEmail.

  • false : désactivée.

ForbiddenStatusList

array

Non

La liste des statuts principaux de validation d'adresse du destinataire à bloquer. Avant l'envoi, le système prévalide l'adresse du destinataire. Les e-mails dont le statut principal de validation correspond à une entrée de cette liste sont rejetés.

string

Non

Le statut principal de validation d'adresse du destinataire à bloquer. Valeurs valides :

  • INVALID : l'adresse n'est pas valide ou n'existe pas.

  • CATCH_ALL : l'adresse est une adresse fourre-tout. Toute boîte mail sous le domaine peut recevoir des e-mails, et l'existence réelle de l'adresse ne peut pas être confirmée.

  • DO_NOT_MAIL : l'adresse peut recevoir des e-mails mais n'est pas recommandée pour l'envoi, comme les comptes de rôle ou les boîtes mail jetables.

  • UNKNOWN : le résultat de la validation ne peut pas être fourni.

Si une valeur inconnue est transmise, une erreur InvalidParameter est renvoyée.

INVALID

ForbiddenSubStatusList

array

Non

La liste des sous-statuts de validation d'adresse du destinataire à bloquer. Cela offre un contrôle de blocage plus granulaire que les statuts principaux. Cela s'applique en union avec ForbiddenStatusList, ce qui signifie qu'un e-mail est bloqué s'il correspond à l'une ou l'autre des listes.

string

Non

Le sous-statut de validation d'adresse à bloquer. Valeurs valides :

  • NO_DNS_ENTRIES : adresse non valide. Aucun enregistrement DNS n'existe.

  • MISSPELLED : adresse non valide. L'adresse est mal orthographiée.

  • DOES_NOT_ACCEPT_MAIL : adresse non valide. Le serveur de messagerie n'accepte pas les e-mails.

  • MAILBOX_NOT_EXISTS : adresse non valide. La boîte mail n'existe pas.

  • SYSTEM_ERROR : statut inconnu. Une erreur système s'est produite.

  • MX_FORWARD : adresse anormale. Le transfert MX est configuré.

  • SYNTAX_INVALID : adresse non valide. L'adresse présente une erreur de syntaxe.

  • ROLE_ACCOUNT : adresse anormale. L'adresse est un compte de rôle, tel que role@, info@ ou contact@.

  • SMTP_CONNECT_FAILED : statut inconnu. Échec de la connexion au serveur SMTP distant.

  • DISABLED : adresse non valide. La boîte mail est désactivée.

  • UNSPECIFIED : non spécifié. Cela peut être renvoyé pour des statuts valides, fourre-tout ou inconnus.

  • IP_UNROUTABLE : adresse non valide. L'adresse IP du serveur de messagerie est injoignable.

  • GRAY_LIST : statut inconnu. L'adresse figure sur une liste grise.

  • MAILBOX_FULL : adresse non valide. La boîte mail est pleine.

  • DISPOSABLE : adresse anormale. L'adresse est une boîte mail jetable sur une liste noire.

  • TIMEOUT_EXCEEDED : statut inconnu. Le délai d'attente spécifié est dépassé.

Si une valeur inconnue est transmise, une erreur InvalidParameter est renvoyée.

DISPOSABLE

Éléments de réponse

Élément

Type

Description

Exemple

object

La réponse.

RequestId

string

L'identifiant de la requête.

XXX

Id

string

L'identifiant de l'ensemble de configuration.

XXX

Exemples

JSON format

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

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.