Atlas 项目 apiKeys 分配
将指定的组织 API 密钥分配给您的项目,并修改该 API 密钥在项目中的角色。
当您使用此命令修改组织 API 密钥的角色时,您指定的值会覆盖分配给该 API 密钥的现有角色。
要查看 ID 参数的可能值,请运行 atlas organizations apiKeys list。
语法
atlas projects apiKeys assign <ID> [options]
参数
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
id | 字符串 | true | 标识 API 密钥的唯一的 24 位字符串。 |
选项
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
-h,--help | false | 分配帮助 | |
-o, --output | 字符串 | false | 输出格式。 有效值为 json、json-path、go-template 或 go-template-file。 要查看完整输出,请使用 -o json 选项。 |
--projectId | 字符串 | false | 标识要使用的项目的十六进制字符串。 此选项会覆盖配置文件或环境变量中的设置。 |
--role | 字符串 | true | 要分配给 API 密钥的一个或多个角色。 要分配多个角色,请为每个角色指定单独的角色标志,或使用一个角色标志将所有角色指定为以逗号分隔的列表。 要了解 CLI 接受哪些值,请参阅 Atlas API 规范中角色的枚举项: https://www.mongodb.com/zh-cn/docs/atlas/reference/api-resources-spec/v 2 / #tag/Programmatic-API-Keys/operation/createProjectApiKey/。 |
继承选项
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
-P, --profile | 字符串 | false | 要从配置文件中使用的配置文件的名称。 要了解 Atlas CLI 的配置文件,请参阅 https://dochub.mongodb.org/core/atlas-cli-save-connection-settings。 |
输出
如果命令成功,CLI 将返回类似于以下示例的输出。 括号中的值代表您的价值观。
API Key successfully assigned.
示例
# Assign an organization API key with the ID 5f46ae53d58b421fe3edc115 and grant the GROUP_DATA_ACCESS_READ_WRITE role for the project with ID 5e2211c17a3e5a48f5497de3: atlas projects apiKeys assign 5f46ae53d58b421fe3edc115 --projectId 5e1234c17a3e5a48f5497de3 --role GROUP_DATA_ACCESS_READ_WRITE --output json