resource-group(资源组)

resource-group命令用于为存储空间(Bucket)配置所属资源组以及获取资源组信息。

注意事项

  • 要配置Bucket所属资源组,您必须具有oss:PutBucketResourceGroup权限;要获取Bucket资源组信息,您必须具有oss:GetBucketResourceGroup权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 从ossutil 1.6.16版本开始,命令行中Binary名称支持直接使用ossutil,您无需根据系统刷新Binary名称。如果您的ossutil版本低于1.6.16,则需要根据系统刷新Binary名称。更多信息,请参见命令行工具ossutil命令参考

  • 仅1.7.16及以上版本支持resource-group命令。

配置Bucket所属资源组

  • 命令格式

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

    参数说明如下:

    参数

    说明

    bucketname

    待设置资源组的Bucket名称。

    local_xml_file

    用于添加资源组配置的本地文件名称,例如config.xml

  • 使用示例

    1. 在本地XML文件中设置Bucket所属资源组。

      <?xml version="1.0" encoding="UTF-8"?>
      <BucketResourceGroupConfiguration>
        <ResourceGroupId>rg-aekz****</ResourceGroupId>
      </BucketResourceGroupConfiguration>
    2. 为examplebucket设置所属资源组。

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

      输出结果如下:

      0.299514(s) elapsed

获取Bucket资源组信息

  • 命令格式

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

    参数说明如下:

    参数

    说明

    bucketname

    待获取所属资源组的Bucket名称。

    local_xml_file

    用于存放资源组信息的本地文件名称,例如local.xml

  • 使用示例

    • 获取examplebucket所属资源组,并将结果输出到屏幕上。

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

      输出结果如下:

      <?xml version="1.0" encoding="UTF-8"?>
      <BucketResourceGroupConfiguration>
        <ResourceGroupId>rg-aekz****</ResourceGroupId>
      </BucketResourceGroupConfiguration>
      
      
      
      0.154689(s) elapsed
    • 获取examplebucket所属资源组,并将结果输出到本地文件中。

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

      输出结果如下:

      • 屏幕显示

        0.214483(s) elapsed
      • local.xml内容

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