@dynatrace-sdk/client-app-settings-v2
Advanced tools
[](https://www.npmjs.com/package/@dynatrace-sdk/client-app-settings-v2/v/1.1.3) [](https://opensource.org/licenses/Apache-2.0)
Retrieve, update and manage app settings.
npm install @dynatrace-sdk/client-app-settings-v2
This SDK is distributed under the Apache License, Version 2.0, see LICENSE for more information.
Full API reference for the latest version of the SDK is also available at the Dynatrace Developer.
import { appSettingsObjectsClient } from '@dynatrace-sdk/client-app-settings-v2';
Required scope: app-settings:objects:write Required permission: app-settings:objects:write
Remove the permissions for an existing all-users accessor on this object, anyone with read/write permissions is allowed to delete permissions
| Name | Type | Description |
|---|---|---|
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.objectId*required | string | The ID of the required settings object |
| Return type | Status code | Description |
|---|---|---|
| void | 204 | success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | No object available for the given objectId or the all-users accessor doesn't have any permissions on this object |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.deleteAppSettingsAllUsersPermissionByObjectId(
{ objectId: "..." },
);
Deletes the specified settings object
Required scope: app-settings:objects:write Required permission: app-settings:objects:write
| Name | Type | Description |
|---|---|---|
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.objectId*required | string | The ID of the required settings object |
| config.optimisticLockingVersion*required | string | The version of the object for optimistic locking. You can use it to detect simultaneous modifications by different users. It is generated upon retrieval (GET requests). If set on update (PUT request) or deletion, the update/deletion will be allowed only if there wasn't any change between the retrieval and the update. |
| Return type | Status code | Description |
|---|---|---|
| void | 204 | Success. Response doesn't have a body. |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | Failed. The input is invalid. | Failed. Forbidden. | Failed. The requested resource doesn't exist. |
| ConflictingResource | Failed. Conflicting resource. |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.deleteAppSettingsObjectByObjectId(
{ objectId: "...", optimisticLockingVersion: "..." },
);
Required scope: app-settings:objects:write Required permission: app-settings:objects:write
Remove the permissions for an existing accessor on this object, anyone with read/write permissions is allowed to delete permissions
| Name | Type | Description |
|---|---|---|
| config.accessorId*required | string | The user uuid or group uuid of the accessor, depending on the type |
| config.accessorType*required | "user" | "group" | The type of the accessor |
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.objectId*required | string | The ID of the required settings object |
| Return type | Status code | Description |
|---|---|---|
| void | 204 | success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | No object available for the given objectId or the accessor doesn't have any permissions on this object |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.deleteAppSettingsPermissionByObjectIdAndAccessorId(
{
objectId: "...",
accessorType: "user",
accessorId: "...",
},
);
Required scope: app-settings:objects:read Required permission: app-settings:objects:read
Get current permissions of the all-users accessor on this object
| Name | Type | Description |
|---|---|---|
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.objectId*required | string | The ID of the required settings object |
| Return type | Status code | Description |
|---|---|---|
| AppSettingsAccessorPermissions | 200 | Success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | No object available for the given objectId or the all-users accessor doesn't have any permissions on this object |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.getAppSettingsAllUsersPermissionByObjectId(
{ objectId: "..." },
);
Gets the specified settings object
Required scope: app-settings:objects:read Required permission: app-settings:objects:read
Gets the specified settings object. Properties of type secret will be included in plain text if the call originates from a serverless function of your app; they will have irreversibly masked values otherwise. This protects these secrets from leaking to users of your app or other third parties.
| Name | Type | Description |
|---|---|---|
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.objectId*required | string | The ID of the required settings object |
| Return type | Status code | Description |
|---|---|---|
| AppSettingsObject | 200 | Success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | Failed. The input is invalid. | Failed. Forbidden. | No object available for the given objectId |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.getAppSettingsObjectByObjectId(
{ objectId: "..." },
);
Lists persisted settings objects
Required scope: app-settings:objects:read Required permission: app-settings:objects:read
Lists persisted settings objects for selected schemas.
If nothing is persisted or if all persisted settings objects are not accessible due to missing permissions, no items will be returned.
To query the effective values (including schema defaults) please see getEffectiveAppSettingsValues.
Properties of type secret will be included in plain text if the call originates from a serverless function of your app; they will have irreversibly masked values otherwise. This protects these secrets from leaking to users of your app or other third parties.
| Name | Type | Description |
|---|---|---|
| config.addFields | string | A list of fields to be included to the response. The provided set of fields extends the default set. Specify the required top-level fields, separated by commas (for example, summary,value). Supported fields: objectId, version, summary, searchSummary, schemaId, schemaVersion, modificationInfo, resourceContext, value, owner. Default fields: objectId, version. |
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.filter | string | The filter parameter, as explained here. Filtering is supported on the following fields:
If this parameter is omitted, all settings objects will be returned. The maximum nesting depth (via parentheses) is 5. The maximum expression length is 1024 characters. Note that only fields included to the response via |
| config.pageKey | string | The cursor for the next page of results. You can find it in the nextPageKey field of the previous response. The first page is always returned if you don't specify the page-key query parameter. When the page-key is set to obtain subsequent pages, you must omit all other query parameters. |
| config.pageSize | number | The amount of settings objects in a single response payload. If set to 0, all available settings objects will be included in the response (not allowed if filter or sort parameter is referencing The maximal allowed page size is 500. If not set, 100 is used. |
| config.schemaId | string | Schema ID to which the requested objects belong. To load the first page, when the nextPageKey is not set, this parameter is required. |
| config.sort | string | The sort parameter, as explained here. Sorting is supported on the following fields:
Note that only fields included to the response via |
| Return type | Status code | Description |
|---|---|---|
| AppSettingsObjectsList | 200 | Success. Uses chunked encoding. |
Even if a response returns a successful response code it is possible that the result is incomplete due to an internal error.
In this case an 'error' property with information about the problem is added. The caller may decide to work with the incomplete result or do a retry of the operation.|
| Error Type | Error Message |
|---|---|
| ErrorResponseError | Failed. The input is invalid. | Failed. Forbidden. | Failed. The specified schema was not found. |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.getAppSettingsObjects();
Required scope: app-settings:objects:read Required permission: app-settings:objects:read
Get current permissions of the accessor on this object
| Name | Type | Description |
|---|---|---|
| config.accessorId*required | string | The user uuid or group uuid of the accessor, depending on the type |
| config.accessorType*required | "user" | "group" | The type of the accessor |
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.objectId*required | string | The ID of the required settings object |
| Return type | Status code | Description |
|---|---|---|
| AppSettingsAccessorPermissions | 200 | Success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | No object available for the given objectId or the accessor doesn't have any permissions on this object |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.getAppSettingsPermissionByObjectIdAndAccessorId(
{
objectId: "...",
accessorType: "user",
accessorId: "...",
},
);
Required scope: app-settings:objects:read Required permission: app-settings:objects:read
Get current permissions on this object
| Name | Type | Description |
|---|---|---|
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.objectId*required | string | The ID of the required settings object |
| Return type | Status code | Description |
|---|---|---|
| AppSettingsAccessorPermissionsList | 200 | Success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | No object available for the given objectId |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.getAppSettingsPermissionsByObjectId(
{ objectId: "..." },
);
Lists effective settings values
Required scope: app-settings:objects:read Required permission: app-settings:objects:read
Lists effective settings values for selected schemas. If no object is persisted for a schema with "multiObject": false, the default value as defined in the schema will be returned.
Properties of type secret will be included in plain text if the call originates from a serverless function of your app; they will have irreversibly masked values otherwise. This protects these secrets from leaking to users of your app or other third parties.
| Name | Type | Description |
|---|---|---|
| config.addFields | string | A list of fields to be included to the response. The provided set of fields extends the default set. Specify the required top-level fields, separated by commas (for example, summary,schemaId). Supported fields: summary, searchSummary, schemaId, schemaVersion, modificationInfo, value. Default fields: value. |
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.pageKey | string | The cursor for the next page of results. You can find it in the nextPageKey field of the previous response. The first page is always returned if you don't specify the page-key query parameter. When the page-key is set to obtain subsequent pages, you must omit all other query parameters. |
| config.pageSize | number | The amount of settings objects in a single response payload. If set to 0, all available settings objects will be included in the response. The maximal allowed page size is 500. If not set, 100 is used. |
| config.schemaId | string | Schema ID to which the requested objects belong. Only considered on load of the first page, when the nextPageKey is not set. |
| Return type | Status code | Description |
|---|---|---|
| EffectiveAppSettingsValuesList | 200 | Success. Uses chunked encoding. |
Even if a response returns a successful response code it is possible that the result is incomplete due to an internal error.
In this case an 'error' property with information about the problem is added. The caller may decide to work with the incomplete result or do a retry of the operation.|
| Error Type | Error Message |
|---|---|
| ErrorResponseError | Failed. The input is invalid. | Failed. The specified schema is not found. |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.getEffectiveAppSettingsValues();
Creates a new settings object
Required scope: app-settings:objects:write Required permission: app-settings:objects:write
Creates a new settings object.
| Name | Type | Description |
|---|---|---|
| config.body*required | AppSettingsObjectCreate | |
| config.validateOnly | boolean | If true, the request runs only validation of the submitted settings objects, without saving them. |
| Return type | Status code | Description |
|---|---|---|
| void | 200 | Success. No validation errors. |
| AppSettingsObjectResponse | 201 | Created |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | Failed. The input is invalid. | Failed. Forbidden. | Failed. The requested resource doesn't exist. |
| ConflictingResource | Failed. Conflicting resource. |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.postAppSettingsObject({
body: { schemaId: "jira-connection", value: {} },
});
Required scope: app-settings:objects:write Required permission: app-settings:objects:write
Transfer ownership of the object, only the owner or the main admin is allowed to transfer the ownership (IAM permission needed).
| Name | Type | Description |
|---|---|---|
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.body*required | AppSettingsTransferOwnershipRequest | |
| config.objectId*required | string | The ID of the required settings object |
| Return type | Status code | Description |
|---|---|---|
| void | 204 | Success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | No object available for the given objectId |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.postAppSettingsOwnershipByObjectId(
{
objectId: "...",
body: { newOwner: { type: "user" } },
},
);
Required scope: app-settings:objects:write Required permission: app-settings:objects:write
Add the permissions for a single accessor on this object, anyone with read/write permissions is allowed to add more permissions
| Name | Type | Description |
|---|---|---|
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.body*required | AppSettingsAccessorPermissions | |
| config.objectId*required | string | The ID of the required settings object |
| Return type | Status code | Description |
|---|---|---|
| AppSettingsAccessorPermissions | 201 | Success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | if accessor id already exists | No object available for the given objectId |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.postAppSettingsPermissionByObjectId(
{
objectId: "...",
body: { accessor: { type: "user" }, permissions: {} },
},
);
Required scope: app-settings:objects:write Required permission: app-settings:objects:write
Update the permissions for an existing all-users accessor on this object, anyone with read/write permissions is allowed to update permissions
| Name | Type | Description |
|---|---|---|
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.body*required | AppSettingsUpdatePermissionsRequest | |
| config.objectId*required | string | The ID of the required settings object |
| Return type | Status code | Description |
|---|---|---|
| void | 200 | success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | if permission list is empty, contains unsupported entries or unsupported combinations of entries | No object available for the given objectId or the all-users accessor doesn't have any permissions on this object |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.putAppSettingsAllUsersPermissionByObjectId(
{ objectId: "...", body: { permissions: {} } },
);
Updates an existing settings object
Required scope: app-settings:objects:write Required permission: app-settings:objects:write
Updates an existing settings object with new values. To update a property of the secret type you need to pass the new value unmasked. To keep the current value, send the current masked secret. You can obtain it via GET an object endpoint.
Some schemas don't allow passing of the masked secret. In that case you need to send the unmasked secret with every update of the object.
| Name | Type | Description |
|---|---|---|
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.body*required | AppSettingsObjectUpdate | |
| config.objectId*required | string | The ID of the required settings object |
| config.optimisticLockingVersion*required | string | The version of the object for optimistic locking. You can use it to detect simultaneous modifications by different users. It is generated upon retrieval (GET requests). If set on update (PUT request) or deletion, the update/deletion will be allowed only if there wasn't any change between the retrieval and the update. |
| Return type | Status code | Description |
|---|---|---|
| AppSettingsUpdateResponse | 200 | Success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | Failed. The input is invalid. | Failed. Forbidden. | Failed. The requested resource doesn't exist. |
| ConflictingResource | Failed. Conflicting resource. |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.putAppSettingsObjectByObjectId(
{
objectId: "...",
optimisticLockingVersion: "...",
body: { value: {} },
},
);
Required scope: app-settings:objects:write Required permission: app-settings:objects:write
Update the permissions for an existing accessor on this object, anyone with read/write permissions is allowed to update permissions
| Name | Type | Description |
|---|---|---|
| config.accessorId*required | string | The user uuid or group uuid of the accessor, depending on the type |
| config.accessorType*required | "user" | "group" | The type of the accessor |
| config.adminAccess | boolean | If set to true and user has app-settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects |
| config.body*required | AppSettingsUpdatePermissionsRequest | |
| config.objectId*required | string | The ID of the required settings object |
| Return type | Status code | Description |
|---|---|---|
| void | 200 | success |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | if permission list is empty, contains unsupported entries or unsupported combinations of entries | No object available for the given objectId or the accessor doesn't have any permissions on this object |
| TooManyRequests | Failed. Too many requests. |
| ServiceUnavailable | Failed. Service unavailable. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.putAppSettingsPermissionByObjectIdAndAccessorId(
{
objectId: "...",
accessorType: "user",
accessorId: "...",
body: { permissions: {} },
},
);
Get the effective settings permissions of the calling user in the environment
Required scope: app-settings:objects:read or app-settings:objects:write Required permission: app-settings:objects:read or app-settings:objects:write
| Name | Type |
|---|---|
| config.body*required | ResolutionRequest |
| Error Type | Error Message |
|---|---|
| ErrorResponseError | Failed. The input is invalid. | Failed. Forbidden. No access to any schema. |
| GeneralError | Error. |
import { appSettingsObjectsClient } from "@dynatrace-sdk/client-app-settings-v2";
const data =
await appSettingsObjectsClient.resolveEffectivePermissions(
{
body: {
permissions: [
{
permission: "app-settings:objects:read",
context: { schemaId: "..." },
},
],
},
},
);
| Name | Type |
|---|---|
| accessor*required | Identity |
| permissions*required | AppSettingsPermissionsList |
| Name | Type |
|---|---|
| accessors*required | Array<AppSettingsAccessorPermissions> |
A settings object.
| Name | Type | Description |
|---|---|---|
| modificationInfo | ModificationInfo | Modification information about the setting. |
| objectId*required | string | The ID of the settings object. |
| owner | Identity | |
| resourceContext | ResourceContext | The resource context, which contains additional permission information about the object. |
| schemaId | string | The schema on which the object is based. |
| schemaVersion | string | The version of the schema on which the object is based. |
| searchSummary | string | A searchable summary string of the setting value. Plain text without Markdown. |
| summary | string | A short summary of settings. This can contain Markdown and will be escaped accordingly. |
| value | AppSettingsValueRaw | The value of the setting. It defines the actual values of settings' parameters. The actual content depends on the object's schema. |
| version*required | string | The version of the object for optimistic locking. You can use it to detect simultaneous modifications by different users. It is generated upon retrieval (GET requests). If set on update (PUT request) or deletion, the update/deletion will be allowed only if there wasn't any change between the retrieval and the update. |
Configuration of a new settings object.
| Name | Type | Description |
|---|---|---|
| insertAfter | string | The position of the new object. The new object will be added after the specified one. If If set to empty string, the new object will be placed in the first position. Only applicable for objects based on schemas with ordered objects (schema's |
| schemaId*required | string | The schema on which the object is based. |
| value*required | AppSettingsValue | The value of the setting. It defines the actual values of settings' parameters. The actual content depends on the object's schema. |
The response to a creation request.
| Name | Type | Description |
|---|---|---|
| objectId*required | string | The ID of the created settings object. |
| version*required | string | The version of the object for optimistic locking. You can use it to detect simultaneous modifications by different users. It is generated upon retrieval (GET requests). If set on update (PUT request) or deletion, the update/deletion will be allowed only if there wasn't any change between the retrieval and the update. |
An update of a settings object.
| Name | Type | Description |
|---|---|---|
| insertAfter | string | The position of the updated object. The new object will be moved behind the specified one. insertAfter and insertBefore are evaluated together and only one of both can be set. If If set to empty string, the updated object will be placed in the first position. Only applicable for objects based on schemas with ordered objects (schema's ordered parameter is set to |
| insertBefore | string | The position of the updated object. The new object will be moved in front of the specified one. insertAfter and insertBefore are evaluated together and only one of both can be set. If If set to empty string, the updated object will be placed in the last position. Only applicable for objects based on schemas with ordered objects (schema's ordered parameter is set to |
| value*required | AppSettingsValue | The value of the setting. It defines the actual values of settings' parameters. The actual content depends on the object's schema. |
A list of settings objects.
| Name | Type | Description |
|---|---|---|
| error | ErrorIncomplete | Error object for an incomplete response |
| items*required | Array<AppSettingsObject> | A list of settings objects. |
| nextPageKey | string | The cursor for the next page of results. Has the value of Use it in the nextPageKey query parameter to obtain subsequent pages of the result. |
| pageSize*required | number | The number of entries per page. |
| totalCount*required | number | The total number of entries in the result. |
type: Array<"r" | "w">
| Name | Type |
|---|---|
| newOwner | Identity |
| Name | Type |
|---|---|
| permissions*required | AppSettingsPermissionsList |
The response to an update request.
| Name | Type | Description |
|---|---|---|
| version*required | string | The version of the object for optimistic locking. You can use it to detect simultaneous modifications by different users. It is generated upon retrieval (GET requests). If set on update (PUT request) or deletion, the update/deletion will be allowed only if there wasn't any change between the retrieval and the update. |
Contains information about a constraint violation caused by invalid input.
| Name | Type | Description |
|---|---|---|
| message*required | string | The constraint violation description message |
| path | string | The path of the parameter that caused the constraint violation |
An effective settings value.
| Name | Type | Description |
|---|---|---|
| modificationInfo | ModificationInfo | Modification information about the setting. |
| schemaId | string | The schema on which the object is based. |
| schemaVersion | string | The version of the schema on which the object is based. |
| searchSummary | string | A searchable summary string of the setting value. Plain text without Markdown. |
| summary | string | A short summary of settings. This can contain Markdown and will be escaped accordingly. |
| value | AppSettingsValueRaw | The value of the setting. It defines the actual values of settings' parameters. The actual content depends on the object's schema. |
A list of effective settings values.
| Name | Type | Description |
|---|---|---|
| error | ErrorIncomplete | Error object for an incomplete response |
| items*required | Array<EffectiveAppSettingsValue> | A list of effective settings values. |
| nextPageKey | string | The cursor for the next page of results. Has the value of Use it in the nextPageKey query parameter to obtain subsequent pages of the result. |
| pageSize*required | number | The number of entries per page. |
| totalCount*required | number | The total number of entries in the result. |
| Name | Type |
|---|---|
| context | PermissionContext |
| granted*required | "true" | "false" | "condition" |
| permission*required | string |
type: Array<EffectivePermission>
Standard error response
| Name | Type | Description |
|---|---|---|
| code*required | number | The error code (HTTP response) |
| details | ErrorDetails | Optional details of the error |
| message*required | string | The error code (HTTP response) |
| retryAfterSeconds | number | Number of seconds a request can be retried after a 'too many requests' error response. |
Optional details of the error
| Name | Type | Description |
|---|---|---|
| constraintViolations | Array<ConstraintViolation> | A list of constraint violations of input parameters (path, query, request body) |
| errorRef | string | reference to the error occurrence in the internal self-monitoring, logging, etc. |
| missingScopes | Array<string> | In case of a 403 - Forbidden response, a list of missing scopes necessary to successfully execute the request |
Error object for an incomplete response
| Name | Type | Description |
|---|---|---|
| code*required | number | The error code (HTTP response) |
| details | ErrorDetails | Optional details of the error |
| message*required | string | The error message |
| retryAfterSeconds | number | Number of seconds a request can be retried after a 'too many requests' error response. |
| Name | Type | Description |
|---|---|---|
| error*required | Error | Standard error response |
| Name | Type | Description |
|---|---|---|
| id | string | user id or user group id if type is 'user' or 'group', missing if type is 'all-users' |
| type*required | "user" | "group" | "all-users" |
Modification information about the setting.
| Name | Type | Description |
|---|---|---|
| createdBy | string | The unique identifier of the user who created the setting. |
| createdTime | Date | Timestamp when the setting was created in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z') |
| lastModifiedBy | string | The unique identifier of the user who performed the most recent modification. |
| lastModifiedTime | Date | Timestamp when the setting was last modified in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z') |
The additional modification details for this settings object.
| Name | Type | Description |
|---|---|---|
| first | boolean | If non-moveable settings object is in the first group of non-moveable settings, or in the last (start or end of list). |
| modifiablePaths*required | Array<string> | Property paths which are modifiable, regardless if the write operation is allowed. |
| movable | boolean | If settings object can be moved/reordered. Only applicable for ordered list schema. |
| nonModifiablePaths*required | Array<string> | Property paths which are not modifiable, even if the write operation is allowed. |
| Name | Type |
|---|---|
| schemaId*required | string |
| Name | Type |
|---|---|
| permissions*required | Array<SinglePermissionRequest> |
The resource context, which contains additional permission information about the object.
| Name | Type | Description |
|---|---|---|
| modifications*required | Modifications | The additional modification details for this settings object. |
| operations*required | Array<"read" | "write" | "delete"> | The allowed operations on this settings object. |
optional generic set of context data
| Name | Type |
|---|---|
| context | PermissionContext |
| permission*required | "app-settings:objects:read" | "app-settings:objects:write" | "app-settings:objects:admin" |
R | W
Condition | False | True
Group | User
AllUsers | Group | User
Delete | Read | Write
AppSettingsObjectsAdmin | AppSettingsObjectsRead | AppSettingsObjectsWrite
FAQs
[](https://www.npmjs.com/package/@dynatrace-sdk/client-app-settings-v2/v/1.1.3) [](https://opensource.org/licenses/Apache-2.0)
The npm package @dynatrace-sdk/client-app-settings-v2 receives a total of 1,434 weekly downloads. As such, @dynatrace-sdk/client-app-settings-v2 popularity was classified as popular.
We found that @dynatrace-sdk/client-app-settings-v2 demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
/Research
Malicious npm package impersonates Nodemailer and drains wallets by hijacking crypto transactions across multiple blockchains.
Security News
This episode explores the hard problem of reachability analysis, from static analysis limits to handling dynamic languages and massive dependency trees.
Security News
/Research
Malicious Nx npm versions stole secrets and wallet info using AI CLI tools; Socket’s AI scanner detected the supply chain attack and flagged the malware.