Send Docs Feedback

Apigee Test is an Apigee Labs feature. It's available free of charge, functions “as is,” and is not supported. There are no service-level agreements (SLAs) for bug fixes. Get help in the Apigee Community.

Update a Probe

Resource Summary

Security

Content Type

application/json

Category

Apigee Test,

UpdateaProbe

PUT

Update a Probe

Updates a Probe by ID. (To get the IDs of your Probes, use List Probes.) The payload you provide for the Probe becomes the new Probe configuration.

 

Consider backing up a Probe before updating it. To back it up, Get a Probe and save the response as a file.

 

Resource URL

https://api.test.apigee.com/v1 /organizations/{org_name}/probes/{probe_id}

Header Parameters

Name Values Description
Content-Type
(required)

application/json

Request Body

For information on Probes beyond what's covered here, see Probes.

Property Description
configSetId Optional. If you want to use a Config Set to set Test Case variables, enter the ID of the Config Set. To get Config Set IDs, use the List Config Sets API.
testcaseId Required. The ID of the Test Case you want the Probe to execute. To get Test Case IDs, use the List Test Cases API.
locations

Geographical locations from which the Probe is executed. Valid values:

  • pdx - Oregon - USA
  • iad - Washington, D.C. - USA
  • dub - Dublin - Ireland
  • syd - Sydney - Australia
  • tyo - Tokyo - Japan
schedule

The time interval between automatic Probe execution. Valid settings:

  • 30 seconds
  • 1 minutes
  • 5 minutes
  • 15 minutes
  • 30 minutes
  • 1 hours
  • Example:

"schedule": {
    "unit": "seconds",
    "interval": "30"
  }
  
alertConditions

Set conditions that trigger notifications. (See the sample payload for an example of each alert condition.) Valid settings are:

  • failures with a threshold number. If the Probe fails the number of consecutive times indicated by the threshold, Apigee Test sends a notification.
  • latency with a value in milliseconds and a threshold number. If the total execution time of all combined Steps in the Probe exceeds the number of milliseconds the specified number of times in a row, Apigee Test sends a notification.
  • anomaly with a boolean of true or false. If Apigee Test detects uncharacteristically high latency over a period of time, it sends a notification.
notificationChannels

At least one notification channel is required if you set one or more alert conditions. You can also create these as placeholders even if you don't set any alert conditions. No notifications will be sent until alert conditions are triggered. Supported notification channels/types are:

  • email with an array of email addresses
  • hipchat with room and accessToken
  • slack with a webHook URL
  • pagerduty with a token and serviceKey

See the sample payload for an example of each notification channel.

inActive
  • false to make the Probe active.
  • true to make the Probe inactive. Inactive Probes aren't executed.

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Response Error Details

  • HTTP Code
    Error Code
    Description
  • 400

    Bad Request

  • 401

    Unauthorized

  • 403

    Forbidden

  • 500

    Internal Server Error

Working...

Help or comments?