本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateLocationNfs
定义网络文件系统 (NFS) 服务器上可读取或可写入的文件系统。
请求语法
{
"MountOptions": {
"Version": "string"
},
"OnPremConfig": {
"AgentArns": [ "string" ]
},
"ServerHostname": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}请求参数
有关所有操作通用的参数的信息，请参阅 Common Parameters (常用参数)。
请求接受采用 JSON 格式的以下数据。
- MountOptions
-
可用于挂载 NFS 共享的 DataSync NFS 挂载选项。
类型：NfsMountOptions 对象
必需：否
- OnPremConfig
-
包含用于连接到 NFS 服务器的代理的 Amazon 资源名称（ARN） 列表。
如果您要将数据复制到设备或从Amazon Snowcone设备复制数据，请参阅上的 NFS 服务器，了解Amazon Snowcone更多信息。
类型：OnPremConfig 对象
必需：是
- ServerHostname
-
NFS 服务器的名称。该值是 NFS 服务器的 IP 地址或域名服务 (DNS) 名称。在本地安装的代理使用此主机名在网络中挂载 NFS 服务器。
如果您要将数据复制到设备或从Amazon Snowcone设备复制数据，请参阅上的 NFS 服务器，了解Amazon Snowcone更多信息。
注意
此名称必须符合 DNS 标准，或者必须是 IP 版本 4 (IPv4) 地址。
类型：字符串
长度限制：最大长度为 255。
模式：
^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$必需：是
- Subdirectory
-
NFS 文件系统中的子目录，用于从 NFS 源位置读取数据或将数据写入 NFS 目标。NFS 路径应该是由 NFS 服务器导出的路径，或者是该路径的一个子目录。该路径应使其能由网络中的其他 NFS 客户端挂载。
要查看 NFS 服务器导出的所有路径，请从可访问服务器的 NFS 客户端运行“
showmount -e nfs-server-name”。您可以指定显示在结果中的任何目录以及该目录的任何子目录。确保无需 Kerberos 身份验证即可访问 NFS 导出。要传输指定文件夹中的所有数据， DataSync 需要有权读取所有数据。为确保这一点，请为 NFS 导出配置，
no_root_squash,或者确保需要的所有文件的权限 DataSync 允许所有用户进行读取访问。通过执行上述任一操作，将允许代理读取这些文件。要使代理能够访问目录，您还必须启用全部执行访问权限。如果您要将数据复制到设备或从Amazon Snowcone设备复制数据，请参阅上的 NFS 服务器，了解Amazon Snowcone更多信息。
有关 NFS 导出配置的信息，请参阅 18.7。Red Hat Enterprise Linux 文档中的 /etc/exports 配置文件
。 类型：字符串
长度约束：最大长度为 4096。
模式：
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$必需：是
- Tags
-
表示要添加到位置的标签的键值对。该值可为空字符串。建议您使用标签来命名资源。
类型：TagListEntry 对象数组
数组成员：最少 0 项。最多 50 项。
必需：否
响应语法
{
"LocationArn": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- LocationArn
-
创建的 NFS 文件系统位置的 Amazon 资源名称 (ARN)。
类型：字符串
长度约束：最大长度为 128。
模式：
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$
错误
有关所有操作常见错误的信息，请参阅常见错误。
- InternalException
-
当Amazon DataSync服务中发生错误时，会抛出此异常。
HTTP 状态代码：500
- InvalidRequestException
-
当客户端提交格式错误的请求时，会引发此异常。
HTTP 状态代码：400
示例
示例
以下示例使用指定的 NFS 版本作为装载选项为 NFS 文件系统创建端点。
示例请求
{
"MountOptions": {
"Version": : "NFS4_0"
},
"OnPremConfig": {
"AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
},
"ServerHostname": "MyServer@amazon.com",
"Subdirectory": "/MyFolder",
"Tags": [
{
"Key": "Name",
"Value": "ElasticFileSystem-1"
}
]
}示例
响应将返回 NFS 位置的 Amazon 资源名称 (ARN)。
示例响应
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：