Administrar ubicación privada

La ubicación privada le permite monitorear la aplicación detrás de su firewall o en redes restringidas. Cuando creas una ubicación privada, instalas y configuras minion privado para ejecutar los monitores asignados a esa ubicación privada. Este tutorial proporciona ejemplos de cómo emplear la API de NerdGraph para gestionar mediante programación la ubicación privada.

Crear una ubicación privada

Puedes crear una ubicación privada usando la mutación syntheticsCreatePrivateLocation. Esta mutación le permite configurar una nueva ubicación privada en su infraestructura de monitoreo donde puede desplegar minion privado o administradores de trabajo.

parámetro de entrada

Solicitud de muestra

mutation {
  syntheticsCreatePrivateLocation(
    accountId: ACCOUNT_ID
    name: "PrivateLocationName"
    description: "Optional description"
    shared: true
    verifiedScriptExecution: false
  ) {
    guid
    errors {
      description
      type
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve el GUID de la ubicación privada recién creada:

{
  "data": {
    "syntheticsCreatePrivateLocation": {
      "guid": "PRIVATE_LOCATION_GUID",
      "errors": null
    }
  }
}

Si hay algún problema al crear la ubicación privada, la matriz errors contendrá objetos con campos description y type que explican qué salió mal.

Actualizar una ubicación privada

Puede actualizar una ubicación privada existente empleando la mutación syntheticsUpdatePrivateLocation. Esto le permite modificar la configuración de una ubicación privada que ya fue creada.

parámetro de entrada

Solicitud de muestra

mutation {
  syntheticsUpdatePrivateLocation(
    guid: "ENTITY_GUID"
    description: "EnterYourDescription"
    shared: false
    verifiedScriptExecution: true
  ) {
    description
    verifiedScriptExecution
    errors {
      description
      type
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve los campos actualizados y null para errores:

{
  "data": {
    "syntheticsUpdatePrivateLocation": {
      "description": "EnterYourDescription",
      "verifiedScriptExecution": true,
      "errors": null
    }
  }
}

Si hay algún problema al actualizar la ubicación privada, la matriz errors contendrá objetos con campos description y type que explican qué salió mal.

Limpiar una cola de trabajos de una ubicación privada

Puede borrar la cola de trabajos de una ubicación privada empleando la mutación syntheticsPurgePrivateLocationQueue. Esto es útil cuando necesita eliminar una acumulación de trabajos de monitorización de Sintético en cola que pueden haber acumulado debido a problemas de rendimiento o problemas de conectividad temporales.

parámetro de entrada

Solicitud de muestra

mutation {
  syntheticsPurgePrivateLocationQueue(guid: "PRIVATE_LOCATION_ENTITY_GUID") {
    errors {
      description
      type
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsPurgePrivateLocationQueue": {
      "errors": null
    }
  }
}

Si hay algún problema al purgar la cola, la matriz errors contendrá objetos con campos description y type que explican qué salió mal.

Eliminar una ubicación privada

Cuando ya no se necesita una ubicación privada, puedes eliminarla de forma permanente empleando la mutación syntheticsDeletePrivateLocation.

parámetro de entrada

Solicitud de muestra

mutation {
  syntheticsDeletePrivateLocation(guid: "ENTITY_GUID") {
    errors {
      description
      type
    }
  }
}

Ejemplo de respuesta

Una respuesta exitosa devuelve null para los errores:

{
  "data": {
    "syntheticsDeletePrivateLocation": {
      "errors": null
    }
  }
}

Si hay algún problema al eliminar la ubicación privada, la matriz errors contendrá objetos con campos description y type que explican qué salió mal.