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

# 애플리케이션 applicationId 버전 semanticVersion
<a name="applications-applicationid-versions-semanticversion"></a>

## URI
<a name="applications-applicationid-versions-semanticversion-url"></a>

`/applications/{{applicationId}}/versions/{{semanticVersion}}`

## HTTP 메소드
<a name="applications-applicationid-versions-semanticversion-http-methods"></a>

### PUT
<a name="applications-applicationid-versions-semanticversionput"></a>

**작업 ID:** `CreateApplicationVersion`

애플리케이션 버전을 생성합니다.


**경로 파라미터**  

| 이름 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| {{applicationId}} | String | True | 애플리케이션의 Amazon 리소스 이름(ARN)입니다. | 
| {{semanticVersion}} | String | True | 새 버전의 의미 체계 버전입니다. | 


**응답**  

| 상태 코드 | 응답 모델 | 설명 | 
| --- |--- |--- |
| 201 | Version | Success | 
| 400 | BadRequestException | 요청의 파라미터 중 하나가 잘못되었습니다. | 
| 403 | ForbiddenException | 클라이언트가 인증되지 않았습니다. | 
| 409 | ConflictException | 리소스가 이미 존재합니다. | 
| 429 | TooManyRequestsException | 클라이언트가 시간 단위당 허용된 요청 수를 초과하여 전송하고 있습니다. | 
| 500 | InternalServerErrorException |  AWS Serverless Application Repository 서비스에서 내부 오류가 발생했습니다. | 

### OPTIONS
<a name="applications-applicationid-versions-semanticversionoptions"></a>


**경로 파라미터**  

| 이름 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| {{applicationId}} | String | True | 애플리케이션의 Amazon 리소스 이름(ARN)입니다. | 
| {{semanticVersion}} | String | True | 새 버전의 의미 체계 버전입니다. | 


**응답**  

| 상태 코드 | 응답 모델 | 설명 | 
| --- |--- |--- |
| 200 | None | 응답 200개 | 

## 스키마
<a name="applications-applicationid-versions-semanticversion-schemas"></a>

### 요청 본문
<a name="applications-applicationid-versions-semanticversion-request-examples"></a>

#### PUT 스키마
<a name="applications-applicationid-versions-semanticversion-request-body-put-example"></a>

```
{
  "templateBody": "string",
  "templateUrl": "string",
  "sourceCodeUrl": "string",
  "sourceCodeArchiveUrl": "string"
}
```

### 응답 본문
<a name="applications-applicationid-versions-semanticversion-response-examples"></a>

#### Version 스키마
<a name="applications-applicationid-versions-semanticversion-response-body-version-example"></a>

```
{
  "applicationId": "string",
  "semanticVersion": "string",
  "sourceCodeUrl": "string",
  "sourceCodeArchiveUrl": "string",
  "templateUrl": "string",
  "creationTime": "string",
  "parameterDefinitions": [
    {
      "name": "string",
      "defaultValue": "string",
      "description": "string",
      "type": "string",
      "noEcho": boolean,
      "allowedPattern": "string",
      "constraintDescription": "string",
      "minValue": integer,
      "maxValue": integer,
      "minLength": integer,
      "maxLength": integer,
      "allowedValues": [
        "string"
      ],
      "referencedByResources": [
        "string"
      ]
    }
  ],
  "requiredCapabilities": [
    enum
  ],
  "resourcesSupported": boolean
}
```

#### BadRequestException 스키마
<a name="applications-applicationid-versions-semanticversion-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### ForbiddenException 스키마
<a name="applications-applicationid-versions-semanticversion-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### ConflictException 스키마
<a name="applications-applicationid-versions-semanticversion-response-body-conflictexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### TooManyRequestsException 스키마
<a name="applications-applicationid-versions-semanticversion-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### InternalServerErrorException 스키마
<a name="applications-applicationid-versions-semanticversion-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## 속성
<a name="applications-applicationid-versions-semanticversion-properties"></a>

### BadRequestException
<a name="applications-applicationid-versions-semanticversion-model-badrequestexception"></a>

요청의 파라미터 중 하나가 잘못되었습니다.


| 속성 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| errorCode | 문자열 | False | 400 | 
| message | 문자열 | False | 요청의 파라미터 중 하나가 잘못되었습니다. | 

### Capability
<a name="applications-applicationid-versions-semanticversion-model-capability"></a>

일부 애플리케이션을 배포하기 위해 지정해야 하는 값입니다.
+ `CAPABILITY_IAM`
+ `CAPABILITY_NAMED_IAM`
+ `CAPABILITY_AUTO_EXPAND`
+ `CAPABILITY_RESOURCE_POLICY`

### ConflictException
<a name="applications-applicationid-versions-semanticversion-model-conflictexception"></a>

리소스가 이미 존재합니다.


| 속성 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| errorCode | 문자열 | False | 409 | 
| message | 문자열 | False | 리소스가 이미 존재합니다. | 

### CreateApplicationVersionInput
<a name="applications-applicationid-versions-semanticversion-model-createapplicationversioninput"></a>

버전 요청을 생성합니다.


| 속성 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| sourceCodeArchiveUrl | 문자열 | False | 이 버전의 애플리케이션에 대한 소스 코드의 ZIP 아카이브가 포함된 S3 객체에 대한 링크입니다.<br />최대 크기 50MB | 
| sourceCodeUrl | 문자열 | False | 특정 GitHub 커밋의 URL과 같은 애플리케이션의 소스 코드에 대한 퍼블릭 리포지토리에 대한 링크입니다. | 
| templateBody | 문자열 | False | 애플리케이션의 원시 패키지 AWS SAM 템플릿입니다. | 
| templateUrl | 문자열 | False | 애플리케이션의 패키징된 AWS SAM 템플릿에 대한 링크입니다. | 

### ForbiddenException
<a name="applications-applicationid-versions-semanticversion-model-forbiddenexception"></a>

클라이언트가 인증되지 않았습니다.


| 속성 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| errorCode | 문자열 | False | 403 | 
| message | 문자열 | False | 클라이언트가 인증되지 않았습니다. | 

### InternalServerErrorException
<a name="applications-applicationid-versions-semanticversion-model-internalservererrorexception"></a>

 AWS Serverless Application Repository 서비스에서 내부 오류가 발생했습니다.


| 속성 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| errorCode | 문자열 | False | 500 | 
| message | 문자열 | False |  AWS Serverless Application Repository 서비스에서 내부 오류가 발생했습니다. | 

### ParameterDefinition
<a name="applications-applicationid-versions-semanticversion-model-parameterdefinition"></a>

애플리케이션에서 지원하는 파라미터입니다.


| 속성 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| allowedPattern | 문자열 | False | `String` 유형에 허용할 패턴을 나타내는 정규식입니다. | 
| allowedValues | 유형 string의 배열 | False | 파라미터에 허용되는 값 목록을 포함하는 어레이입니다. | 
| constraintDescription | 문자열 | False | 제약 위반 시 해당 제약을 설명하는 문자열입니다. 예를 들어 제약 설명이 없으면 `[A-Za-z0-9]+` 패턴이 허용된 파라미터에 사용자가 유효하지 않은 값을 지정할 때 다음과 같은 오류 메시지가 표시됩니다.<br /> `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` <br />"대문자와 소문자 및 숫자만 포함해야 함"과 같은 제약 조건 설명을 추가하면 다음과 같은 사용자 지정 오류 메시지를 표시할 수 있습니다.<br /> `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.`  | 
| defaultValue | 문자열 | False | 스택 생성 시 지정된 값이 없는 경우에 사용할 템플릿에 적합한 유형의 값입니다. 파라미터에 대한 제약을 정의하는 경우 이러한 제약을 준수하는 값을 지정해야 합니다. | 
| description | 문자열 | False | 파라미터를 설명하는 최대 4,000자의 문자열입니다. | 
| maxLength | 정수 | False | `String` 유형에 허용할 최대 문자 수를 결정하는 정수 값입니다. | 
| maxValue | 정수 | False | `Number` 유형에 허용할 가장 큰 숫자 값을 결정하는 숫자 값입니다. | 
| minLength | 정수 | False | `String` 유형에 허용할 최소 문자 수를 결정하는 정수 값입니다. | 
| minValue | 정수 | False | `Number` 유형에 허용할 가장 작은 숫자 값을 결정하는 숫자 값입니다. | 
| 이름 | 문자열 | True | 파라미터의 이름입니다. | 
| noEcho | 부울 | False | 스택을 설명하는 호출을 할 때마다 파라미터 값을 마스킹할지 여부입니다. 값을 true로 설정하면 파라미터 값이 별표(\*\*\*\*\*)로 마스킹됩니다. | 
| referencedByResources | 유형 string의 배열 | True | 이 파라미터를 사용하는 AWS SAM 리소스 목록입니다. | 
| type | 문자열 | False | 파라미터의 유형입니다.<br />유효한 값: `String \| Number \| List<Number> \| CommaDelimitedList` <br /> `String`: 리터럴 문자열입니다.<br />예를 들어 사용자는를 지정할 수 있습니다`"MyUserName"`.<br /> `Number`: 정수 또는 float. CloudFormation valid는 파라미터 값을 숫자로 확인합니다. 그러나 템플릿의 다른 곳에서 파라미터를 사용하는 경우(예: `Ref` 내장 함수 사용) 파라미터 값은 문자열이 됩니다.<br />예를 들어 사용자는를 지정할 수 있습니다`"8888"`.<br /> `List<Number>`: 쉼표로 구분된 정수 또는 부동 소수점의 배열입니다. CloudFormation 는 파라미터 값을 숫자로 검증합니다. 그러나 템플릿의 다른 곳에서 파라미터를 사용하는 경우(예: `Ref` 내장 함수 사용) 파라미터 값은 문자열 목록이 됩니다.<br />예를 들어 사용자는 "80,20"을 지정한 다음를 `Ref` 생성할 수 있습니다`["80","20"]`.<br /> `CommaDelimitedList`: 쉼표로 구분된 리터럴 문자열의 배열입니다. 총 문자열 수는 총 쉼표 수보다 하나 더 많아야 합니다. 또한 각 멤버 문자열은 공백으로 잘립니다.<br />예를 들어 사용자는 "test,dev,prod"를 지정한 다음를 `Ref` 생성할 수 있습니다`["test","dev","prod"]`. | 

### TooManyRequestsException
<a name="applications-applicationid-versions-semanticversion-model-toomanyrequestsexception"></a>

클라이언트가 시간 단위당 허용된 요청 수를 초과하여 전송하고 있습니다.


| 속성 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| errorCode | 문자열 | False | 429 | 
| message | 문자열 | False | 클라이언트가 시간 단위당 허용된 요청 수를 초과하여 전송하고 있습니다. | 

### Version
<a name="applications-applicationid-versions-semanticversion-model-version"></a>

애플리케이션 버전 세부 정보입니다.


| 속성 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| applicationId | 문자열 | True |  애플리케이션 Amazon 리소스 이름(ARN). | 
| creationTime | 문자열 | True | 이 리소스가 생성된 날짜와 시간입니다. | 
| parameterDefinitions | 유형 [ParameterDefinition](#applications-applicationid-versions-semanticversion-model-parameterdefinition)의 배열 | True | 애플리케이션에서 지원하는 파라미터 유형의 배열입니다. | 
| requiredCapabilities | 유형 [Capability](#applications-applicationid-versions-semanticversion-model-capability)의 배열 | True | 특정 애플리케이션을 배포하기 전에 지정해야 하는 값 목록입니다. 일부 애플리케이션에는 새 AWS Identity and Access Management (IAM) 사용자를 생성하는 등 AWS 계정의 권한에 영향을 미칠 수 있는 리소스가 포함될 수 있습니다. 이러한 애플리케이션의 경우이 파라미터를 지정하여 해당 기능을 명시적으로 승인해야 합니다.<br />유일하게 유효한 값은 `CAPABILITY_IAM`, `CAPABILITY_RESOURCE_POLICY`, `CAPABILITY_NAMED_IAM`및 입니다`CAPABILITY_AUTO_EXPAND`.<br />다음 리소스에는 `CAPABILITY_IAM` 또는 `CAPABILITY_NAMED_IAM`을 지정해야 합니다. [AWS::IAM::Group](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html), [AWS::IAM::InstanceProfile](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html), [AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html), and [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html). 애플리케이션에 IAM 리소스가 포함된 경우 `CAPABILITY_IAM` 또는 중 하나를 지정할 수 있습니다`CAPABILITY_NAMED_IAM`. 애플리케이션에 사용자 지정 이름을 가진 IAM 리소스가 포함되어 있는 경우 `CAPABILITY_NAMED_IAM`을 지정해야 합니다.<br />AWS`CAPABILITY_RESOURCE_POLICY`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html), [AWS::IAM:Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html), [AWS::ApplicationAutoScaling::ScalingPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html), [AWS::S3::BucketPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html), [AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html) 및 [AWS::SNS::TopicPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html) 리소스를 지정해야 합니다.<br />중첩 애플리케이션을 한 개 이상 포함하는 애플리케이션은 `CAPABILITY_AUTO_EXPAND`를 지정해야 합니다.<br />애플리케이션 템플릿에 위의 리소스가 포함된 경우 배포하기 전에 애플리케이션과 연결된 모든 권한을 검토하는 것이 좋습니다. 기능이 필요한 애플리케이션에 대해이 파라미터를 지정하지 않으면 호출이 실패합니다. | 
| resourcesSupported | 부울 | True | 이 애플리케이션에 포함된 모든 AWS 리소스가 검색되는 리전에서 지원되는지 여부입니다. | 
| semanticVersion | 문자열 | True | 애플리케이션의 의미 체계 버전:<br /> [https://semver.org/](https://semver.org/)  | 
| sourceCodeArchiveUrl | 문자열 | False | 이 버전의 애플리케이션에 대한 소스 코드의 ZIP 아카이브가 포함된 S3 객체에 대한 링크입니다.<br />최대 크기 50MB | 
| sourceCodeUrl | 문자열 | False | 특정 GitHub 커밋의 URL과 같은 애플리케이션의 소스 코드에 대한 퍼블릭 리포지토리에 대한 링크입니다. | 
| templateUrl | 문자열 | True | 애플리케이션의 패키징된 AWS SAM 템플릿에 대한 링크입니다. | 

## 다음 사항도 참조하세요.
<a name="applications-applicationid-versions-semanticversion-see-also"></a>

언어별 AWS SDKs 및 참조 중 하나에서이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.

### CreateApplicationVersion
<a name="CreateApplicationVersion-see-also"></a>
+ [AWS 명령줄 인터페이스 V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [.NET V4용 AWS SDK](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK for C\+\+](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [Go v2용 AWS SDK](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK for Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [JavaScript V3용 AWS SDK](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [Kotlin용 AWS SDK](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK for PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK for Python](/goto/boto3/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK for Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplicationVersion)