Mettre à jour un enregistrement DNS avec l'API Cloudflare
Modifie un enregistrement DNS et le renvoie. Seuls les champs envoyés changent. Les enregistrements A et AAAA ne peuvent pas partager un nom avec un CNAME, et un enregistrement NS ne peut partager son nom avec aucun autre.
- Identifiant
- cloudflare_update_dns_record
L'appel
POST https://connect.reportei.com/api/tools/cloudflare_update_dns_record/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"zone_id": "<zone_id>",
"dns_record_id": "<dns_record_id>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| zone_id | string | Oui | The id of the zone, from List zones. |
| dns_record_id | string | Oui | The id of the record, from List DNS records. |
| type | string | Non | Record type.Valeurs : A, AAAA, CNAME, MX, TXT, NS, CAA, SRV, HTTPS |
| name | string | Non | Full name of the record, including the zone, such as www.example.com. |
| content | string | Non | Value of the record: the IPv4 or IPv6 address, the target host of a CNAME, MX or NS, or the text of a TXT. CAA and SRV records use data instead. |
| ttl | number | Non | Time to live in seconds, from 60 to 86400, or 1 for automatic. |
| proxied | boolean | Non | Sends the traffic through Cloudflare. Only for A, AAAA and CNAME records. |
| priority | number | Non | Priority of an MX record. Lower values are preferred. |
| comment | string | Non | Note about the record, with no effect on DNS answers. |
| data | object | Non | Parts of a CAA or SRV record: flags, tag and value for CAA, such as {flags: 0, tag: issue, value: letsencrypt.org}; priority, weight, port and target for SRV. |
Connexions possibles
Votre client connecte son compte Cloudflare une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/cloudflare_update_dns_record. Il devient la définition de tool de votre agent sans conversion.
Autres tools Cloudflare
- Lister les zonesGETListe les zones (domaines) auxquelles le token accède, avec id, nom, statut, name_servers, forfait et compte. L'id est le zone_id utilisé par les autres tools. Paginez avec page et per_page ; result_info.total_pages indique le nombre de pages.
- Créer une zonePOSTAjoute un domaine à un compte Cloudflare et renvoie la zone au statut pending, avec les name_servers à configurer chez le registrar du domaine. La zone devient active quand le registrar pointe vers eux.
- Mettre à jour une zonePATCHMet en pause ou reprend Cloudflare sur une zone et la renvoie. Avec paused true, la zone ne garde que le DNS, sans les fonctions de sécurité et de performance de Cloudflare.
- Lister les enregistrements DNSGETListe les enregistrements DNS d'une zone, avec id, type, name, content, proxied, ttl et comment. Les filtres fonctionnent ensemble sauf si match vaut any. Paginez avec page et per_page ; result_info.total_pages indique le nombre de pages.
- Créer un enregistrement DNSPOSTCrée un enregistrement DNS dans une zone et le renvoie, avec son id. Les enregistrements A et AAAA ne peuvent pas partager un nom avec un CNAME, et un enregistrement NS ne peut partager son nom avec aucun autre.
- Supprimer un enregistrement DNSDELETESupprime un enregistrement DNS d'une zone et renvoie son id. Le changement atteint immédiatement les réponses DNS et ne peut pas être annulé.
- Purger le cachePOSTSupprime le contenu en cache d'une zone de tous les data centers Cloudflare ; la requête suivante va à l'origine. Envoyez exactement un parmi files, tags, hosts, prefixes ou purge_everything. Un succès signifie que la requête a été acceptée, pas que quelque chose était en cache. Le nombre d'éléments par appel dépend du forfait.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
