Todos los productos
Search
Centro de documentos

File Storage NAS:Ejemplo de integración con la CLI

Última actualización: Sep 03, 2026

Alibaba Cloud Command Line Interface (CLI) es una herramienta de línea de comandos de uso general desarrollada con base en APIs. Puede utilizar Alibaba Cloud CLI para interactuar con File Storage NAS (NAS) y gestionar sus recursos de NAS mediante una herramienta de shell. Este tema describe cómo usar Alibaba Cloud CLI para invocar operaciones de la API de NAS.

Contexto

Para obtener más información sobre Alibaba Cloud CLI, consulte What is Alibaba Cloud CLI.

Instalar Alibaba Cloud CLI

Debe instalar Alibaba Cloud CLI antes de poder utilizarla. Puede instalar Alibaba Cloud CLI en los sistemas operativos Windows, Linux y macOS. Seleccione un paquete de instalación de Alibaba Cloud CLI según el sistema operativo de su dispositivo. Para obtener más información, consulte los siguientes temas:

También puede utilizar Cloud Shell, proporcionado por Alibaba Cloud, para depurar los comandos que desea ejecutar en Alibaba Cloud CLI. Para obtener más información sobre Cloud Shell, consulte What is Cloud Shell?.

Configurar Alibaba Cloud CLI

Importante

Una cuenta de Alibaba Cloud tiene permisos para invocar todas las operaciones de la API. Utilizar una cuenta de Alibaba Cloud para realizar operaciones constituye una acción de alto riesgo. Se recomienda invocar las operaciones de la API o realizar tareas rutinarias de operación y mantenimiento como usuario de Resource Access Management (RAM). Debe adjuntar la directiva AliyunNASFullAccess al usuario de RAM.

Antes de usar Alibaba Cloud CLI, debe configurar la información de credenciales, como las credenciales de identidad y un ID de región, en Alibaba Cloud CLI. Alibaba Cloud CLI admite diversas credenciales de identidad. Para obtener más información, consulte Configure and manage credentials. En este ejemplo, se utilizan credenciales AccessKey. Siga estos pasos:

  1. Cree un usuario de RAM y otorgue los permisos para gestionar los servicios de Alibaba Cloud según sus necesidades empresariales. Para obtener más información, consulte Create a RAM user y Manage RAM user permissions.

  2. Después de crear y autorizar a un usuario de RAM, debe crear un par de AccessKey para dicho usuario y registrar el AccessKey ID y el AccessKey Secret para la configuración posterior de credenciales. Para obtener más información, consulte Create an AccessKey.

  3. Especifique un ID de región. Alibaba Cloud CLI invoca las operaciones de la API en la región especificada. Para obtener más información sobre las regiones disponibles, consulte Endpoints.

  4. Utilice el par de AccessKey del usuario de RAM para configurar las credenciales de identidad en el archivo de configuración denominado AkProfile. Para obtener más información, consulte Configure and manage credentials.

Generar un comando de la CLI

  1. Inicie sesión en OpenAPI Portal.

  2. En la página de depuración de la API, puede buscar la API que desea utilizar en el cuadro de búsqueda de la izquierda. En la sección Parameter Configuration, introduzca los parámetros según la documentación de la API y, a continuación, haga clic en la pestaña CLI Example a la derecha de Parameter Configuration para generar un ejemplo de comando con los parámetros.

    • Haga clic en Run Command para abrir Cloud Shell y depurar rápidamente el comando.

    • Haga clic en Copy para copiar el ejemplo de comando al portapapeles. Luego puede pegarlo en su herramienta de shell local para ejecutarlo.

      • Preste atención a los formatos de los parámetros cuando copie y pegue el comando de la CLI en el shell local. Para obtener más información sobre los formatos de parámetros de Alibaba Cloud CLI, consulte Understand command parameters.

      • De forma predeterminada, la opción --region se agrega al comando de ejemplo generado en OpenAPI Explorer. Cuando copia el comando a su herramienta de shell, Alibaba Cloud CLI ignora la información de región en las configuraciones de credenciales predeterminadas y en las variables de entorno, y ejecuta preferentemente el comando en la región especificada. Puede eliminar o conservar esta opción según sus necesidades empresariales.

Usar Alibaba Cloud CLI para invocar operaciones de la API de NAS

Sintaxis

En Alibaba Cloud CLI, puede utilizar la siguiente sintaxis para ejecutar comandos. Para obtener más información, consulte Generate and run CLI commands with OpenAPI Explorer.

aliyun <command> <subcommand> [options and parameters]

Opciones de comando

Cuando utiliza Alibaba Cloud CLI, puede especificar opciones de comando para cambiar el comportamiento de los comandos o implementar funciones extendidas. Las siguientes opciones de comando se utilizan con frecuencia:

  • --profile<profileName>: Después de utilizar la opción --profile y su parámetro profileName para especificar un perfil de configuración, Alibaba Cloud CLI ignora la credencial de identidad predeterminada y las configuraciones de variables de entorno, y utiliza las configuraciones que usted especifique para ejecutar comandos.

  • --help: Puede especificar la opción --help para obtener información de ayuda sobre un comando. Para obtener más información, consulte Use the help command.

Ejemplos

Nota

En los siguientes ejemplos, los comandos se ejecutan en el Símbolo del sistema de Windows. Los formatos de los parámetros de los comandos varían en otros sistemas operativos. Para obtener más información sobre los formatos de parámetros de Alibaba Cloud CLI, consulte Understand command parameters.

  • Ejemplo 1: Uso de Alibaba Cloud CLI para invocar la operación CreateFileSystem de NAS y crear un sistema de archivos Network File System (NFS) de capacidad de uso general pay-as-you-go.

    1. Ejecute el siguiente comando:

      aliyun nas CreateFileSystem --FileSystemType standard --ChargeType PayAsYouGo --StorageType Capacity --ProtocolType NFS
    2. Consulte la salida del comando.

      {
              "FileSystemId": "6a2464****",
              "RequestId": "3879AB9C-1DED-5A49-A015-350138B23BF0"
      }
  • Ejemplo 2: Uso de Alibaba Cloud CLI para invocar la operación CreateAccessGroup de NAS y crear un grupo de permisos llamado vpc_test .

    1. Ejecute el siguiente comando:

      aliyun nas CreateAccessGroup --AccessGroupName vpc_test --AccessGroupType Vpc
    2. Consulte la salida del comando.

      {
              "AccessGroupName": "vpc_test",
              "RequestId": "95CB3005-C251-5E11-A949-29CB2C7A9C54"
      }
Nota

Si se devuelve un error después de invocar una operación de la API de NAS, debe comprobar si los parámetros de la solicitud y sus valores son válidos según el código de error devuelto.

También puede utilizar el RequestID o el mensaje de error del SDK de la respuesta con la OpenAPI Diagnostic Platform para diagnosticar el problema.