本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # Resources AWS Serverless Application Repository REST API 包含下列資源。 **Topics** + [Applications](applications.md) + [應用程式 applicationId](applications-applicationid.md) + [應用程式 applicationId 變更集](applications-applicationid-changesets.md) + [Applications applicationId Dependencies](applications-applicationid-dependencies.md) + [應用程式 applicationId 政策](applications-applicationid-policy.md) + [Applications applicationId Templates](applications-applicationid-templates.md) + [Applications applicationId Templates templateId](applications-applicationid-templates-templateid.md) + [Applications applicationId Unshare](applications-applicationid-unshare.md) + [應用程式 applicationId 版本](applications-applicationid-versions.md) + [應用程式 applicationId 版本semanticVersion](applications-applicationid-versions-semanticversion.md) # Applications ## URI `/applications` ## HTTP 方法 ### GET **操作 ID：**`ListApplications` 列出請求者擁有的應用程式。 **查詢參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | maxItems | String | False | 要傳回的項目總數。 | | nextToken | String | False | 用以指定分頁開始位置的字符。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | ApplicationPage | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### POST **操作 ID：**`CreateApplication` 建立應用程式，選擇性地包含 AWS SAM 檔案，以在相同的呼叫中建立第一個應用程式版本。 **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 201 | Application | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 409 | ConflictException | 此資源已存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### OPTIONS **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ## 結構描述 ### 請求內文 #### POST 結構描述 ``` { "name": "string", "description": "string", "author": "string", "spdxLicenseId": "string", "licenseBody": "string", "licenseUrl": "string", "readmeBody": "string", "readmeUrl": "string", "labels": [ "string" ], "homePageUrl": "string", "semanticVersion": "string", "templateBody": "string", "templateUrl": "string", "sourceCodeUrl": "string", "sourceCodeArchiveUrl": "string" } ``` ### 回應內文 #### ApplicationPage 結構描述 ``` { "applications": [ { "applicationId": "string", "name": "string", "description": "string", "author": "string", "spdxLicenseId": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string" } ], "nextToken": "string" } ``` #### Application 結構描述 ``` { "applicationId": "string", "name": "string", "description": "string", "author": "string", "isVerifiedAuthor": boolean, "verifiedAuthorUrl": "string", "spdxLicenseId": "string", "licenseUrl": "string", "readmeUrl": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string", "version": { "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 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### NotFoundException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ConflictException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### Application 有關應用程式的詳細資訊。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | 作者 | string | True | 發佈應用程式的作者名稱。最小長度 = 1。最大長度 = 127。模式 "^【a-z0-9】((【a-z0-9】\$1-(？！-))\$1【a-z0-9】)？\$1"； | | creationTime | string | False | 建立此資源的日期和時間。 | | 描述 | string | True | 應用程式的描述。最小長度 = 1。長度上限 = 256 | | homePageUrl | string | False | 包含應用程式詳細資訊的 URL，例如應用程式的 GitHub 儲存庫位置。 | | isVerifiedAuthor | boolean | False | 指定是否已驗證此應用程式的作者。這表示 AWS 已以合理且謹慎的服務提供者身分，對申請者提供的資訊進行誠意審查，並確認申請者的身分已宣告。 | | labels | 類型 string 的陣列 | False | 用於改善搜尋結果中應用程式探索的標籤。最小長度 = 1。最大長度 = 127。標籤數量上限：10模式："^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | licenseUrl | string | False | 與應用程式 spdxLicenseID 值相符的應用程式授權檔案連結。大小上限為 5 MB | | name | string | True | 應用程式名稱。最小長度 = 1。長度上限 = 140模式："[a-zA-Z0-9\$1\$1-]\$1"; | | readmeUrl | string | False | Markdown 語言的讀我檔案連結，其中包含應用程式及其運作方式的更詳細說明。大小上限為 5 MB | | spdxLicenseId | string | False | 來自 https://spdx.org/licenses/ 的有效識別符。 | | verifiedAuthorUrl | string | False | 已驗證作者的公有設定檔 URL。此 URL 是由作者提交。 | | version | [版本](#applications-model-version) | False | 有關應用程式的版本資訊。 | ### ApplicationPage 應用程式詳細資訊清單。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | 應用程式 | 類型 [ApplicationSummary](#applications-model-applicationsummary) 的陣列 | True | 應用程式摘要的陣列。 | | nextToken | string | False | 請求下一頁結果的字符。 | ### ApplicationSummary 有關應用程式的詳細資訊摘要。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | 作者 | string | True | 發佈應用程式的作者名稱。最小長度 = 1。最大長度 = 127。模式 "^【a-z0-9】((【a-z0-9】\$1-(？！-))\$1【a-z0-9】)？\$1"； | | creationTime | string | False | 建立此資源的日期和時間。 | | 描述 | string | True | 應用程式的描述。最小長度 = 1。長度上限 = 256 | | homePageUrl | string | False | 包含應用程式詳細資訊的 URL，例如應用程式的 GitHub 儲存庫位置。 | | labels | 類型 string 的陣列 | False | 用於改善搜尋結果中應用程式探索的標籤。最小長度 = 1。最大長度 = 127。標籤數量上限：10模式："^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | name | string | True | 應用程式名稱。最小長度 = 1。長度上限 = 140模式："[a-zA-Z0-9\$1\$1-]\$1"; | | spdxLicenseId | string | False | 來自 [https://spdx.org/licenses/](https://spdx.org/licenses/) 的有效識別符。 | ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### Capability 必須指定才能部署某些應用程式的值。 + `CAPABILITY_IAM` + `CAPABILITY_NAMED_IAM` + `CAPABILITY_AUTO_EXPAND` + `CAPABILITY_RESOURCE_POLICY` ### ConflictException 此資源已存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 409 | | message | string | False | 此資源已存在。 | ### CreateApplicationInput 建立應用程式請求。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | 作者 | string | True | 發佈應用程式的作者名稱。最小長度 = 1。最大長度 = 127。模式 "^【a-z0-9】((【a-z0-9】\$1-(？！-))\$1【a-z0-9】)？\$1"； | | 描述 | string | True | 應用程式的描述。最小長度 = 1。長度上限 = 256 | | homePageUrl | string | False | 包含應用程式詳細資訊的 URL，例如應用程式的 GitHub 儲存庫位置。 | | labels | 類型 string 的陣列 | False | 用於改善搜尋結果中應用程式探索的標籤。最小長度 = 1。最大長度 = 127。標籤數量上限：10模式："^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | licenseBody | string | False | 本機文字檔案，其中包含與應用程式 spdxLicenseID 值相符的應用程式授權。檔案的格式為 `file:///`。大小上限為 5 MB您只能指定 `licenseBody`和的其中一個，`licenseUrl`否則會指定錯誤結果。 | | licenseUrl | string | False | S3 物件的連結，其中包含與應用程式 spdxLicenseID 值相符的應用程式授權。大小上限為 5 MB您只能指定 `licenseBody`和的其中一個，`licenseUrl`否則會指定錯誤結果。 | | name | string | True | 您要發佈的應用程式名稱。最小長度 = 1。長度上限 = 140模式："[a-zA-Z0-9\$1\$1-]\$1"; | | readmeBody | string | False | Markdown 語言的本機文字讀我檔案，其中包含應用程式及其運作方式的更詳細說明。檔案的格式為 `file:///`。大小上限為 5 MB您只能指定 `readmeBody`和的其中一個，`readmeUrl`否則會指定錯誤結果。 | | readmeUrl | string | False | 以 Markdown 語言指向 S3 物件的連結，其中包含應用程式及其運作方式的更詳細說明。大小上限為 5 MB您只能指定 `readmeBody`和的其中一個，`readmeUrl`否則會指定錯誤結果。 | | semanticVersion | string | False | 應用程式語意版本： [https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | string | False | S3 物件的連結，其中包含此應用程式版本原始碼的 ZIP 封存。大小上限為 50 MB | | sourceCodeUrl | string | False | 應用程式原始碼的公有儲存庫連結，例如特定 GitHub 遞交的 URL。 | | spdxLicenseId | string | False | 來自 [https://spdx.org/licenses/](https://spdx.org/licenses/) 的有效識別符。 | | templateBody | string | False | 應用程式的本機原始封裝 AWS SAM 範本檔案。檔案的格式為 `file:///`。您只能指定其中一個 `templateBody`和 `templateUrl`；否則會指定錯誤結果。 | | templateUrl | string | False | 包含應用程式封裝 AWS SAM 範本的 S3 物件連結。您只能指定其中一個 `templateBody`和 `templateUrl`；否則會指定錯誤結果。 | ### ForbiddenException 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務發生內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務發生內部錯誤。 | ### NotFoundException 請求中指定的資源（例如，存取政策陳述式）不存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 404 | | message | string | False | 請求中指定的資源（例如，存取政策陳述式）不存在。 | ### ParameterDefinition 應用程式支援的參數。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | allowedPattern | string | False | 規則表達式，代表 `String` 類型允許的模式。 | | allowedValues | 類型 string 的陣列 | False | 陣列，包含參數的允許值清單。 | | constraintDescription | string | False | 字串，說明違反限制時的限制。例如，具有允許模式 `[A-Za-z0-9]+` 的參數會在使用者指定無效值時顯示下列錯誤訊息，但沒有限制描述： `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` 透過新增限制描述，例如「必須僅包含大寫和小寫字母和數字」，您可以顯示下列自訂錯誤訊息： `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.` | | defaultValue | string | False | 建立堆疊時，範本要在未指定值時使用的適當類型值。如果您定義參數的限制，則必須指定遵循這些限制的值。 | | 描述 | string | False | 最多 4，000 個字元的字串，描述參數。 | | maxLength | integer | False | 整數值，決定您要允許 `String`類型的最大字元數。 | | maxValue | integer | False | 數值，決定您要允許 `Number`類型的最大數值。 | | minLength | integer | False | 整數值，決定您想要允許 `String`類型使用的最小字元數。 | | minValue | integer | False | 數值，決定您想要允許 `Number`類型的最小數值。 | | name | string | True | 參數名稱。 | | noEcho | boolean | False | 是否在任何人進行描述堆疊的呼叫時遮罩參數值。如果您將值設定為 true，參數值會以星號 (\$1\$1\$1\$1\$1) 遮罩。 | | referencedByResources | 類型 string 的陣列 | True | 使用此參數 AWS SAM 的資源清單。 | | type | string | False | 參數的類型。有效值：`String \| Number \| List \| CommaDelimitedList` `String`：常值字串。例如，使用者可以指定 `"MyUserName"`。 `Number`：整數或 float. CloudFormation valid 會將參數值驗證為數字。不過，當您在範本的其他位置使用參數（例如，使用`Ref`內部函數）時，參數值會變成字串。例如，使用者可以指定 `"8888"`。 `List`：以逗號分隔的整數或浮點數陣列。 CloudFormation 會將參數值驗證為數字。不過，當您在範本的其他位置使用參數（例如，使用`Ref`內部函數）時，參數值會成為字串清單。例如，使用者可能會指定「80，20」，然後`Ref`產生 `["80","20"]`。 `CommaDelimitedList`：以逗號分隔的常值字串陣列。字串總數應該比逗號總數多一個。此外，每個成員字串都是空格修剪的。例如，使用者可能會指定 "test，dev，prod"，然後`Ref`產生 `["test","dev","prod"]`。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ### Version 應用程式版本詳細資訊。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | creationTime | string | True | 建立此資源的日期和時間。 | | parameterDefinitions | 類型 [ParameterDefinition](#applications-model-parameterdefinition) 的陣列 | True | 應用程式支援的參數類型陣列。 | | requiredCapabilities | 類型 [Capability](#applications-model-capability) 的陣列 | True | 您必須先指定的值清單，才能部署特定應用程式。有些應用程式可能包含可能會影響您 AWS 帳戶中許可的資源，例如，建立新的 AWS Identity and Access Management (IAM) 使用者。對於這些應用程式，您必須指定此參數來明確認可其功能。唯一有效的值是 `CAPABILITY_IAM`、`CAPABILITY_RESOURCE_POLICY`、 `CAPABILITY_NAMED_IAM`和 `CAPABILITY_AUTO_EXPAND`。下列資源需要由您指定 `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`。下列資源需要由您指定 `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)。包含一個或多個巢狀應用程式的應用程式需要由您指定 `CAPABILITY_AUTO_EXPAND`。如果您的應用程式範本包含上述任何資源，建議您在部署之前檢閱與應用程式相關聯的所有許可。如果您未為需要功能的應用程式指定此參數，呼叫將會失敗。 | | resourcesSupported | boolean | True | 此應用程式中包含的所有 AWS 資源是否都支援擷取該資源的區域。 | | semanticVersion | string | True | 應用程式語意版本： [https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | string | False | S3 物件的連結，其中包含此應用程式版本原始碼的 ZIP 封存。大小上限為 50 MB | | sourceCodeUrl | string | False | 應用程式原始碼的公有儲存庫連結，例如特定 GitHub 遞交的 URL。 | | templateUrl | string | True | 應用程式封裝 AWS SAM 範本的連結。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### ListApplications + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/ListApplications) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/ListApplications) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/ListApplications) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/ListApplications) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/ListApplications) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/ListApplications) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/ListApplications) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/ListApplications) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/ListApplications) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/ListApplications) ### CreateApplication + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplication) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplication) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplication) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplication) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplication) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplication) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplication) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplication) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/CreateApplication) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplication) # 應用程式 applicationId ## URI `/applications/applicationId` ## HTTP 方法 ### GET **操作 ID：**`GetApplication` 取得指定的應用程式。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **查詢參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | semanticVersion | String | False | 要取得的應用程式語意版本。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | Application | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### DELETE **操作 ID：**`DeleteApplication` 刪除指定的應用程式。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 204 | None | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 409 | ConflictException | 此資源已存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### OPTIONS **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ### PATCH **操作 ID：**`UpdateApplication` 更新指定的應用程式。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | Application | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 409 | ConflictException | 此資源已存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ## 結構描述 ### 請求內文 #### PATCH 結構描述 ``` { "description": "string", "author": "string", "readmeBody": "string", "readmeUrl": "string", "labels": [ "string" ], "homePageUrl": "string" } ``` ### 回應內文 #### Application 結構描述 ``` { "applicationId": "string", "name": "string", "description": "string", "author": "string", "isVerifiedAuthor": boolean, "verifiedAuthorUrl": "string", "spdxLicenseId": "string", "licenseUrl": "string", "readmeUrl": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string", "version": { "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 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### NotFoundException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ConflictException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### Application 有關應用程式的詳細資訊。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | 作者 | string | True | 發佈應用程式的作者名稱。最小長度 = 1。最大長度 = 127。模式 "^【a-z0-9】((【a-z0-9】\$1-(？！-))\$1【a-z0-9】)？\$1"； | | creationTime | string | False | 建立此資源的日期和時間。 | | 描述 | string | True | 應用程式的描述。最小長度 = 1。長度上限 = 256 | | homePageUrl | string | False | 包含應用程式詳細資訊的 URL，例如應用程式的 GitHub 儲存庫位置。 | | isVerifiedAuthor | boolean | False | 指定是否已驗證此應用程式的作者。這表示 AWS 已以合理且謹慎的服務提供者身分，對申請者提供的資訊進行誠意審查，並確認申請者的身分已宣告。 | | labels | 類型 string 的陣列 | False | 用於改善搜尋結果中應用程式探索的標籤。最小長度 = 1。最大長度 = 127。標籤數量上限：10模式："^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | licenseUrl | string | False | 與應用程式 spdxLicenseID 值相符的應用程式授權檔案連結。大小上限為 5 MB | | name | string | True | 應用程式名稱。最小長度 = 1。長度上限 = 140模式："[a-zA-Z0-9\$1\$1-]\$1"; | | readmeUrl | string | False | Markdown 語言的讀我檔案連結，其中包含應用程式及其運作方式的更詳細說明。大小上限為 5 MB | | spdxLicenseId | string | False | 來自 https://spdx.org/licenses/ 的有效識別符。 | | verifiedAuthorUrl | string | False | 已驗證作者的公有設定檔 URL。此 URL 是由作者提交。 | | version | [版本](#applications-applicationid-model-version) | False | 有關應用程式的版本資訊。 | ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### Capability 必須指定才能部署某些應用程式的值。 + `CAPABILITY_IAM` + `CAPABILITY_NAMED_IAM` + `CAPABILITY_AUTO_EXPAND` + `CAPABILITY_RESOURCE_POLICY` ### ConflictException 此資源已存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 409 | | message | string | False | 此資源已存在。 | ### ForbiddenException 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務發生內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務發生內部錯誤。 | ### NotFoundException 請求中指定的資源（例如，存取政策陳述式）不存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 404 | | message | string | False | 請求中指定的資源（例如，存取政策陳述式）不存在。 | ### ParameterDefinition 應用程式支援的參數。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | allowedPattern | string | False | 規則表達式，代表 `String` 類型允許的模式。 | | allowedValues | 類型 string 的陣列 | False | 陣列，包含參數的允許值清單。 | | constraintDescription | string | False | 字串，說明違反限制時的限制。例如，具有允許模式 `[A-Za-z0-9]+` 的參數會在使用者指定無效值時顯示下列錯誤訊息，但沒有限制描述： `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` 透過新增限制描述，例如「必須僅包含大寫和小寫字母和數字」，您可以顯示下列自訂錯誤訊息： `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.` | | defaultValue | string | False | 建立堆疊時，範本要在未指定值時使用的適當類型值。如果您定義參數的限制，則必須指定遵循這些限制的值。 | | 描述 | string | False | 最多 4，000 個字元的字串，描述參數。 | | maxLength | integer | False | 整數值，決定您要允許 `String`類型的最大字元數。 | | maxValue | integer | False | 數值，決定您要允許 `Number`類型的最大數值。 | | minLength | integer | False | 整數值，決定您想要允許 `String`類型使用的最小字元數。 | | minValue | integer | False | 數值，決定您想要允許 `Number`類型的最小數值。 | | name | string | True | 參數名稱。 | | noEcho | boolean | False | 是否在任何人進行描述堆疊的呼叫時遮罩參數值。如果您將值設定為 true，參數值會以星號 (\$1\$1\$1\$1\$1) 遮罩。 | | referencedByResources | 類型 string 的陣列 | True | 使用此參數 AWS SAM 的資源清單。 | | type | string | False | 參數的類型。有效值：`String \| Number \| List \| CommaDelimitedList` `String`：常值字串。例如，使用者可以指定 `"MyUserName"`。 `Number`：整數或 float. CloudFormation valid 會將參數值驗證為數字。不過，當您在範本的其他位置使用參數（例如，使用`Ref`內部函數）時，參數值會變成字串。例如，使用者可以指定 `"8888"`。 `List`：以逗號分隔的整數或浮點數陣列。 CloudFormation 會將參數值驗證為數字。不過，當您在範本的其他位置使用參數（例如，使用`Ref`內部函數）時，參數值會成為字串清單。例如，使用者可能會指定「80，20」，然後`Ref`產生 `["80","20"]`。 `CommaDelimitedList`：以逗號分隔的常值字串陣列。字串總數應該比逗號總數多一個。此外，每個成員字串都是空格修剪的。例如，使用者可能會指定 "test，dev，prod"，然後`Ref`產生 `["test","dev","prod"]`。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ### UpdateApplicationInput 更新應用程式請求。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | 作者 | string | False | 發佈應用程式的作者名稱。最小長度 = 1。最大長度 = 127。模式 "^【a-z0-9】((【a-z0-9】\$1-(？！-))\$1【a-z0-9】)？\$1"； | | 描述 | string | False | 應用程式的描述。最小長度 = 1。長度上限 = 256 | | homePageUrl | string | False | 包含應用程式詳細資訊的 URL，例如應用程式的 GitHub 儲存庫位置。 | | labels | 類型 string 的陣列 | False | 用於改善搜尋結果中應用程式探索的標籤。最小長度 = 1。最大長度 = 127。標籤數量上限：10模式："^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | readmeBody | string | False | Markdown 語言的文字讀我檔案，其中包含應用程式及其運作方式的更詳細說明。大小上限為 5 MB | | readmeUrl | string | False | Markdown 語言的讀我檔案連結，其中包含應用程式及其運作方式的更詳細說明。大小上限為 5 MB | ### Version 應用程式版本詳細資訊。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | creationTime | string | True | 建立此資源的日期和時間。 | | parameterDefinitions | 類型 [ParameterDefinition](#applications-applicationid-model-parameterdefinition) 的陣列 | True | 應用程式支援的參數類型陣列。 | | requiredCapabilities | 類型 [Capability](#applications-applicationid-model-capability) 的陣列 | True | 您必須先指定的值清單，才能部署特定應用程式。有些應用程式可能包含可能會影響您 AWS 帳戶中許可的資源，例如，建立新的 AWS Identity and Access Management (IAM) 使用者。對於這些應用程式，您必須指定此參數來明確認可其功能。唯一有效的值是 `CAPABILITY_IAM`、`CAPABILITY_RESOURCE_POLICY`、 `CAPABILITY_NAMED_IAM`和 `CAPABILITY_AUTO_EXPAND`。下列資源需要由您指定 `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`。下列資源需要由您指定 `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)。包含一個或多個巢狀應用程式的應用程式需要由您指定 `CAPABILITY_AUTO_EXPAND`。如果您的應用程式範本包含上述任何資源，建議您在部署之前檢閱與應用程式相關聯的所有許可。如果您未為需要功能的應用程式指定此參數，呼叫將會失敗。 | | resourcesSupported | boolean | True | 此應用程式中包含的所有 AWS 資源是否都支援擷取該資源的區域。 | | semanticVersion | string | True | 應用程式語意版本： [https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | string | False | S3 物件的連結，其中包含此應用程式版本原始碼的 ZIP 封存。大小上限為 50 MB | | sourceCodeUrl | string | False | 應用程式原始碼的公有儲存庫連結，例如特定 GitHub 遞交的 URL。 | | templateUrl | string | True | 應用程式封裝 AWS SAM 範本的連結。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### GetApplication + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/GetApplication) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/GetApplication) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/GetApplication) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/GetApplication) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/GetApplication) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/GetApplication) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/GetApplication) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/GetApplication) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/GetApplication) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/GetApplication) ### DeleteApplication + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/DeleteApplication) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/DeleteApplication) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/DeleteApplication) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/DeleteApplication) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/DeleteApplication) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/DeleteApplication) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/DeleteApplication) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/DeleteApplication) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/DeleteApplication) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/DeleteApplication) ### UpdateApplication + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/UpdateApplication) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/UpdateApplication) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/UpdateApplication) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/UpdateApplication) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/UpdateApplication) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/UpdateApplication) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/UpdateApplication) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/UpdateApplication) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/UpdateApplication) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/UpdateApplication) # 應用程式 applicationId 變更集 ## URI `/applications/applicationId/changesets` ## HTTP 方法 ### POST **操作 ID：**`CreateCloudFormationChangeSet` 為指定的應用程式建立 AWS CloudFormation 變更集。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 201 | ChangeSetDetails | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### OPTIONS **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ## 結構描述 ### 請求內文 #### POST 結構描述 ``` { "stackName": "string", "semanticVersion": "string", "templateId": "string", "parameterOverrides": [ { "name": "string", "value": "string" } ], "capabilities": [ "string" ], "changeSetName": "string", "clientToken": "string", "description": "string", "notificationArns": [ "string" ], "resourceTypes": [ "string" ], "rollbackConfiguration": { "rollbackTriggers": [ { "arn": "string", "type": "string" } ], "monitoringTimeInMinutes": integer }, "tags": [ { "key": "string", "value": "string" } ] } ``` ### 回應內文 #### ChangeSetDetails 結構描述 ``` { "applicationId": "string", "semanticVersion": "string", "changeSetId": "string", "stackId": "string" } ``` #### BadRequestException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### ChangeSetDetails 變更集的詳細資訊。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | changeSetId | string | True | 變更集的 Amazon Resource Name (ARN)。長度限制：長度下限為 1。模式：ARN：【-a-zA-Z0-9：/】\$1 | | semanticVersion | string | True | 應用程式語意版本： [https://semver.org/](https://semver.org/) | | stackId | string | True | 堆疊的唯一 ID。 | ### CreateCloudFormationChangeSetInput 建立應用程式變更集請求。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | capabilities | 類型 string 的陣列 | False | 您必須先指定的值清單，才能部署特定應用程式。有些應用程式可能包含可能會影響您 AWS 帳戶中許可的資源，例如，建立新的 AWS Identity and Access Management (IAM) 使用者。對於這些應用程式，您必須指定此參數來明確認可其功能。唯一有效的值是 `CAPABILITY_IAM`、`CAPABILITY_RESOURCE_POLICY`、 `CAPABILITY_NAMED_IAM`和 `CAPABILITY_AUTO_EXPAND`。下列資源需要由您指定 `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`。下列資源需要您指定 `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)。包含一個或多個巢狀應用程式的應用程式需要由您指定 `CAPABILITY_AUTO_EXPAND`。如果您的應用程式範本包含上述任何資源，建議您在部署之前檢閱與應用程式相關聯的所有許可。如果您未為需要功能的應用程式指定此參數，呼叫將會失敗。 | | changeSetName | string | False | 此屬性對應至 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) * API 相同名稱的參數。 | | clientToken | string | False | 此屬性對應至 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) * API 相同名稱的參數。 | | 描述 | string | False | 此屬性對應至 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) * API 相同名稱的參數。 | | notificationArns | 類型 string 的陣列 | False | 此屬性對應至 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) * API 相同名稱的參數。 | | parameterOverrides | 類型 [ParameterValue](#applications-applicationid-changesets-model-parametervalue) 的陣列 | False | 應用程式參數的參數值清單。 | | resourceTypes | 類型 string 的陣列 | False | 此屬性對應至 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) * API 相同名稱的參數。 | | rollbackConfiguration | [RollbackConfiguration](#applications-applicationid-changesets-model-rollbackconfiguration) | False | 此屬性對應至 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) * API 相同名稱的參數。 | | semanticVersion | string | False | 應用程式語意版本： [https://semver.org/](https://semver.org/) | | stackName | string | True | 此屬性對應至 *CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) * API 相同名稱的參數。 | | 標籤 | 類型 [Tag](#applications-applicationid-changesets-model-tag) 的陣列 | False | 此屬性對應至 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) * API 相同名稱的參數。 | | templateId | string | False | CreateCloudFormationTemplate 傳回的 UUID。模式：【0-9a-fA-F】\$18\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$112\$1 | ### ForbiddenException 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務發生內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務發生內部錯誤。 | ### ParameterValue 應用程式參數值。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | name | string | True | 與參數相關聯的金鑰。如果您未指定特定參數的金鑰和值， CloudFormation 會使用範本中指定的預設值。 | | value | string | True | 與參數關聯的輸入值。 | ### RollbackConfiguration 此屬性對應至 *CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration) * 資料類型。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | monitoringTimeInMinutes | integer | False | 此屬性對應至 *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration) * 資料類型的相同名稱內容。 | | rollbackTriggers | 類型 [RollbackTrigger](#applications-applicationid-changesets-model-rollbacktrigger) 的陣列 | False | 此屬性對應至 *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration) * 資料類型的相同名稱內容。 | ### RollbackTrigger 此屬性對應於 *CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger) * 資料類型。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | arn | string | True | 此屬性對應於 *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger) * 資料類型的相同名稱內容。 | | type | string | True | 此屬性對應於 *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger) * 資料類型的相同名稱內容。 | ### Tag 此屬性對應至*CloudFormation [標籤](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*資料類型。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | 金鑰 | string | True | 此屬性對應至*AWS CloudFormation [標籤](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*資料類型的相同名稱內容。 | | value | string | True | 此屬性對應至*AWS CloudFormation [標籤](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*資料類型的相同名稱內容。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### CreateCloudFormationChangeSet + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) # Applications applicationId Dependencies ## URI `/applications/applicationId/dependencies` ## HTTP 方法 ### GET **操作 ID：**`ListApplicationDependencies` 擷取包含在包含應用程式中巢狀的應用程式清單。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **查詢參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | nextToken | String | False | 用以指定分頁開始位置的字符。 | | maxItems | String | False | 要傳回的項目總數。 | | semanticVersion | String | False | 要取得的應用程式語意版本。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | ApplicationDependencyPage | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務遇到內部錯誤。 | ### OPTIONS **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ## 結構描述 ### 回應內文 #### ApplicationDependencyPage 結構描述 ``` { "dependencies": [ { "applicationId": "string", "semanticVersion": "string" } ], "nextToken": "string" } ``` #### BadRequestException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### NotFoundException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### ApplicationDependencyPage 應用程式中巢狀的應用程式摘要清單。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | dependencies | 類型 [ApplicationDependencySummary](#applications-applicationid-dependencies-model-applicationdependencysummary) 的陣列 | True | 巢狀在應用程式中的應用程式摘要陣列。 | | nextToken | string | False | 請求下一頁結果的字符。 | ### ApplicationDependencySummary 巢狀應用程式摘要。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 巢狀應用程式的 Amazon Resource Name (ARN)。 | | semanticVersion | string | True | 巢狀應用程式的語意版本。 | ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### ForbiddenException 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務遇到內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務遇到內部錯誤。 | ### NotFoundException 請求中指定的資源（例如，存取政策陳述式）不存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 404 | | message | string | False | 請求中指定的資源（例如，存取政策陳述式）不存在。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### ListApplicationDependencies + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/ListApplicationDependencies) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/ListApplicationDependencies) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/ListApplicationDependencies) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/ListApplicationDependencies) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/ListApplicationDependencies) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/ListApplicationDependencies) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/ListApplicationDependencies) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/ListApplicationDependencies) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/ListApplicationDependencies) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/ListApplicationDependencies) # 應用程式 applicationId 政策 ## URI `/applications/applicationId/policy` ## HTTP 方法 ### GET **操作 ID：**`GetApplicationPolicy` 擷取應用程式的政策。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | ApplicationPolicy | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務遇到內部錯誤。 | ### PUT **操作 ID：**`PutApplicationPolicy` 設定應用程式的許可政策。如需此操作支援的動作清單，請參閱[應用程式許可](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/access-control-resource-based.html#application-permissions)。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | ApplicationPolicy | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### OPTIONS **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ## 結構描述 ### 請求內文 #### PUT 結構描述 ``` { "statements": [ { "statementId": "string", "principals": [ "string" ], "actions": [ "string" ], "principalOrgIDs": [ "string" ] } ] } ``` ### 回應內文 #### ApplicationPolicy 結構描述 ``` { "statements": [ { "statementId": "string", "principals": [ "string" ], "actions": [ "string" ], "principalOrgIDs": [ "string" ] } ] } ``` #### BadRequestException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### NotFoundException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### ApplicationPolicy 套用至應用程式的政策陳述式。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | 陳述式 | 類型 [ApplicationPolicyStatement](#applications-applicationid-policy-model-applicationpolicystatement) 的陣列 | True | 套用至應用程式的政策陳述式陣列。 | ### ApplicationPolicyStatement 政策陳述式已套用至應用程式。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | actions | 類型 string 的陣列 | True | 如需此操作支援的動作清單，請參閱[應用程式許可](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/access-control-resource-based.html#application-permissions)。 | | principalOrgIDs | 類型 string 的陣列 | False | 要共用應用程式的 AWS Organizations ID。 | | principals | 類型 string 的陣列 | True | 要與之共用應用程式 AWS 的帳戶 IDs 陣列，或將應用程式設為公有的 \$1。 | | statementId | string | False | 陳述式的唯一 ID。 | ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### ForbiddenException 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務發生內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務發生內部錯誤。 | ### NotFoundException 請求中指定的資源（例如，存取政策陳述式）不存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 404 | | message | string | False | 請求中指定的資源（例如，存取政策陳述式）不存在。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### GetApplicationPolicy + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/GetApplicationPolicy) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/GetApplicationPolicy) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/GetApplicationPolicy) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/GetApplicationPolicy) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/GetApplicationPolicy) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/GetApplicationPolicy) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/GetApplicationPolicy) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/GetApplicationPolicy) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/GetApplicationPolicy) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/GetApplicationPolicy) ### PutApplicationPolicy + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/PutApplicationPolicy) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/PutApplicationPolicy) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/PutApplicationPolicy) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/PutApplicationPolicy) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/PutApplicationPolicy) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/PutApplicationPolicy) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/PutApplicationPolicy) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/PutApplicationPolicy) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/PutApplicationPolicy) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/PutApplicationPolicy) # Applications applicationId Templates ## URI `/applications/applicationId/templates` ## HTTP 方法 ### POST **操作 ID：**`CreateCloudFormationTemplate` 建立 a AWS CloudFormation 範本。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 201 | TemplateDetails | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### OPTIONS **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ## 結構描述 ### 請求內文 #### POST 結構描述 ``` { "semanticVersion": "string" } ``` ### 回應內文 #### TemplateDetails 結構描述 ``` { "templateId": "string", "templateUrl": "string", "applicationId": "string", "semanticVersion": "string", "status": enum, "creationTime": "string", "expirationTime": "string" } ``` #### BadRequestException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### NotFoundException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### CreateCloudFormationTemplateInput 建立範本請求。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | semanticVersion | string | False | 應用程式語意版本： [https://semver.org/](https://semver.org/) | ### ForbiddenException 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務發生內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務發生內部錯誤。 | ### NotFoundException 請求中指定的資源（例如，存取政策陳述式）不存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 404 | | message | string | False | 請求中指定的資源（例如，存取政策陳述式）不存在。 | ### TemplateDetails 範本的詳細資訊。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | creationTime | string | True | 建立此資源的日期和時間。 | | expirationTime | string | True | 此範本過期的日期和時間。範本會在建立 1 小時後過期。 | | semanticVersion | string | True | 應用程式語意版本： [https://semver.org/](https://semver.org/) | | status | string值： `PREPARING \| ACTIVE \| EXPIRED` | True | 範本建立工作流程的狀態。可能的值： `PREPARING \| ACTIVE \| EXPIRED` | | templateId | string | True | CreateCloudFormationTemplate 傳回的 UUID。模式：【0-9a-fA-F】\$18\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$112\$1 | | templateUrl | string | True | 範本的連結，可用於使用部署應用程式 AWS CloudFormation。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### CreateCloudFormationTemplate + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationTemplate) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationTemplate) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationTemplate) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationTemplate) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationTemplate) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationTemplate) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationTemplate) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationTemplate) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationTemplate) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationTemplate) # Applications applicationId Templates templateId ## URI `/applications/applicationId/templates/templateId` ## HTTP 方法 ### GET **操作 ID：**`GetCloudFormationTemplate` 取得指定的 AWS CloudFormation 範本。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | | templateId | String | True | CreateCloudFormationTemplate 傳回的 UUID。模式：【0-9a-fA-F】\$18\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$112\$1 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | TemplateDetails | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務遇到內部錯誤。 | ### OPTIONS **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | | templateId | String | True | CreateCloudFormationTemplate 傳回的 UUID。模式：【0-9a-fA-F】\$18\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$112\$1 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ## 結構描述 ### 回應內文 #### TemplateDetails 結構描述 ``` { "templateId": "string", "templateUrl": "string", "applicationId": "string", "semanticVersion": "string", "status": enum, "creationTime": "string", "expirationTime": "string" } ``` #### BadRequestException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### NotFoundException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### ForbiddenException 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務遇到內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務遇到內部錯誤。 | ### NotFoundException 請求中指定的資源（例如，存取政策陳述式）不存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 404 | | message | string | False | 請求中指定的資源（例如，存取政策陳述式）不存在。 | ### TemplateDetails 範本的詳細資訊。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | creationTime | string | True | 建立此資源的日期和時間。 | | expirationTime | string | True | 此範本過期的日期和時間。範本會在建立 1 小時後過期。 | | semanticVersion | string | True | 應用程式語意版本： [https://semver.org/](https://semver.org/) | | status | string值： `PREPARING \| ACTIVE \| EXPIRED` | True | 範本建立工作流程的狀態。可能的值： `PREPARING \| ACTIVE \| EXPIRED` | | templateId | string | True | CreateCloudFormationTemplate 傳回的 UUID。模式：【0-9a-fA-F】\$18\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$14\$1\$1-【0-9a-fA-F】\$112\$1 | | templateUrl | string | True | 範本的連結，可用於使用部署應用程式 AWS CloudFormation。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### GetCloudFormationTemplate + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/GetCloudFormationTemplate) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/GetCloudFormationTemplate) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/GetCloudFormationTemplate) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/GetCloudFormationTemplate) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/GetCloudFormationTemplate) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/GetCloudFormationTemplate) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/GetCloudFormationTemplate) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/GetCloudFormationTemplate) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/GetCloudFormationTemplate) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/GetCloudFormationTemplate) # Applications applicationId Unshare ## URI `/applications/applicationId/unshare` ## HTTP 方法 ### POST **操作 ID：**`UnshareApplication` 從 AWS 組織取消共用應用程式。此操作只能從組織的管理帳戶呼叫。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 204 | None | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### OPTIONS **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ## 結構描述 ### 請求內文 #### POST 結構描述 ``` { "organizationId": "string" } ``` ### 回應內文 #### BadRequestException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### NotFoundException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### ForbiddenException 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務發生內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務發生內部錯誤。 | ### NotFoundException 請求中指定的資源（例如，存取政策陳述式）不存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 404 | | message | string | False | 請求中指定的資源（例如，存取政策陳述式）不存在。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ### UnshareApplicationInput 取消共用應用程式請求。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | organizationId | string | True | 取消共用應用程式的 AWS Organizations ID。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### UnshareApplication + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/UnshareApplication) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/UnshareApplication) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/UnshareApplication) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/UnshareApplication) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/UnshareApplication) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/UnshareApplication) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/UnshareApplication) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/UnshareApplication) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/UnshareApplication) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/UnshareApplication) # 應用程式 applicationId 版本 ## URI `/applications/applicationId/versions` ## HTTP 方法 ### GET **操作 ID：**`ListApplicationVersions` 列出指定應用程式的版本。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **查詢參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | maxItems | String | False | 要傳回的項目總數。 | | nextToken | String | False | 用以指定分頁開始位置的字符。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | ApplicationVersionPage | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 404 | NotFoundException | 請求中指定的資源（例如，存取政策陳述式）不存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### OPTIONS **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ## 結構描述 ### 回應內文 #### ApplicationVersionPage 結構描述 ``` { "versions": [ { "applicationId": "string", "semanticVersion": "string", "sourceCodeUrl": "string", "creationTime": "string" } ], "nextToken": "string" } ``` #### BadRequestException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### NotFoundException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### ApplicationVersionPage 應用程式版本摘要的清單。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | nextToken | string | False | 請求下一頁結果的字符。 | | 版本 | 類型 [VersionSummary](#applications-applicationid-versions-model-versionsummary) 的陣列 | True | 應用程式的版本摘要陣列。 | ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### ForbiddenException 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務發生內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務發生內部錯誤。 | ### NotFoundException 請求中指定的資源（例如，存取政策陳述式）不存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 404 | | message | string | False | 請求中指定的資源（例如，存取政策陳述式）不存在。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ### VersionSummary 應用程式版本摘要。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | creationTime | string | True | 建立此資源的日期和時間。 | | semanticVersion | string | True | 應用程式語意版本： [https://semver.org/](https://semver.org/) | | sourceCodeUrl | string | False | 應用程式原始碼的公有儲存庫連結，例如特定 GitHub 遞交的 URL。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### ListApplicationVersions + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/ListApplicationVersions) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/ListApplicationVersions) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/ListApplicationVersions) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/ListApplicationVersions) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/ListApplicationVersions) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/ListApplicationVersions) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/ListApplicationVersions) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/ListApplicationVersions) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/ListApplicationVersions) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/ListApplicationVersions) # 應用程式 applicationId 版本semanticVersion ## URI `/applications/applicationId/versions/semanticVersion` ## HTTP 方法 ### PUT **操作 ID：**`CreateApplicationVersion` 建立應用程式版本。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | | semanticVersion | String | True | 新版本的語意版本。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 201 | Version | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 409 | ConflictException | 此資源已存在。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### OPTIONS **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | | semanticVersion | String | True | 新版本的語意版本。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ## 結構描述 ### 請求內文 #### PUT 結構描述 ``` { "templateBody": "string", "templateUrl": "string", "sourceCodeUrl": "string", "sourceCodeArchiveUrl": "string" } ``` ### 回應內文 #### Version 結構描述 ``` { "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 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ConflictException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### Capability 必須指定才能部署某些應用程式的值。 + `CAPABILITY_IAM` + `CAPABILITY_NAMED_IAM` + `CAPABILITY_AUTO_EXPAND` + `CAPABILITY_RESOURCE_POLICY` ### ConflictException 此資源已存在。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 409 | | message | string | False | 此資源已存在。 | ### CreateApplicationVersionInput 建立版本請求。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | sourceCodeArchiveUrl | string | False | S3 物件的連結，其中包含此應用程式版本原始碼的 ZIP 封存。大小上限為 50 MB | | sourceCodeUrl | string | False | 應用程式原始碼的公有儲存庫連結，例如特定 GitHub 遞交的 URL。 | | templateBody | string | False | 應用程式的原始封裝 AWS SAM 範本。 | | templateUrl | string | False | 應用程式封裝 AWS SAM 範本的連結。 | ### ForbiddenException 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務發生內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務發生內部錯誤。 | ### ParameterDefinition 應用程式支援的參數。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | allowedPattern | string | False | 規則表達式，代表 `String` 類型允許的模式。 | | allowedValues | 類型 string 的陣列 | False | 陣列，包含參數的允許值清單。 | | constraintDescription | string | False | 字串，說明違反限制時的限制。例如，具有允許模式 `[A-Za-z0-9]+` 的參數會在使用者指定無效值時顯示下列錯誤訊息，但沒有限制描述： `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` 透過新增限制描述，例如「必須僅包含大寫和小寫字母和數字」，您可以顯示下列自訂錯誤訊息： `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.` | | defaultValue | string | False | 建立堆疊時，範本要在未指定值時使用的適當類型值。如果您定義參數的限制，則必須指定遵循這些限制的值。 | | 描述 | string | False | 最多 4，000 個字元的字串，描述參數。 | | maxLength | integer | False | 整數值，決定您要允許 `String`類型的最大字元數。 | | maxValue | integer | False | 數值，決定您要允許 `Number`類型的最大數值。 | | minLength | integer | False | 整數值，決定您想要允許 `String`類型使用的最小字元數。 | | minValue | integer | False | 數值，決定您想要允許 `Number`類型的最小數值。 | | name | string | True | 參數名稱。 | | noEcho | boolean | False | 是否在任何人進行描述堆疊的呼叫時遮罩參數值。如果您將值設定為 true，參數值會以星號 (\$1\$1\$1\$1\$1) 遮罩。 | | referencedByResources | 類型 string 的陣列 | True | 使用此參數 AWS SAM 的資源清單。 | | type | string | False | 參數的類型。有效值：`String \| Number \| List \| CommaDelimitedList` `String`：常值字串。例如，使用者可以指定 `"MyUserName"`。 `Number`：整數或 float. CloudFormation valid 會將參數值驗證為數字。不過，當您在範本的其他位置使用參數（例如，使用`Ref`內部函數）時，參數值會變成字串。例如，使用者可以指定 `"8888"`。 `List`：以逗號分隔的整數或浮點數陣列。 CloudFormation 會將參數值驗證為數字。不過，當您在範本的其他位置使用參數（例如，使用`Ref`內部函數）時，參數值會成為字串清單。例如，使用者可能會指定「80，20」，然後`Ref`產生 `["80","20"]`。 `CommaDelimitedList`：以逗號分隔的常值字串陣列。字串總數應該比逗號總數多一個。此外，每個成員字串都是空格修剪的。例如，使用者可能會指定 "test，dev，prod"，然後`Ref`產生 `["test","dev","prod"]`。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ### Version 應用程式版本詳細資訊。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | creationTime | string | True | 建立此資源的日期和時間。 | | parameterDefinitions | 類型 [ParameterDefinition](#applications-applicationid-versions-semanticversion-model-parameterdefinition) 的陣列 | True | 應用程式支援的參數類型陣列。 | | requiredCapabilities | 類型 [Capability](#applications-applicationid-versions-semanticversion-model-capability) 的陣列 | True | 您必須先指定的值清單，才能部署特定應用程式。有些應用程式可能包含會影響您 AWS 帳戶中許可的資源，例如，建立新的 AWS Identity and Access Management (IAM) 使用者。對於這些應用程式，您必須指定此參數來明確認可其功能。唯一有效的值是 `CAPABILITY_IAM`、`CAPABILITY_RESOURCE_POLICY`、 `CAPABILITY_NAMED_IAM`和 `CAPABILITY_AUTO_EXPAND`。下列資源需要由您指定 `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`。下列資源需要由您指定 `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)。包含一個或多個巢狀應用程式的應用程式需要由您指定 `CAPABILITY_AUTO_EXPAND`。如果您的應用程式範本包含上述任何資源，建議您在部署之前檢閱與應用程式相關聯的所有許可。如果您未為需要功能的應用程式指定此參數，呼叫將會失敗。 | | resourcesSupported | boolean | True | 此應用程式中包含的所有 AWS 資源是否都支援擷取該資源的區域。 | | semanticVersion | string | True | 應用程式語意版本： [https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | string | False | S3 物件的連結，其中包含此應用程式版本原始碼的 ZIP 封存。大小上限為 50 MB | | sourceCodeUrl | string | False | 應用程式原始碼的公有儲存庫連結，例如特定 GitHub 遞交的 URL。 | | templateUrl | string | True | 應用程式封裝 AWS SAM 範本的連結。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### CreateApplicationVersion + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplicationVersion) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplicationVersion) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplicationVersion) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplicationVersion) + [適用於 Java 的 AWS SDK 第 2 版](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplicationVersion) + [適用於 JavaScript V3 的 AWS 開發套件](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplicationVersion) + [適用於 Kotlin 的 AWS 開發套件](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplicationVersion) + [適用於 PHP V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplicationVersion) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/CreateApplicationVersion) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplicationVersion)