atlas accessLists create
为项目创建 IP 访问列表条目。
访问列表可以包含受信任的 IP 地址、Amazon Web Services 群组 ID(group ID) 和无类别域间路由 (CIDR) 表示法的条目。您一次只能添加一个访问列表条目。 您可以为每个项目创建一个访问列表。
该命令不会覆盖访问列表中的现有条目。 相反,它将新条目添加到条目列表中。
要使用此命令,您必须使用具有读写角色的用户帐户或 API 密钥进行身份验证。
语法
atlas accessLists create [entry] [options]
参数
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
条目 | 字符串 | false | 要添加到访问列表的 IP 地址、CIDR 地址或 Amazon Web Services 群组 ID(group ID)。 |
选项
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
--comment | 字符串 | false | 条目的可选描述或注释。 |
--currentIp | false | 将当前正在执行命令的主机的 IP 地址添加到访问列表的标志。 仅适用于 ipAddress 类型的条目。 使用 currentIp 选项时,不需要条目参数。 | |
--deleteAfter | 字符串 | false | ISO-8601 格式的 UTC 日期,在该日期之后,Atlas 会从访问列表中删除该条目。 |
-h,--help | false | 创建帮助 | |
-o, --output | 字符串 | false | 输出格式。 有效值为 json、json-path、go-template 或 go-template-file。 要查看完整输出,请使用 -o json 选项。 |
--projectId | 字符串 | false | 标识要使用的项目的十六进制字符串。 此选项会覆盖配置文件或环境变量中的设置。 |
--type | 字符串 | false | 访问列表条目的类型。 有效值为 cidrBlock、ipAddress 或 awsSecurityGroup。 此值默认为“ipAddress”。 |
继承选项
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
-P, --profile | 字符串 | false | 要从配置文件中使用的配置文件的名称。 要了解 Atlas CLI 的配置文件,请参阅 https://dochub.mongodb.org/core/atlas-cli-save-connection-settings。 |
输出
如果命令成功,CLI 将返回类似于以下示例的输出。 括号中的值代表您的价值观。
Created a new IP access list.
示例
# Create an IP access list entry using the current IP address: atlas accessList create --currentIp
# Create an access list entry for the IP address 192.0.2.15 in the project with ID 5e2211c17a3e5a48f5497de3: atlas accessList create 192.0.2.15 --type ipAddress --projectId 5e2211c17a3e5a48f5497de3 --comment "IP address for app server 2" --output json
# Create an access list entry in CIDR notation for 73.231.201.205/24 in the project with ID 5e2211c17a3e5a48f5497de3: atlas accessList create 73.231.201.205/24 --type cidrBlock --projectId 5e2211c17a3e5a48f5497de3 --output json --comment "CIDR block for servers C - F"
# Create an access list entry for the AWS security group sg-903004f8 in the project with ID 5e2211c17a3e5a48f5497de3: atlas accessList create sg-903004f8 --type awsSecurityGroup --projectId 5e2211c17a3e5a48f5497de3 --output json --comment "AWS Security Group"