Aplicativos: ApplicationID Versions SemanticVersion - AWS Serverless Application Repository
URIMétodos HTTPEsquemasPropriedadesConsulte também

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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
NameTipoObrigatórioDescrição
applicationIdStringVerdadeiro

O nome de recurso da Amazon (ARN) do aplicativo.

semanticVersionStringVerdadeiro

A versão semântica da nova versão.

Respostas
Código de statusModelo de respostaDescrição
201Version

Bem-sucedida

400BadRequestException

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

403ForbiddenException

O cliente não está autenticado.

409ConflictException

O recurso já existe.

429TooManyRequestsException

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

500InternalServerErrorException

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

OPTIONS

Parâmetros de caminho
NameTipoObrigatórioDescrição
applicationIdStringVerdadeiro

O nome de recurso da Amazon (ARN) do aplicativo.

semanticVersionStringVerdadeiro

A versão semântica da nova versão.

Respostas
Código de statusModelo de respostaDescrição
200Nenhum

200 respostas

Esquemas

Corpos da solicitação

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

Corpos da resposta

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

Propriedades

BadRequestException

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

PropriedadeTipoObrigatórioDescrição
errorCode

string

Falso

400

message

string

Falso

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.

PropriedadeTipoObrigatórioDescrição
errorCode

string

Falso

409

message

string

Falso

O recurso já existe.

CreateApplicationVersionInput

Crie uma solicitação de versão.

PropriedadeTipoObrigatórioDescrição
sourceCodeArchiveUrl

string

Falso

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

Falso

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

Falso

O AWS SAM modelo empacotado bruto do seu aplicativo.

templateUrl

string

Falso

Um link para o AWS SAM modelo empacotado do seu aplicativo.

ForbiddenException

O cliente não está autenticado.

PropriedadeTipoObrigatórioDescrição
errorCode

string

Falso

403

message

string

Falso

O cliente não está autenticado.

InternalServerErrorException

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

PropriedadeTipoObrigatórioDescrição
errorCode

string

Falso

500

message

string

Falso

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

ParameterDefinition

Parâmetros suportados pelo aplicativo.

PropriedadeTipoObrigatórioDescrição
allowedPattern

string

Falso

Uma expressão regular que representa os padrões a serem permitidos para tipos String.

allowedValues

Matriz de tipos string

Falso

Uma matriz que contém a lista de valores permitidos para o parâmetro.

constraintDescription

string

Falso

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

Falso

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.

description

string

Falso

Uma sequência de até 4.000 caracteres que descreve o parâmetro.

maxLength

integer

Falso

Um valor inteiro que determina o maior número de caracteres que você deseja permitir para String tipos.

maxValue

integer

Falso

Um valor numérico que determina o maior valor numérico que você deseja permitir para Number tipos.

minLength

integer

Falso

Um valor inteiro que determina o menor número de caracteres que você deseja permitir para String tipos.

minValue

integer

Falso

Um valor numérico que determina o menor valor numérico que você deseja permitir para Number tipos.

name

string

Verdadeiro

O nome do parâmetro.

noEcho

boolean

Falso

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 de tipos string

Verdadeiro

Uma lista de AWS SAM recursos que usam esse parâmetro.

type

string

Falso

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 CloudFormation valida 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 CloudFormation valida 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.

PropriedadeTipoObrigatórioDescrição
errorCode

string

Falso

429

message

string

Falso

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.

PropriedadeTipoObrigatórioDescrição
applicationId

string

Verdadeiro

O nome de recurso da Amazon (ARN) do aplicativo do .

creationTime

string

Verdadeiro

A data e a hora em que esse recurso foi criado.

parameterDefinitions

Matriz de tipos ParameterDefinition

Verdadeiro

Uma matriz de tipos de parâmetros suportados pelo aplicativo.

requiredCapabilities

Matriz de tipos Recurso

Verdadeiro

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á.

resourcesSupported

booliano

Verdadeiro

Se todos os AWS recursos contidos nesse aplicativo são suportados na região em que ele está sendo recuperado.

semanticVersion

string

Verdadeiro

A versão semântica do aplicativo:

https://semver.org/

sourceCodeArchiveUrl

string

Falso

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

Falso

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.

templateUrl

string

Verdadeiro

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 uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

CreateApplicationVersion