applicationId Versions des applications semanticVersion - AWS Serverless Application Repository
URIHTTPméthodesSchémasPropriétésConsultez aussi

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.

applicationId Versions des applications semanticVersion

URI

/applications/applicationId/versions/semanticVersion

HTTPméthodes

PUT

ID de l'opération : CreateApplicationVersion

Crée une version de l'application.

Paramètres de chemin d'accès
NomTypeObligatoireDescription
applicationIdChaîneTrue

Le nom de la ressource Amazon (ARN) de l'application.

semanticVersionChaîneTrue

La version sémantique de la nouvelle version.

Réponses
Code d’étatModèle de réponseDescription
201Version

Réussite

400BadRequestException

L'un des paramètres dans la demande n'est pas valide.

403ForbiddenException

Le client n'est pas authentifié.

409ConflictException

La ressource existe déjà.

429TooManyRequestsException

Le client envoie un nombre de demandes supérieur au nombre autorisé par unité de temps.

500InternalServerErrorException

Le AWS Serverless Application Repository service a rencontré une erreur interne.

OPTIONS

Paramètres de chemin d'accès
NomTypeObligatoireDescription
applicationIdChaîneTrue

Le nom de la ressource Amazon (ARN) de l'application.

semanticVersionChaîneTrue

La version sémantique de la nouvelle version.

Réponses
Code d’étatModèle de réponseDescription
200Aucun

Réponse 200

Schémas

Corps de la demande

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

Corps de la réponse

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

Propriétés

BadRequestException

L'un des paramètres dans la demande n'est pas valide.

PropriétéTypeObligatoireDescription
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éTypeObligatoireDescription
errorCode

chaîne

False

409

message

chaîne

False

La ressource existe déjà.

CreateApplicationVersionInput

Créez une demande de version.

PropriétéTypeObligatoireDescription
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.

templateBody

chaîne

False

Le AWS SAM modèle brut empaqueté de votre application.

templateUrl

chaîne

False

Lien vers le AWS SAM modèle intégré de votre application.

ForbiddenException

Le client n'est pas authentifié.

PropriétéTypeObligatoireDescription
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éTypeObligatoireDescription
errorCode

chaîne

False

500

message

chaîne

False

Le AWS Serverless Application Repository service a rencontré une erreur interne.

ParameterDefinition

Paramètres pris en charge par l'application.

PropriétéTypeObligatoireDescription
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éTypeObligatoireDescription
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éTypeObligatoireDescription
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, etCAPABILITY_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 soitCAPABILITY_NAMED_IAM. Si l'application contient des IAM ressources avec des noms personnalisés, vous devez le spécifierCAPABILITY_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 :

CreateApplicationVersion