URI HTTPméthodes Schémas Propriétés Consultez aussi

Demandes applicationId

URI

/applications/applicationId

HTTPméthodes

GET

ID de l'opération : GetApplication

Obtient l'application spécifiée.

Paramètres de chemin d'accès
Nom	Type	Obligatoire	Description
`applicationId`	Chaîne	True	Le nom de la ressource Amazon (ARN) de l'application.

Paramètres Query (Requête)
Nom	Type	Obligatoire	Description
`semanticVersion`	Chaîne	False	Version sémantique de l'application à obtenir.

Réponses
Code d’état	Modèle de réponse	Description
`200`	`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é.
`404`	`NotFoundException`	La ressource (par exemple, une déclaration de politique d'accès) spécifiée dans la demande n'existe pas.
`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.

DELETE

ID de l'opération : DeleteApplication

Supprime l’application spécifiée.

Paramètres de chemin d'accès
Nom	Type	Obligatoire	Description
`applicationId`	Chaîne	True	Le nom de la ressource Amazon (ARN) de l'application.

Réponses
Code d’état	Modèle de réponse	Description
`204`	Aucun	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.
`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

Paramètres de chemin d'accès
Nom	Type	Obligatoire	Description
`applicationId`	Chaîne	True	Le nom de la ressource Amazon (ARN) de l'application.

Réponses
Code d’état	Modèle de réponse	Description
`200`	Aucun	Réponse 200

PATCH

ID de l'opération : UpdateApplication

Met à jour l'application spécifiée.

Paramètres de chemin d'accès
Nom	Type	Obligatoire	Description
`applicationId`	Chaîne	True	Le nom de la ressource Amazon (ARN) de l'application.

Réponses
Code d’état	Modèle de réponse	Description
`200`	`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é.
`404`	`NotFoundException`	La ressource (par exemple, une déclaration de politique d'accès) spécifiée dans la demande n'existe pas.
`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.

Schémas

Corps de la demande


{
  "description": "string",
  "author": "string",
  "readmeBody": "string",
  "readmeUrl": "string",
  "labels": [
    "string"
  ],
  "homePageUrl": "string"
}

Corps de la réponse


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


{
  "message": "string",
  "errorCode": "string"
}


{
  "message": "string",
  "errorCode": "string"
}


{
  "message": "string",
  "errorCode": "string"
}


{
  "message": "string",
  "errorCode": "string"
}


{
  "message": "string",
  "errorCode": "string"
}


{
  "message": "string",
  "errorCode": "string"
}

Propriétés

Application

Informations sur l'application.

Propriété	Type	Obligatoire	Description
`applicationId`	chaîne	True	L'application Amazon Resource Name (ARN).
`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] \|- (? ! -) * [a-z0-9]) ? $ » ;
`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	R URL avec plus d'informations 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 qu'il a confirmé que l'identité du demandeur est celle revendiquée.
`labels`	Tableau de types 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 : 10 Modèle : ^[a-zA-Z0-9+\\-_:\\/@]+$
`licenseUrl`	chaîne	False	Lien vers un fichier de licence de l'application qui correspond à la valeur d'spdxLicenseidentifiant de votre application. Taille maximale 5 Mo
`name`	chaîne	True	Nom de l'application. Longueur minimale = 1. Longueur maximale = 140 Modèle : [a-zA-Z0-9\-]+
`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	Vers URL le profil public d'un auteur vérifié. Ceci URL est soumis par l'auteur.
`version`	Version	False	Informations sur la version de l'application.

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à.

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 types 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 (*****).
`referencedByResources`	Tableau de types 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<Number> \| CommaDelimitedList` `String`: chaîne littérale. Par exemple, les utilisateurs peuvent spécifier`"MyUserName"`. `Number`: entier ou valeur flottante. AWS 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<Number>`: tableau d'entiers ou de nombres flottants séparés par des virgules. AWS 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.

UpdateApplicationInput

Mettez à jour la demande de candidature.

Propriété	Type	Obligatoire	Description
`author`	chaîne	False	Nom de l'auteur qui publie l'application. Longueur minimale = 1. Longueur maximale = 127. Motif « ^ [a-z0-9] (([a-z0-9] \|- (? ! -) * [a-z0-9]) ? $ » ;
`description`	chaîne	False	Description de l'application. Longueur minimale = 1. Longueur maximale = 256
`homePageUrl`	chaîne	False	R URL avec plus d'informations sur l'application, par exemple l'emplacement de votre GitHub référentiel pour l'application.
`labels`	Tableau de types 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 : 10 Modèle : ^[a-zA-Z0-9+\\-_:\\/@]+$
`readmeBody`	chaîne	False	Un fichier texte readme en langage Markdown qui contient une description plus détaillée de l'application et de son fonctionnement. Taille maximale 5 Mo
`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

Version

Détails de la version de l'application.

Propriété	Type	Obligatoire	Description
`applicationId`	chaîne	True	L'application Amazon Resource Name (ARN).
`creationTime`	chaîne	True	Date et heure de création de cette ressource.
`parameterDefinitions`	Tableau de types ParameterDefinition	True	Tableau de types de paramètres pris en charge par l'application.
`requiredCapabilities`	Tableau de types Capacité	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 AWS Identity and Access Management (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_IAMCAPABILITY_NAMED_IAM`,`CAPABILITY_RESOURCE_POLICY`, et`CAPABILITY_AUTO_EXPAND`. Les ressources suivantes nécessitent que vous spécifiez `CAPABILITY_IAM` or `CAPABILITY_NAMED_IAM` : AWS: IAM : :Group, AWS: : : IAM :InstanceProfile, AWS : : :Policy et IAM : : AWS IAM: :Role. Si l'application contient IAM des ressources, vous pouvez spécifier `CAPABILITY_IAM` soit`CAPABILITY_NAMED_IAM`. Si l'application contient des IAM ressources avec des noms personnalisés, vous devez le spécifier`CAPABILITY_NAMED_IAM`. Les ressources suivantes nécessitent que vous spécifiez `CAPABILITY_RESOURCE_POLICY` : AWS: :Lambda : :Permission, AWS: ::PolicyIAM, : : : AWS :, AWS :S3 ApplicationAutoScaling : ScalingPolicy : :, : : : : :, et BucketPolicy AWS: : : SQS :. QueuePolicy AWS SNS TopicPolicy 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	La version sémantique de l'application : https://semver.org/
`sourceCodeArchiveUrl`	chaîne	False	Lien vers l'objet S3 qui contient l'ZIParchive du code source de cette version de votre application. Taille maximale 50 Mo
`sourceCodeUrl`	chaîne	False	Lien vers un dépôt public pour le code source de votre application, par exemple le code 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 son utilisation API dans l'une des références spécifiques au langage AWS SDKs, consultez ce qui suit :

GetApplication

DeleteApplication

UpdateApplication

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Applications

Ensembles de applicationId modifications pour les applications