您可以通过更新服务器的访问权限配置来更新允许连接到 Cloud FTP 服务器的用户。您还可以更新元数据,例如服务器的显示名称。
服务器创建后,您便无法更改其是外部服务器还是内部服务器。
所需的角色
如需获得更新 SFTP 服务器所需的权限,请让您的管理员为您授予项目的 Cloud FTP Admin (roles/ftp.admin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色可提供更新 SFTP 服务器所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
如需更新 SFTP 服务器,您需要具备以下权限:
-
ftp.servers.update -
如果您使用 Google Cloud 控制台执行此任务:
-
ftp.servers.list -
ftp.servers.get
-
更新外部服务器的访问权限
控制台
- 在 Google Cloud 控制台中,前往 Cloud FTP 页面。
点击服务器 ID。
在外部配置部分中,点击 修改外部配置。
在允许的 IP 范围字段中,指定允许访问服务器的 IP 地址:
如需允许某个 IP 地址范围访问,请提供 CIDR 块,然后按 Enter 键。例如
192.0.2.0/24。 如需允许来自所有 IP 地址的连接,请使用0.0.0.0/0。如需移除某个 IP 范围的访问权限,请点击 移除。
您必须至少提供一个值,最多可以提供 500 个 CIDR 块。
点击保存。
gcloud
如需更新外部服务器的访问配置,请运行 gcloud alpha storage ftp servers update 命令。提供 --allowed-cidr-blocks 标志。
在使用下面的命令数据之前,请先进行以下替换:
- SERVER_ID:服务器 ID。
- LOCATION_ID:服务器的位置,例如
us-west1。 - CIDR_BLOCK:允许访问服务器的 CIDR 块。例如
192.0.2.0/24。您必须至少提供一个值,并且最多可以在英文逗号分隔列表中提供 500 个 CIDR 块。 如需允许来自所有 IP 地址的连接,请使用0.0.0.0/0。
执行以下命令:
Linux、macOS 或 Cloud Shell
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID \ --allowed-cidr-blocks=CIDR_BLOCK
Windows (PowerShell)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ` --allowed-cidr-blocks=CIDR_BLOCK
Windows (cmd.exe)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ^ --allowed-cidr-blocks=CIDR_BLOCK
REST
如需更新外部服务器的访问配置,请使用 servers.patch 方法。在 updateMask 查询参数中,提供 externalConfig 字段。
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:服务器的 Google Cloud 项目 ID。
- LOCATION_ID:服务器的位置,例如
us-west1。 - SERVER_ID:服务器 ID。
- CIDR_BLOCK:允许访问服务器的 CIDR 块。例如
192.0.2.0/24。您必须至少提供一个值,最多可以提供 500 个 CIDR 块。 如需允许来自所有 IP 地址的连接,请使用0.0.0.0/0。
HTTP 方法和网址:
PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=externalConfig
请求 JSON 正文:
{
"externalConfig": {
"allowedCidrBlocks": [
"CIDR_BLOCK"
]
}
}
如需发送您的请求,请展开以下选项之一:
响应会识别长时间运行的操作。 服务器需要几秒钟的时间才能完成更新。客户端库
C#
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP C# API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Go
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP Go API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP Java API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP Node.js API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
PHP
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP PHP API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Python
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP Python API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP Ruby API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
更新内部服务器的访问权限
控制台
- 在 Google Cloud 控制台中,前往 Cloud FTP 页面。
点击服务器 ID。
在内部配置部分中,点击 修改内部配置。
在接受的项目部分中,指定允许使用 Private Service Connect 连接到服务器的使用方项目:
如需允许项目,请执行以下操作:
点击添加接受的项目。
在项目 ID 或编号字段中,输入允许连接的项目的项目 ID 或编号。例如
example-allowed-project。在连接限制字段中,输入可在使用方项目中创建的 Private Service Connect 端点数上限。该值必须介于 1 到 250 个端点之间。
如需移除允许的项目,请点击 删除接受的项目。
(可选)在拒绝的项目部分中,指定禁止连接到服务器的项目:
如需禁止某个项目,请点击添加拒绝的项目。输入禁止连接到服务器的使用方项目的项目 ID 或编号。
此列表中的项目即使包含在允许的项目列表中,也会被拒绝访问服务器。
如需移除被禁止的项目,请点击 删除被拒绝的项目。
点击保存。
gcloud
如需更新内部服务器的访问配置,请运行 gcloud alpha storage ftp servers update 命令。提供 --consumer-accept-list 标志,并视需要提供 --consumer-reject-list 标志。
在使用下面的命令数据之前,请先进行以下替换:
- SERVER_ID:服务器 ID。
- LOCATION_ID:服务器的位置,例如
us-west1。 -
PROJECT_TO_ALLOW:允许使用 Private Service Connect 连接到服务器的使用方项目的项目 ID 或编号。例如
example-allowed-project。您必须至少指定一个项目。您最多可以允许 500 个项目。 在逗号分隔列表中提供多个项目及其各自的连接数上限。例如
--consumer-accept-list=projectA=20,projectB=15。 - CONNECTION_LIMIT:可在使用方项目中创建的 Private Service Connect 端点数量上限。该值必须介于 1 到 250 个端点之间。
-
(可选)PROJECT_TO_REJECT:禁止连接到服务器的使用方项目的项目 ID 或编号。例如
example-rejected-project。 此列表中的项目即使包含在允许的项目列表中,也会被拒绝访问服务器。您最多可以拒绝 64 个项目。 在逗号分隔列表中提供多个项目。
如果您不想明确拒绝任何项目,请省略--consumer-reject-list标志。
执行以下命令:
Linux、macOS 或 Cloud Shell
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID \ --consumer-accept-list=PROJECT_TO_ALLOW=CONNECTION_LIMIT \ --consumer-reject-list=PROJECT_TO_REJECT
Windows (PowerShell)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ` --consumer-accept-list=PROJECT_TO_ALLOW=CONNECTION_LIMIT ` --consumer-reject-list=PROJECT_TO_REJECT
Windows (cmd.exe)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ^ --consumer-accept-list=PROJECT_TO_ALLOW=CONNECTION_LIMIT ^ --consumer-reject-list=PROJECT_TO_REJECT
REST
如需更新内部服务器的访问权限配置,请使用 servers.patch 方法。在 updateMask 查询参数中,提供 internalConfig 字段。
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:服务器的 Google Cloud 项目 ID。
- LOCATION_ID:服务器的位置,例如
us-west1。 - SERVER_ID:服务器 ID。
-
PROJECT_TO_ALLOW:允许使用 Private Service Connect 连接到服务器的使用方项目的项目 ID 或编号。例如
example-allowed-project。您必须至少指定一个项目。您最多可以允许 500 个项目。
- CONNECTION_LIMIT:可在使用方项目中创建的 Private Service Connect 端点数量上限。该值必须介于 1 到 250 个端点之间。
-
(可选)PROJECT_TO_REJECT:禁止连接到服务器的使用方项目的项目 ID 或编号。例如
example-rejected-project。 此列表中的项目即使包含在允许的项目列表中,也会被拒绝访问服务器。您最多可以拒绝 64 个项目。
如果您不想明确拒绝任何项目,请省略
consumerRejectList对象。
HTTP 方法和网址:
PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=internalConfig
请求 JSON 正文:
{
"internalConfig": {
"consumerAcceptList": [
{
"project": "projects/PROJECT_TO_ALLOW",
"connectionLimit": CONNECTION_LIMIT
}
],
"consumerRejectList": [
{
"project": "projects/PROJECT_TO_REJECT"
}
]
}
}
如需发送您的请求,请展开以下选项之一:
响应会识别长时间运行的操作。 服务器需要几秒钟才能完成更新。客户端库
C#
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP C# API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Go
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP Go API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP Java API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP Node.js API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
PHP
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP PHP API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Python
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP Python API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
如需了解如何安装和使用 Cloud FTP 客户端库,请参阅 Cloud FTP 客户端库。 如需了解详情,请参阅 Cloud FTP Ruby API 参考文档。
如需向 Cloud FTP 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
更新服务器的显示名称
控制台
- 在 Google Cloud 控制台中,前往 Cloud FTP 页面。
点击服务器 ID。
点击 修改显示名称。
输入显示名称,然后点击保存。
gcloud
如需更新元数据(例如 SFTP 服务器的显示名称),请运行 gcloud alpha storage ftp servers update 命令。
在使用下面的命令数据之前,请先进行以下替换:
- SERVER_ID:服务器 ID。
- LOCATION_ID:服务器的位置,例如
us-west1。 - DISPLAY_NAME:服务器的显示名称。
执行以下命令:
Linux、macOS 或 Cloud Shell
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID \ --display-name="DISPLAY_NAME"
Windows (PowerShell)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ` --display-name="DISPLAY_NAME"
Windows (cmd.exe)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ^ --display-name="DISPLAY_NAME"
REST
如需更新元数据(例如 SFTP 服务器的显示名称),请使用 servers.patch 方法。在 updateMask 查询参数中,提供要更新的字段的英文逗号分隔列表。在请求正文中,提供一个包含要设置的值的 JSON 对象。
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:服务器的 Google Cloud 项目 ID。
- LOCATION_ID:服务器的位置,例如
us-west1。 - SERVER_ID:服务器 ID。
- FIELDS_TO_UPDATE:要更新的字段的英文逗号分隔列表(相对于服务器资源)。例如,如需更新显示名称,请提供查询参数
updateMask=displayName。 - DISPLAY_NAME:服务器的显示名称。
HTTP 方法和网址:
PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=FIELDS_TO_UPDATE
请求 JSON 正文:
{
"displayName": "DISPLAY_NAME"
}
如需发送您的请求,请展开以下选项之一:
响应会识别长时间运行的操作。 服务器需要几秒钟才能完成更新。