Content resources API - PUT configuration

Updates the configuration of content providers in your Dynatrace environment.

The request consumes an application/json payload.

PUT
  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/contentResources
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/config/v1/contentResources

Authentication

To execute this request, you need the Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter Type Description In Required
body ContentResources

The JSON body of the request. Contains the configuration of content resources.

body optional

Body format

The ContentResources object

The configuration of content resources.

Element Type Description Required
resourceProviders ResourceProvider[]

An ordered list of manually added content providers.

Rules are evaluated from top to bottom; the first matching rules applies.

optional
resourceUrlCleanupRules ResourceUrlCleanupRule[]

An ordered list of resource URL cleanup rules.

Rules are evaluated from top to bottom; the first matching rules applies.

optional
resourceTypes ResourceType[]

An ordered list of manually defined resource types.

Rules are evaluated from top to bottom; the first matching rules applies.

optional

The ResourceType object

A rule for the resource type.

Element Type Description Required
regularExpression string

The regular expression to detect the resource.

required
primaryResourceType string

The primary type of the resource.

required
secondaryResourceType string

The secondary type of the resource.

optional

The ResourceUrlCleanupRule object

A rule for the URL cleanup rule.

Element Type Description Required
resourceName string

The name of the rule.

required
regularExpression string

The pattern (regular expression) to look for.

required
replaceWith string

The text to replace the found pattern with.

required

The ResourceProvider object

A rule for the content provider.

Element Type Description Required
resourceName string

The name of the provider.

required
resourceType string

The type of the provider.

required
brandIconUrl string

The URL of the provider's icon.

required
domainNamePatterns string[]

A list of domain patterns of the provider.

required

Response

Response codes

Code Description
204

Success. The configuration has been updated. Response doesn't have a body.

400

Failed. The input is invalid

Response body

A successful request doesn't return any content.

Validate payload

We recommend that you validate the payload before submitting it with an actual request. A response code of 204 indicates a valid payload.

The request consumes an application/json payload.

POST
  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/contentResources/validator
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/config/v1/contentResources/validator

Authentication

To execute this request, you need the Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Response

Response codes

Code Description
204

Validated. The submitted configuration is valid. Response doesn't have a body.

400

Failed. The input is invalid

Response body

A successful request doesn't return any content.