As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# DescribeTheme
Descreve um tema.
## Sintaxe da solicitação
```
GET /accounts/AwsAccountId/themes/ThemeId?alias-name=AliasName&version-number=VersionNumber HTTP/1.1
```
## Parâmetros da solicitação de URI
A solicitação usa os parâmetros de URI a seguir.
** [AliasName](#API_DescribeTheme_RequestSyntax) **
O alias do tema do que você deseja descrever. Se você nomear um alias específico, descreverá a versão ao qual o alias aponta. Você pode especificar a versão mais recente do tema fornecendo a palavra-chave`$LATEST`no`AliasName`parâmetro . A palavra-chave`$PUBLISHED`não se aplica a temas.
Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 2048.
Padrão: `[\w\-]+|(\$LATEST)|(\$PUBLISHED)`
** [AwsAccountId](#API_DescribeTheme_RequestSyntax) **
O ID doAWSconta que contém o tema que você está descrevendo.
Padrão: `^(aws|[0-9]{12})$`
Obrigatório: Sim
** [ThemeId](#API_DescribeTheme_RequestSyntax) **
O ID do tema.
Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 2048.
Padrão: `[\w\-]+`
Obrigatório: Sim
** [VersionNumber](#API_DescribeTheme_RequestSyntax) **
O número da versão a ser descrita. Em caso de`VersionNumber`valor de parâmetro não é fornecido, a versão mais recente do tema é descrita.
Intervalo válido: Valor mínimo de 1.
## Corpo da solicitação
Essa solicitação não tem o corpo da solicitação.
## Sintaxe da resposta
```
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
}
}
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.
** [Status](#API_DescribeTheme_ResponseSyntax) **
O status HTTP da solicitação.
Os seguintes dados são retornados no formato JSON pelo serviço.
** [RequestId](#API_DescribeTheme_ResponseSyntax) **
OAWSID da solicitação para essa operação.
Type: String
** [Theme](#API_DescribeTheme_ResponseSyntax) **
As informações sobre o tema que você está descrevendo.
Tipo: objeto [Theme](API_Theme.md)
## Erros
Para obter informações sobre os erros que são comuns a todas as ações, consulte[Erros comuns](CommonErrors.md).
** AccessDeniedException **
Você não tem acesso a esse item. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight se as políticas têm as permissões corretas e se você está usando as chaves de acesso corretas.
Código de status HTTP: 401
** InternalFailureException **
Ocorreu um erro interno.
Código de status HTTP: 500
** InvalidParameterValueException **
Um ou mais parâmetros têm um valor que não é válido.
Código de status HTTP: 400
** ResourceExistsException **
O recurso especificado já existe.
Código de status HTTP: 409
** ResourceNotFoundException **
Não foi possível encontrar um ou mais recursos.
Código de status HTTP: 404
** ThrottlingException **
O acesso é limitado.
Código de status HTTP: 429
** UnsupportedUserEditionException **
Esse erro indica que você está chamando uma operação em uma Amazon QuickSightassinatura em que a edição não inclui suporte para essa operação. Amazon Amazon QuickSight No momento, a Standard Edition e Enterprise Edition. Nem todas operações e recursos estão disponível em todas as edições.
Código de status HTTP: 403
## Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/DescribeTheme)
+ [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/DescribeTheme)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/DescribeTheme)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/DescribeTheme)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/DescribeTheme)
+ [AWSSDK para o JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/DescribeTheme)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/DescribeTheme)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/DescribeTheme)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/DescribeTheme)