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. # ApplicationID ## URI `/applications/applicationId` ## Métodos HTTP ### GET **ID de la operación:** `GetApplication` Obtiene la aplicación especificada. **Parámetros de la ruta** | Name | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | applicationId | Cadena | True | El nombre de recurso de Amazon (ARN) de la aplicación. | **Parámetros de consulta** | Name | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | semanticVersion | Cadena | False | La versión semántica de la aplicación que se va a obtener. | **Respuestas** | Código de estado | Modelo de respuesta | Description (Descripción) | | --- |--- |--- | | 200 | Application | 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. | | 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. | ### DELETE **ID de la operación:** `DeleteApplication` Elimina la aplicación especificada. **Parámetros de la ruta** | Name | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | applicationId | Cadena | True | El nombre de recurso de Amazon (ARN) de la aplicación. | **Respuestas** | Código de estado | Modelo de respuesta | Description (Descripción) | | --- |--- |--- | | 204 | Ninguno | 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. | | 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** | Name | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | applicationId | Cadena | True | El nombre de recurso de Amazon (ARN) de la aplicación. | **Respuestas** | Código de estado | Modelo de respuesta | Description (Descripción) | | --- |--- |--- | | 200 | Ninguno | Respuesta de 200 | ### PATCH **ID de la operación:** `UpdateApplication` Actualiza la aplicación especificada. **Parámetros de la ruta** | Name | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | applicationId | Cadena | True | El nombre de recurso de Amazon (ARN) de la aplicación. | **Respuestas** | Código de estado | Modelo de respuesta | Description (Descripción) | | --- |--- |--- | | 200 | Application | 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. | | 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. | ## Esquemas ### Cuerpos de la solicitud #### Esquema PATCH ``` { "description": "string", "author": "string", "readmeBody": "string", "readmeUrl": "string", "labels": [ "string" ], "homePageUrl": "string" } ``` ### Cuerpos de respuesta #### 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-applicationid-model-version) | False | Información sobre la versión de la aplicación. | ### 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. | ### 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. | ### UpdateApplicationInput Actualice la solicitud de solicitud. | Propiedad | Tipo | Obligatorio | Descripción | | --- |--- |--- |--- | | author | cadena | False | 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 | False | 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"; | | readmeBody | cadena | False | Un archivo readme de texto en lenguaje Markdown que contiene una descripción más detallada de la aplicación y su funcionamiento.Tamaño máximo: 5 MB | | 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 | ### 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-applicationid-model-parameterdefinition) | True | Conjunto de tipos de parámetros compatibles con la aplicación. | | requiredCapabilities | Matriz de tipo [Capability](#applications-applicationid-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: ### GetApplication + [Interfaz de línea de comandos de AWS V2](/goto/cli2/serverlessrepo-2017-09-08/GetApplication) + [AWS SDK para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/GetApplication) + [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/GetApplication) + [AWS SDK para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/GetApplication) + [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/GetApplication) + [AWS SDK para la JavaScript versión 3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/GetApplication) + [SDK de AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/GetApplication) + [SDK de AWS para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/GetApplication) + [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/GetApplication) + [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/GetApplication) ### DeleteApplication + [Interfaz de línea de comandos de AWS V2](/goto/cli2/serverlessrepo-2017-09-08/DeleteApplication) + [AWS SDK para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/DeleteApplication) + [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/DeleteApplication) + [AWS SDK para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/DeleteApplication) + [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/DeleteApplication) + [AWS SDK para la JavaScript versión 3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/DeleteApplication) + [SDK de AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/DeleteApplication) + [SDK de AWS para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/DeleteApplication) + [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/DeleteApplication) + [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/DeleteApplication) ### UpdateApplication + [Interfaz de línea de comandos de AWS V2](/goto/cli2/serverlessrepo-2017-09-08/UpdateApplication) + [AWS SDK para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/UpdateApplication) + [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/UpdateApplication) + [AWS SDK para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/UpdateApplication) + [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/UpdateApplication) + [AWS SDK para la JavaScript versión 3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/UpdateApplication) + [SDK de AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/UpdateApplication) + [SDK de AWS para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/UpdateApplication) + [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/UpdateApplication) + [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/UpdateApplication)