Todos os produtos
Search
Central de documentação

Object Storage Service:resource-group, resource-group

Última atualização: Sep 25, 2026

Execute o comando resource-group para configure um grupo de recursos para um bucket e consulte os grupos de recursos de um bucket.

Notas de uso

  • Para configure um grupo de recursos para um bucket, você deve ter a permissão oss:PutBucketResourceGroup. Para consultar os grupos de recursos de um bucket, você deve ter a permissão oss:GetBucketResourceGroup. Para mais informações, consulte Grant a custom policy.

  • No ossutil 1.6.16 e versões posteriores, utilize ossutil diretamente como nome binário na linha de comando, sem necessidade de atualize o nome binário com base no sistema operacional. Em versões anteriores ao ossutil 1.6.16, especifique um nome binário correspondente ao sistema operacional. Para mais informações, consulte ossutil command reference.

  • O comando resource-group é compatível somente com o ossutil 1.7.16 e versões posteriores.

Configure um grupo de recursos para um bucket

  • Sintaxe do comando

    ossutil resource-group --method put oss://bucketname/ local_xml_file

    A tabela a seguir descreve os parâmetros anteriores.

    Parâmetro

    Descrição

    bucketname

    O nome do bucket para o qual você deseja configure um grupo de recursos.

    local_xml_file

    O nome do arquivo local usado para adicionar configurações de grupo de recursos. Exemplo: config.xml.

  • Exemplos

    1. Adicione configurações de grupo de recursos a um arquivo XML local.

      <?xml version="1.0" encoding="UTF-8"?>
      <BucketResourceGroupConfiguration>
        <ResourceGroupId>rg-aekz****</ResourceGroupId>
      </BucketResourceGroupConfiguration>
    2. Especifique um grupo de recursos para o bucket examplebucket usando o arquivo XML local.

      ossutil resource-group --method put oss://examplebucket/ config.xml

      Exemplo de saída:

      0.299514(s) elapsed

Consultar os grupos de recursos de um bucket

  • Sintaxe do comando

    ossutil resource-group --method get oss://bucketname/ local_xml_file

    A tabela a seguir descreve os parâmetros anteriores.

    Parâmetro

    Descrição

    bucketname

    O nome do bucket cujos grupos de recursos você deseja consultar.

    local_xml_file

    O nome do arquivo local usado para armazenar as configurações de grupo de recursos do bucket. Exemplo: local.xml.

  • Exemplos

    • Consulte e exiba os grupos de recursos de um bucket chamado examplebucket:

      ./ossutil resource-group --method get oss://examplebucket/

      Exemplo de saída:

      <?xml version="1.0" encoding="UTF-8"?>
      <BucketResourceGroupConfiguration>
        <ResourceGroupId>rg-aekz****</ResourceGroupId>
      </BucketResourceGroupConfiguration>
      
      0.154689(s) elapsed
    • Consulte os grupos de recursos de um bucket chamado examplebucket e armazene as configurações de grupo de recursos em um arquivo local:

      ./ossutil resource-group --method get oss://examplebucket/ local.xml

      Exemplo de saída:

      • O seguinte resultado é exibido:

        0.214483(s) elapsed
      • O arquivo local contém o seguinte conteúdo:

        <?xml version="1.0" encoding="UTF-8"?>
        <BucketResourceGroupConfiguration>
          <ResourceGroupId>rg-aekz****</ResourceGroupId>
        </BucketResourceGroupConfiguration>