# @dynatrace-sdk/client-platform-management-service 中文文档

规范地址：https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/

版本：1\.9\.0
npm 元数据更新时间：2026-09-30T09:50:18.567Z
中文译文更新时间：2026-11-13T02:39:14.792Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dynatrace-sdk/client-platform-management-service
原文对照：https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：142 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2024-07-01T11:53:44.623Z
- 最新版本发布：2026-09-30T09:50:18.345Z
- 近 30 天下载量：15134（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 3 个）

## 中文简介

[![npm](https://img.shields.io/badge/npm-v1.9.0-blue)](https://www.npmjs.com/package/@dynatrace-sdk/client-platform-management-service/v/1.9.0) \[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)\[(\][页:1](https://opensource.org/licenses/Apache-2)

## 安装

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

也可以使用：`pnpm add @dynatrace-sdk/client-platform-management-service`、`yarn add @dynatrace-sdk/client-platform-management-service`、`bun add @dynatrace-sdk/client-platform-management-service`

## README

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

[![npm](https://img.shields.io/badge/npm-v1.9.0-blue)](https://www.npmjs.com/package/@dynatrace-sdk/client-platform-management-service/v/1.9.0) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

# 概览

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

## 安装

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

## 获得帮助

-   访问 [用于打字的 SDK](https://developer.dynatrace.com/reference/sdks/) 指南中 [Dynatrace 开发者](https://developer.dynatrace.com/)
-   问个问题 [Dynatrace社区](https://community.dynatrace.com/)

## 许可证

此 SDK 分布于 [Apache 许可证,2.0版本](http://www.apache.org/licenses/LICENSE-2.0),更多信息见LICENSE.

# API 参考

最新版本SDK的API 完整参考文件也可在 [Dynatrace 开发者](https://developer.dynatrace.com/reference/sdks/client-platform-management-service/)。 。 。 .

## 有效许可

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

### 解析有效任务

**无效的 Permissions.client.resolveive permissions(配置):承诺 <[有效许可](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-effectivepermissions)\> 翻译:**

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

**需要以下范围之一:**

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

此端点决定了调用者( 调用此端点时根据提供的 OAuth 令牌) 是否拥有请求的权限( 见 [IAM 政策参考](https://dt-url.net/ut02qdv) 许可清单及其条件。 它通过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 开发者](https://dt-url.net/query-user-permissions)。 。 。 .

#### 参数

| 名称 | 类型 |
| --- | --- |
| 配置. 身体\*必须 | [决议要求](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-resolutionrequest) |

#### 掷出

| 错误类型 | 错误消息 |
| --- | --- |
| 默认错误回复 | 意外错误 |

代码示例

```ts
import { effectivePermissionsClient } from "@dynatrace-sdk/client-platform-management-service";

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

## 环境

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

### 获取环境信息

**环境信息Client.get 环境信息(配置):承诺 <[环境信息](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-environmentinfo)\> 翻译:**

获取基本环境信息

**需要以下范围之一:**

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

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

#### 回返

| 返回类型 | 状态代码 | 说明 |
| --- | --- | --- |
| [环境信息](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-environmentinfo) | 200个 | 请求的环境信息 . |

#### 掷出

| 错误类型 | 错误消息 |
| --- | --- |
| 错误请求 | 错误的请求 |
| 未经授权 | 认证失败 |
| 无果 | 未找到资源 |
| 服务不可用 | 后端有一个临时问题 . |
| 默认错误回复 | 意外错误 |

代码示例

```ts
import { environmentInformationClient } from "@dynatrace-sdk/client-platform-management-service";

const data =
  await environmentInformationClient.getEnvironmentInformation();
```

## 环境设置

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

### 获得环境安排

**环境设置 Client.get 环境设置( 配置): 承诺 <[设置响应](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-settingsresponse)\> 翻译:**

获取环境设置

**需要以下范围之一:**

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

获取环境设置 .

#### 回返

| 返回类型 | 状态代码 | 说明 |
| --- | --- | --- |
| [设置响应](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-settingsresponse) | 200个 | 请求环境的设置 |

#### 掷出

| 错误类型 | 错误消息 |
| --- | --- |
| 错误请求 | 错误的请求 |
| 未经授权 | 认证失败 |
| 无果 | 未找到资源 |
| 服务不可用 | 后端有一个临时问题 . |
| 默认错误回复 | 意外错误 |

代码示例

```ts
import { environmentSettingsClient } from "@dynatrace-sdk/client-platform-management-service";

const data =
  await environmentSettingsClient.getEnvironmentSettings();
```

## 许可证信息客户

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

### 获取语录

**许可信息Client.getLicense(配置):承诺 <[许可证](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-license)\> 翻译:**

获取基本许可证信息

**需要以下范围之一:**

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

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

#### 回返

| 返回类型 | 状态代码 | 说明 |
| --- | --- | --- |
| [许可证](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-license) | 200个 | 申请环境的许可证信息 . |

#### 掷出

| 错误类型 | 错误消息 |
| --- | --- |
| 错误请求 | 错误的请求 |
| 未经授权 | 认证失败 |
| 无果 | 未找到资源 |
| 服务不可用 | 后端有一个临时问题 . |
| 默认错误回复 | 意外错误 |

代码示例

```ts
import { licenseInformationClient } from "@dynatrace-sdk/client-platform-management-service";

const data = await licenseInformationClient.getLicense();
```

### 获得License安排

**许可信息Client.getLicenseSettings(配置):承诺<[许可证安排回复](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-licensesettingsresponse)\> 翻译:**

获取基本许可证设置信息

**需要以下范围之一:**

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

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

#### 参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 配置. keys | 矩阵 <[字符串](https://developer.mozilla.org/en-US/docs/Glossary/String)\> 翻译: | 用于过滤的可选密钥数组  
  
**示例** `[]` |

#### 回返

| 返回类型 | 状态代码 | 说明 |
| --- | --- | --- |
| [许可证安排回复](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-licensesettingsresponse) | 200个 | 请求环境的许可证设置信息 . |

#### 掷出

| 错误类型 | 错误消息 |
| --- | --- |
| 错误请求 | 错误的请求 |
| 未经授权 | 认证失败 |
| 无果 | 未找到资源 |
| 服务不可用 | 后端有一个临时问题 . |
| 默认错误回复 | 意外错误 |

代码示例

```ts
import { licenseInformationClient } from "@dynatrace-sdk/client-platform-management-service";

const data =
  await licenseInformationClient.getLicenseSettings();
```

## 类型

### 有效许可

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 上下文 | 矩阵 <[权限链接](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-permissioncontext)\> 翻译: |  |
| 获准\*必须 | "真""假""条件" | 真:来电者有许可假:来电者没有许可条件: 呼叫者有条件地获得许可,或者在范围从"Environment-api:"开始的情况下,呼叫者只获得特定管理区的许可.  
  
**示例** `true` |
| 权限\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | **示例** `state:app-states:write` |

### 有效许可

**类型**: 阵列 <[有效许可](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-effectivepermission)\> 翻译:

### 环境信息

| 名称 | 类型 |
| --- | --- |
| 块时间 | 日期 |
| 创建时间\*必须 | 日期 |
| 环境编号\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) |
| 状态\*必须 | "BEING CREATED""CREATED NOT-INITIALID""相去相去""相去相去""相去相去""相去相去""相去相去""相去相去相去""相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相 |
| 类型\*必须 | "INTERNAL""CUSTOMER""SELF MINTORING" 互联网电影数据库(IMDB)上"CUSTOMER"的资料(英文) |

### 错误

标准错误反应

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 代码\*必须 | [编号](https://developer.mozilla.org/en-US/docs/Glossary/Number) | **示例** `500` |
| 细节 | [错误细节](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-errordetails) |  |
| 消息\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | **示例** `Internal server error` |

### 错误细节

| 名称 | 类型 |
| --- | --- |
| 失踪 | 矩阵 <[字符串](https://developer.mozilla.org/en-US/docs/Glossary/String)\> 翻译: |
| 缺少缩写 | 矩阵 <[字符串](https://developer.mozilla.org/en-US/docs/Glossary/String)\> 翻译: |

### 信封错误

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 错误\*必须 | [错误](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-error) | 标准错误反应 |

### 许可证

| 名称 | 类型 |
| --- | --- |
| 平台订阅\*必须 | [布尔](https://developer.mozilla.org/en-US/docs/Glossary/Boolean) |
| 审判\*必须 | [布尔](https://developer.mozilla.org/en-US/docs/Glossary/Boolean) |

### 许可证设置

| 名称 | 类型 |
| --- | --- |
| 键\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) |
| 价值\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) |

### 许可证安排回复

| 名称 | 类型 |
| --- | --- |
| 设置\*必须 | 矩阵 <[许可证设置](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-licensesetting)\> 翻译: |

### 权限链接

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 键\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | **示例** `shared:app-id` |
| 价值\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | **示例** `dynatrace.notebooks` |

### 决议要求

| 名称 | 类型 |
| --- | --- |
| 权限\*必须 | 矩阵 <[单一许可请求](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-singlepermissionrequest)\> 翻译: |

### 设置响应

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 正在运行的文本订阅结束 | 日期 | 试验期结束的日期.  
  
**示例** `2025-04-25T10:08:09.193592Z` |
| 聊天已启用\*必须 | [布尔](https://developer.mozilla.org/en-US/docs/Glossary/Boolean) |  |
| 国家代码 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | ISO3166-1α-2 二个字母国家代码. 见: [https://en.wikipedia.org/wiki/ISO 3166-1 alpha-2 互联网档案馆的存檔,存档日期2014-12-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)  
  
**示例** `ES` |

### 单一许可请求

可选的通用上下文数据集

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 上下文 | 无效QQ阵列 <[权限链接](https://npmcn.com/package/%40dynatrace-sdk/client-platform-management-service/#readme-permissioncontext)\> 翻译: |  |
| 权限\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | **示例** `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 是什么？

\[\[\(\]页: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 和提交记录判断。