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. # Applications ## URI `/applications` ## Métodos HTTP ### GET **ID de la operación:** `ListApplications` Muestra las aplicaciones que son propiedad del solicitante. **Parámetros de consulta** | Name | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | maxItems | Cadena | False | El número total de artículos que se van a devolver. | | nextToken | Cadena | False | Un token destinado a especificar dónde iniciar la paginación. | **Respuestas** | Código de estado | Modelo de respuesta | Description (Descripción) | | --- |--- |--- | | 200 | ApplicationPage | Success | | 400 | BadRequestException | Uno de los parámetros de la solicitud no es válido. | | 403 | ForbiddenException | El cliente no está autenticado. | | 404 | NotFoundException | El recurso (por ejemplo, una declaración de política de acceso) especificado en la solicitud no existe. | | 500 | InternalServerErrorException | El AWS Serverless Application Repository servicio ha detectado un error interno. | ### POST **ID de la operación:** `CreateApplication` Crea una aplicación y, si lo desea, incluye un archivo AWS SAM para crear la primera versión de la aplicación en la misma llamada. **Respuestas** | Código de estado | Modelo de respuesta | Description (Descripción) | | --- |--- |--- | | 201 | Application | 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 **Respuestas** | Código de estado | Modelo de respuesta | Description (Descripción) | | --- |--- |--- | | 200 | Ninguno | Respuesta de 200 | ## Esquemas ### Cuerpos de la solicitud #### Esquema POST ``` { "name": "string", "description": "string", "author": "string", "spdxLicenseId": "string", "licenseBody": "string", "licenseUrl": "string", "readmeBody": "string", "readmeUrl": "string", "labels": [ "string" ], "homePageUrl": "string", "semanticVersion": "string", "templateBody": "string", "templateUrl": "string", "sourceCodeUrl": "string", "sourceCodeArchiveUrl": "string" } ``` ### Cuerpos de respuesta #### Esquema ApplicationPage ``` { "applications": [ { "applicationId": "string", "name": "string", "description": "string", "author": "string", "spdxLicenseId": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string" } ], "nextToken": "string" } ``` #### Esquema Application ``` { "applicationId": "string", "name": "string", "description": "string", "author": "string", "isVerifiedAuthor": boolean, "verifiedAuthorUrl": "string", "spdxLicenseId": "string", "licenseUrl": "string", "readmeUrl": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string", "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 NotFoundException ``` { "message": "string", "errorCode": "string" } ``` #### Esquema ConflictException ``` { "message": "string", "errorCode": "string" } ``` #### Esquema TooManyRequestsException ``` { "message": "string", "errorCode": "string" } ``` #### Esquema InternalServerErrorException ``` { "message": "string", "errorCode": "string" } ``` ## Propiedades ### Application Detalles sobre la aplicación. | Propiedad | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | applicationId | cadena | True | El nombre de recurso de Amazon (ARN) de la aplicación. | | author | cadena | True | El nombre del autor que publica la aplicación.Longitud mínima = 1. Longitud máxima = 127.Patrón «^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1»; | | creationTime | cadena | False | La fecha y la hora en que se creó este recurso. | | description | cadena | True | La descripción de la aplicación.Longitud mínima = 1. Longitud máxima = 256 | | homePageUrl | cadena | False | Una URL con más información sobre la aplicación, por ejemplo, la ubicación del GitHub repositorio de la aplicación. | | isVerifiedAuthor | valor booleano | False | Especifica si se ha verificado el autor de esta aplicación. Esto significa que AWS ha revisado de buena fe, como proveedor de servicios razonable y prudente, la información proporcionada por el solicitante y ha confirmado que la identidad del solicitante es la que afirma. | | labels | Matriz de tipo string | False | Etiquetas para mejorar la detección de aplicaciones en los resultados de búsqueda.Longitud mínima = 1. Longitud máxima = 127. Número máximo de etiquetas: 10Patrón: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | licenseUrl | cadena | False | Un enlace a un archivo de licencia de la aplicación que coincide con el valor SPDXLicenseID de la aplicación.Tamaño máximo: 5 MB | | name | cadena | True | Nombre de la aplicación.Longitud mínima = 1. Longitud máxima = 140Patrón: "[a-zA-Z0-9\$1\$1-]\$1"; | | readmeUrl | cadena | False | Un enlace al archivo readme en lenguaje Markdown que contiene una descripción más detallada de la aplicación y su funcionamiento.Tamaño máximo: 5 MB | | spdxLicenseId | cadena | False | Un identificador válido de https://spdx.org/licenses/. | | verifiedAuthorUrl | cadena | False | La URL del perfil público de un autor verificado. Esta URL la envía el autor. | | version | [Versión](#applications-model-version) | False | Información sobre la versión de la aplicación. | ### ApplicationPage Lista de detalles de la aplicación. | Propiedad | Tipo | Obligatorio | Description (Descripción) | | --- |--- |--- |--- | | applications | Matriz de tipo [ApplicationSummary](#applications-model-applicationsummary) | True | Una variedad de resúmenes de solicitudes. | | nextToken | cadena | False | El token para solicitar la siguiente página de resultados. | ### ApplicationSummary Resumen de los detalles de la aplicación. | Propiedad | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | applicationId | cadena | True | El nombre de recurso de Amazon (ARN) de la aplicación. | | author | cadena | True | El nombre del autor que publica la aplicación.Longitud mínima = 1. Longitud máxima = 127.Patrón «^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1»; | | creationTime | cadena | False | La fecha y la hora en que se creó este recurso. | | description | cadena | True | La descripción de la aplicación.Longitud mínima = 1. Longitud máxima = 256 | | homePageUrl | cadena | False | Una URL con más información sobre la aplicación, por ejemplo, la ubicación del GitHub repositorio de la aplicación. | | labels | Matriz de tipo string | False | Etiquetas para mejorar la detección de aplicaciones en los resultados de búsqueda.Longitud mínima = 1. Longitud máxima = 127. Número máximo de etiquetas: 10Patrón: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | name | cadena | True | Nombre de la aplicación.Longitud mínima = 1. Longitud máxima = 140Patrón: "[a-zA-Z0-9\$1\$1-]\$1"; | | spdxLicenseId | cadena | False | [Un identificador válido de https://spdx.org/licenses/.](https://spdx.org/licenses/) | ### 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. | ### CreateApplicationInput Cree una solicitud de solicitud. | Propiedad | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | author | cadena | True | El nombre del autor que publica la aplicación.Longitud mínima = 1. Longitud máxima = 127.Patrón «^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1»; | | description | cadena | True | La descripción de la aplicación.Longitud mínima = 1. Longitud máxima = 256 | | homePageUrl | cadena | False | Una URL con más información sobre la aplicación, por ejemplo, la ubicación del GitHub repositorio de la aplicación. | | labels | Matriz de tipo string | False | Etiquetas para mejorar la detección de aplicaciones en los resultados de búsqueda.Longitud mínima = 1. Longitud máxima = 127. Número máximo de etiquetas: 10Patrón: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | licenseBody | cadena | False | Un archivo de texto local que contiene la licencia de la aplicación y que coincide con el valor spdxLicenseID de la aplicación. El archivo tiene el formato. `file:///`Tamaño máximo: 5 MBPuede especificar solo uno de ellos`licenseUrl`; `licenseBody` de lo contrario, se producirá un error. | | licenseUrl | cadena | False | Un enlace al objeto S3 que contiene la licencia de la aplicación que coincide con el valor SPDXLicenseID de la aplicación.Tamaño máximo: 5 MBPuede especificar solo uno de ellos`licenseUrl`; `licenseBody` de lo contrario, se producirá un error. | | name | cadena | True | El nombre de la aplicación que desea publicar.Longitud mínima = 1. Longitud máxima = 140Patrón: "[a-zA-Z0-9\$1\$1-]\$1"; | | readmeBody | cadena | False | Un archivo readme de texto local en lenguaje Markdown que contiene una descripción más detallada de la aplicación y de su funcionamiento. El archivo tiene el formato. `file:///`Tamaño máximo: 5 MBPuede especificar solo uno de ellos`readmeUrl`; `readmeBody` de lo contrario, se producirá un error. | | readmeUrl | cadena | False | Un enlace al objeto S3 en lenguaje Markdown que contiene una descripción más detallada de la aplicación y de su funcionamiento.Tamaño máximo: 5 MBPuede especificar solo uno de ellos`readmeUrl`; `readmeBody` de lo contrario, se producirá un error. | | semanticVersion | cadena | False | La versión semántica de la aplicación: [https://semver.org/](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. | | spdxLicenseId | cadena | False | Un identificador válido de [https://spdx.org/licenses/](https://spdx.org/licenses/). | | templateBody | cadena | False | El archivo de AWS SAM plantilla empaquetado sin procesar local de su aplicación. El archivo tiene el formato`file:///`.Puede especificar solo uno de `templateBody` y`templateUrl`; de lo contrario, se producirá un error. | | templateUrl | cadena | False | Un enlace al objeto S3 que contiene la AWS SAM plantilla empaquetada de su aplicación.Puede especificar solo una de las siguientes opciones`templateUrl`; `templateBody` de lo contrario, se producirá un error. | ### 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 ha detectado un error interno. | ### NotFoundException El recurso (por ejemplo, una declaración de política de acceso) especificado en la solicitud no existe. | Propiedad | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | errorCode | cadena | False | 404 | | message | cadena | False | El recurso (por ejemplo, una declaración de política de acceso) especificado en la solicitud no existe. | ### 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 mayúsculas y minúsculas», 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 | entero | False | Un valor entero que determina el número máximo 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 los `Number` tipos. | | minLength | entero | False | Un valor entero que determina el número mínimo de caracteres que desea permitir para los `String` tipos. | | minValue | entero | 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 (\$1\$1\$1\$1\$1). | | 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 \| CommaDelimitedList` `String`: cadena literal.Por ejemplo, los usuarios pueden especificar`"MyUserName"`. `Number`: entero o flotante. 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`: matriz de números enteros o números flotantes separados por comas. 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](#applications-model-parameterdefinition) | True | Conjunto de tipos de parámetros compatibles con la aplicación. | | requiredCapabilities | Matriz de tipo [Capability](#applications-model-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_IAM``CAPABILITY_NAMED_IAM`,`CAPABILITY_RESOURCE_POLICY`, y`CAPABILITY_AUTO_EXPAND`.Los siguientes recursos requieren que especifique `CAPABILITY_IAM` o`CAPABILITY_NAMED_IAM`: [AWS::IAM::Group[AWS::IAM::InstanceProfile](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html), [AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html), 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 una `CAPABILITY_IAM` o`CAPABILITY_NAMED_IAM`. Si la aplicación contiene recursos de IAM con nombres personalizados, debe especificar `CAPABILITY_NAMED_IAM`.Los siguientes recursos requieren que especifique`CAPABILITY_RESOURCE_POLICY`: [AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html), [AWS: :IAM:Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html),, [AWS::ApplicationAutoScaling::ScalingPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html), [AWS::S3::BucketPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html)y. [AWS::SQS::QueuePolicy[AWS::SNS::TopicPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)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/](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 idiomas específicos AWS SDKs y las referencias, consulte lo siguiente: ### ListApplications + [Interfaz de línea de comandos de AWS V2](/goto/cli2/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK para la JavaScript versión 3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/ListApplications) + [SDK de AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/ListApplications) + [SDK de AWS para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/ListApplications) ### CreateApplication + [Interfaz de línea de comandos de AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK para la JavaScript versión 3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplication) + [SDK de AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplication) + [SDK de AWS para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplication)