Configuration API - addSocketSite

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

  • Description

  • Type

  • 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 identifiant de compte n'est pas affiché dans l'Application de gestion Cato, il s'agit du numéro dans l'URL pour l'Application de gestion Cato. Par exemple, l'identifiant de 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 indication contraire :

  • nom - Nom du 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 l'icône utilisée pour le site dans l'écran de Topologie dans l'Application de gestion Cato.

Voici les options :

Description AddSocketSite (Optionnelle)

La 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 disponibles pour une Région spécifique dans votre compte.

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

Voici les arguments siteLocation :

Script Postman Exemple

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

Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 0 sur 1

0 commentaire