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á.
DescribeAccountCustomization
Descreve as personalizações associadas aoAWSconta e Amazon Amazon QuickSight namespace emRegião da AWS. A Amazon QuickSight O console avalia quais personalizações aplicar executando essa operação de API com oResolvedsinalizador incluído
Para determinar quais personalizações são exibidas quando você executa esse comando, isso pode ajudar a visualizar o relacionamento das entidades envolvidas.
-
AWS account- OAWSconta existe no topo da hierarquia. Ele tem o potencial de usar todos osRegiões da AWSeAWS Services. Quando você assina a Amazon QuickSight, você escolhe umRegião da AWSpara usar como sua região de origem. É aí que sua capacidade gratuita do SPICE está localizada. Você pode usar a Amazon QuickSight em qualquerRegião da AWS. -
Região da AWS- Em cadaRegião da AWSonde você faz login na Amazon QuickSightpelo menos uma vez, a Amazon QuickSight atua como uma instância separada do mesmo serviço. Se você tiver um diretório de usuário, ele residirá em us-east-1, que é o Leste dos EUA (Norte da Virgínia) (us-east-1). De modo geral, esses usuários têm acesso à Amazon QuickSight em qualquerRegião da AWS, a menos que estejam restritos a um namespace.Para executar o comando em umaRegião da AWS, você altera suas configurações de região. Se você estiver usando aAWS CLI, você pode usar uma das opções a seguir:
-
Usar oopções de linha de comando.
-
Usar operfis nomeados.
-
Execução do
aws configurepara alterar seu padrãoRegião da AWS. Use Enter para digitar as mesmas configurações para suas chaves. Para obter mais informações, consulte Configuração da AWS CLI.
-
-
Namespace- UM QuickSight namespace é uma partição que contém usuários e ativos (fontes de dados, conjuntos de dados, painéis e assim por diante). Para acessar ativos que estão em um namespace específico, usuários e grupos também devem fazer parte do mesmo namespace. As pessoas que compartilham um namespace são completamente isoladas dos usuários e ativos em outros namespaces, mesmo que estejam no mesmoAWSConta da eRegião da AWS. -
Applied customizations- Em umRegião da AWS, um conjunto da Amazon QuickSight personalizações podem ser aplicadas a umAWSconta ou para um namespace. As configurações que você aplica a um namespace substituem as configurações que você aplica a umAWSconta. Todas as configurações são isoladas em um únicoRegião da AWS. Para aplicá-los em outrosRegiões da AWS, execute aCreateAccountCustomizationcomando em cadaRegião da AWSno qual você deseja aplicar as mesmas personalizações.
Sintaxe da solicitação
GET /accounts/AwsAccountId/customizations?namespace=Namespace&resolved=Resolved HTTP/1.1
Parâmetros da solicitação de URI
A solicitação usa os parâmetros de URI a seguir.
- AwsAccountId
-
O ID doAWSconta que você deseja descrever a Amazon QuickSight personalizações para.
Restrições de tamanho: Comprimento fixo de 12
Padrão:
^[0-9]{12}$Obrigatório: Sim
- Namespace
-
A Amazon QuickSight namespace que você deseja descrever a Amazon QuickSight personalizações para.
Restrições de tamanho: Tamanho máximo de 64.
Padrão:
^[a-zA-Z0-9._-]*$ - Resolved
-
O
Resolvedflag funciona com os outros parâmetros para determinar qual visualização da Amazon QuickSight as personalizações são retornadas. Você pode adicionar esse sinalizador ao seu comando para usar a mesma visualização que a Amazon QuickSight usa para identificar quais personalizações aplicar ao console. Omitir esse sinalizador ou defini-lo comono-resolved, para revelar personalizações configuradas em diferentes níveis.
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
{
"AccountCustomization": {
"DefaultEmailCustomizationTemplate": "string",
"DefaultTheme": "string"
},
"Arn": "string",
"AwsAccountId": "string",
"Namespace": "string",
"RequestId": "string"
}Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.
- Status
-
O status HTTP da solicitação.
Os seguintes dados são retornados no formato JSON pelo serviço.
- AccountCustomization
-
A Amazon QuickSight personalizações que existem no atualRegião da AWS.
Tipo: objeto AccountCustomization
- Arn
-
O nome de recurso da Amazon (ARN) da personalização associada aAWSconta.
Type: String
- AwsAccountId
-
O ID doAWSconta que você está descrevendo.
Type: String
Restrições de tamanho: Comprimento fixo de 12
Padrão:
^[0-9]{12}$ - Namespace
-
A Amazon QuickSight namespace que você está descrevendo.
Type: String
Restrições de tamanho: Tamanho máximo de 64.
Padrão:
^[a-zA-Z0-9._-]*$ - RequestId
-
OAWSID da solicitação para essa operação.
Type: String
Erros
Para obter informações sobre os erros que são comuns a todas as ações, consulteErros comuns.
- AccessDeniedException
-
Você não tem acesso a este 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 suas políticas têm as permissões corretas e se você está usando as chaves de acesso corretas
Código HTTP: 401
- InternalFailureException
-
Ocorreu um erro interno.
Código HTTP: 500
- InvalidParameterValueException
-
Um ou mais parâmetros têm um valor que não é válido.
Código HTTP: 400
- ResourceNotFoundException
-
Não foi possível encontrar um ou mais recursos.
Código HTTP: 404
- ResourceUnavailableException
-
Este recurso está indisponível no momento.
Código HTTP: 503
- ThrottlingException
-
O acesso é limitado.
Código HTTP: 429
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:
