Lister les enregistrements DNS avec l'API Cloudflare
Liste 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.
- Identifiant
- cloudflare_list_dns_records
L'appel
POST https://connect.reportei.com/api/tools/cloudflare_list_dns_records/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>"
}
}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. |
| type | string | Non | Only records of this type.Valeurs : A, AAAA, CAA, CERT, CNAME, DNSKEY, DS, HTTPS, LOC, MX, NAPTR, NS, OPENPGPKEY, PTR, SMIMEA, SRV, SSHFP, SVCB, TLSA, TXT, URI |
| name | string | Non | Exact full name of the record, including the zone, such as www.example.com. |
| content | string | Non | Exact content of the record, such as an IP address. |
| comment | string | Non | Exact comment of the record. |
| proxied | boolean | Non | Only records that go, or do not go, through the Cloudflare proxy. |
| match | string | Non | all requires every filter (the default); any accepts records that pass at least one.Valeurs : all, any |
| order | string | Non | Sort field. The default is type.Valeurs : type, name, content, ttl, proxied |
| direction | string | Non | Sort order. The default is asc.Valeurs : asc, desc |
| per_page | number | Non | Records per page. The default is 100. |
| page | number | Non | Page number, starting at 1. |
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_list_dns_records. 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.
- 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.
- Mettre à jour un enregistrement DNSPATCHModifie 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.
- 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.
