Aplicaciones ApplicationID Versiones SemanticVersion

URI

/applications/applicationId/versions/semanticVersion

Métodos HTTP

PUT

ID de la operación: CreateApplicationVersion

Crea una versión de la aplicación.

Parámetros de la ruta
Nombre	Tipo	Obligatorio	Descripción
ApplicationiD	Cadena	True	El nombre de recurso de Amazon (ARN) de la aplicación.
Versión semántica	Cadena	True	La versión semántica de la nueva versión.

Respuestas
Código de estado	Modelo de respuesta	Descripción
201	Version	Success
400	BadRequestException	Uno de los parámetros de la solicitud no es válido.
403	ForbiddenException	El cliente no está autenticado.
409	ConflictException	El recurso ya existe.
429	TooManyRequestsException	El cliente envía más solicitudes por unidad de tiempo de las permitidas.
500	InternalServerErrorException	El AWS Serverless Application Repository servicio ha detectado un error interno.

OPTIONS

Parámetros de la ruta
Nombre	Tipo	Obligatorio	Descripción
ApplicationiD	Cadena	True	El nombre de recurso de Amazon (ARN) de la aplicación.
Versión semántica	Cadena	True	La versión semántica de la nueva versión.

Respuestas
Código de estado	Modelo de respuesta	Descripción
200	Ninguna	200 respuestas

Schemas

Cuerpos de la solicitud

esquema PUT

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

Cuerpos de respuesta

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

Propiedades

BadRequestException

Uno de los parámetros de la solicitud no es válido.

Propiedad	Tipo	Obligatorio	Descripción
errorCode	cadena	False	400
message	cadena	False	Uno de los parámetros de la solicitud no es válido.

Capability

Valores que se deben especificar para poder implementar algunas aplicaciones.

• CAPABILITY_IAM

• CAPABILITY_NAMED_IAM

• CAPABILITY_AUTO_EXPAND

• CAPABILITY_RESOURCE_POLICY

ConflictException

El recurso ya existe.

Propiedad	Tipo	Obligatorio	Descripción
errorCode	cadena	False	409
message	cadena	False	El recurso ya existe.

CreateApplicationVersionInput

Cree una solicitud de versión.

Propiedad	Tipo	Obligatorio	Descripción
sourceCodeArchiveUrl	cadena	False	Un enlace al objeto S3 que contiene el archivo ZIP del código fuente de esta versión de la aplicación. Tamaño máximo: 50 MB
sourceCodeUrl	cadena	False	Un enlace a un repositorio público para el código fuente de tu aplicación, por ejemplo, la URL de una GitHub confirmación específica.
templateBody	cadena	False	La AWS SAM plantilla empaquetada sin procesar de tu aplicación.
templateUrl	cadena	False	Un enlace a la AWS SAM plantilla empaquetada de su solicitud.

ForbiddenException

El cliente no está autenticado.

Propiedad	Tipo	Obligatorio	Descripción
errorCode	cadena	False	403
message	cadena	False	El cliente no está autenticado.

InternalServerErrorException

El AWS Serverless Application Repository servicio ha detectado un error interno.

Propiedad	Tipo	Obligatorio	Descripción
errorCode	cadena	False	500
message	cadena	False	El AWS Serverless Application Repository servicio detectó un error interno.

ParameterDefinition

Parámetros compatibles con la aplicación.

Propiedad	Tipo	Obligatorio	Descripción
allowedPattern	cadena	False	Una expresión regular que representa los patrones que hay que permitir para tipos de String.
allowedValues	Matriz de tipo string	False	Una matriz que contiene la lista de valores permitidos para el parámetro.
constraintDescription	cadena	False	Una cadena que explica una restricción cuando se infringe la restricción. Por ejemplo, sin una descripción de la restricción, un parámetro con un patrón permitido de [A-Za-z0-9]+ muestra el siguiente mensaje de error cuando el usuario especifica un valor no válido: Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+ Al añadir una descripción de la restricción, como «debe contener solo letras y números en mayúscula y minúscula», puede mostrar el siguiente mensaje de error personalizado: Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.
defaultValue	cadena	False	Un valor del tipo apropiado para la plantilla que se debe utilizar si no se especifica ningún valor al crear una pila. Si define restricciones para el parámetro, debe especificar un valor que cumpla dichas restricciones.
description	cadena	False	Cadena de hasta 4000 caracteres que describe el parámetro.
maxLength	integer	False	Un valor entero que determina el número máximo de caracteres que desea permitir para los String tipos.
maxValue	integer	False	Un valor numérico que determina el mayor valor numérico que desea permitir para los Number tipos.
minLength	integer	False	Un valor entero que determina el número mínimo de caracteres que desea permitir para los String tipos.
minValue	integer	False	Un valor numérico que determina el valor numérico más pequeño que se desea permitir para los Number tipos.
name	cadena	True	El nombre del parámetro.
noEcho	valor booleano	False	Si se debe enmascarar el valor del parámetro cada vez que alguien realice una llamada que describa la pila. Si establece el valor en verdadero, el valor del parámetro se enmascara con asteriscos (*****).
referencedByResources	Matriz de tipo string	True	Una lista de AWS SAM recursos que utilizan este parámetro.
type	cadena	False	El tipo del parámetro. Valores válidos: String | Number | List<Number> | CommaDelimitedList String: cadena literal. Por ejemplo, los usuarios pueden especificar"MyUserName". Number: entero o flotante. AWS CloudFormation valida el valor del parámetro como un número. Sin embargo, cuando se utiliza el parámetro en otro lugar de la plantilla (por ejemplo, mediante la función Ref intrínseca), el valor del parámetro se convierte en una cadena. Por ejemplo, los usuarios pueden especificar"8888". List<Number>: matriz de números enteros o flotantes separados por comas. AWS CloudFormation valida el valor del parámetro en forma de números. Sin embargo, cuando se utiliza el parámetro en otro lugar de la plantilla (por ejemplo, mediante la función Ref intrínseca), el valor del parámetro se convierte en una lista de cadenas. Por ejemplo, los usuarios pueden especificar «80,20" y, a continuación, dar Ref como resultado. ["80","20"] CommaDelimitedList: matriz de cadenas literales separadas por comas. El número total de cadenas debería ser uno más que el número total de comas. Además, cada cadena de miembros está recortada con espacios. Por ejemplo, los usuarios pueden especificar «test, dev, prod» y, a continuación, arrojar los resultados. Ref ["test","dev","prod"]

TooManyRequestsException

El cliente envía más solicitudes por unidad de tiempo de las permitidas.

Propiedad	Tipo	Obligatorio	Descripción
errorCode	cadena	False	429
message	cadena	False	El cliente envía más solicitudes de las permitidas por unidad de tiempo.

Version

Detalles de la versión de la aplicación.

Propiedad	Tipo	Obligatorio	Descripción
applicationId	cadena	True	El nombre de recurso de Amazon (ARN) de la aplicación.
creationTime	cadena	True	Fecha y hora en que se creó este recurso.
parameterDefinitions	Matriz de tipo ParameterDefinition	True	Conjunto de tipos de parámetros compatibles con la aplicación.
requiredCapabilities	Matriz de tipo Capability	True	Una lista de valores que debe especificar antes de poder implementar determinadas aplicaciones. Algunas aplicaciones pueden incluir recursos que pueden afectar a los permisos de su AWS cuenta, por ejemplo, al crear nuevos AWS Identity and Access Management (IAM) usuarios. En el caso de esas aplicaciones, debes reconocer explícitamente sus capacidades especificando este parámetro. Los únicos valores válidos son CAPABILITY_IAMCAPABILITY_NAMED_IAM,CAPABILITY_RESOURCE_POLICY, yCAPABILITY_AUTO_EXPAND. Los siguientes recursos requieren que especifique CAPABILITY_IAM oCAPABILITY_NAMED_IAM: AWS::IAM::GroupAWS::IAM::InstanceProfile, AWS::IAM::Policy, y AWS::IAM::Role. Si la aplicación contiene recursos de IAM, puede especificar una CAPABILITY_IAM oCAPABILITY_NAMED_IAM. Si la aplicación contiene recursos de IAM con nombres personalizados, debe especificar CAPABILITY_NAMED_IAM. Los siguientes recursos requieren que especifiqueCAPABILITY_RESOURCE_POLICY: AWS::Lambda::Permission, AWS: :IAM:Policy,, AWS::ApplicationAutoScaling::ScalingPolicy, AWS::S3::BucketPolicyy. AWS::SQS::QueuePolicyAWS::SNS::TopicPolicy Las aplicaciones que contienen una o varias aplicaciones anidadas requieren que especifique CAPABILITY_AUTO_EXPAND. Si la plantilla de su aplicación contiene alguno de los recursos anteriores, le recomendamos que revise todos los permisos asociados a la aplicación antes de implementarla. Si no especifica este parámetro para una aplicación que requiere capacidades, la llamada fallará.
resourcesSupported	booleano	True	Si todos los AWS recursos contenidos en esta aplicación son compatibles en la región en la que se está recuperando.
semanticVersion	cadena	True	La versión semántica de la aplicación: https://semver.org/
sourceCodeArchiveUrl	cadena	False	Un enlace al objeto S3 que contiene el archivo ZIP del código fuente de esta versión de la aplicación. Tamaño máximo: 50 MB
sourceCodeUrl	cadena	False	Un enlace a un repositorio público para el código fuente de tu aplicación, por ejemplo, la URL de una GitHub confirmación específica.
templateUrl	cadena	True	Un enlace a la AWS SAM plantilla empaquetada de tu aplicación.

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK y referencias específicos del idioma, consulta lo siguiente:

CreateApplicationVersion

• Interfaz de línea de comandos de AWS

• AWS SDK para .NET

• AWS SDK para C++

• AWS SDK para Go v2

• AWS SDK para Java V2

• AWS SDK para la JavaScript versión 3

• SDK de AWS para PHP V3

• AWS SDK para Python

• AWS SDK para Ruby V3