翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Applications applicationId Versions 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`

アプリケーションバージョンを作成します。


**パスパラメータ**  

| 名前 | 型 | 必須 | 説明 | 
| --- |--- |--- |--- |
| {{applicationId}} | String | True | アプリケーションの Amazon リソースネーム (ARN) です。 | 
| {{semanticVersion}} | String | True | 新しいバージョンのセマンティックバージョン。 | 


**レスポンス**  

| ステータスコード | レスポンスモデル | 説明 | 
| --- |--- |--- |
| 201 | Version | Success | 
| 400 | BadRequestException | リクエストに含まれているパラメータの 1 つが無効です。 | 
| 403 | ForbiddenException | クライアントは認証されていません。 | 
| 409 | ConflictException | リソースは既に存在します。 | 
| 429 | TooManyRequestsException | クライアントが、単位時間あたりの許可されるリクエスト数よりも多くのリクエストを送信しています。 | 
| 500 | InternalServerErrorException |  AWS Serverless Application Repository サービスで内部エラーが発生しました。 | 

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


**パスパラメータ**  

| 名前 | 型 | 必須 | 説明 | 
| --- |--- |--- |--- |
| {{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>

リクエストに含まれているパラメータの 1 つが無効です。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| errorCode | string | False | 400 | 
| メッセージ | string | False | リクエストに含まれているパラメータの 1 つが無効です。 | 

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

リソースは既に存在します。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| errorCode | string | False | 409 | 
| メッセージ | string | False | リソースは既に存在します。 | 

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

バージョンリクエストを作成します。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| sourceCodeArchiveUrl | string | False | アプリケーションのこのバージョンのソースコードの ZIP アーカイブを含む S3 オブジェクトへのリンク。<br />最大サイズ: 50 MB。 | 
| SourceCodeUrl | string | False | 特定の GitHub コミットの URL など、アプリケーションのソースコードのパブリックリポジトリへのリンク。 | 
| templateBody | string | False | アプリケーションの raw パッケージ AWS SAM テンプレート。 | 
| templateUrl | string | False | アプリケーションのパッケージ化された AWS SAM テンプレートへのリンク。 | 

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

クライアントは認証されていません。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| errorCode | string | False | 403 | 
| メッセージ | string | False | クライアントは認証されていません。 | 

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

 AWS Serverless Application Repository サービスで内部エラーが発生しました。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| errorCode | string | False | 500 | 
| メッセージ | string | False |  AWS Serverless Application Repository サービスで内部エラーが発生しました。 | 

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

アプリケーションでサポートされるパラメータ。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| allowedPattern | string | False | `String` 型に使用できるパターンを表す正規表現。 | 
| allowedValues | string タイプの配列 | False | パラメーターに許容される一連の値を含む配列。 | 
| constraintDescription | string | False | 制約が違反された場合に、制約について説明する文字列。たとえば、制約の説明を指定しないとき、許容されているパターンが `[A-Za-z0-9]+` であるパラメーターの場合、ユーザーが無効な値を指定すると次のエラーメッセージが表示されます。<br /> `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` <br />「must contain only uppercase and lowercase letters and numbers」などの制約の説明を追加することによって、次のようにカスタマイズされたエラーメッセージを表示することができます。<br /> `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.`  | 
| defaultValue | string | False | スタックの作成時に値を指定しなかった場合に、テンプレートで使用される適切な型の値。パラメーターの制約を定義する場合は、これらの制約に従う値を指定する必要があります。 | 
| 説明 | string | False | パラメータについて説明する最大 4000 文字の文字列。 | 
| maxLength | integer | False | `String` タイプに使用できる最大文字数を決定する整数値。 | 
| maxValue | integer | False | `Number` タイプに使用できる数値の最大値を決定する数値。 | 
| minLength | integer | False | `String` タイプに使用できる最小文字数を決定する整数値。 | 
| minValue | integer | False | `Number` タイプに使用できる数値の最小値を決定する数値。 | 
| 名前 | string | True | パラメータの名前。 | 
| noEcho | boolean | False | スタックの詳細を取得する呼び出しが他のユーザーによって作成された場合に、必ずパラメータ値をマスクするかどうか。値を true に設定すると、パラメータ値はアスタリスク (\*\*\*\*\*) でマスクされます。 | 
| referencedByResources | string タイプの配列 | True | このパラメータを使用する AWS SAM リソースのリスト。 | 
| 型 | string | False | パラメータのタイプ。<br />有効な値: `String \| Number \| List<Number> \| CommaDelimitedList` <br /> `String`: リテラル文字列。<br />例えば、`"MyUserName"` と指定することができます。<br /> `Number`: 整数または float. CloudFormation validates the parameter value as a number。ただし、テンプレート内の他の場所で使用した場合には (`Ref` 組み込み関数を使用した場合など) 文字列として扱います。<br />例えば、`"8888"` のように指定することがができます。<br /> `List<Number>`: カンマで区切られた整数または浮動小数値の配列。 CloudFormation はパラメータ値を数値として検証します。ただし、テンプレート内の他の場所で使用した場合には (`Ref` 組み込み関数を使用した場合など) 文字列のリストとして扱います。<br />例えば、「80,20」を指定すると、`Ref` は `["80","20"]` になります。<br /> `CommaDelimitedList`: カンマで区切られたリテラル文字列の配列。文字列の合計数は、カンマの合計数よりも 1 つ多いはずです。また、各メンバー文字列の前後の空白は削除されます。<br />例えば、「test,dev,prod」を指定すると、`Ref` は `["test","dev","prod"]` になります。 | 

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

クライアントが、単位時間あたりの許可されるリクエスト数よりも多くのリクエストを送信しています。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| errorCode | string | False | 429 | 
| メッセージ | string | False | クライアントが、単位時間あたりの許可されるリクエスト数よりも多くのリクエストを送信しています。 | 

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

アプリケーションのバージョンの詳細。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| applicationId | string | True | アプリケーションの Amazon リソースネーム (ARN)。 | 
| creationTime | string | 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_NAMED_IAM`、`CAPABILITY_RESOURCE_POLICY`、および `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)、および [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 />以下のリソースでは、`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 />1 つまたは複数のネストされたアプリケーションが含まれているアプリケーションでは、`CAPABILITY_AUTO_EXPAND` を指定する必要があります。<br />アプリケーションテンプレートに前述のリソースが含まれている場合、デプロイする前にアプリケーションに関連付けられたすべてのアクセス許可を確認することをお勧めします。機能を必要とするアプリケーションにこのパラメータを指定しないと、呼び出しは失敗します。 | 
| resourcesSupported | boolean | True | このアプリケーションに含まれるすべての AWS リソースが、取得するリージョンでサポートされているかどうか。 | 
| semanticVersion | string | True | アプリケーションのセマンティックバージョン：<br /> [https://semver.org/](https://semver.org/)  | 
| sourceCodeArchiveUrl | string | False | アプリケーションのこのバージョンのソースコードの ZIP アーカイブを含む S3 オブジェクトへのリンク。<br />最大サイズ: 50 MB。 | 
| SourceCodeUrl | string | False | 特定の GitHub コミットの URL など、アプリケーションのソースコードのパブリックリポジトリへのリンク。 | 
| templateUrl | string | 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)
+ [AWS SDK for .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK for C\+\+](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK for Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK for Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK for JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK for Kotlin](/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)