atlas accessLists create

为项目创建 IP 访问列表条目。

访问列表可以包含受信任的 IP 地址、Amazon Web Services 群组 ID（group ID）和无类别域间路由 (CIDR) 表示法的条目。您一次只能添加一个访问列表条目。您可以为每个项目创建一个访问列表。

该命令不会覆盖访问列表中的现有条目。相反，它将新条目添加到条目列表中。

要使用此命令，您必须使用具有 Read Write 角色的用户帐户、服务帐户或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"