Press CTRL+K to open search

Configuration API - addSocketSite

  • Mis à jour le Jul 30, 2026
  • Publié le Jun 28, 2026
  • 3 Minute(s) lue(s)
Prev Next

Nous recommandons fortement qu'avant de commencer à utiliser l'API Cato, vous consultiez la politique de support pour l'API Cato.

Aperçu de addSocketSite

Utilisez l'API de mutation addSocketSite pour créer un nouveau site Socket dans votre compte et définir les paramètres suivants pour le site :

  • Nom

  • Nom d'affichage

  • Type de menace

  • Type de Connexion

  • Fuseau horaire

  • Pays

  • État

  • Adresse

  • Plage native

Le site est créé avec les paramètres par défaut de bande passante, 25 Mbps en aval et 25 Mbps en amont, et est créé sans licence assignée.

Pour les comptes revendeurs, vous pouvez créer des clés API séparées dans chaque compte client avec lequel vous configurez les paramètres API Cato.

Localisation de l'accountId pour Votre Compte

Cet ID de compte n'est pas affiché dans l'Application de gestion Cato, il s'agit plutôt du numéro dans l'URL pour l'Application de gestion Cato. Par exemple, l'ID du compte est 26 pour l'URL suivante : https://cc.catonetworks.com/#!/26/topology.

Entrez cet ID dans l'argument accountId pour l'API de création de site, par exemple :

site(accountId: 26) {
    addSocketSite(input: $addSocketSite) { 
        siteId 
    } 
}

Détails pour les arguments addSocketSite

Voici les arguments pour la création d'un nouveau site Socket en utilisant l'API de configuration Cato. Les arguments sont obligatoires sauf s'ils sont marqués comme optionnels :

  • nom - Nom de la site

  • connectionType - Socket physique ou vSocket pour ce site

  • siteType - Type de site dans votre organisation, par exemple Centre de Données Cloud

  • description - (optionnel) Description du site

  • nativeNetworkRange - Plage IP pour le LAN natif derrière le site, au format CIDR

  • siteLocation - Données sur l'emplacement physique du site

Nom AddSocketSite

Définissez le nom du site Socket que vous créez.

AddSocketSite connectionType

Le connectionType est un argument enum qui définit le type de Socket physique ou virtuel pour le site.

Voici les options :

  • SOCKET_X1500 - Socket X1500 ou X1500B pour un site physique

  • SOCKET_X1600 - Socket X1600 pour un site physique

  • SOCKET_X1700 - Socket X1700 ou X1700B pour un site physique

  • SOCKET_ESX - vSocket pour un site VMware virtuel

  • SOCKET_AWS - vSocket pour un site AWS virtuel

  • SOCKET_AZURE - vSocket pour un site Azure virtuel

Type de site AddSocketSite

Le siteType est un argument enum qui définit le type de site qui détermine quelle icône est utilisée pour le site dans l'écran Surveillance > Topologie dans l'Application de Gestion Cato.

Voici les options :

  • BRANCH - Sites physiques ou virtuels

  • HEADQUARTERS - Sites physiques pour les sièges d'entreprise

  • CLOUD_DC - Sites virtuels pour centres de données basés sur le cloud

  • DATACENTER - Sites physiques pour centres de données

Description AddSocketSite (Optionnelle)

Le description est un champ de texte libre optionnel pour décrire le site.

Plage de réseau natif AddSocketSite

Définissez la plage IP pour la plage native LAN pour le site dans l'argument nativeNetworkRange au format IPSubnet. La plage native utilise CIDR pour le sous-réseau, et les blocs CIDR /32 ne sont pas pris en charge.

Emplacement du site AddSocketSite

Les arguments siteLocation définissent les détails physiques suivants pour le site. Le countryCode est pertinent pour le nombre de licences de site qui sont disponibles pour une Région spécifique dans votre compte.

Vous pouvez utiliser la requête API entityLookup pour récupérer les valeurs de ces arguments, voir Cato API - EntityLookup.

Ce sont les arguments siteLocation :

  • countryCode - Code à deux lettres (ISO 3166-1 alpha-2) pour le pays où le site est situé

    Pour entityLookup, utilisez le type avec la valeur country

  • stateCode - (Optionnel) Pour les pays applicables, l'état où le site est situé

    Pour entityLookup, utilisez le type avec la valeur countryState

  • timezone - Fuseau horaire pour le site, utilisé pour définir la période de la fenêtre de maintenance pour les mises à jour des Socket et vSocket

    Pour entityLookup, utilisez le type avec la valeur timezone

  • adresse - (Optionnel) Adresse de rue pour le site physique

Exemple de script Postman

mutation addSocketSite ($accountId: ID!, $input: AddSocketSiteInput!) {
    site(accountId: $accountId) {
        addSocketSite (input: $input) {
            siteId
        }
    }
}

Variables GraphQL

{
    "accountId": "26",
    "input": {
        "name": "SampleUsSite2",
        "description": "Mon premier site API",
        "siteType": "BRANCH",
        "connectionType": "SOCKET_X1500",
        "nativeNetworkRange": "10.0.0.0/24",
        "siteLocation": {
            "countryCode": "US",
            "timezone": "US/Central",
            "stateCode": "US-AL"
        }
    }
}

Ressources Associées

Articles Liés