

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

계정에 대한 분석기를 생성합니다.

## Request Syntax
<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"
}
```

## URI 요청 파라미터
<a name="API_CreateAnalyzer_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_CreateAnalyzer_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [analyzerName](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-analyzerName"></a>
생성할 분석기의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 255.  
패턴: `[A-Za-z][A-Za-z0-9_.-]*`   
필수 여부: 예

 ** [archiveRules](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-archiveRules"></a>
분석기에 추가할 아카이브 규칙을 지정합니다. 아카이브 규칙은 규칙에 대해 정의한 기준을 충족하는 결과를 자동으로 아카이브합니다.  
타입: [InlineArchiveRule](API_InlineArchiveRule.md)객체 배열  
필수: 아니요

 ** [clientToken](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-clientToken"></a>
클라이언트 토큰입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [configuration](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-configuration"></a>
분석기의 구성을 지정합니다. 분석기가 미사용 액세스 분석기인 경우 구성에 지정된 미사용 액세스 범위가 사용됩니다. 분석기가 내부 액세스 분석기인 경우 지정된 내부 액세스 분석 규칙이 구성에 사용됩니다.  
유형: [AnalyzerConfiguration](API_AnalyzerConfiguration.md)객체  
 **참고: **이 객체는 Union입니다. 이 객체의 멤버는 하나만 지정하거나 반환할 수 있습니다.  
필수 여부: 아니요

 ** [tags](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-tags"></a>
분석기에 적용할 키-값 페어의 배열입니다. 유니코드 문자, 숫자, 공백, , `_`, `.`, `/`, 및 집합`=`을 사용할 수 `+`있습니다`-`.  
태그 키의 경우 길이가 1\$1128자이고 접두사가 붙을 수 없는 값을 지정할 수 있습니다`aws:`.  
태그 값의 경우 0\$1256자 길이의 값을 지정할 수 있습니다.  
유형: 문자열 대 문자열 맵  
필수 여부: 아니요

 ** [type](#API_CreateAnalyzer_RequestSyntax) **   <a name="accessanalyzer-CreateAnalyzer-request-type"></a>
생성할 분석기의 유형입니다. 리전별로 계정당 하나의 분석기만 생성할 수 있습니다. 리전별로 조직당 최대 5개의 분석기를 생성할 수 있습니다.  
타입: 문자열  
유효 값: `ACCOUNT | ORGANIZATION | ACCOUNT_UNUSED_ACCESS | ORGANIZATION_UNUSED_ACCESS | ACCOUNT_INTERNAL_ACCESS | ORGANIZATION_INTERNAL_ACCESS`   
필수 여부: 예

## 응답 구문
<a name="API_CreateAnalyzer_ResponseSyntax"></a>

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

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

## 응답 요소
<a name="API_CreateAnalyzer_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [arn](#API_CreateAnalyzer_ResponseSyntax) **   <a name="accessanalyzer-CreateAnalyzer-response-arn"></a>
요청에 의해 생성된 분석기의 ARN입니다.  
유형: String  
패턴: `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}` 

## 오류
<a name="API_CreateAnalyzer_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.  
HTTP 상태 코드: 403

 ** ConflictException **   
충돌 예외 오류입니다.    
 ** resourceId **   
리소스의 ID입니다.  
 ** resourceType **   
리소스 유형.
HTTP 상태 코드: 409

 ** InternalServerException **   
내부 서버 오류.    
 ** retryAfterSeconds **   
재시도할 때까지 기다리는 초입니다.
HTTP 상태 코드: 500

 ** ServiceQuotaExceededException **   
서비스 따옴표가 오류를 충족했습니다.    
 ** resourceId **   
리소스 ID입니다.  
 ** resourceType **   
리소스 유형.
HTTP 상태 코드: 402

 ** ThrottlingException **   
제한 한도가 오류를 초과했습니다.    
 ** retryAfterSeconds **   
재시도할 때까지 기다리는 초입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
검증 예외 오류입니다.    
 ** fieldList **   
검증되지 않은 필드 목록입니다.  
 ** reason **   
예외의 이유입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_CreateAnalyzer_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/CreateAnalyzer) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/CreateAnalyzer) 