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

# CreateAnalysis
<a name="API_CreateAnalysis"></a>

Cria uma análise na Amazon QuickSight.

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

```
POST /accounts/AwsAccountId/analyses/AnalysisId HTTP/1.1
Content-type: application/json

{
   "Name": "string",
   "Parameters": { 
      "DateTimeParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "DecimalParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "IntegerParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "StringParameters": [ 
         { 
            "Name": "string",
            "Values": [ "string" ]
         }
      ]
   },
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "SourceEntity": { 
      "SourceTemplate": { 
         "Arn": "string",
         "DataSetReferences": [ 
            { 
               "DataSetArn": "string",
               "DataSetPlaceholder": "string"
            }
         ]
      }
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThemeArn": "string"
}
```

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

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

 ** [AnalysisId](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-AnalysisId"></a>
O ID da análise que você está criando. Esse ID é exibido no URL da análise.  
Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 2048.  
Padrão: `[\w\-]+`   
Obrigatório: Sim

 ** [AwsAccountId](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-AwsAccountId"></a>
O ID doAWSconta em que você está criando uma análise.  
Restrições de comprimento: Comprimento fixo de 12.  
Padrão: `^[0-9]{12}$`   
Obrigatório: Sim

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

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

 ** [Name](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Name"></a>
Um nome descritivo para a análise que você está criando. Esse nome é exibido para a análise na Amazônia QuickSight console do .   
Type: String  
Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 2048.  
Obrigatório: Sim

 ** [SourceEntity](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-SourceEntity"></a>
Uma entidade de origem a ser usada para a análise que você está criando. Essa estrutura de metadados contém detalhes que descrevem um modelo de origem e um ou mais conjuntos de dados.  
Tipo: objeto [AnalysisSourceEntity](API_AnalysisSourceEntity.md)  
Obrigatório: Sim

 ** [Parameters](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Parameters"></a>
Os nomes dos parâmetros e os valores de substituição que você deseja usar. Uma análise pode ter qualquer tipo de parâmetro, e alguns parâmetros podem aceitar vários valores.   
Tipo: objeto [Parameters](API_Parameters.md)  
Obrigatório: Não

 ** [Permissions](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Permissions"></a>
Uma estrutura que descreve os principais e as permissões em nível de recurso em uma análise. Você pode usar o`Permissions`estrutura para conceder permissões fornecendo uma lista deAWS Identity and Access ManagementInformações de ação (IAM) para cada entidade listada pelo Nome de recurso da Amazon (ARN).   
Para especificar nenhuma permissão, omita`Permissions`.  
Type: matriz de[ResourcePermission](API_ResourcePermission.md)objetos  
Membros da matriz: Número mínimo de 1 item. Número máximo de 64 itens.  
Obrigatório: Não

 ** [Tags](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Tags"></a>
Contém um mapa dos pares de chave-valor para a tag de recurso ou tags atribuídas à análise.  
Type: matriz de[Tag](API_Tag.md)objetos  
Membros da matriz: Número mínimo de 1 item. Número máximo de 200 itens.  
Obrigatório: Não

 ** [ThemeArn](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-ThemeArn"></a>
O ARN do tema a ser aplicado à análise que você está criando. Para ver o tema na Amazon QuickSight console, verifique se você tem acesso a ele.  
Type: String  
Obrigatório: Não

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

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

{
   "AnalysisId": "string",
   "Arn": "string",
   "CreationStatus": "string",
   "RequestId": "string"
}
```

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

Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.

 ** [Status](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-Status"></a>
O status HTTP da solicitação.

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

 ** [AnalysisId](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-AnalysisId"></a>
O ID da análise.  
Type: String  
Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 2048.  
Padrão: `[\w\-]+` 

 ** [Arn](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-Arn"></a>
O ARN para a análise.  
Type: String

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

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

## Erros
<a name="API_CreateAnalysis_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

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