Todos los productos
Search

Este producto

    Object Storage Service:config

    Centro de documentos

    Object Storage Service:config

    Última actualización: Sep 24, 2026

    En este tema se describe cómo ejecutar el comando config para crear un archivo de configuración que almacena la información de acceso a Object Storage Service (OSS). Al agregar la opción -c cuando ejecute otros comandos, ossutil usará los valores de un archivo específico para acceder a OSS.

    Importante

    A partir de la versión 1.6.16 de ossutil, puede usar directamente ossutil como nombre del binario en la línea de comandos. No es necesario ajustar el nombre según el sistema operativo. En versiones anteriores a la 1.6.16, sí debe modificar el nombre del binario de acuerdo con su sistema operativo. Para obtener más información, consulte ossutil command reference.

    Sintaxis del comando

    El comando config se ejecuta en modo interactivo o no interactivo. En el modo interactivo, primero complete los ajustes correspondientes mediante un archivo de configuración; después, al ejecutar el comando config, ossutil leerá esos valores directamente. En el modo no interactivo, debe especificar los parámetros al momento de ejecutar el comando. El modo interactivo ofrece mayor seguridad que el no interactivo.

    Para ejecutar el comando config en modo no interactivo, use esta sintaxis:

    ossutil config 
[-e, --endpoint <value>] 
[-i, --access-key-id <value>] 
[-k, --access-key-secret <value>] 
[-t, --sts-token <value>]
[--ram-role-arn <value>]
[-L language <value>] 
[--output-dir <value>] 
[-c, --config-file <value>]

    A continuación se describen las opciones anteriores.

    Opción

    Descripción

    -e, --endpoint

    Endpoint de la región donde se ubica el bucket. Para obtener más información, consulte Regions and endpoints. Si desea indicar el protocolo que usará ossutil para acceder a OSS, agregue http:// o https://. El protocolo predeterminado es HTTP.

    -i, --access-key-id

    AccessKey ID ubicado en la sección [Credentials] del archivo de configuración. Para saber cómo consultar el AccessKey ID, consulte Obtain an AccessKey pair.

    -k, --access-key-secret

    AccessKey secret ubicado en la sección [Credentials] del archivo de configuración. Para saber cómo consultar el AccessKey secret, consulte Obtain an AccessKey pair.

    -t, --sts-token

    Token de Security Token Service (STS) que se usa para acceder a OSS. Este parámetro es obligatorio únicamente si emplea credenciales de acceso temporales de STS. Para obtener más información sobre cómo generar un token de STS, consulte Access OSS by using STS temporary credentials.

    --ram-role-arn

    Alibaba Cloud Resource Name (ARN) del rol de RAM cuando se usa el modo RamRoleArn para la autenticación. Configure este parámetro solo si llama a AssumeRole para acceder a OSS como usuario de RAM.

    -L language

    Idioma que usa ossutil. Valores válidos:

    • CH: chino. Si establece este parámetro en CH, compruebe que su sistema admita la codificación UTF-8.

    • EN: inglés.

    --output-dir

    Directorio donde se almacenan los objetos de salida. Estos incluyen los archivos de reporte generados por errores durante la ejecución del comando cp, cuando se copian varios objetos de forma simultánea.

    De manera predeterminada, el directorio de salida es ossutil_output, dentro del directorio actual.

    -c, --config-file

    Ruta del archivo de configuración de ossutil. Cuando se inicia ossutil, lee esta ruta desde dicho archivo.

    Ejemplos

    • Genere un archivo de configuración en modo interactivo

      ossutil config
Specify the name of the configuration file. The file name can contain the file path. The default file name is /home/user/.ossutilconfig. If you press the Enter key without specifying a file path, the configuration file is generated in the default path. 
If you want to store the configuration file in another path, set the --config-file option to the file path. 
If you do not specify the path of the configuration file, the default configuration file named /home/user/.ossutilconfig is used.  
If you press the Enter key without specifying the following parameters, these parameters are ignored. For more information about the parameters, run the help config command.  
Enter the endpoint: https://oss-cn-shenzhen.aliyuncs.com 
Enter the AccessKey ID: yourAccessKeyID 
Enter the AccessKey secret: yourAccessKeySecret
Enter the STS token: yourStsToken

    • Genere un archivo de configuración en modo no interactivo

      ossutil config -e oss-cn-beijing.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret -L CH -c /myconfig

      Si especifica parámetros al ejecutar el comando config, excepto -L language y -c, --config-file, se activa el modo no interactivo. En ese caso, debe proporcionar todos los parámetros obligatorios.

    Modificar el archivo de configuración

    Importante

    • En ossutil V1.7.15 y versiones posteriores, no necesita especificar Bucket-Endpoint ni Bucket-Cname si usa el modo interactivo. Puede definir un endpoint o un CNAME para cada bucket directamente en el archivo de configuración.

    • ossutil permite especificar endpoints mediante distintos métodos. Las configuraciones de endpoint se aplican en el siguiente orden de prioridad descendente: los indicados con la opción --endpoint en el comando, los definidos en la sección [Bucket-Cname], los de la sección [Bucket-Endpoint] y, por último, los de la sección [Credentials].

    Modifique el archivo generado para actualizar la información de acceso a OSS. El archivo de configuración de ossutil tiene el formato que se muestra a continuación:

    [Credentials]
        language = CH
        endpoint = oss.aliyuncs.com
        accessKeyID = your_accesskey_id
        accessKeySecret = your_accesskey_secret
        stsToken = your_sts_token
        outputDir = your_output_dir
        ramRoleArn = your_ram_role_arn
[Bucket-Endpoint]
        bucket1 = endpoint1
        bucket2 = endpoint2
        ...
[Bucket-Cname]
        bucket1 = cname1
        bucket2 = cname2
        ...
[AkService]
        ecsAk=http://100.100.100.200/latest/meta-data/ram/security-credentials/EcsRamRoleTesting
[Default]
        userAgent = user_agent
        loglevel = log_level
        proxyHost = proxy_host
        proxyUser = proxy_user
        proxyPwd = proxy_pwd
        readTimeOut = read_time_out
        connectTimeOut = connect_time_out
        retryTimes = retry_times

    • Bucket-Endpoint: asigne un endpoint específico a cada bucket indicado.

    • Bucket-Cname: defina un CNAME para cada bucket especificado. Para obtener más información sobre los CNAME, consulte 绑定自定义域名.

    • AkService: esta opción es obligatoria si desea operar en OSS con un rol de RAM asociado a una instancia de Elastic Compute Service (ECS). Al configurarla, basta con establecer EcsRamRoleTesting con el nombre del rol de RAM vinculado a la instancia. Una vez definida, ya no requiere indicar los parámetros AccessKey ID, AccessKey Secret ni STSToken. Si proporciona un AccessKey ID, la configuración de AkService no surte efecto. Los valores de AccessKey ID, AccessKey Secret y STSToken sirven para comprobar su identidad. Para conocer el procedimiento de asociación de un rol de RAM a una instancia ECS, consulte Instance RAM roles.

    • Default: configure esta opción cuando necesite cambiar los valores predeterminados de los parámetros comunes. Para obtener más información, consulte View options.

      Nota

      La opción Default solo es compatible con ossutil V1.7.15 y versiones posteriores.