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á.

# UpdateDashboard
<a name="API_UpdateDashboard"></a>

Atualiza um painel emAWSconta.

**nota**  
A atualização de um painel cria uma nova versão do painel, mas não publica imediatamente a nova versão. Você pode atualizar a versão publicada de um painel usando` [UpdateDashboardPublishedVersion](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateDashboardPublishedVersion.html) `Operação da API

## Sintaxe da solicitação
<a name="API_UpdateDashboard_RequestSyntax"></a>

```
PUT /accounts/AwsAccountId/dashboards/DashboardId HTTP/1.1
Content-type: application/json

{
   "DashboardPublishOptions": { 
      "AdHocFilteringOption": { 
         "AvailabilityStatus": "string"
      },
      "ExportToCSVOption": { 
         "AvailabilityStatus": "string"
      },
      "SheetControlsOption": { 
         "VisibilityState": "string"
      }
   },
   "Name": "string",
   "Parameters": { 
      "DateTimeParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "DecimalParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "IntegerParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "StringParameters": [ 
         { 
            "Name": "string",
            "Values": [ "string" ]
         }
      ]
   },
   "SourceEntity": { 
      "SourceTemplate": { 
         "Arn": "string",
         "DataSetReferences": [ 
            { 
               "DataSetArn": "string",
               "DataSetPlaceholder": "string"
            }
         ]
      }
   },
   "ThemeArn": "string",
   "VersionDescription": "string"
}
```

## Parâmetros da solicitação de URI
<a name="API_UpdateDashboard_RequestParameters"></a>

A solicitação usa os parâmetros de URI a seguir.

 ** [AwsAccountId](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-AwsAccountId"></a>
O ID daAWSconta que contém o painel que você está atualizando.  
Restrições de tamanho Comprimento fixo de 12.  
Padrão: `^[0-9]{12}$`   
Obri Sim

 ** [DashboardId](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-DashboardId"></a>
A ID do painel.  
Restrições de tamanho Tamanho mínimo de 1. Tamanho máximo de 2048.  
Padrão: `[\w\-]+`   
Obri Sim

## Corpo da solicitação
<a name="API_UpdateDashboard_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [Name](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-Name"></a>
O nome de exibição do painel.  
Type: String  
Restrições de tamanho Tamanho mínimo de 1. Tamanho máximo de 2048.  
Obri Sim

 ** [SourceEntity](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-SourceEntity"></a>
A entidade que você está usando como fonte ao atualizar o painel. Dentro`SourceEntity`, você especifica o tipo de objeto que está usando como origem. Você só pode atualizar um painel a partir de um modelo, então você usa um`SourceTemplate`Entidade. Se você precisar atualizar um painel a partir de uma análise, primeiro converta a análise em um modelo usando a` [CreateTemplate](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateTemplate.html) `Operação da API para o`SourceTemplate`, especifica o nome de recurso da Amazon (ARN) do modelo de origem. O`SourceTemplate`O ARN pode conter qualquerAWSconta e qualquer Amazon QuickSight-suportRegião da AWS.   
Usar a`DataSetReferences`entidade dentro`SourceTemplate`para listar os conjuntos de dados de substituição para os espaços reservados listados no original. O esquema em cada conjunto de dados deve corresponder ao seu espaço reservado.   
Tipo: objeto [DashboardSourceEntity](API_DashboardSourceEntity.md)  
Obri Sim

 ** [DashboardPublishOptions](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-DashboardPublishOptions"></a>
Opções para publicar o painel ao criá-lo:  
+  `AvailabilityStatus`pelo`AdHocFilteringOption`- Este status pode ser`ENABLED`ou`DISABLED`. Quando isso for configurado`DISABLED`, Amazon QuickSight desativa o painel de filtro esquerdo no painel publicado, que pode ser usado para filtragem ad hoc (única). Esta opção`ENABLED`por padrão 
+  `AvailabilityStatus`pelo`ExportToCSVOption`- Este status pode ser`ENABLED`ou`DISABLED`. A opção visual para exportar dados para o formato .CSV não está habilitada quando está definida como`DISABLED`. Esta opção`ENABLED`por padrão 
+  `VisibilityState`pelo`SheetControlsOption`- Esse estado de visibilidade pode ser`COLLAPSED`ou`EXPANDED`. Esta opção`COLLAPSED`por padrão 
Tipo: objeto [DashboardPublishOptions](API_DashboardPublishOptions.md)  
Obri Não

 ** [Parameters](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-Parameters"></a>
Uma estrutura que contém os parâmetros do painel. Essas são substituições de parâmetros para um painel. Um painel pode ter qualquer tipo de parâmetro, e alguns parâmetros podem aceitar vários valores.  
Tipo: objeto [Parameters](API_Parameters.md)  
Obri Não

 ** [ThemeArn](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-ThemeArn"></a>
O nome de recurso da Amazon (ARN) do tema que está sendo usado para este painel. Se você adicionar um valor para este campo, ele substituirá o valor que foi originalmente associado à Entidade. O ARN do tema deve existirAWSconta na qual você cria o painel.  
Type: String  
Obri Não

 ** [VersionDescription](#API_UpdateDashboard_RequestSyntax) **   <a name="QS-UpdateDashboard-request-VersionDescription"></a>
Uma descrição para a primeira versão do painel que está sendo criada.  
Type: String  
Restrições de tamanho Tamanho mínimo de 1. Tamanho máximo de 512.  
Obri Não

## Sintaxe da resposta
<a name="API_UpdateDashboard_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "CreationStatus": "string",
   "DashboardId": "string",
   "RequestId": "string",
   "Status": number,
   "VersionArn": "string"
}
```

## Elementos de resposta
<a name="API_UpdateDashboard_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.

Os seguintes dados são retornados no formato JSON pelo serviço.

 ** [Arn](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-Arn"></a>
O nome de recurso da Amazon (ARN) do recurso.  
Type: String

 ** [CreationStatus](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-CreationStatus"></a>
O status de criação da solicitação  
Type: String  
Valores válidos:` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` 

 ** [DashboardId](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-DashboardId"></a>
A ID do painel.  
Type: String  
Restrições de tamanho Tamanho mínimo de 1. Tamanho máximo de 2048.  
Padrão: `[\w\-]+` 

 ** [RequestId](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-RequestId"></a>
OAWSID da solicitação para essa operação.  
Type: String

 ** [Status](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-Status"></a>
O status HTTP da solicitação.  
Type: Inteiro

 ** [VersionArn](#API_UpdateDashboard_ResponseSyntax) **   <a name="QS-UpdateDashboard-response-VersionArn"></a>
O ARN do painel, incluindo o número da versão.  
Type: String

## Erros
<a name="API_UpdateDashboard_Errors"></a>

Para obter informações sobre os erros que são comuns a todas as ações, consulte[Erros comuns](CommonErrors.md).

 ** ConflictException **   
Atualizar ou excluir um recurso pode causar um estado inconsistente.  
Código de status HTTP 409

 ** 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

 ** LimitExceededException **   
Um limite foi excedido.  
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 **   
Este 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 QuickSight No momento, está disponível na 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
<a name="API_UpdateDashboard_SeeAlso"></a>

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/UpdateDashboard) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/UpdateDashboard) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/UpdateDashboard) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/UpdateDashboard)