애플리케이션 applicationId 버전 semanticVersion

URI

/applications/applicationId/versions/semanticVersion

HTTP 메서드

PUT

작업 ID: CreateApplicationVersion

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

경로 파라미터
명칭	유형	필수	설명
`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

경로 파라미터
명칭	유형	필수	설명
`applicationId`	String	True	애플리케이션의 Amazon 리소스 이름(ARN)입니다.
`semanticVersion`	String	True	새 버전의 시맨틱 버전입니다.

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

스키마

요청 본문


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

응답 본문


{
  "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
}


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


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


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


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


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

속성

BadRequestException

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

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

Capability

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

CAPABILITY_IAM
CAPABILITY_NAMED_IAM
CAPABILITY_AUTO_EXPAND
CAPABILITY_RESOURCE_POLICY

ConflictException

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

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

CreateApplicationVersionInput

버전 요청을 생성합니다.

속성	유형	필수	설명
`sourceCodeArchiveUrl`	문자열	False	애플리케이션의 이 버전에 대한 소스 코드 ZIP 아카이브가 포함된 S3 객체에 대한 링크입니다. 최대 크기 50MB
`sourceCodeUrl`	문자열	False	애플리케이션의 소스 코드에 대한 퍼블릭 리포지토리에 대한 링크입니다. 예를 들어, 특정 GitHub 커밋URL의 입니다.
`templateBody`	문자열	False	애플리케이션의 원시 패키징 AWS SAM 템플릿입니다.
`templateUrl`	문자열	False	애플리케이션의 패키지 AWS SAM 템플릿에 대한 링크입니다.

ForbiddenException

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

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

InternalServerErrorException

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

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

ParameterDefinition

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

속성	유형	필수	설명
`allowedPattern`	문자열	False	`String` 유형에 허용할 패턴을 나타내는 정규식입니다.
`allowedValues`	유형 배열 string	False	파라미터에 허용되는 값 목록을 포함하는 어레이입니다.
`constraintDescription`	문자열	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`	문자열	False	스택 생성 시 지정된 값이 없는 경우에 사용할 템플릿에 적합한 유형의 값입니다. 파라미터에 대한 제약을 정의하는 경우 이러한 제약을 준수하는 값을 지정해야 합니다.
`description`	문자열	False	파라미터를 설명하는 최대 4,000자의 문자열입니다.
`maxLength`	정수	False	`String` 유형에 허용할 최대 문자 수를 결정하는 정수 값입니다.
`maxValue`	정수	False	`Number` 유형에 허용하려는 가장 큰 숫자 값을 결정하는 숫자 값입니다.
`minLength`	정수	False	`String` 유형에 허용하려는 가장 작은 문자 수를 결정하는 정수 값입니다.
`minValue`	정수	False	`Number` 유형에 허용하려는 가장 작은 숫자 값을 결정하는 숫자 값입니다.
`name`	문자열	True	파라미터의 이름입니다.
`noEcho`	부울	False	스택을 설명하는 전화를 걸 때마다 파라미터 값을 마스킹할지 여부입니다. 값을 true로 설정하면 파라미터 값이 별표(*****)로 마스킹됩니다.
`referencedByResources`	유형 배열 string	True	이 파라미터를 사용하는 AWS SAM 리소스 목록입니다.
`type`	문자열	False	파라미터의 유형입니다. 유효값: `String \| Number \| List<Number> \| CommaDelimitedList` `String`: 리터럴 문자열입니다. 예를 들어 사용자는 를 지정할 수 있습니다`"MyUserName"`. `Number`: 정수 또는 float. AWS CloudFormation valid는 파라미터 값을 숫자로 확인합니다. 그러나 템플릿의 다른 곳에서 파라미터를 사용하는 경우(예: `Ref` 내장 함수 사용) 파라미터 값은 문자열이 됩니다. 예를 들어 사용자는 를 지정할 수 있습니다`"8888"`. `List<Number>`: 쉼표로 구분된 정수 또는 부동 소수점 배열입니다. AWS CloudFormation 는 파라미터 값을 숫자로 검증합니다. 그러나 템플릿의 다른 곳에서 파라미터를 사용하는 경우(예: `Ref` 내장 함수 사용) 파라미터 값은 문자열 목록이 됩니다. 예를 들어 사용자는 '80,20'을 지정한 다음 를 `Ref` 생성할 수 있습니다`["80","20"]`. `CommaDelimitedList`: 쉼표로 구분된 리터럴 문자열 배열입니다. 총 문자열 수는 총 쉼표 수보다 하나 더 많아야 합니다. 또한 각 멤버 문자열은 스페이스 트림됩니다. 예를 들어, 사용자는 'test,dev,prod'를 지정한 다음 를 `Ref` 지정할 수 있습니다`["test","dev","prod"]`.

TooManyRequestsException

클라이언트가 시간 단위당 허용된 요청 수보다 많은 요청을 보내고 있습니다.

속성	유형	필수	설명
`errorCode`	문자열	False	429
`message`	문자열	False	클라이언트가 시간 단위당 허용된 요청 수보다 많은 요청을 보내고 있습니다.

Version

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

속성	유형	필수	설명
`applicationId`	문자열	True	애플리케이션 Amazon 리소스 이름(ARN).
`creationTime`	문자열	True	이 리소스가 생성된 날짜 및 시간입니다.
`parameterDefinitions`	유형 배열 ParameterDefinition	True	애플리케이션에서 지원하는 파라미터 유형의 배열입니다.
`requiredCapabilities`	유형 배열 기능	True	특정 애플리케이션을 배포하기 전에 지정해야 하는 값 목록입니다. 일부 애플리케이션에는 새 AWS Identity and Access Management (IAM) 사용자를 생성하는 등 AWS 계정의 권한에 영향을 미칠 수 있는 리소스가 포함될 수 있습니다. 이러한 애플리케이션의 경우 이 파라미터를 지정하여 해당 기능을 명시적으로 확인해야 합니다. 유일한 유효한 값은 `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM`, 및 `CAPABILITY_RESOURCE_POLICY`입니다`CAPABILITY_AUTO_EXPAND`. 다음 리소스에서는 `CAPABILITY_IAM` 또는 AWS:::IAM:Group `CAPABILITY_NAMED_IAM`, ::::, :AWS:IAM:InstanceProfile AWSIAM:Policy 및 AWS:::IAM::Role 을 지정해야 합니다. 애플리케이션에 IAM 리소스가 포함된 경우 `CAPABILITY_IAM` 또는 중 하나를 지정할 수 있습니다`CAPABILITY_NAMED_IAM`. 애플리케이션에 사용자 지정 이름이 있는 IAM 리소스가 포함된 경우 를 지정해야 합니다`CAPABILITY_NAMED_IAM`. 다음 리소스를 지정하려면 `CAPABILITY_RESOURCE_POLICY`AWS::Lambda::Permission , AWS::IAM:Policy , AWS:::ApplicationAutoScaling:ScalingPolicy, AWS::S3::BucketPolicy, AWS::SQS::QueuePolicy, AWS::SNS::를TopicPolicy 지정해야 합니다. 중첩 애플리케이션을 한 개 이상 포함하는 애플리케이션은 `CAPABILITY_AUTO_EXPAND`를 지정해야 합니다. 애플리케이션 템플릿에 위 리소스 중 하나라도 포함된 경우 배포하기 전에 애플리케이션과 연결된 모든 권한을 검토하는 것이 좋습니다. 기능이 필요한 애플리케이션에 대해 이 파라미터를 지정하지 않으면 호출이 실패합니다.
`resourcesSupported`	boolean	True	이 애플리케이션에 포함된 모든 AWS 리소스가 검색되는 리전에서 지원되는지 여부.
`semanticVersion`	문자열	True	애플리케이션의 의미 버전: https://semver.org/
`sourceCodeArchiveUrl`	문자열	False	이 애플리케이션 버전의 소스 코드 ZIP 아카이브가 포함된 S3 객체에 대한 링크입니다. 최대 크기 50MB
`sourceCodeUrl`	문자열	False	애플리케이션의 소스 코드에 대한 퍼블릭 리포지토리에 대한 링크입니다. 예를 들어, 특정 GitHub 커밋URL의 입니다.
`templateUrl`	문자열	True	애플리케이션의 패키지 AWS SAM 템플릿에 대한 링크입니다.

다음 사항도 참조하세요.

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

CreateApplicationVersion

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

애플리케이션 applicationId 버전

문서 기록