npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@dynatrace-sdk/client-bucket-management

v2.3.0

Published

Provides a public bucket management API for Grail.

Downloads

36

Readme

@dynatrace-sdk/client-bucket-management

npm License

Here you can find the

  • The Dynatrace Bucket Management API for Grail. Get more information about use cases and examples from the Dynatrace Documentation

Installation

npm install @dynatrace-sdk/client-bucket-management

Getting help

License

This SDK is distributed under the Apache License, Version 2.0, see LICENSE for more information.

API reference

Full API reference for the latest version of the SDK is also available at the Dynatrace Developer.

bucketDefinitionsClient

import { bucketDefinitionsClient } from '@dynatrace-sdk/client-bucket-management';

createBucket

Create a new bucket

Create a new bucket. Bucket creation can take up to 1 minute.

Required scope: storage:bucket-definitions:write

Parameters

| Name | Type | | --- | --- | |config.body*required|NewBucket|

Returns

| Return type | Status code | Description | |---|---|---| |Bucket|201|Successfully created bucket definition|

Throws

| Error Type | Error Message | |---|---| |ErrorEnvelopeError|bad request | unauthorized | missing permissions | Bucket already exists|

import { bucketDefinitionsClient } from "@dynatrace-sdk/client-bucket-management";

const data = await bucketDefinitionsClient.createBucket({
  body: {
    bucketName: "custom_logs",
    table: "logs",
    displayName: "Custom logs bucket",
    retentionDays: 35,
  },
});

deleteBucket

Delete a bucket

Starts deleting a bucket.

Deletes the bucket and all data stored in the bucket. This operation can not be undone.

Required scope: storage:bucket-definitions:delete

Parameters

| Name | Type | | --- | --- | |config.bucketName*required|string|

Returns

| Return type | Status code | Description | |---|---|---| |Bucket|202|accepted delete bucket|

Throws

| Error Type | Error Message | |---|---| |ErrorEnvelopeError|bad request | unauthorized | Forbidden | bucket not found | another operation is still in progress that prevents deletion.|

import { bucketDefinitionsClient } from "@dynatrace-sdk/client-bucket-management";

const data = await bucketDefinitionsClient.deleteBucket({
  bucketName: "...",
});

getDefinition

Get bucket definition by name

Get bucket definition by name.

Newly created buckets are not shown immediately, this can take up to a minute.

Required scope: storage:bucket-definitions:read

Parameters

| Name | Type | Description | | --- | --- | --- | |config.addFields|Array<string>|Define additional fields added to the response. Depending on the field this may result in longer response times. records: Request number of records stored in a bucket. estimatedUncompressedBytes: Request estimated uncompressed size of a bucket. | |config.bucketName*required|string| |

Returns

| Return type | Status code | Description | |---|---|---| |Bucket|200|Successfully retrieved bucket definition.|

Throws

| Error Type | Error Message | |---|---| |ErrorEnvelopeError|bad request | unauthorized | missing permissions | Bucket with provided name was not found.|

import { bucketDefinitionsClient } from "@dynatrace-sdk/client-bucket-management";

const data = await bucketDefinitionsClient.getDefinition({
  bucketName: "...",
});

getDefinitions

Get all bucket definitions

Get all bucket definitions.

Newly created buckets are not shown immediately, this can take up to a minute.

Required scope: storage:bucket-definitions:read

Parameters

| Name | Type | Description | | --- | --- | --- | |config.addFields|Array<string>|Define additional fields added to the response. Depending on the field this may result in longer response times. records: Request number of records stored in a bucket. estimatedUncompressedBytes: Request estimated uncompressed size of a bucket. |

Returns

| Return type | Status code | Description | |---|---|---| |Buckets|200|Successfully retrieved all bucket definitions|

Throws

| Error Type | Error Message | |---|---| |ErrorEnvelopeError|bad request | unauthorized | missing permissions|

import { bucketDefinitionsClient } from "@dynatrace-sdk/client-bucket-management";

const data = await bucketDefinitionsClient.getDefinitions();

truncateBucket

Truncate a bucket

Truncate a specific bucket. Removes the content of the given bucket. Operation can be executed with all types of buckets.

Required scope: storage:bucket-definitions:truncate

Parameters

| Name | Type | | --- | --- | |config.bucketName*required|string|

Returns

| Return type | Status code | Description | |---|---|---| |void|202|Accepted truncate bucket|

Throws

| Error Type | Error Message | |---|---| |ErrorEnvelopeError|bad request | unauthorized | Forbidden | Bucket not found | Server not ready|

import { bucketDefinitionsClient } from "@dynatrace-sdk/client-bucket-management";

const data = await bucketDefinitionsClient.truncateBucket({
  bucketName: "...",
});

updateBucket

Update a bucket

Update a bucket. Update one of the following fields or both:

  • displayName: descriptive name of the bucket
  • retentionDays: retention period in days (important note: the new retention days will also apply to existing records. Shortening the retention period could result in data deletion!)

Define the full bucket definition with updated field(s) in the request body.

Required scope: storage:bucket-definitions:write.

Parameters

| Name | Type | Description | | --- | --- | --- | |config.body*required|UpdateBucket| | |config.bucketName*required|string| | |config.optimisticLockingVersion*required|number|Define on which version the updated data is based on. |

Returns

| Return type | Status code | Description | |---|---|---| |void|200|Successfully updated bucket definition| |void|202|Accepted update bucket definition|

Throws

| Error Type | Error Message | |---|---| |ErrorEnvelopeError|bad request | unauthorized | Forbidden | Bucket with provided name was not found | Attempt to update an old version or an operation is currently in progress that prevents current modifications (creating, deleting, updating)|

import { bucketDefinitionsClient } from "@dynatrace-sdk/client-bucket-management";

const data = await bucketDefinitionsClient.updateBucket({
  bucketName: "...",
  optimisticLockingVersion: 10,
  body: {
    bucketName: "custom_logs",
    table: "logs",
    displayName: "Custom logs bucket (updated)",
    status: "active",
    retentionDays: 10,
    version: 1,
  },
});

updateBucketPartially

Update a bucket partially

Update a bucket. Update one of the following fields or both:

  • displayName: descriptive name of the bucket
  • retentionDays: retention period in days (important note: the new retention days will also apply to existing records. Shortening the retention period could result in data deletion!)

Add the field(s) to be updated to the request body.

Required scope: storage:bucket-definitions:write

Parameters

| Name | Type | Description | | --- | --- | --- | |config.body*required|PartialUpdateBucket| | |config.bucketName*required|string| | |config.optimisticLockingVersion*required|number|Define on which version the updated data is based on. |

Returns

| Return type | Status code | Description | |---|---|---| |void|200|Successfully updated bucket definition| |void|202|Accepted update bucket definition|

Throws

| Error Type | Error Message | |---|---| |ErrorEnvelopeError|bad request | unauthorized | Forbidden | Bucket with provided name was not found | Attempt to update an old version or an operation is currently in progress that prevents current modifications (creating, deleting, updating)|

import { bucketDefinitionsClient } from "@dynatrace-sdk/client-bucket-management";

const data =
  await bucketDefinitionsClient.updateBucketPartially({
    bucketName: "...",
    optimisticLockingVersion: 10,
    body: {
      displayName: "Custom logs bucket (updated)",
      retentionDays: 10,
    },
  });

Types

Bucket

| Name | Type | Description | | --- | --- | --- | |bucketName*required|string|The unique identifier of the bucket within the tenant. | |displayName|string|Descriptive name of the bucket. No restriction regarding unique naming or valid characters. | |estimatedUncompressedBytes|number|Estimated uncompressed size of the bucket in bytes. | |metricInterval|"PT1S" | "PT5S" | "PT10S" | "PT1M" | "PT5M" | "PT15M" | "PT1H"|Interval of aggregated metric data. Only applies to metric buckets. | |records|number|Amount of records in the bucket. | |retentionDays*required|number|The retention period in days of the data in the bucket. | |status*required|"creating" | "active" | "updating" | "deleting"|The current status of the bucket, depending on bucket lifecycle. | |table*required|string|Name of the table the bucket is assigned to. | |updatable*required|boolean|A flag indicating whether a bucket can be updated or not. | |version*required|number|Optimistic locking version. Update requests define with this on which version the data updated is based on. This must match with the version stored, otherwise the update will fail due to concurrent modification. |

Buckets

| Name | Type | | --- | --- | |buckets*required|Array<Bucket>|

CustomValidationErrorInfo

| Name | Type | | --- | --- | |message|string|

ErrorEnvelope

| Name | Type | | --- | --- | |error|ExceptionalReturn|

ErrorInfo

| Name | Type | | --- | --- | |message|string|

ExceptionalReturn

| Name | Type | | --- | --- | |code|number| |errorDetails|Array<CustomValidationErrorInfo | InvalidAuditEventsErrorInfo | MediaTypeErrorInfo | ParameterErrorInfo | ProxyErrorInfo | QueryFrontendRawErrorInfo | RequestBodyErrorInfo>| |message|string|

InvalidAuditEventsErrorInfo

| Name | Type | | --- | --- | |invalidAuditEventIndices|Array<number>| |invalidEventIndices|Array<number>| |message|string|

MediaTypeErrorInfo

| Name | Type | | --- | --- | |message|string| |supportedMediaTypes|Array<string>|

NewBucket

| Name | Type | Description | | --- | --- | --- | |bucketName*required|string|The unique identifier of the bucket within the tenant. | |displayName|string|Descriptive name of the bucket. No restriction regarding unique naming or valid characters. | |metricInterval|"PT1M" | "PT5M" | "PT15M" | "PT1H"|Interval of aggregated metric data. Only applies to metric buckets. | |retentionDays*required|number|The retention period in days of the data in the bucket. | |table*required|string|Name of the table the bucket is assigned to. One of [logs, events, bizevents] |

ParameterErrorInfo

| Name | Type | | --- | --- | |message|string| |parameterDescriptor|string|

PartialUpdateBucket

| Name | Type | Description | | --- | --- | --- | |displayName|string|Descriptive name of the bucket. No restriction regarding unique naming or valid characters. | |retentionDays|number|The retention period in days of the data in the bucket. Important note: the new retention days will also apply to existing records. Shortening the retention period could result in data deletion! |

ProxyErrorInfo

| Name | Type | | --- | --- | |message|string|

QueryFrontendRawErrorInfo

| Name | Type | | --- | --- | |message|string| |rawQueryFrontendResponse|string|

RequestBodyErrorInfo

| Name | Type | | --- | --- | |bodyDescriptor|string| |message|string|

UpdateBucket

| Name | Type | Description | | --- | --- | --- | |bucketName*required|string|The unique identifier of the bucket within the tenant. | |displayName|string|Descriptive name of the bucket. No restriction regarding unique naming or valid characters. | |metricInterval|"PT1M" | "PT5M" | "PT15M" | "PT1H"|Metric interval for metric buckets. Will be ignored for other buckets. | |retentionDays*required|number|The retention period in days of the data in the bucket. Important note: the new retention days will also apply to existing records. Shortening the retention period could result in data deletion! | |status*required|"creating" | "active" | "updating" | "deleting"|The current status of the bucket, depending on bucket lifecycle. | |table*required|"logs" | "events" | "bizevents"|Name of the table the bucket is assigned to. | |version*required|number|Optimistic locking version. Update requests define with this on which version the data updated is based on. This must match with the version stored, otherwise the update will fail due to concurrent modification. |

Enums

BucketMetricInterval

Interval of aggregated metric data. Only applies to metric buckets.

Enum keys

Pt10S | Pt15M | Pt1H | Pt1M | Pt1S | Pt5M | Pt5S

BucketStatus

The current status of the bucket, depending on bucket lifecycle.

Enum keys

Active | Creating | Deleting | Updating

NewBucketMetricInterval

Interval of aggregated metric data. Only applies to metric buckets.

Enum keys

Pt15M | Pt1H | Pt1M | Pt5M

UpdateBucketMetricInterval

Metric interval for metric buckets. Will be ignored for other buckets.

Enum keys

Pt15M | Pt1H | Pt1M | Pt5M

UpdateBucketStatus

The current status of the bucket, depending on bucket lifecycle.

Enum keys

Active | Creating | Deleting | Updating

UpdateBucketTable

Name of the table the bucket is assigned to.

Enum keys

Bizevents | Events | Logs