Aplicativos: ApplicationID Versions SemanticVersion

URI

/applications/applicationId/versions/semanticVersion

Métodos HTTP

PUT

ID da operação: CreateApplicationVersion

Cria uma versão do aplicativo.

Parâmetros de caminho
Nome	Type	Obrigatório	Descrição
applicationId	String	True	O nome de recurso da Amazon (ARN) do aplicativo.
Versão semântica	String	True	A versão semântica da nova versão.

Respostas
Código de status	Modelo de resposta	Descrição
201	Version	Bem-sucedida
400	BadRequestException	Um dos parâmetros na solicitação é inválido.
403	ForbiddenException	O cliente não está autenticado.
409	ConflictException	O recurso já existe.
429	TooManyRequestsException	O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.
500	InternalServerErrorException	O serviço AWS Serverless Application Repository encontrou um erro interno.

OPTIONS

Parâmetros de caminho
Nome	Type	Obrigatório	Descrição
applicationId	String	True	O nome de recurso da Amazon (ARN) do aplicativo.
Versão semântica	String	True	A versão semântica da nova versão.

Respostas
Código de status	Modelo de resposta	Descrição
200	None	200 respostas

Esquemas

Corpos da solicitação

Esquema PUT

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

Corpos da resposta

Esquema 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
}

Esquema BadRequestException

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

Esquema ForbiddenException

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

Esquema ConflictException

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

Esquema TooManyRequestsException

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

Esquema InternalServerErrorException

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

Propriedades

BadRequestException

Um dos parâmetros na solicitação é inválido.

Propriedade	Tipo	Obrigatório	Descrição
errorCode	string	False	400
mensagem	string	False	Um dos parâmetros na solicitação é inválido.

Capability

Valores que devem ser especificados para implantar alguns aplicativos.

• CAPABILITY_IAM

• CAPABILITY_NAMED_IAM

• CAPABILITY_AUTO_EXPAND

• CAPABILITY_RESOURCE_POLICY

ConflictException

O recurso já existe.

Propriedade	Tipo	Obrigatório	Descrição
errorCode	string	False	409
mensagem	string	False	O recurso já existe.

CreateApplicationVersionInput

Crie uma solicitação de versão.

Propriedade	Tipo	Obrigatório	Descrição
sourceCodeArchiveURL	string	False	Um link para o objeto S3 que contém o arquivo ZIP do código-fonte dessa versão do seu aplicativo. Tamanho máximo 50 MB
sourceCodeUrl	string	False	Um link para um repositório público para o código-fonte do seu aplicativo, por exemplo, o URL de um GitHub commit específico.
templateBody	string	False	O AWS SAM modelo empacotado bruto do seu aplicativo.
URL do modelo	string	False	Um link para o AWS SAM modelo empacotado do seu aplicativo.

ForbiddenException

O cliente não está autenticado.

Propriedade	Tipo	Obrigatório	Descrição
errorCode	string	False	403
mensagem	string	False	O cliente não está autenticado.

InternalServerErrorException

O serviço AWS Serverless Application Repository encontrou um erro interno.

Propriedade	Tipo	Obrigatório	Descrição
errorCode	string	False	500
mensagem	string	False	O serviço AWS Serverless Application Repository encontrou um erro interno.

ParameterDefinition

Parâmetros suportados pelo aplicativo.

Propriedade	Tipo	Obrigatório	Descrição
allowedPattern	string	False	Uma expressão regular que representa os padrões a serem permitidos para tipos String.
allowedValues	Matriz do tipo string	False	Uma matriz que contém a lista de valores permitidos para o parâmetro.
Descrição da restrição	string	False	Uma sequência que explica uma restrição quando a restrição é violada. Por exemplo, sem uma descrição da restrição, um parâmetro que tem um padrão permitido de [A-Za-z0-9]+ exibe a seguinte mensagem de erro quando o usuário especifica um valor inválido: Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+ Ao adicionar uma descrição de restrição, como “deve conter somente letras maiúsculas e minúsculas e números”, você pode exibir a seguinte mensagem de erro personalizada: Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.
defaultValue	string	False	Um valor do tipo apropriado para o modelo a ser usado se nenhum valor for especificado quando uma pilha é criada. Se definir restrições para o parâmetro, você deverá especificar um valor que esteja de acordo com essas restrições.
descrição	string	False	Uma sequência de até 4.000 caracteres que descreve o parâmetro.
Comprimento máximo	integer	False	Um valor inteiro que determina o maior número de caracteres que você deseja permitir para String tipos.
Valor máximo	integer	False	Um valor numérico que determina o maior valor numérico que você deseja permitir para Number tipos.
Comprimento mínimo	integer	False	Um valor inteiro que determina o menor número de caracteres que você deseja permitir para String tipos.
Valor mínimo	integer	False	Um valor numérico que determina o menor valor numérico que você deseja permitir para Number tipos.
name	string	True	O nome do parâmetro.
Um eco	booleano	False	Se o valor do parâmetro deve ser mascarado sempre que alguém fizer uma chamada que descreva a pilha. Se você definir o valor como verdadeiro, o valor do parâmetro será mascarado com asteriscos (*****).
referencedByResources	Matriz do tipo string	True	Uma lista de AWS SAM recursos que usam esse parâmetro.
tipo	string	False	O tipo do parâmetro. Valores válidos: String | Number | List<Number> | CommaDelimitedList String: Uma sequência de caracteres literal. Por exemplo, os usuários podem especificar"MyUserName". Number: Um número inteiro ou flutuante. AWS CloudFormationvalida o valor do parâmetro como um número. No entanto, quando você usa o parâmetro em outro lugar em seu modelo (por exemplo, usando a função Ref intrínseca), o valor do parâmetro se torna uma string. Por exemplo, os usuários podem especificar"8888". List<Number>: uma matriz de números inteiros ou flutuantes separados por vírgulas. AWS CloudFormationvalida o valor do parâmetro como números. No entanto, quando você usa o parâmetro em outro lugar do seu modelo (por exemplo, usando a função Ref intrínseca), o valor do parâmetro se torna uma lista de cadeias de caracteres. Por exemplo, os usuários podem especificar “80,20" e, em seguida, resultar emRef. ["80","20"] CommaDelimitedList: uma matriz de cadeias de caracteres literais separadas por vírgulas. O total de sequências deve ser um número a mais que o número total de vírgulas. Além disso, cada sequência de membros é cortada com espaço. Por exemplo, os usuários podem especificar “test, dev, prod” e, em seguida, Ref resultar em["test","dev","prod"].

TooManyRequestsException

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.

Propriedade	Tipo	Obrigatório	Descrição
errorCode	string	False	429
mensagem	string	False	O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.

Version

Detalhes da versão do aplicativo.

Propriedade	Tipo	Obrigatório	Descrição
applicationId	string	True	O nome de recurso da Amazon (ARN) do aplicativo do .
creationTime	string	True	A data e a hora em que esse recurso foi criado.
Definições de parâmetros	Matriz do tipo ParameterDefinition	True	Uma matriz de tipos de parâmetros suportados pelo aplicativo.
requiredCapabilities	Matriz do tipo Capability	True	Uma lista de valores que você deve especificar antes de poder implantar determinados aplicativos. Alguns aplicativos podem incluir recursos que podem afetar as permissões em sua AWS conta, por exemplo, criando novos usuários AWS Identity and Access Management (IAM). Para esses aplicativos, você deve reconhecer explicitamente seus recursos especificando esse parâmetro. Os únicos valores válidos são CAPABILITY_IAM CAPABILITY_NAMED_IAMCAPABILITY_RESOURCE_POLICY,, CAPABILITY_AUTO_EXPAND e. Os recursos a seguir exigem que você especifique CAPABILITY_IAM ouCAPABILITY_NAMED_IAM: AWS::IAM::GroupAWS::IAM::InstanceProfileAWS::IAM::Policy,, AWS::IAM::Rolee. Se o aplicativo contiver recursos do IAM, você poderá especificar CAPABILITY_IAM ouCAPABILITY_NAMED_IAM. Se o aplicativo contém recursos do IAM com nomes personalizados, você deverá especificar CAPABILITY_NAMED_IAM. Os recursos a seguir exigem que você especifiqueCAPABILITY_RESOURCE_POLICY: AWS::Lambda::Permission, AWS: :iam:policy,, AWS::ApplicationAutoScaling::ScalingPolicy, e. AWS::S3::BucketPolicyAWS::SQS::QueuePolicyAWS::SNS::TopicPolicy Os aplicativos que contêm um ou mais aplicativos aninhados exigem que você especifique CAPABILITY_AUTO_EXPAND. Se seu modelo de aplicativo contiver algum dos recursos acima, recomendamos que você revise todas as permissões associadas ao aplicativo antes da implantação. Se você não especificar esse parâmetro para um aplicativo que requer recursos, a chamada falhará.
Recursos suportados	booleano	True	Se todos os AWS recursos contidos nesse aplicativo são suportados na região em que ele está sendo recuperado.
Versão semântica	string	True	A versão semântica do aplicativo: https://semver.org/
sourceCodeArchiveURL	string	False	Um link para o objeto S3 que contém o arquivo ZIP do código-fonte dessa versão do seu aplicativo. Tamanho máximo 50 MB
sourceCodeUrl	string	False	Um link para um repositório público para o código-fonte do seu aplicativo, por exemplo, o URL de um GitHub commit específico.
URL do modelo	string	True	Um link para o AWS SAM modelo empacotado do seu aplicativo.

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs e referências de uma linguagem específica, consulte o seguinte:

CreateApplicationVersion

• Interface de linha de comando da AWS

• AWS SDK para .NET

• AWS SDK para C++

• AWS SDK para Go

• AWS SDK para Java V2

• SDK da AWS para JavaScript V3

• AWS SDK para PHP V3

• AWS SDK para Python

• AWS SDK para Ruby V3