Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

DeleteInstrumentationConfiguration

Deletes the specified instrumentation configuration. SDKs remove the instrumentation during their next sync after the configuration is deleted or expires.

Request Syntax


POST /delete-instrumentation-configuration HTTP/1.1
Content-type: application/json

{
   "Environment": "string",
   "InstrumentationType": "string",
   "LocationIdentifier": { ... },
   "Service": "string",
   "SignalType": "string"
}

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

Environment

The environment name for the instrumentation configuration.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Required: Yes

InstrumentationType

The type of instrumentation configuration (BREAKPOINT or PROBE). Required to identify the configuration to delete.

Type: String

Valid Values: BREAKPOINT | PROBE

Required: Yes

LocationIdentifier

The location identifier - either the full code location or a pre-computed location hash.

Type: LocationIdentifier object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: Yes

Service

The service name for the instrumentation configuration.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Required: Yes

SignalType

The telemetry signal type for instrumentation.

SNAPSHOT - Captures a snapshot of the instrumentation point.

Type: String

Valid Values: SNAPSHOT

Required: Yes

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "DeletionStatus": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

DeletionStatus

The result of the delete request. The value is DELETED when the configuration has been removed.

Type: String

Valid Values: DELETED

Errors

For information about the errors that are common to all actions, see Common Error Types.

ResourceNotFoundException

Resource not found.

ResourceId: Can't find the resource id.
ResourceType: The resource type is not valid.

HTTP Status Code: 404

ThrottlingException

The request was throttled because of quota limits.

HTTP Status Code: 429

ValidationException

The resource is not valid.

HTTP Status Code: 400