ListRegions - AWS 帳戶管理
請求語法URI請求參數請求主體回應語法回應元素錯誤另請參閱

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

ListRegions

列出指定帳戶的所有區域及其各自的選擇加入狀態。或者，您可以使用region-opt-status-contains參數篩選此清單。

請求語法

POST /listRegions HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "MaxResults": number,
   "NextToken": "string",
   "RegionOptStatusContains": [ "string" ]
}

URI請求參數

請求不使用任何URI參數。

請求主體

請求接受以下JSON格式的數據。

AccountId

指定 12 位數的帳號 ID 號碼 AWS 帳戶 您要使用此操作訪問或修改的。如果您未指定此參數，它會預設為用來呼叫作業之身分的 Amazon Web Services 帳戶。若要使用此參數，來電者必須是組織管理帳戶中的身分識別，或是委派的系統管理員帳戶。指定的帳號 ID 必須是相同組織中的成員帳戶。組織必須啟用所有功能，且組織必須啟用帳戶管理服務的受信任存取權，並選擇性地指派委派管理員帳戶。

注意

管理帳戶無法指定自己的帳戶AccountId。它必須通過不包括AccountId參數在獨立上下文中調用操作。

若要在非組織成員的帳戶上呼叫此作業，請勿指定此參數。請改為使用屬於您要擷取或修改其聯絡人之帳戶的身分來呼叫作業。

類型：字串

模式：^\d{12}$

必要：否

MaxResults

要在命令輸出中傳回的項目總數。如果可用的項目總數大於指定的值，則會NextToken在命令的輸出中提供 a。若要繼續分頁，請在後續命令的 starting-token 引數中提供 NextToken 值。不要直接在之外使用NextToken響應元素 AWS CLI。如需使用範例，請參閱中的分頁 AWS 命令行界面用戶指南。

類型：整數

有效範圍：最小值為 1。最大值為 50。

必要：否

NextToken

用來指定從何處開始分頁的權杖。這是先前截斷的NextToken回應。如需使用範例，請參閱中的分頁 AWS 命令行界面用戶指南。

類型：字串

長度限制：長度下限為 0。長度上限為 1000。

必要：否

RegionOptStatusContains

區域狀態清單 (「啟用」、「已啟用」、「停用」、「已停用」、「已啟用 _BY_DEFAULT」)，用於篩選指定帳戶的區域清單。例如，傳入的值只ENABLING會傳回「地區」狀態為的「區域」清單ENABLING。

類型：字串陣列

有效值:ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT

必要：否

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Regions": [ 
      { 
         "RegionName": "string",
         "RegionOptStatus": "string"
      }
   ]
}

回應元素

如果動作成功，服務會傳回 HTTP 200 回應。

服務會以JSON格式傳回下列資料。

NextToken

如果有更多的數據要返回，這將被填充。它應該被傳遞到的next-token請求參數list-regions。

類型：字串

Regions

這是指定帳戶的「區域」清單，或者如果使用篩選的參數，則會列出符合filter參數中設定之篩選準則的「區域」清單。

類型：Region 物件陣列

錯誤

如需所有動作常見錯誤的資訊，請參閱常見錯誤。

AccessDeniedException

作業失敗，因為呼叫識別沒有必要的最低權限。

HTTP狀態碼:4

InternalServerException

操作失敗，因為內部錯誤 AWS。 請稍後再次嘗試操作。

HTTP狀態碼:5

TooManyRequestsException

作業失敗，因為呼叫頻率太頻繁，而且超出了節流限制。

HTTP狀態碼:

ValidationException

作業失敗，因為其中一個輸入參數無效。

HTTP狀態碼:

另請參閱

有關在其中一種特定語言API中使用此功能的更多信息 AWS SDKs，請參閱下列內容：