Configuración API - actualizarDetallesGeneralesDelSitio

Recomendamos encarecidamente que, antes de comenzar a usar la API de Cato, revise la Política de Soporte para la API de Cato.

Resumen de actualizarDetallesGeneralesDelSitio

Utilice la mutación API actualizarDetallesGeneralesDelSitio para actualizar las siguientes configuraciones en la sección General de un sitio en la Aplicación de Gestión de Cato (Red > Sitios > {nombre del sitio} > Configuración del Sitio > General)

Nombre
Descripción
Tipo
Zona horaria
País
Estado
Dirección

Ubicación del accountId para su Cuenta

Este ID de Cuenta no se muestra en la Aplicación de Gestión de Cato, en su lugar es el número en la URL para la Aplicación de Gestión de Cato. Por ejemplo, el ID de Cuenta es 26 para la siguiente URL: https://cc.catonetworks.com/#!/26/topology.

Ingrese este ID en el argumento accountId para la API de creación de sitio, por ejemplo:

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

Localizando el siteID para un Sitio

El ID del sitio no se muestra en la aplicación de gestión de Cato, puedes localizar el ID del sitio:

Usando la consulta API entityLookup (ver API de Cato - EntityLookup), utiliza el tipo con el valor site
También puedes utilizar el parámetro search con el valor como el nombre del sitio, y la consulta devuelve el ID del sitio
Número en la URL para la aplicación de gestión de Cato, cuando seleccionas un sitio (Red > Sitios > {site name}). Por ejemplo, el ID del sitio es 12345 para la siguiente URL: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics

Detalles para los Argumentos de actualizarDetallesGeneralesDelSitio

Estos son los argumentos para actualizar las siguientes configuraciones Generales para un sitio usando la API de configuración de Cato. Los argumentos son obligatorios a menos que se indiquen como opcionales:

nombre - Nombre del sitio
tipoDeSitio - Tipo de sitio en su organización, por ejemplo Centro de Datos en la Nube
descripción - (opcional) Descripción del sitio
ubicaciónDelSitio - Datos sobre la ubicación física del sitio

Nombre de actualizarDetallesGeneralesDelSitio

Actualice el nombre del sitio.

tipoDeSitio de actualizarDetallesGeneralesDelSitio

El tipoDeSitio es un argumento de enumeración que define el tipo de sitio que determina qué icono se utiliza para el sitio en la pantalla de Supervisión > Topología en la Aplicación de Gestión de Cato.

Estas son las opciones:

SUCURSAL - Sitios físicos o virtuales
SEDE - Sitios físicos para sedes corporativas
NUBE_CD - Sitios virtuales para centros de datos basados en la nube
CENTRO_DE_DATOS - Sitios físicos para centros de datos

Descripción de actualizarDetallesGeneralesDelSitio (Opcional)

La descripción es un campo de texto libre opcional para describir el sitio.

ubicaciónDelSitio de actualizarDetallesGeneralesDelSitio

Los argumentos ubicaciónDelSitio definen los siguientes detalles físicos para el sitio. El códigoDePaís es relevante para el número de licencias de sitio que están disponibles para una Región específica en su cuenta.

Puede utilizar la consulta API entityLookup para recuperar valores para estos argumentos, consulte API de Cato - EntityLookup.

Estos son los argumentos ubicaciónDelSitio:

códigoDePaís - Código de dos letras (ISO 3166-1 alpha-2) para el país donde se encuentra el sitio
Para entityLookup, utilice el tipo con el valor país
códigoDeEstado - (Opcional) Para los países aplicables, el estado donde se encuentra el sitio
Para entityLookup, utilice el tipo con el valor estadoPaís
zona horaria - Zona horaria para el sitio, utilizada para establecer el marco de tiempo para la ventana de mantenimiento para actualizaciones de Socket y vSocket
Para entityLookup, utilice el tipo con el valor zona horaria
dirección - (Opcional) Dirección de la calle para el sitio físico

Script de Postman de Ejemplo

mutación actualizarDetallesGeneralesDelSitio ($accountId: ID!, $siteID: ID!, $input: UpdateSiteGeneralDetailsInput!) {
    sitio(accountId: $accountId) {
        actualizarDetallesGeneralesDelSitio (siteId: $siteID, input: $input) {
            siteId
        }
    }
}

Variables de GraphQL

{
    "accountId": "",
    "siteID": "",
    "input": {
        "nombre": "MiSitio",
        "descripción": "Mi primer CD usando la API",
        "tipoDeSitio": "CENTRO_DE_DATOS",
        "ubicaciónDelSitio": {
            "códigoDePaís": "FR",
            "zona horaria": "Europa/París"
        }
    }
}

Recursos Relacionados

Documentation Index