Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Applications ## URI `/applications` ## Méthodes HTTP ### GET **ID de l'opération :** `ListApplications` Répertorie les applications dont le demandeur est propriétaire. **Paramètres Query (Requête)** | Nom | Type | Obligatoire | Description | | --- |--- |--- |--- | | maxItems | String | False | Le nombre total d'articles à retourner. | | nextToken | String | False | Jeton permettant de spécifier où commencer la pagination. | **Réponses** | Code de statut | Modèle de réponse | Description | | --- |--- |--- | | 200 | ApplicationPage | Réussite | | 400 | BadRequestException | L'un des paramètres dans la demande n'est pas valide. | | 403 | ForbiddenException | Le client n'est pas authentifié. | | 404 | NotFoundException | La ressource (par exemple, une déclaration de politique d'accès) spécifiée dans la demande n'existe pas. | | 500 | InternalServerErrorException | Le AWS Serverless Application Repository service a rencontré une erreur interne. | ### POST **ID de l'opération :** `CreateApplication` Crée une application, en incluant éventuellement un fichier AWS SAM pour créer la première version de l'application dans le même appel. **Réponses** | Code de statut | Modèle de réponse | Description | | --- |--- |--- | | 201 | Application | Réussite | | 400 | BadRequestException | L'un des paramètres dans la demande n'est pas valide. | | 403 | ForbiddenException | Le client n'est pas authentifié. | | 409 | ConflictException | La ressource existe déjà. | | 429 | TooManyRequestsException | Le client envoie un nombre de demandes supérieur au nombre autorisé par unité de temps. | | 500 | InternalServerErrorException | Le AWS Serverless Application Repository service a rencontré une erreur interne. | ### OPTIONS **Réponses** | Code de statut | Modèle de réponse | Description | | --- |--- |--- | | 200 | Aucune | Réponse 200 | ## Schémas ### Corps de la demande #### Schéma 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" } ``` ### Corps de la réponse #### Schéma ApplicationPage ``` { "applications": [ { "applicationId": "string", "name": "string", "description": "string", "author": "string", "spdxLicenseId": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string" } ], "nextToken": "string" } ``` #### Schéma 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 } } ``` #### Schéma BadRequestException ``` { "message": "string", "errorCode": "string" } ``` #### Schéma ForbiddenException ``` { "message": "string", "errorCode": "string" } ``` #### Schéma NotFoundException ``` { "message": "string", "errorCode": "string" } ``` #### Schéma ConflictException ``` { "message": "string", "errorCode": "string" } ``` #### Schéma TooManyRequestsException ``` { "message": "string", "errorCode": "string" } ``` #### Schéma InternalServerErrorException ``` { "message": "string", "errorCode": "string" } ``` ## Propriétés ### Application Informations sur l'application. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | applicationId | chaîne | True | Amazon Resource Name (ARN) de l'application . | | author | chaîne | True | Nom de l'auteur qui publie l'application.Longueur minimale = 1. Longueur maximale = 127.Motif « ^ [a-z0-9] (([a-z0-9] \$1- (? \$1 -) \$1 [a-z0-9]) ? \$1 » ; | | creationTime | chaîne | False | Date et heure de création de cette ressource. | | description | chaîne | True | Description de l'application.Longueur minimale = 1. Longueur maximale = 256 | | homePageUrl | chaîne | False | URL contenant des informations supplémentaires sur l'application, par exemple l'emplacement de votre GitHub référentiel pour l'application. | | isVerifiedAuthor | boolean | False | Spécifie si l'auteur de cette application a été vérifié. Cela signifie qu'il AWS a examiné de bonne foi, en tant que fournisseur de services raisonnable et prudent, les informations fournies par le demandeur et a confirmé que l'identité du demandeur est telle qu'elle est revendiquée. | | labels | Tableau de type string | False | Étiquettes pour améliorer la découverte des applications dans les résultats de recherche.Longueur minimale = 1. Longueur maximale = 127. Nombre maximum d'étiquettes : 10Modèle : ^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1 | | licenseUrl | chaîne | False | Lien vers un fichier de licence de l'application qui correspond à la valeur SPDXLicenseID de votre application.Taille maximale 5 Mo | | name | chaîne | True | Nom de l'application.Longueur minimale = 1. Longueur maximale = 140Modèle : [a-zA-Z0-9\$1-]\$1 | | readmeUrl | chaîne | False | Un lien vers le fichier readme en langage Markdown qui contient une description plus détaillée de l'application et de son fonctionnement.Taille maximale 5 Mo | | spdxLicenseId | chaîne | False | Un identifiant valide provenant de https://spdx.org/licenses/. | | verifiedAuthorUrl | chaîne | False | URL du profil public d'un auteur vérifié. Cette URL est soumise par l'auteur. | | version | [Version](#applications-model-version) | False | Informations sur la version de l'application. | ### ApplicationPage Une liste des détails de l'application. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | applications | Tableau de type [ApplicationSummary](#applications-model-applicationsummary) | True | Un ensemble de résumés de candidatures. | | nextToken | chaîne | False | Le jeton permettant de demander la page de résultats suivante. | ### ApplicationSummary Résumé des informations relatives à l'application. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | applicationId | chaîne | True | Amazon Resource Name (ARN) de l'application . | | author | chaîne | True | Nom de l'auteur qui publie l'application.Longueur minimale = 1. Longueur maximale = 127.Motif « ^ [a-z0-9] (([a-z0-9] \$1- (? \$1 -) \$1 [a-z0-9]) ? \$1 » ; | | creationTime | chaîne | False | Date et heure de création de cette ressource. | | description | chaîne | True | Description de l'application.Longueur minimale = 1. Longueur maximale = 256 | | homePageUrl | chaîne | False | URL contenant des informations supplémentaires sur l'application, par exemple l'emplacement de votre GitHub référentiel pour l'application. | | labels | Tableau de type string | False | Étiquettes pour améliorer la découverte des applications dans les résultats de recherche.Longueur minimale = 1. Longueur maximale = 127. Nombre maximum d'étiquettes : 10Modèle : ^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1 | | name | chaîne | True | Nom de l'application.Longueur minimale = 1. Longueur maximale = 140Modèle : [a-zA-Z0-9\$1-]\$1 | | spdxLicenseId | chaîne | False | Un identifiant valide provenant de [https://spdx.org/licenses/](https://spdx.org/licenses/). | ### BadRequestException L'un des paramètres dans la demande n'est pas valide. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | errorCode | chaîne | False | 400 | | message | chaîne | False | L'un des paramètres dans la demande n'est pas valide. | ### Capability Valeurs qui doivent être spécifiées pour déployer certaines applications. + `CAPABILITY_IAM` + `CAPABILITY_NAMED_IAM` + `CAPABILITY_AUTO_EXPAND` + `CAPABILITY_RESOURCE_POLICY` ### ConflictException La ressource existe déjà. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | errorCode | chaîne | False | 409 | | message | chaîne | False | La ressource existe déjà. | ### CreateApplicationInput Créez une demande de candidature. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | author | chaîne | True | Nom de l'auteur qui publie l'application.Longueur minimale = 1. Longueur maximale = 127.Motif « ^ [a-z0-9] (([a-z0-9] \$1- (? \$1 -) \$1 [a-z0-9]) ? \$1 » ; | | description | chaîne | True | Description de l'application.Longueur minimale = 1. Longueur maximale = 256 | | homePageUrl | chaîne | False | URL contenant des informations supplémentaires sur l'application, par exemple l'emplacement de votre GitHub référentiel pour l'application. | | labels | Tableau de type string | False | Étiquettes pour améliorer la découverte des applications dans les résultats de recherche.Longueur minimale = 1. Longueur maximale = 127. Nombre maximum d'étiquettes : 10Modèle : ^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1 | | licenseBody | chaîne | False | Un fichier texte local contenant la licence de l'application qui correspond à la valeur SPDXLicenseID de votre application. Le fichier est au format`file:///`.Taille maximale 5 MoVous ne pouvez spécifier que l'un `licenseBody` des deux `licenseUrl` ; dans le cas contraire, une erreur se produira. | | licenseUrl | chaîne | False | Lien vers l'objet S3 contenant la licence de l'application qui correspond à la valeur SPDXLicenseID de votre application.Taille maximale 5 MoVous ne pouvez spécifier que l'un `licenseBody` des deux `licenseUrl` ; dans le cas contraire, une erreur se produira. | | name | chaîne | True | Nom de l'application que vous souhaitez publier.Longueur minimale = 1. Longueur maximale = 140Modèle : [a-zA-Z0-9\$1-]\$1 | | readmeBody | chaîne | False | Un fichier texte readme local en langage Markdown qui contient une description plus détaillée de l'application et de son fonctionnement. Le fichier est au format`file:///`.Taille maximale 5 MoVous ne pouvez spécifier que l'un `readmeBody` des deux `readmeUrl` ; dans le cas contraire, une erreur se produira. | | readmeUrl | chaîne | False | Lien vers l'objet S3 en langage Markdown qui contient une description plus détaillée de l'application et de son fonctionnement.Taille maximale 5 MoVous ne pouvez spécifier que l'un `readmeBody` des deux `readmeUrl` ; dans le cas contraire, une erreur se produira. | | semanticVersion | chaîne | False | Version sémantique de l'application : [https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | chaîne | False | Lien vers l'objet S3 qui contient l'archive ZIP du code source de cette version de votre application.Taille maximale 50 Mo | | sourceCodeUrl | chaîne | False | Lien vers un référentiel public contenant le code source de votre application, par exemple l'URL d'un GitHub commit spécifique. | | spdxLicenseId | chaîne | False | Un identifiant valide provenant de [https://spdx.org/licenses/](https://spdx.org/licenses/). | | templateBody | chaîne | False | Le fichier AWS SAM modèle brut empaqueté local de votre application. Le fichier est au format`file:///`.Vous ne pouvez spécifier que l'un des deux `templateBody` `templateUrl` ; dans le cas contraire, une erreur se produira. | | templateUrl | chaîne | False | Lien vers l'objet S3 contenant le AWS SAM modèle empaqueté de votre application.Vous ne pouvez spécifier que l'un des deux `templateBody` `templateUrl` ; dans le cas contraire, une erreur se produira. | ### ForbiddenException Le client n'est pas authentifié. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | errorCode | chaîne | False | 403 | | message | chaîne | False | Le client n'est pas authentifié. | ### InternalServerErrorException Le AWS Serverless Application Repository service a rencontré une erreur interne. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | errorCode | chaîne | False | 500 | | message | chaîne | False | Le AWS Serverless Application Repository service a rencontré une erreur interne. | ### NotFoundException La ressource (par exemple, une déclaration de politique d'accès) spécifiée dans la demande n'existe pas. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | errorCode | chaîne | False | 404 | | message | chaîne | False | La ressource (par exemple, une déclaration de politique d'accès) spécifiée dans la demande n'existe pas. | ### ParameterDefinition Paramètres pris en charge par l'application. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | allowedPattern | chaîne | False | Expression régulière qui représente les modèles que vous voulez autoriser pour les types `String`. | | allowedValues | Tableau de type string | False | Tableau contenant la liste des valeurs autorisées pour le paramètre. | | constraintDescription | chaîne | False | Chaîne qui explique la contrainte lorsque celle-ci n'est pas respectée. Par exemple, sans description de contrainte, un paramètre dont le modèle `[A-Za-z0-9]+` est autorisé affiche le message d'erreur suivant lorsque l'utilisateur spécifie une valeur non valide : `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` En ajoutant une description de contrainte, telle que « ne doit contenir que des lettres majuscules et minuscules et des chiffres », vous pouvez afficher le message d'erreur personnalisé suivant : `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.` | | defaultValue | chaîne | False | Valeur correspondant au type approprié de modèle à utiliser si aucune valeur n’est spécifiée lors de la création d’une pile. Si vous avez défini des contraintes pour le paramètre, vous devez spécifier une valeur conforme à ces contraintes. | | description | chaîne | False | Chaîne de 4 000 caractères maximum qui décrit le paramètre. | | maxLength | entier | False | Valeur entière qui détermine le plus grand nombre de caractères que vous souhaitez autoriser pour les `String` types. | | maxValue | entier | False | Valeur numérique qui détermine la plus grande valeur numérique que vous souhaitez autoriser pour `Number` les types. | | minLength | entier | False | Valeur entière qui détermine le plus petit nombre de caractères que vous souhaitez autoriser pour les `String` types. | | minValue | entier | False | Valeur numérique qui détermine la plus petite valeur numérique que vous souhaitez autoriser pour `Number` les types. | | name | chaîne | True | Nom du paramètre. | | noEcho | boolean | False | S'il faut masquer la valeur du paramètre chaque fois que quelqu'un passe un appel décrivant la pile. Si vous définissez la valeur sur true, la valeur du paramètre est masquée par des astérisques (\$1\$1\$1\$1\$1). | | referencedByResources | Tableau de type string | True | Liste des AWS SAM ressources qui utilisent ce paramètre. | | type | chaîne | False | Type du paramètre.Valeurs valides : `String \| Number \| List \| CommaDelimitedList` `String`: chaîne littérale.Par exemple, les utilisateurs peuvent spécifier`"MyUserName"`. `Number`: entier ou valeur flottante. CloudFormation valide la valeur du paramètre sous forme de nombre. Toutefois, lorsque vous utilisez le paramètre ailleurs dans votre modèle (par exemple, en utilisant la fonction `Ref` intrinsèque), la valeur du paramètre devient une chaîne.Par exemple, les utilisateurs peuvent spécifier`"8888"`. `List`: tableau d'entiers ou de nombres flottants séparés par des virgules. CloudFormation valide la valeur du paramètre sous forme de nombres. Toutefois, lorsque vous utilisez le paramètre ailleurs dans votre modèle (par exemple, en utilisant la fonction `Ref` intrinsèque), la valeur du paramètre devient une liste de chaînes.Par exemple, les utilisateurs peuvent spécifier « 80,20 », puis `Ref` obtenir le résultat. `["80","20"]` `CommaDelimitedList`: tableau de chaînes littérales séparées par des virgules. Le nombre total de chaînes doit correspondre au nombre total de virgules, plus un. De plus, chaque chaîne de membres est découpée en espace.Par exemple, les utilisateurs peuvent spécifier « test, dev, prod », puis `Ref` obtenir le résultat. `["test","dev","prod"]` | ### TooManyRequestsException Le client envoie un nombre de demandes supérieur au nombre autorisé par unité de temps. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | errorCode | chaîne | False | 429 | | message | chaîne | False | Le client envoie un nombre de demandes supérieur au nombre autorisé par unité de temps. | ### Version Détails de la version de l'application. | Propriété | Type | Obligatoire | Description | | --- |--- |--- |--- | | applicationId | chaîne | True | Amazon Resource Name (ARN) de l'application . | | creationTime | chaîne | True | Date et heure de création de cette ressource. | | parameterDefinitions | Tableau de type [ParameterDefinition](#applications-model-parameterdefinition) | True | Tableau de types de paramètres pris en charge par l'application. | | requiredCapabilities | Tableau de type [Capability](#applications-model-capability) | True | Liste de valeurs que vous devez spécifier avant de pouvoir déployer certaines applications. Certaines applications peuvent inclure des ressources susceptibles d'affecter les autorisations de votre AWS compte, par exemple en créant de nouveaux Gestion des identités et des accès AWS (IAM) utilisateurs. Pour ces applications, vous devez explicitement reconnaître leurs capacités en spécifiant ce paramètre.Les seules valeurs valides sont `CAPABILITY_IAM``CAPABILITY_NAMED_IAM`,`CAPABILITY_RESOURCE_POLICY`, et`CAPABILITY_AUTO_EXPAND`.Les ressources suivantes nécessitent que vous spécifiiez `CAPABILITY_IAM` ou `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), et [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html). Si l'application contient des ressources IAM, vous pouvez spécifier `CAPABILITY_IAM` soit`CAPABILITY_NAMED_IAM`. Si l'application contient des ressources IAM dotées de noms personnalisés, vous devez spécifier `CAPABILITY_NAMED_IAM`.Les ressources suivantes nécessitent que vous spécifiiez `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)et. [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)Les applications contenant une ou plusieurs applications imbriquées exigent de spécifier `CAPABILITY_AUTO_EXPAND`.Si votre modèle d'application contient l'une des ressources ci-dessus, nous vous recommandons de vérifier toutes les autorisations associées à l'application avant le déploiement. Si vous ne spécifiez pas ce paramètre pour une application nécessitant des fonctionnalités, l'appel échouera. | | resourcesSupported | boolean | True | Si toutes les AWS ressources contenues dans cette application sont prises en charge dans la région dans laquelle elles sont récupérées. | | semanticVersion | chaîne | True | Version sémantique de l'application : [https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | chaîne | False | Lien vers l'objet S3 qui contient l'archive ZIP du code source de cette version de votre application.Taille maximale 50 Mo | | sourceCodeUrl | chaîne | False | Lien vers un référentiel public contenant le code source de votre application, par exemple l'URL d'un GitHub commit spécifique. | | templateUrl | chaîne | True | Lien vers le AWS SAM modèle intégré de votre application. | ## Consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'une des références spécifiques au langage AWS SDKs , consultez ce qui suit : ### ListApplications + [Interface de ligne de commande AWS V2](/goto/cli2/serverlessrepo-2017-09-08/ListApplications) + [Kit de développement logiciel AWS pour .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/ListApplications) + [Kit AWS SDK pour C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/ListApplications) + [SDK AWS pour Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/ListApplications) + [Kit AWS SDK pour Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/ListApplications) + [SDK AWS pour V3 JavaScript ](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/ListApplications) + [Kit de développement logiciel AWS pour Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK pour PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK pour Python](/goto/boto3/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK pour Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/ListApplications) ### CreateApplication + [Interface de ligne de commande AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplication) + [Kit de développement logiciel AWS pour .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplication) + [Kit AWS SDK pour C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplication) + [SDK AWS pour Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplication) + [Kit AWS SDK pour Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplication) + [SDK AWS pour V3 JavaScript ](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplication) + [Kit de développement logiciel AWS pour Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK pour PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK pour Python](/goto/boto3/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK pour Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplication)