View a markdown version of this page

Aplicaciones, ID de aplicación, versiones, versión semántica - AWS Serverless Application Repository

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Aplicaciones, ID de aplicación, versiones, versión semántica

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
NameTipoObligatorioDescripción
applicationIdCadenaTrue

El nombre de recurso de Amazon (ARN) de la aplicación.

semanticVersionCadenaTrue

La versión semántica de la nueva versión.

Respuestas
Código de estadoModelo de respuestaDescription (Descripción)
201Version

Success

400BadRequestException

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

403ForbiddenException

El cliente no está autenticado.

409ConflictException

El recurso ya existe.

429TooManyRequestsException

El cliente envía más solicitudes del permitido por unidad de tiempo.

500InternalServerErrorException

El AWS Serverless Application Repository servicio detectó un error interno.

OPCIONES

Parámetros de la ruta
NameTipoObligatorioDescripción
applicationIdCadenaTrue

El nombre de recurso de Amazon (ARN) de la aplicación.

semanticVersionCadenaTrue

La versión semántica de la nueva versión.

Respuestas
Código de estadoModelo de respuestaDescription (Descripción)
200Ninguno

200 respuestas

Esquemas

Cuerpos de la solicitud

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

Cuerpos de respuesta

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

Propiedades

BadRequestException

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

PropiedadTipoObligatorioDescripción
errorCode

cadena

False

400

message

cadena

False

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

Funcionalidad

Valores que deben especificarse para implementar algunas aplicaciones.

  • CAPABILITY_IAM

  • CAPABILITY_NAMED_IAM

  • CAPABILITY_AUTO_EXPAND

  • CAPABILITY_RESOURCE_POLICY

ConflictException

El recurso ya existe.

PropiedadTipoObligatorioDescripción
errorCode

cadena

False

409

message

cadena

False

El recurso ya existe.

CreateApplicationVersionInput

Crea una solicitud de versión.

PropiedadTipoObligatorioDescripció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 aplicación.

ForbiddenException

El cliente no está autenticado.

PropiedadTipoObligatorioDescripción
errorCode

cadena

False

403

message

cadena

False

El cliente no está autenticado.

InternalServerErrorException

El AWS Serverless Application Repository servicio detectó un error interno.

PropiedadTipoObligatorioDescripción
errorCode

cadena

False

500

message

cadena

False

El AWS Serverless Application Repository servicio detectó un error interno.

ParameterDefinition

Parámetros admitidos por la aplicación.

PropiedadTipoObligatorioDescripció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]+

Si agrega 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

Una cadena de hasta 4.000 caracteres que describe el parámetro.

maxLength

entero

False

Un valor entero que determina el mayor número de caracteres que desea permitir para los String tipos.

maxValue

entero

False

Un valor numérico que determina el mayor valor numérico que desea permitir para Number los tipos.

minLength

entero

False

Un valor entero que determina el número mínimo de caracteres que desea permitir para String los tipos.

minValue

entero

False

Un valor numérico que determina el valor numérico más pequeño que desea permitir para Number los 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 haga 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 los 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: una cadena literal.

Por ejemplo, los usuarios pueden especificar"MyUserName".

Number: un entero o flotante. CloudFormation valida el valor del parámetro como un número. Sin embargo, cuando usa el parámetro en cualquier parte 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>: una matriz de números enteros o flotantes separados por comas. CloudFormation valida el valor del parámetro como números. Sin embargo, al usar el parámetro en cualquier parte 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: conjunto 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 elementos está recortada con espacios.

Por ejemplo, los usuarios pueden especificar «test, dev, prod» y, a continuación, dar como resultado. Ref ["test","dev","prod"]

TooManyRequestsException

El cliente envía más solicitudes del permitido por unidad de tiempo.

PropiedadTipoObligatorioDescripción
errorCode

cadena

False

429

message

cadena

False

El cliente envía más solicitudes del permitido por unidad de tiempo.

Versión

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

PropiedadTipoObligatorioDescripción
applicationId

cadena

True

El nombre de recurso de Amazon (ARN) de la aplicación.

creationTime

cadena

True

La fecha y la hora en que se creó este recurso.

parameterDefinitions

Matriz de tipo ParameterDefinition

True

Conjunto de tipos de parámetros admitidos por 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 tu AWS cuenta, por ejemplo, al crear nuevos AWS Identity and Access Management (IAM) usuarios. Para 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: :Group, AWS: :IAM::, AWS: :IAM: InstanceProfile :Policy y AWS: :IAM: :Role. https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html Si la aplicación contiene recursos de IAM, puede especificar o. CAPABILITY_IAM CAPABILITY_NAMED_IAM Si la aplicación contiene recursos de IAM con nombres personalizados, debe especificar CAPABILITY_NAMED_IAM.

Los siguientes recursos requieren que especifiquesCAPABILITY_RESOURCE_POLICY: AWS::Lambda:: Permission, AWS:: IAM:Policy, AWS AWS::ApplicationAutoScaling: :S3:: ScalingPolicy, AWS: BucketPolicy :SQS:: y AWS: :SNS:: QueuePolicy. 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 especificas 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, consulte lo siguiente:

CreateApplicationVersion