全部產品
Search
文件中心

Object Storage Service:ListAccessPointsForObjectProcess

更新時間:Jun 08, 2024

調用ListAccessPointsForObjectProcess介面擷取使用者層級的對象FC存取點資訊。

注意事項

阿里雲帳號預設擁有擷取對象FC存取點資訊的許可權。如果您希望通過RAM使用者或者STS的方式擷取對象FC存取點資訊,您必須擁有oss:ListAccessPointsForObjectProcess許可權。

請求文法

GET /?accessPointForObjectProcess&max-keys=10&continuation-token=abcd HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

要求標頭

此介面僅涉及公用要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)

請求元素

名稱

類型

是否必選

樣本值

描述

max-keys

字串

10

指定返回對象FC存取點的最大數量。

取值:大於0小於等於1000

說明

如果因為max-keys的設定無法一次完成列舉,返回結果會附加一個<NextContinuationToken>作為下一次列舉的continuation-token。

continuation-token

字串

abc

指定List操作需要從此token開始。您可以從返回結果中的NextContinuationToken擷取此token。

回應標頭

此介面僅包含公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)

響應元素

名稱

類型

樣本值

描述

ListAccessPointsForObjectProcessResult

容器

不涉及

儲存本次列舉對象FC存取點資訊結果的容器。

父節點:無

子節點:IsTruncated,NextContinuationToken,AccountId和AccessPointsForObjectProcess

IsTruncated

布爾值

true

請求中返回的結果是否被截斷。傳回值如下:

  • true:表示本次未返回全部結果。

  • false:表示本次已返回全部結果。

父節點:ListAccessPointsForObjectProcessResult

子節點:無

NextContinuationToken

字串

abc

表明本次ListAccessPointsForObjectProcess請求包含後續結果,需要將NextContinuationToken指定為continuation-token繼續擷取結果。

父節點:ListAccessPointsForObjectProcessResult

子節點:無

AccountId

字串

111933544165****

對象FC存取點所屬的阿里雲帳號UID。

父節點:ListAccessPointsForObjectProcessResult

子節點:無

AccessPointsForObjectProcess

容器

不涉及

儲存所有對象FC存取點資訊的容器。

父節點:ListAccessPointsForObjectProcessResult

子節點:AccessPointForObjectProcess

AccessPointForObjectProcess

容器

不涉及

儲存單個對象FC存取點資訊的容器。

父節點:AccessPointsForObjectProcess

子節點:AccessPointNameForObjectProcess、AccessPointForObjectProcessAlias、AccessPointName和Status

AccessPointNameForObjectProcess

字串

fc-ap-01

對象FC存取點名稱。

父節點:AccessPointForObjectProcess

子節點:無

AccessPointForObjectProcessAlias

字串

fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias

對象FC存取點別名。

父節點:AccessPointForObjectProcess

子節點:無

AccessPointName

字串

fc-01

存取點名稱。

父節點:AccessPointForObjectProcess

子節點:無

Status

枚舉字串

enable

對象FC存取點所處狀態。傳回值如下:

  • enable:對象FC存取點已建立完成。

  • disable:對象FC存取點已禁用。

  • creating:對象FC存取點正在建立中。

  • deleting:對象FC存取點已刪除。

父節點:AccessPointForObjectProcess

子節點:無

樣本

  • 請求樣本

    GET /?accessPointForObjectProcess&max-keys=10&continuation-token=abcd HTTP/1.1
    Date: Mon, 30 Oct 2023 03:15:40 GMT
    Content-Length:0
    Content-Type: application/xml
    Host: oss-cn-qingdao.aliyuncs.com
    Authorization: OSS qn6q**************:77Dv****************
  • 返回樣本

    HTTP/1.1 200
    <?xml version="1.0" encoding="UTF-8"?>
    <ListAccessPointsForObjectProcessResult>
       <IsTruncated>true</IsTruncated>
       <NextContinuationToken>abc</NextContinuationToken>
       <AccountId>111933544165****</AccountId>
       <AccessPointsForObjectProcess>
          <AccessPointForObjectProcess>
              <AccessPointNameForObjectProcess>fc-ap-01</AccessPointNameForObjectProcess>
              <AccessPointForObjectProcessAlias>fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias</AccessPointForObjectProcessAlias>
              <AccessPointName>fc-01</AccessPointName>
              <Status>enable</Status>
          </AccessPointForObjectProcess>
       </AccessPointsForObjectProcess>
    </ListAccessPointsForObjectProcessResult>