Todos os produtos
Search
Central de documentação

Object Storage Service:config

Última atualização: Oct 12, 2026

Cria ou gerencia arquivos de configuração. Os arquivos de configuração armazenam credenciais de acesso e configurações. O comando config pode ser interativo ou não interativo, dependendo dos seus cenários de uso.

Crie um arquivo de configuração

  1. Execute o seguinte comando para iniciar o processo de configuração:

    ossutil config
  2. Siga as instruções na tela e configure o caminho do arquivo de configuração. Pressione a tecla Enter para usar o caminho padrão do arquivo de configuração.

    Este exemplo mostra como configurar o caminho padrão do arquivo de configuração no Linux.

    Please enter the config file name,the file name can include path(default /root/.ossutilconfig, carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):
  3. Especifique o AccessKey ID, o AccessKey secret e o ID da região com base nas instruções na tela.

    1. Insira o AccessKey ID que você criou.

      Please enter Access Key ID [****************id]:LTAI****************
    2. Insira o AccessKey secret que você criou.

      Please enter Access Key Secret [****************sk]:R6vg*********************
    3. Insira o ID da região onde o bucket que armazena seus dados está localizado. Valor padrão: cn-hangzhou.

      Please enter Region [cn-hangzhou]: cn-hangzhou
    4. Especifique o endpoint da região onde o bucket está localizado. Pressione Enter para pular esta etapa.

      Após especificar o ID da região na etapa anterior, o endpoint público da região é usado por padrão. Por exemplo, se você definir region-id como cn-hangzhou, o endpoint público padrão será https://oss-cn-hangzhou.aliyuncs.com.

      Se quiser usar um endpoint diferente, insira o endpoint. Se quiser acessar o OSS a partir de outros serviços da Alibaba Cloud na mesma região do OSS, use o endpoint interno da região (https://oss-cn-hangzhou-internal.aliyuncs.com neste exemplo).

      Please enter Endpoint (optional, use public endpoint by default) [None]: https://oss-cn-hangzhou-internal.aliyuncs.com

    A tabela a seguir descreve os parâmetros.

    Parâmetro

    Obrigatório

    Descrição

    accessKeyID

    Sim

    O par de AccessKey (AccessKey ID e secret) do usuário RAM. Para obter informações sobre como obter um par de AccessKey, consulte Create an AccessKey pair for a RAM user.

    Criar um par de AccessKey usando o ROS

    Crie rapidamente um par de AccessKey para um usuário RAM com permissões totais de acesso ao OSS usando um script do Resource Orchestration Service (ROS) em formato YAML. Para isso, acesse o wizard for template-based stack creation, selecione I confirm that Alibaba Cloud ROS may create RAM resources na seção Security Confirmation, confirme a ação e clique em Create.

    1.png

    Após criar o par de AccessKey, copie-o na aba Outputs.

    1.png

    accessKeySecret

    Sim

    Region

    Sim

    O ID da região em que o seu bucket do OSS está localizado. Neste exemplo, é usado o ID da região China (Hangzhou) (cn-hangzhou). Para obter informações sobre os IDs de outras regiões, consulte regions and endpoints.

    endpoint

    Não

    Especifique o endpoint da região em que o bucket está localizado. Se não especificar manualmente um endpoint, o parâmetro Region gerará automaticamente um endpoint público. Para usar um endpoint interno, especifique-o explicitamente. Neste exemplo, é usado o endpoint público da região China (Hangzhou) (https://oss-cn-hangzhou.aliyuncs.com).

    Se quiser acessar o OSS a partir de outros serviços da Alibaba Cloud na mesma região do OSS, use o endpoint interno da região (https://oss-cn-hangzhou-internal.aliyuncs.com neste exemplo).

    Para obter mais informações sobre a relação entre regiões e endpoints, consulte Regions and endpoints.

Crie e consulte configurações

Crie configurações

ossutil config set

Esse comando cria configurações de credenciais de acesso ou outras configurações. Nesse caso, o comando não é interativo. A opção --config-file especifica o caminho para o arquivo de configuração, e a opção --profile especifica a seção do perfil.

O seguinte comando de exemplo define o parâmetro region na seção dev do arquivo de configuração myconfig:

ossutil config set region cn-hangzhou --config-file myconfig --profile dev

Para excluir um item de configuração, defina o valor como uma string vazia na linha de comando ou exclua manualmente a entrada com um editor de texto.

ossutil config set region "" --config-file myconfig --profile dev

Consulte configurações

ossutil config get

Esse comando consulta credenciais de acesso ou configurações. Nesse caso, o comando não é interativo. A opção --config-file especifica o caminho para o arquivo de configuração, e a opção --profile especifica a seção do perfil a ser usada. O seguinte comando de exemplo consulta o parâmetro region na seção dev do arquivo de configuração myconfig:

ossutil config get region --config-file myconfig --profile dev

Liste todas as seções de configuração

Esse comando lista todas as seções. Nesse caso, o comando não é interativo.

ossutil config list-profiles

Configure credenciais de acesso

ossutil config credential

Esse comando configura credenciais de acesso. Nesse caso, o comando é interativo. O sistema perguntará se deseja criptografar o AccessKey ID, o AccessKey secret e o token.

ossutil config credential
The command creates a config file and stores configuration settings and credentials.

Please enter the config file name,the file name can include path(default "C:\Users\issuser\.ossutilconfig", carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):

No config file entered, will use the default config file "C:\Users\issuser\.ossutilconfig"For the following settings, carriage return means skip the configuration.
Please enter profile:
Please enter authenticate mode, supports RamRoleArn,EcsRamRole,Process,Uri,OIDCRoleArn,AK,StsToken:
Do you need to encryt access key id and access key secret (y or N)
Please enter Access Key ID [None]:
Please enter Access Key Secret [None]: