浏览大数据量容器和对象列表

浏览大数据量容器和对象列表

如果你的容器和对象数量较大,可以设置``marker``, limit, 和``end_marker``参数来控制列表返回的数目以及起始和结束位置。

  • marker
    请求容器和对象列表时,对象存储为每次请求最多返回10,000项数据。如需继续获取数据,需使用 ``marker``参数再次发送请求。将 ``marker``参数的值设置为前一次请求获取列表的最后一项的名称。 发送请求前,``marker``值必须进行URL编码。对象存储将返回从标记的位置开始的最多10,000项数据。
  • limit
    如需返回少于10,000项数据,使用``limit``参数。如果返回的数据量等于指定的数量(省略``limit``参数时默认为10,000),则表明有更多数据未显示。如果返回的数据量是``limit``的整数倍,则最后一次请求无数据。
  • end_marker
    根据 ``end_marker``参数的值限定返回结果。发送请求前必须对 ``end_marker``进行URL编码。

浏览大数据量容器和对象列表

假定已有如下容器:

apples
bananas
kiwis
oranges
pears
  1. 设置``limit``为2:

    # curl -i $publicURL/?limit=2 -X GET -H "X-Auth-Token: $token"
    
    apples
    bananas
    

    返回了两个容器名,这表明有更多容器未显示。

  2. 使用``marker``参数标记最后请求项,再次发送请求。

    # curl -i $publicURL/?limit=2&marker=bananas -X GET -H \
      “X-Auth-Token: $token"
    
    kiwis
    oranges
    

    再次,两个项目被返回,并且会有更多。

  3. 在最后一个项目返回的“marker”中使用另一个请求:

    # curl -i $publicURL/?limit=2&marker=oranges -X GET -H \”
      X-Auth-Token: $token"
    
    pears
    

    您收到的一条少于“limit”的名称数量响应。这表明,这是列表的结尾。

  4. 使用“end_marker”参数来限制对象名称的结果集小于“end_marker”参数的值:

    # curl -i $publicURL/?end_marker=oranges -X GET -H \”
     X-Auth-Token: $token"
    
    apples
    bananas
    kiwis
    

    您会接收到在“end-marker”值之前的所有容器的名称的结果集。

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.