Execute o comando config para criar um arquivo de configuração - Object Storage Service: Central de Documentação do Alibaba Cloud

Este tópico descreve como executar o comando config para criar um arquivo de configuração que armazena informações de acesso ao Object Storage Service (OSS). Adicione a opção -c ao executar outros comandos para que o ossutil utilize as definições de um arquivo específico no acesso ao OSS.

Importante

No ossutil 1.6.16 e versões posteriores, use ossutil diretamente como nome do binário na linha de comando, sem necessidade de alteração conforme o sistema operacional. Em versões anteriores à 1.6.16, ajuste o nome do binário de acordo com o sistema operacional. Para mais detalhes, consulte Introdução rápida à ferramenta de linha de comando ossutil.

Sintaxe do comando

Execute o comando config nos modos interativo ou não interativo. No modo interativo, preencha as configurações necessárias por meio de prompts guiados; o ossutil lê os dados diretamente durante a execução. No modo não interativo, especifique todos os parâmetros diretamente na linha de comando. O modo interativo oferece maior segurança que o não interativo.

Para executar o comando config no modo não interativo, utilize a seguinte sintaxe:

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 tabela a seguir descreve as opções anteriores.

Opção	Descrição
-e, --endpoint	Endpoint da região onde o bucket está localizado. Para mais informações, consulte Regiões e endpoints. Para definir o protocolo de acesso ao OSS, adicione `http://` ou `https://`. O protocolo padrão é HTTP.
-i, --access-key-id	AccessKey ID na seção [Credentials] do arquivo de configuração. Para visualizar o AccessKey ID, consulte Obter um par de AccessKeys.
-k, --access-key-secret	AccessKey Secret na seção [Credentials] do arquivo de configuração. Para visualizar o AccessKey Secret, consulte Obter um par de AccessKeys.
-t, --sts-token	Token do Security Token Service (STS) usado para acessar o OSS. Esse parâmetro é obrigatório apenas ao usar credenciais de acesso temporário do STS. Para gerar um token STS, consulte Acessar o OSS usando credenciais temporárias do STS.
--ram-role-arn	Alibaba Cloud Resource Name (ARN) da função RAM no modo de autenticação RamRoleArn. Configure esse parâmetro somente se chamar a API AssumeRole para acessar o OSS como usuário RAM.
-L language	Idioma usado pelo ossutil. Valores válidos: CH: Chinês. Se definir este parâmetro como CH, verifique se o sistema suporta codificação UTF-8. EN: Inglês.
--output-dir	Diretório onde os arquivos de saída são armazenados. Esses arquivos incluem relatórios gerados por erros ocorridos durante a execução do comando cp para copiar múltiplos objetos simultaneamente. Por padrão, o diretório de armazenamento dos arquivos de saída é ossutil_output, no diretório atual.
-c, --config-file	Caminho do arquivo de configuração do ossutil. Durante a inicialização, o ossutil lê as configurações desse caminho.

Exemplos

Gerar um arquivo de configuração no modo interativo

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

Gerar um arquivo de configuração no modo não interativo
```
ossutil config -e oss-cn-beijing.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret -L CH -c /myconfig
```
Ao especificar parâmetros na execução do comando config, exceto -L language e -c, --config-file, o modo não interativo é ativado automaticamente. Nesse caso, forneça todos os parâmetros explicitamente.

Modificar o arquivo de configuração

Importante

A partir do ossutil V1.7.15, não é necessário especificar Bucket-Endpoint ou Bucket-Cname no modo interativo. Defina um endpoint ou CNAME individual para cada bucket diretamente no arquivo de configuração.
O ossutil permite especificar endpoints de diferentes formas. A prioridade de aplicação das configurações segue esta ordem decrescente: endpoints definidos pela opção --endpoint no comando, endpoints na seção [Bucket-Cname], endpoints na seção [Bucket-Endpoint] e, por fim, endpoints na seção [Credentials].

Para alterar as informações de acesso ao OSS, edite o arquivo de configuração gerado. O formato do arquivo de configuração do ossutil segue o modelo abaixo:

[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: Define um endpoint específico para cada bucket listado.
Bucket-Cname: Associa um CNAME a cada bucket especificado. Para mais detalhes sobre CNAMEs, consulte Vincular um nome de domínio personalizado.
AkService: Opção necessária para usar uma função RAM anexada a uma instância do Elastic Compute Service (ECS) nas operações do OSS. Ao configurar essa opção, defina EcsRamRoleTesting com o nome da função RAM vinculada à instância ECS. Assim, não é preciso informar AccessKey ID, AccessKey Secret e STSToken. Se um AccessKey ID for especificado, a configuração AkService será ignorada, pois as credenciais explícitas têm precedência na verificação de identidade. Para anexar uma função RAM a uma instância ECS, consulte Funções RAM de instância.
Default: Use esta seção para alterar os valores padrão de parâmetros comuns. Para mais informações, consulte Visualizar opções.

Nota
A opção Default é suportada apenas no ossutil V1.7.15 e versões posteriores.