DescribeTheme - Amazon QuickSight
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

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

DescribeTheme

描述佈景主題。

請求語法

GET /accounts/AwsAccountId/themes/ThemeId?alias-name=AliasName&version-number=VersionNumber HTTP/1.1

URI 請求參數

請求會使用下列 URI 參數。

AliasName

您要描述的佈景主題清單。如果您命名特定別名，則會描述別名將指向的版本。您可以通過提供關鍵字來指定最新版本的佈景主題$LATEST中的AliasName參數。關鍵字$PUBLISHED不適用於佈景主題。

長度限制：長度下限為 1。長度上限為 2048。

模式：[\w\-]+|(\$LATEST)|(\$PUBLISHED)

AwsAccountId

的 IDAWS包含您所描述之佈景主題的帳戶。

模式：^(aws|[0-9]{12})$

必要：是

ThemeId

佈景主題的 ID。

長度限制：長度下限為 1。長度上限為 2048。

模式：[\w\-]+

必要：是

VersionNumber

要描述之版本的版本號：如果一個VersionNumber未提供參數值，描述最新版本的佈景主題。

有效範圍：最小值為 1。

請求主體

請求沒有請求主體。

回應語法

HTTP/1.1 Status
Content-type: application/json

{
   "RequestId": "string",
   "Theme": { 
      "Arn": "string",
      "CreatedTime": number,
      "LastUpdatedTime": number,
      "Name": "string",
      "ThemeId": "string",
      "Type": "string",
      "Version": { 
         "Arn": "string",
         "BaseThemeId": "string",
         "Configuration": { 
            "DataColorPalette": { 
               "Colors": [ "string" ],
               "EmptyFillColor": "string",
               "MinMaxGradient": [ "string" ]
            },
            "Sheet": { 
               "Tile": { 
                  "Border": { 
                     "Show": boolean
                  }
               },
               "TileLayout": { 
                  "Gutter": { 
                     "Show": boolean
                  },
                  "Margin": { 
                     "Show": boolean
                  }
               }
            },
            "UIColorPalette": { 
               "Accent": "string",
               "AccentForeground": "string",
               "Danger": "string",
               "DangerForeground": "string",
               "Dimension": "string",
               "DimensionForeground": "string",
               "Measure": "string",
               "MeasureForeground": "string",
               "PrimaryBackground": "string",
               "PrimaryForeground": "string",
               "SecondaryBackground": "string",
               "SecondaryForeground": "string",
               "Success": "string",
               "SuccessForeground": "string",
               "Warning": "string",
               "WarningForeground": "string"
            }
         },
         "CreatedTime": number,
         "Description": "string",
         "Errors": [ 
            { 
               "Message": "string",
               "Type": "string"
            }
         ],
         "Status": "string",
         "VersionNumber": number
      }
   }
}

回應元素

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

Status

請求的 HTTP 狀態。

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

RequestId

所以此AWS此操作的請求 ID。

類型：字串

Theme

您所描述之主題的相關資訊。

類型：Theme 物件

錯誤

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

AccessDeniedException

您無法存取。提供的登入資料無法驗證。您可能無法取得授權以執行請求。確保您的帳戶被授權使用亞馬遜 QuickSight 服務，您的政策有正確許可，以及您使用正確的存取金鑰。

HTTP 狀態：HTTP 狀態：401

InternalFailureException

發生內部故障。

HTTP 狀態：HTTP 狀態：500

InvalidParameterValueException

一或多個參數的值無效。

HTTP 狀態：HTTP 狀態：400

ResourceExistsException

指定的資源已存在。

HTTP 狀態：HTTP 狀態：409

ResourceNotFoundException

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

HTTP 狀態：HTTP 狀態：404

ThrottlingException

存取已調節。

HTTP 狀態：HTTP 狀態：429

UnsupportedUserEditionException

此錯誤表示您正在呼叫 Amazon 的操作 QuickSight訂閱版本不包括對該操作的支持。amazon QuickSight 目前包含 Standard Edition 不是每個版本都會提供所有操作和功能。

HTTP 狀態：HTTP 狀態：403

另請參閱

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