@dynatrace-sdk/client-platform-management-service

中文文档
1.9.0发布于 2026/09/30Apache-2.0TypeScriptESM + CJS近 30 天下载 1.5万

npm [License[(]页:1

中文使用文档
文档目录30 节
  1. 安装
  2. 获得帮助
  3. 许可证
  4. 有效许可
  5. 解析有效任务
  6. 环境
  7. 获取环境信息
  8. 环境设置
  9. 获得环境安排
  10. 许可证信息客户
  11. 获取语录
  12. 获得License安排
  13. 类型
  14. 有效许可
  15. 有效许可
  16. 环境信息
  17. 错误
  18. 错误细节
  19. 信封错误
  20. 许可证
  21. 许可证设置
  22. 许可证安排回复
  23. 权限链接
  24. 决议要求
  25. 设置响应
  26. 单一许可请求
  27. 数字
  28. 有效许可
  29. 环境信息类型
  30. 环境状态

@ dynatrace-sdk/客户端-平台-管理-服务

npm License

概览

关于当前登录环境的基本只读信息

安装

npm install @dynatrace-sdk/client-platform-management-service

获得帮助

许可证

此 SDK 分布于 Apache 许可证,2.0版本,更多信息见LICENSE.

API 参考

最新版本SDK的API 完整参考文件也可在 Dynatrace 开发者。 。 。 .

有效许可

import { effectivePermissionsClient } from '@dynatrace-sdk/client-platform-management-service';

解析有效任务

无效的 Permissions.client.resolveive permissions(配置):承诺 <有效许可> 翻译:

在环境中获取呼叫用户的有效权限

需要以下范围之一:

  • app-engine:apps:运行
  • 应用程序引擎: 函数: 运行
  • 平台管理: 有效许可:解决

此端点决定了调用者( 调用此端点时根据提供的 OAuth 令牌) 是否拥有请求的权限( 见 IAM 政策参考 许可清单及其条件。 它通过IAM解决许可,并使用可选上下文来评价有条件的结果. 提供的上下文包括: key 必须符合所请求许可的辅助条件的名称和 value 是指根据给定的用户政策评估该条件的价值.

对于每项请求的许可,答复表明用户是否拥有请求的许可(第1段)"granted": "true"),没有"granted": "false")或仅有条件("granted": "condition")),指为上下文条件提供的值不足以决定呼叫者是否拥有许可.

对于环境API v2 范围(即从环境-api开始的范围:),也将考虑环境和管理区一级的作用.

> i️ 设置权限 范围请求 settings:schemas:read, (中文(简体) ), settings:objects:read,以及 settings:objects:write 最终结果 "granted": "condition"。您可以使用专用的有效权限端点来进行设置.

> iQQ Apps 必须列出他们在列表中检查的所有权限 scopes 在他们的应用配置.

您可以更多地了解查询用户权限 Dynatrace 开发者。 。 。 .

参数

名称类型
配置. 身体*必须决议要求

掷出

错误类型错误消息
默认错误回复意外错误
代码示例
import { effectivePermissionsClient } from "@dynatrace-sdk/client-platform-management-service";

const data =
  await effectivePermissionsClient.resolveEffectivePermissions(
    {
      body: {
        permissions: [
          { permission: "state:app-states:write" },
        ],
      },
    },
  );

环境

import { environmentInformationClient } from '@dynatrace-sdk/client-platform-management-service';

获取环境信息

环境信息Client.get 环境信息(配置):承诺 <环境信息> 翻译:

获取基本环境信息

需要以下范围之一:

  • app-engine:apps:运行
  • 应用程序引擎: 函数: 运行
  • 平台管理:环境:已读

获取当前环境的基本信息.

回返

返回类型状态代码说明
环境信息200个请求的环境信息 .

掷出

错误类型错误消息
错误请求错误的请求
未经授权认证失败
无果未找到资源
服务不可用后端有一个临时问题 .
默认错误回复意外错误
代码示例
import { environmentInformationClient } from "@dynatrace-sdk/client-platform-management-service";

const data =
  await environmentInformationClient.getEnvironmentInformation();

环境设置

import { environmentSettingsClient } from '@dynatrace-sdk/client-platform-management-service';

获得环境安排

环境设置 Client.get 环境设置( 配置): 承诺 <设置响应> 翻译:

获取环境设置

需要以下范围之一:

  • app-engine:apps:运行
  • 应用程序引擎: 函数: 运行
  • 平台管理:环境:已读

获取环境设置 .

回返

返回类型状态代码说明
设置响应200个请求环境的设置

掷出

错误类型错误消息
错误请求错误的请求
未经授权认证失败
无果未找到资源
服务不可用后端有一个临时问题 .
默认错误回复意外错误
代码示例
import { environmentSettingsClient } from "@dynatrace-sdk/client-platform-management-service";

const data =
  await environmentSettingsClient.getEnvironmentSettings();

许可证信息客户

import { licenseInformationClient } from '@dynatrace-sdk/client-platform-management-service';

获取语录

许可信息Client.getLicense(配置):承诺 <许可证> 翻译:

获取基本许可证信息

需要以下范围之一:

  • app-engine:apps:运行
  • 应用程序引擎: 函数: 运行
  • 平台管理:环境:已读

获取当前环境的基本许可信息.

回返

返回类型状态代码说明
许可证200个申请环境的许可证信息 .

掷出

错误类型错误消息
错误请求错误的请求
未经授权认证失败
无果未找到资源
服务不可用后端有一个临时问题 .
默认错误回复意外错误
代码示例
import { licenseInformationClient } from "@dynatrace-sdk/client-platform-management-service";

const data = await licenseInformationClient.getLicense();

获得License安排

许可信息Client.getLicenseSettings(配置):承诺<许可证安排回复> 翻译:

获取基本许可证设置信息

需要以下范围之一:

  • app-engine:apps:运行
  • 应用程序引擎: 函数: 运行
  • 平台管理:环境:已读

获取当前环境的基本许可设置信息

参数

名称类型说明
配置. keys矩阵 <字符串> 翻译:用于过滤的可选密钥数组

示例 []

回返

返回类型状态代码说明
许可证安排回复200个请求环境的许可证设置信息 .

掷出

错误类型错误消息
错误请求错误的请求
未经授权认证失败
无果未找到资源
服务不可用后端有一个临时问题 .
默认错误回复意外错误
代码示例
import { licenseInformationClient } from "@dynatrace-sdk/client-platform-management-service";

const data =
  await licenseInformationClient.getLicenseSettings();

类型

有效许可

名称类型说明
上下文矩阵 <权限链接> 翻译:
获准*必须"真""假""条件"真:来电者有许可假:来电者没有许可条件: 呼叫者有条件地获得许可,或者在范围从"Environment-api:"开始的情况下,呼叫者只获得特定管理区的许可.

示例 true
权限*必须字符串示例 state:app-states:write

有效许可

类型: 阵列 <有效许可> 翻译:

环境信息

名称类型
块时间日期
创建时间*必须日期
环境编号*必须字符串
状态*必须"BEING CREATED""CREATED NOT-INITIALID""相去相去""相去相去""相去相去""相去相去""相去相去""相去相去相去""相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相
类型*必须"INTERNAL""CUSTOMER""SELF MINTORING" 互联网电影数据库(IMDB)上"CUSTOMER"的资料(英文)

错误

标准错误反应

名称类型说明
代码*必须编号示例 500
细节错误细节
消息*必须字符串示例 Internal server error

错误细节

名称类型
失踪矩阵 <字符串> 翻译:
缺少缩写矩阵 <字符串> 翻译:

信封错误

名称类型说明
错误*必须错误标准错误反应

许可证

名称类型
平台订阅*必须布尔
审判*必须布尔

许可证设置

名称类型
键*必须字符串
价值*必须字符串

许可证安排回复

名称类型
设置*必须矩阵 <许可证设置> 翻译:

权限链接

名称类型说明
键*必须字符串示例 shared:app-id
价值*必须字符串示例 dynatrace.notebooks

决议要求

名称类型
权限*必须矩阵 <单一许可请求> 翻译:

设置响应

名称类型说明
正在运行的文本订阅结束日期试验期结束的日期.

示例 2025-04-25T10:08:09.193592Z
聊天已启用*必须布尔
国家代码字符串ISO3166-1α-2 二个字母国家代码. 见: https://en.wikipedia.org/wiki/ISO 3166-1 alpha-2 互联网档案馆的存檔,存档日期2014-12-2

示例 ES

单一许可请求

可选的通用上下文数据集

名称类型说明
上下文无效QQ阵列 <权限链接> 翻译:
权限*必须字符串示例 state:app-states:write

数字

有效许可

⚠️ 折旧 使用字面值.

真:来电者有许可假:来电者没有许可条件: 呼叫者有条件地获得许可,或者在范围从"Environment-api:"开始的情况下,呼叫者只获得特定管理区的许可.

Enum 键

Condition | False | True

环境信息类型

⚠️ 折旧 使用字面值.

Enum 键

Customer | Internal | SelfMonitoring

环境状态

⚠️ 折旧 使用字面值.

Enum 键

Active | BeingCreated | BeingDeleted | Blocked | CreatedNotInitialized | Deactivated | DeletionFailed | PreAllocated

版本与发布记录

@dynatrace-sdk/client-platform-management-service 共发布 17 个版本,首次发布于 2024/07/01;过去 12 个月发布了 3 个版本。

版本发布日期距今
1.9.0latest2026/09/301 个月前
1.8.12026/08/033 个月前
1.8.02026/06/184 个月前
1.7.02025/07/151.3 年前
1.6.82025/07/011.4 年前
1.6.72025/06/171.4 年前

关于 @dynatrace-sdk/client-platform-management-service 的常见问题

@dynatrace-sdk/client-platform-management-service 是什么?

[[(]页:1

如何安装 @dynatrace-sdk/client-platform-management-service?

在项目目录运行 npm install @dynatrace-sdk/client-platform-management-service,或使用 pnpm add / yarn add / bun add。

@dynatrace-sdk/client-platform-management-service 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dynatrace-sdk/client-platform-management-service 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@dynatrace-sdk/client-platform-management-service 可以商用吗?

@dynatrace-sdk/client-platform-management-service 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dynatrace-sdk/client-platform-management-service 的下载量有多少?

根据 npm 官方下载统计,@dynatrace-sdk/client-platform-management-service 在 2026/10/13 – 2026/11/11 这 30 天内被下载 15,134 次,日均约 504 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dynatrace-sdk/client-platform-management-service 还在维护吗?

最新版本 1.9.0 发布于 2026/09/30(1 个月前);至今共发布 17 个版本,其中过去 12 个月发布了 3 个;首次发布于 2024/07/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。