Configuración API - actualizarDetallesGeneralesDelSitio

Recomendamos encarecidamente que, antes de comenzar a utilizar la API de Cato, revise la Política de Soporte Técnico 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 la 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 
    } 
}

Ubicación del siteID para un Sitio

El ID del sitio no se muestra en la Aplicación de Gestión de Cato, puede localizar el ID del sitio:

Usando la consulta API entityLookup (ver API de Cato - EntityLookup), use el tipo con el valor sitio

También puede usar el parámetro buscar 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 seleccionó un sitio (Red > Sitios > {nombre del sitio}). 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:

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 muestra de Postman

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