Actualiza un servidor SFTP

Para actualizar los usuarios que pueden conectarse a un servidor de Cloud FTP, actualiza la configuración de acceso del servidor. También puedes actualizar metadatos, como el nombre visible del servidor.

No puedes cambiar si un servidor es externo o interno después de que se crea.

Roles obligatorios

Para obtener el permiso que necesitas para actualizar un servidor SFTP, pídele a tu administrador que te otorgue el rol de IAM Administrador de Cloud FTP (roles/ftp.admin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el ftp.servers.update permiso, que se requiere para actualizar un servidor SFTP.

También puedes obtener este permiso con roles personalizados o otros roles predefinidos.

Actualiza el acceso para un servidor externo

REST

Para actualizar la configuración de acceso de un servidor externo, usa el servers.patch método. En el parámetro de consulta updateMask, proporciona el campo externalConfig.

**Precaución:** Los bloques de CIDR que proporcionas en el cuerpo de la solicitud reemplazan todos los valores existentes.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el Google Cloud ID del proyecto del servidor.
• LOCATION_ID: Es la ubicación del servidor, como us-west1.
• SERVER_ID: Es el ID del servidor.
• CIDR_BLOCK: Es un bloque de CIDR que tiene permiso para acceder al servidor. Por ejemplo, 192.0.2.0/24. Debes proporcionar al menos un valor y puedes proporcionar un máximo de 500 bloques de CIDR. Para permitir conexiones desde todas las direcciones IP, usa 0.0.0.0/0.

Método HTTP y URL:

PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=externalConfig

Cuerpo JSON de la solicitud:

{
  "externalConfig": {
    "allowedCidrBlocks": [
      "CIDR_BLOCK"
    ]
  }
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json, y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=externalConfig"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json, y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=externalConfig" | Select-Object -Expand Content

La respuesta identifica una operación de larga duración. El servidor tarda unos segundos en actualizarse.

Actualiza el acceso para un servidor interno

REST

Para actualizar la configuración de acceso de un servidor interno, usa el servers.patch método. En el parámetro de consulta updateMask, proporciona el campo internalConfig.

Precaución: Las listas de proyectos de consumidor permitidos y rechazados que proporcionas en el cuerpo de la solicitud reemplazan todos los valores existentes.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el Google Cloud ID del proyecto del servidor.
• LOCATION_ID: Es la ubicación del servidor, como us-west1.
• SERVER_ID: Es el ID del servidor.
• PROJECT_TO_ALLOW: Es el ID del proyecto o el número de proyecto de un proyecto de consumidor que tiene permiso para conectarse al servidor mediante Private Service Connect. Por ejemplo, example-allowed-project. Debes especificar al menos un proyecto.
• CONNECTION_LIMIT: Es la cantidad máxima de extremos de Private Service Connect que se pueden crear en el proyecto de consumidor.
• (Opcional) PROJECT_TO_REJECT: Es el ID del proyecto o el número de un proyecto de consumidor al que se le prohíbe conectarse al servidor. Por ejemplo, example-rejected-project. Los proyectos de esta lista no pueden acceder al servidor, incluso si se incluyen en la lista de proyectos permitidos. Si esta lista está vacía, no se rechaza ningún proyecto de forma explícita.

Método HTTP y URL:

PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=internalConfig

Cuerpo JSON de la solicitud:

{
  "internalConfig": {
    "consumerAcceptList": [
      {
        "project": "projects/PROJECT_TO_ALLOW",
        "connectionLimit": CONNECTION_LIMIT
      }
    ],
    "consumerRejectList": [
      {
        "project": "projects/PROJECT_TO_REJECT"
      }
    ]
  }
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json, y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=internalConfig"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json, y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=internalConfig" | Select-Object -Expand Content

La respuesta identifica una operación de larga duración. El servidor tarda unos segundos en actualizarse.

Actualiza el nombre visible de un servidor

REST

Para actualizar metadatos, como el nombre visible de un servidor SFTP, usa el servers.patch método. En el parámetro de consulta updateMask, proporciona una lista separada por comas de los campos que se actualizarán. En el cuerpo de la solicitud, proporciona un objeto JSON con los valores que se establecerán.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el Google Cloud ID del proyecto del servidor.
• LOCATION_ID: Es la ubicación del servidor, como us-west1.
• SERVER_ID: Es el ID del servidor.
• FIELDS_TO_UPDATE: Es una lista separada por comas de los campos que se actualizarán, en relación con el recurso del servidor. Por ejemplo, para actualizar el nombre visible, proporciona el parámetro de consulta updateMask=displayName.
• DISPLAY_NAME: Es un nombre visible para el servidor.

Método HTTP y URL:

PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=FIELDS_TO_UPDATE

Cuerpo JSON de la solicitud:

{
  "displayName": "DISPLAY_NAME"
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json, y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=FIELDS_TO_UPDATE"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json, y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=FIELDS_TO_UPDATE" | Select-Object -Expand Content

La respuesta identifica una operación de larga duración. El servidor tarda unos segundos en actualizarse.