DescribeAccountCustomization

PDF

描述與提供的相關聯的自訂AWS帳戶和亞馬遜亞馬遜 QuickSight 命名空間AWS 區域。Amazon QuickSight 控制台通過運行此 API 操作來評估應用哪些自定義Resolved旗標。

若要判斷執行此命令時顯示的自訂項目，可協助視覺化相關實體的關係。

• AWS account-該AWS帳戶存在於階層中存在。它具有使用所有的潛力AWS 區域和AWS服務。當您訂閱 Amazon QuickSight，你選擇一個AWS 區域作為您的家庭地區使用。這就是您的免費 SPICE 容量所在的位置。您可以使用亞馬遜 QuickSight 在任何支援AWS 區域。

• AWS 區域 -在每個AWS 區域您在哪裡登錄到亞馬遜 QuickSight至少有一次 Amazon QuickSight 充當相同服務的個別執行個體。如果您有使用者目錄，則位於 us-us-us-east-1 中，即美國東部 (維吉尼亞北部) 中。一般來說，這些用戶可以訪問亞馬遜 QuickSight 在任何AWS 區域，除非它們被限制在命名空間中。

  以不同的方式執行命令AWS 區域，您可以變更您的「地區」設定。如果您使用AWS CLI，您可以使用下列其中一個選項：

  • 使用命令列選項。

  • 使用命名設定檔。

  • 執行aws configure變更您的預設值AWS 區域。使用 Enter 鍵為您的金鑰輸入相同的設定。如需詳細資訊，請參閱設定 AWS CLI。

• Namespace-一個 QuickSight 命名空間是包含使用者和資產 (資料來源、資料集、儀表板等) 的分割區。若要存取特定命名空間中的資產，使用者和群組也必須屬於相同命名空間。共用命名空間的使用者與其他命名空間中的使用者和資產完全隔離，即使它們位於相同的名稱空間AWS帳戶和AWS 區域。

• Applied customizations-內AWS 區域，一套亞馬遜 QuickSight 自訂可套用至AWS帳戶或命名空間。您套用至命名空間的設定會覆寫您套用至AWS帳戶。所有設置都被隔離為一個AWS 區域。要將它們應用於其他AWS 區域，執行CreateAccountCustomization每個指令AWS 區域您想要套用相同自訂的位置。

請求語法

GET /accounts/AwsAccountId/customizations?namespace=Namespace&resolved=Resolved HTTP/1.1

URI 請求參數

請求會使用下列 URI 參數。

AwsAccountId

的 IDAWS您想要描述 Amazon QuickSight 自訂。

長度限制：12。

模式：^[0-9]{12}$

必要：是

Namespace

Amazon QuickSight 您想要描述 Amazon QuickSight 自訂。

長度限制：長度上限為 64。

模式：^[a-zA-Z0-9._-]*$

Resolved

所以此Resolved標誌與其他參數一起使用，以確定亞馬遜的哪個視圖 QuickSight 會傳回自訂。您可以將此標誌添加到您的命令中以使用與亞馬遜相同的視圖 QuickSight 用來識別要套用至主控台的自訂。省略此旗標，或將其設定為no-resolved，以顯示在不同層級設定的自訂。

請求主體

請求沒有請求主體。

回應語法

HTTP/1.1 Status
Content-type: application/json

{
   "AccountCustomization": { 
      "DefaultEmailCustomizationTemplate": "string",
      "DefaultTheme": "string"
   },
   "Arn": "string",
   "AwsAccountId": "string",
   "Namespace": "string",
   "RequestId": "string"
}

回應元素

如果動作成功，則服務傳回下列 HTTP 回應。

Status

請求的 HTTP 狀態。

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

AccountCustomization

Amazon QuickSight 目前存在的自訂AWS 區域。

類型：AccountCustomization 物件

Arn

與此相關聯之自訂的 Amazon Resource Name (ARN)AWS帳戶。

類型：字串

AwsAccountId

的 IDAWS您正在描述的帳戶。

類型：字串

長度限制：12。

模式：^[0-9]{12}$

Namespace

Amazon QuickSight 您正在描述的命名空間。

類型：字串

長度限制：長度上限為 64。

模式：^[a-zA-Z0-9._-]*$

RequestId

所以此AWS此操作的 ID。

類型：字串

錯誤

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

AccessDeniedException

您無法存取此物品。提供的登入資料無法驗證。您可能無法取得授權以執行請求。確保您的帳戶已獲授權使用亞馬遜 QuickSight services。

HTTP 狀態碼：401

InternalFailureException

發生內部故障。

HTTP 狀態碼：500

InvalidParameterValueException

一或多個參數具有無效的值。

HTTP 狀態碼：400

ResourceNotFoundException

無法找到一個或多個資源。

HTTP 狀態碼：404

ResourceUnavailableException

此資源目前無法使用。

HTTP 狀態碼：503

ThrottlingException

存取已調節。

HTTP 狀態碼：429

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：

• AWS 命令列界面

• 適用於 .NET 的 AWS 開發套件

• 適用於 C++ 的 AWS SDK

• 適用於 Go 的 AWS 開發套件

• 適用於 Java 的 AWS 開發套件第 2 版

• AWS適用於 JavaScript

• 適用於 PHP V3 的 AWS SDK

• 適用於 Python 的 AWS SDK

• 適用於 Ruby 的 AWS 開發套件第 3 版