UNPKG

@datadog/datadog-api-client

Version:
249 lines 14.3 kB
"use strict"; var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) { function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); } return new (P || (P = Promise))(function (resolve, reject) { function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } } function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } } function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); } step((generator = generator.apply(thisArg, _arguments || [])).next()); }); }; var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); } var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) { if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined."); var g = generator.apply(thisArg, _arguments || []), i, q = []; return i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i; function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; } function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } } function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); } function fulfill(value) { resume("next", value); } function reject(value) { resume("throw", value); } function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); } }; Object.defineProperty(exports, "__esModule", { value: true }); exports.DashboardsApi = exports.DashboardsApiResponseProcessor = exports.DashboardsApiRequestFactory = void 0; const baseapi_1 = require("../../datadog-api-client-common/baseapi"); const configuration_1 = require("../../datadog-api-client-common/configuration"); const http_1 = require("../../datadog-api-client-common/http/http"); const logger_1 = require("../../../logger"); const ObjectSerializer_1 = require("../models/ObjectSerializer"); const exception_1 = require("../../datadog-api-client-common/exception"); class DashboardsApiRequestFactory extends baseapi_1.BaseAPIRequestFactory { getDashboardUsage(dashboardId, _options) { return __awaiter(this, void 0, void 0, function* () { const _config = _options || this.configuration; logger_1.logger.warn("Using unstable operation 'getDashboardUsage'"); if (!_config.unstableOperations["v2.getDashboardUsage"]) { throw new Error("Unstable operation 'getDashboardUsage' is disabled"); } // verify required parameter 'dashboardId' is not null or undefined if (dashboardId === null || dashboardId === undefined) { throw new baseapi_1.RequiredError("dashboardId", "getDashboardUsage"); } // Path Params const localVarPath = "/api/v2/dashboards/{dashboard_id}/usage".replace("{dashboard_id}", encodeURIComponent(String(dashboardId))); // Make Request Context const requestContext = _config .getServer("v2.DashboardsApi.getDashboardUsage") .makeRequestContext(localVarPath, http_1.HttpMethod.GET); requestContext.setHeaderParam("Accept", "application/json"); requestContext.setHttpConfig(_config.httpConfig); // Apply auth methods (0, configuration_1.applySecurityAuthentication)(_config, requestContext, [ "apiKeyAuth", "appKeyAuth", "AuthZ", ]); return requestContext; }); } listDashboardsUsage(pageLimit, pageOffset, filterEditedBefore, filterViewedBefore, _options) { return __awaiter(this, void 0, void 0, function* () { const _config = _options || this.configuration; logger_1.logger.warn("Using unstable operation 'listDashboardsUsage'"); if (!_config.unstableOperations["v2.listDashboardsUsage"]) { throw new Error("Unstable operation 'listDashboardsUsage' is disabled"); } // Path Params const localVarPath = "/api/v2/dashboards/usage"; // Make Request Context const requestContext = _config .getServer("v2.DashboardsApi.listDashboardsUsage") .makeRequestContext(localVarPath, http_1.HttpMethod.GET); requestContext.setHeaderParam("Accept", "application/json"); requestContext.setHttpConfig(_config.httpConfig); // Query Params if (pageLimit !== undefined) { requestContext.setQueryParam("page[limit]", ObjectSerializer_1.ObjectSerializer.serialize(pageLimit, "number", "int64"), ""); } if (pageOffset !== undefined) { requestContext.setQueryParam("page[offset]", ObjectSerializer_1.ObjectSerializer.serialize(pageOffset, "number", "int64"), ""); } if (filterEditedBefore !== undefined) { requestContext.setQueryParam("filter[edited_before]", ObjectSerializer_1.ObjectSerializer.serialize(filterEditedBefore, "string", ""), ""); } if (filterViewedBefore !== undefined) { requestContext.setQueryParam("filter[viewed_before]", ObjectSerializer_1.ObjectSerializer.serialize(filterViewedBefore, "string", ""), ""); } // Apply auth methods (0, configuration_1.applySecurityAuthentication)(_config, requestContext, [ "apiKeyAuth", "appKeyAuth", "AuthZ", ]); return requestContext; }); } } exports.DashboardsApiRequestFactory = DashboardsApiRequestFactory; class DashboardsApiResponseProcessor { /** * Unwraps the actual response sent by the server from the response context and deserializes the response content * to the expected objects * * @params response Response returned by the server for a request to getDashboardUsage * @throws ApiException if the response code was not in [200, 299] */ getDashboardUsage(response) { return __awaiter(this, void 0, void 0, function* () { const contentType = ObjectSerializer_1.ObjectSerializer.normalizeMediaType(response.headers["content-type"]); if (response.httpStatusCode === 200) { const body = ObjectSerializer_1.ObjectSerializer.deserialize(ObjectSerializer_1.ObjectSerializer.parse(yield response.body.text(), contentType), "DashboardUsageResponse"); return body; } if (response.httpStatusCode === 400 || response.httpStatusCode === 403 || response.httpStatusCode === 404 || response.httpStatusCode === 429) { const bodyText = ObjectSerializer_1.ObjectSerializer.parse(yield response.body.text(), contentType); let body; try { body = ObjectSerializer_1.ObjectSerializer.deserialize(bodyText, "APIErrorResponse"); } catch (error) { logger_1.logger.debug(`Got error deserializing error: ${error}`); throw new exception_1.ApiException(response.httpStatusCode, bodyText); } throw new exception_1.ApiException(response.httpStatusCode, body); } // Work around for missing responses in specification, e.g. for petstore.yaml if (response.httpStatusCode >= 200 && response.httpStatusCode <= 299) { const body = ObjectSerializer_1.ObjectSerializer.deserialize(ObjectSerializer_1.ObjectSerializer.parse(yield response.body.text(), contentType), "DashboardUsageResponse", ""); return body; } const body = (yield response.body.text()) || ""; throw new exception_1.ApiException(response.httpStatusCode, 'Unknown API Status Code!\nBody: "' + body + '"'); }); } /** * Unwraps the actual response sent by the server from the response context and deserializes the response content * to the expected objects * * @params response Response returned by the server for a request to listDashboardsUsage * @throws ApiException if the response code was not in [200, 299] */ listDashboardsUsage(response) { return __awaiter(this, void 0, void 0, function* () { const contentType = ObjectSerializer_1.ObjectSerializer.normalizeMediaType(response.headers["content-type"]); if (response.httpStatusCode === 200) { const body = ObjectSerializer_1.ObjectSerializer.deserialize(ObjectSerializer_1.ObjectSerializer.parse(yield response.body.text(), contentType), "ListDashboardsUsageResponse"); return body; } if (response.httpStatusCode === 400 || response.httpStatusCode === 403 || response.httpStatusCode === 429) { const bodyText = ObjectSerializer_1.ObjectSerializer.parse(yield response.body.text(), contentType); let body; try { body = ObjectSerializer_1.ObjectSerializer.deserialize(bodyText, "APIErrorResponse"); } catch (error) { logger_1.logger.debug(`Got error deserializing error: ${error}`); throw new exception_1.ApiException(response.httpStatusCode, bodyText); } throw new exception_1.ApiException(response.httpStatusCode, body); } // Work around for missing responses in specification, e.g. for petstore.yaml if (response.httpStatusCode >= 200 && response.httpStatusCode <= 299) { const body = ObjectSerializer_1.ObjectSerializer.deserialize(ObjectSerializer_1.ObjectSerializer.parse(yield response.body.text(), contentType), "ListDashboardsUsageResponse", ""); return body; } const body = (yield response.body.text()) || ""; throw new exception_1.ApiException(response.httpStatusCode, 'Unknown API Status Code!\nBody: "' + body + '"'); }); } } exports.DashboardsApiResponseProcessor = DashboardsApiResponseProcessor; class DashboardsApi { constructor(configuration, requestFactory, responseProcessor) { this.configuration = configuration; this.requestFactory = requestFactory || new DashboardsApiRequestFactory(configuration); this.responseProcessor = responseProcessor || new DashboardsApiResponseProcessor(); } /** * Get usage statistics for a single dashboard. The response includes view counts, the most recent view and edit times, widget counts, and the dashboard quality score. View-count fields depend on Real User Monitoring (RUM) and are `null` or `0` in orgs without RUM. * @param param The request object */ getDashboardUsage(param, options) { const requestContextPromise = this.requestFactory.getDashboardUsage(param.dashboardId, options); return requestContextPromise.then((requestContext) => { return this.configuration.httpApi .send(requestContext) .then((responseContext) => { return this.responseProcessor.getDashboardUsage(responseContext); }); }); } /** * Get paginated usage statistics for every dashboard in the caller's organization. Use `page[limit]` and `page[offset]` to walk the result set. Use `filter[edited_before]` or `filter[viewed_before]` to narrow results by recency. View-count fields depend on Real User Monitoring (RUM) and are `null` or `0` in orgs without RUM. * @param param The request object */ listDashboardsUsage(param = {}, options) { const requestContextPromise = this.requestFactory.listDashboardsUsage(param.pageLimit, param.pageOffset, param.filterEditedBefore, param.filterViewedBefore, options); return requestContextPromise.then((requestContext) => { return this.configuration.httpApi .send(requestContext) .then((responseContext) => { return this.responseProcessor.listDashboardsUsage(responseContext); }); }); } /** * Provide a paginated version of listDashboardsUsage returning a generator with all the items. */ listDashboardsUsageWithPagination(param = {}, options) { return __asyncGenerator(this, arguments, function* listDashboardsUsageWithPagination_1() { let pageSize = 250; if (param.pageLimit !== undefined) { pageSize = param.pageLimit; } param.pageLimit = pageSize; while (true) { const requestContext = yield __await(this.requestFactory.listDashboardsUsage(param.pageLimit, param.pageOffset, param.filterEditedBefore, param.filterViewedBefore, options)); const responseContext = yield __await(this.configuration.httpApi.send(requestContext)); const response = yield __await(this.responseProcessor.listDashboardsUsage(responseContext)); const responseData = response.data; if (responseData === undefined) { break; } const results = responseData; for (const item of results) { yield yield __await(item); } if (results.length < pageSize) { break; } if (param.pageOffset === undefined) { param.pageOffset = pageSize; } else { param.pageOffset = param.pageOffset + pageSize; } } }); } } exports.DashboardsApi = DashboardsApi; //# sourceMappingURL=DashboardsApi.js.map