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

# CreateAnalyzer
<a name="API_CreateAnalyzer"></a>

Cria um analisador para sua conta.

## Sintaxe da Solicitação
<a name="API_CreateAnalyzer_RequestSyntax"></a>

```
PUT /analyzer HTTP/1.1
Content-type: application/json

{
   "analyzerName": "string",
   "archiveRules": [ 
      { 
         "filter": { 
            "string" : { 
               "contains": [ "string" ],
               "eq": [ "string" ],
               "exists": boolean,
               "neq": [ "string" ]
            }
         },
         "ruleName": "string"
      }
   ],
   "clientToken": "string",
   "configuration": { ... },
   "tags": { 
      "string" : "string" 
   },
   "type": "string"
}
```

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

A solicitação não usa nenhum parâmetro de URI.

## Corpo da Solicitação
<a name="API_CreateAnalyzer_RequestBody"></a>

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

 ** [analyzerName](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-analyzerName"></a>
O nome do analisador a ser criado.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 255.  
Padrão: `[A-Za-z][A-Za-z0-9_.-]*`   
Obrigatório: Sim

 ** [archiveRules](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-archiveRules"></a>
Especifica as regras de arquivamento a serem adicionadas ao analisador. As regras de arquivamento arquivam automaticamente as descobertas que atendem aos critérios definidos para a regra.  
Tipo: matriz de objetos [InlineArchiveRule](API_InlineArchiveRule.md)  
Obrigatório: não

 ** [clientToken](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-clientToken"></a>
Um token de cliente.  
Tipo: string  
Obrigatório: não

 ** [configuration](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-configuration"></a>
Especifica a configuração do analisador. Se o analisador for um analisador de acesso não utilizado, o escopo especificado do acesso não utilizado será usado para a configuração. Se o analisador for um analisador de acesso interno, as regras de análise de acesso interno especificadas serão usadas para a configuração.  
Tipo: objeto [AnalyzerConfiguration](API_AnalyzerConfiguration.md)  
 **Observação:** este objeto é uma união. Somente um membro desse objeto pode ser especificado ou retornado.  
Obrigatório: não

 ** [tags](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-tags"></a>
Uma matriz de pares de valores-chave a serem aplicados ao analisador. Você pode usar o conjunto de letras Unicode, dígitos, espaços em branco,,,`_`, `.``/`, e. `=` `+` `-`  
Para a chave de tag, você pode especificar um valor que tenha de 1 a 128 caracteres e não possa ser prefixado com`aws:`.  
Para o valor da tag, você pode especificar um valor de 0 a 256 caracteres.  
Tipo: mapa de string para string  
Obrigatório: não

 ** [type](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-type"></a>
O tipo de analisador a ser criado. Você pode criar somente um analisador por conta por região. Você pode criar até 5 analisadores por organização por região.  
Tipo: string  
Valores válidos: `ACCOUNT | ORGANIZATION | ACCOUNT_UNUSED_ACCESS | ORGANIZATION_UNUSED_ACCESS | ACCOUNT_INTERNAL_ACCESS | ORGANIZATION_INTERNAL_ACCESS`   
Obrigatório: sim

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

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

{
   "arn": "string"
}
```

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

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

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

 ** [arn](#API_CreateAnalyzer_ResponseSyntax) **   <a name="accessanalyzer-CreateAnalyzer-response-arn"></a>
O ARN do analisador que foi criado pela solicitação.  
Tipo: sequência  
Padrão: `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}` 

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

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

 ** AccessDeniedException **   
Você não tem acesso suficiente para executar esta ação.  
Código de status HTTP: 403

 ** ConflictException **   
Um erro de exceção de conflito.    
 ** resourceId **   
O ID do recurso.  
 ** resourceType **   
O tipo de recurso.
Código de Status HTTP: 409

 ** InternalServerException **   
Erro interno do servidor.    
 ** retryAfterSeconds **   
Os segundos de espera para tentar novamente.
Código de status HTTP: 500

 ** ServiceQuotaExceededException **   
A cotação do serviço encontrou um erro.    
 ** resourceId **   
O ID do recurso.  
 ** resourceType **   
O tipo de recurso.
Código de status HTTP: 402

 ** ThrottlingException **   
Erro de limite de limitação excedido.    
 ** retryAfterSeconds **   
Os segundos de espera para tentar novamente.
Código de status HTTP: 429

 ** ValidationException **   
Erro de exceção de validação.    
 ** fieldList **   
Uma lista de campos que não foram validados.  
 ** reason **   
O motivo da exceção.
Código de Status HTTP: 400

## Consulte também
<a name="API_CreateAnalyzer_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/CreateAnalyzer)