URI Metodi HTTP Schemi Properties Consulta anche

Applicazioni ApplicationID Versions SemanticVersion

URI

/applications/applicationId/versions/semanticVersion

Metodi HTTP

PUT

ID dell'operazione: CreateApplicationVersion

Crea una versione dell'applicazione.

Parametri del percorso
Nome	Tipo	Campo obbligatorio	Descrizione
`applicationId`	Stringa	True	Il nome della risorsa Amazon (ARN) dell'applicazione.
`semanticVersion`	Stringa	True	La versione semantica della nuova versione.

Risposte
Codice di stato	Modello di risposta	Description
`201`	`Version`	Completato
`400`	`BadRequestException`	Uno dei parametri della richiesta non è valido.
`403`	`ForbiddenException`	Il client non è autenticato.
`409`	`ConflictException`	La risorsa esiste già.
`429`	`TooManyRequestsException`	Il client invia un numero di richieste superiore a quello consentito per unità di tempo.
`500`	`InternalServerErrorException`	Il AWS Serverless Application Repository servizio ha riscontrato un errore interno.

OPTIONS

Parametri del percorso
Nome	Tipo	Campo obbligatorio	Descrizione
`applicationId`	Stringa	True	Il nome della risorsa Amazon (ARN) dell'applicazione.
`semanticVersion`	Stringa	True	La versione semantica della nuova versione.

Risposte
Codice di stato	Modello di risposta	Description
`200`	Nessuno	Risposta 200

Schemi

Corpi della richiesta


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

Corpi della risposta


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

Properties

BadRequestException

Uno dei parametri della richiesta non è valido.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`errorCode`	stringa	False	400
`message`	stringa	False	Uno dei parametri della richiesta non è valido.

Funzionalità

Valori che devono essere specificati per distribuire alcune applicazioni.

CAPABILITY_IAM
CAPABILITY_NAMED_IAM
CAPABILITY_AUTO_EXPAND
CAPABILITY_RESOURCE_POLICY

ConflictException

La risorsa esiste già.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`errorCode`	stringa	False	409
`message`	stringa	False	La risorsa esiste già.

CreateApplicationVersionInput

Crea una richiesta di versione.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`sourceCodeArchiveUrl`	stringa	False	Un link all'oggetto S3 che contiene l'archivio ZIP del codice sorgente per questa versione dell'applicazione. Dimensione massima 50 MB
`sourceCodeUrl`	stringa	False	Un collegamento a un archivio pubblico per il codice sorgente dell'applicazione, ad esempio l'URL di un GitHub commit specifico.
`templateBody`	stringa	False	Il AWS SAM modello grezzo confezionato della tua applicazione.
`templateUrl`	stringa	False	Un link al AWS SAM modello preconfezionato della tua applicazione.

ForbiddenException

Il client non è autenticato.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`errorCode`	stringa	False	403
`message`	stringa	False	Il client non è autenticato.

InternalServerErrorException

Il AWS Serverless Application Repository servizio ha riscontrato un errore interno.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`errorCode`	stringa	False	500
`message`	stringa	False	Il AWS Serverless Application Repository servizio ha riscontrato un errore interno.

ParameterDefinition

Parametri supportati dall'applicazione.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`allowedPattern`	stringa	False	Espressione regolare che rappresenta i modelli da consentire per i tipi `String`.
`allowedValues`	Array di tipo string	False	Matrice contenente l’elenco dei valori consentiti per il parametro.
`constraintDescription`	stringa	False	Stringa che illustra un vincolo in caso di violazione del vincolo. Ad esempio, senza una descrizione del vincolo, un parametro associato al modello consentito `[A-Za-z0-9]+` restituisce il seguente messaggio di errore quando l’utente specifica un valore non valido: `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` Aggiungendo una descrizione del vincolo, ad esempio «deve contenere solo lettere e numeri maiuscoli e minuscoli», è possibile visualizzare il seguente messaggio di errore personalizzato: `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.`
`defaultValue`	stringa	False	Valore del tipo appropriato per il modello da utilizzare se non viene specificato alcun valore al momento della creazione di uno stack. Se per il parametro definisci vincoli, devi specificare un valore conforme a tali vincoli.
`description`	stringa	False	Una stringa composta da un massimo di 4.000 caratteri che descrive il parametro.
`maxLength`	intero	False	Un valore intero che determina il numero massimo di caratteri che si desidera consentire per `String` i tipi.
`maxValue`	intero	False	Un valore numerico che determina il valore numerico massimo che si desidera consentire per i tipi. `Number`
`minLength`	intero	False	Un valore intero che determina il numero minimo di caratteri che si desidera consentire per i tipi. `String`
`minValue`	intero	False	Un valore numerico che determina il valore numerico più piccolo che si desidera consentire per i tipi. `Number`
`name`	stringa	True	Nome del parametro.
`noEcho`	booleano	False	Se mascherare il valore del parametro ogni volta che qualcuno effettua una chiamata che descrive lo stack. Se si imposta il valore su true, il valore del parametro viene mascherato da asterischi (*****).
`referencedByResources`	Array di tipo string	True	Un elenco di AWS SAM risorse che utilizzano questo parametro.
`type`	stringa	False	Il tipo di parametro. Valori validi: `String \| Number \| List<Number> \| CommaDelimitedList` `String`: Una stringa letterale. Ad esempio, gli utenti possono specificare`"MyUserName"`. `Number`: Un numero intero o un float. CloudFormation convalida il valore del parametro come numero. Tuttavia, quando si utilizza il parametro in un altro punto del modello (ad esempio, utilizzando la funzione `Ref` intrinseca), il valore del parametro diventa una stringa. Ad esempio, gli utenti potrebbero specificare. `"8888"` `List<Number>`: Una matrice di numeri interi o float separati da virgole. CloudFormation convalida il valore del parametro come numeri. Tuttavia, quando si utilizza il parametro in un altro punto del modello (ad esempio, utilizzando la funzione `Ref` intrinseca), il valore del parametro diventa un elenco di stringhe. Ad esempio, gli utenti possono specificare «80,20" e quindi ottenere. `Ref` `["80","20"]` `CommaDelimitedList`: una matrice di stringhe letterali separate da virgole. Il numero totale di stringhe deve corrispondere al numero totale di virgole più uno. Inoltre, ogni stringa membro è tagliata con spazi. Ad esempio, gli utenti possono specificare «test, dev, prod» e quindi inserire i risultati. `Ref` `["test","dev","prod"]`

TooManyRequestsException

Il client sta inviando un numero di richieste superiore a quello consentito per unità di tempo.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`errorCode`	stringa	False	429
`message`	stringa	False	Il client sta inviando un numero di richieste superiore a quello consentito per unità di tempo.

Versione

Dettagli sulla versione dell'applicazione.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`applicationId`	stringa	True	L'applicazione Amazon Resource Name (ARN).
`creationTime`	stringa	True	La data e l'ora di creazione di questa risorsa.
`parameterDefinitions`	Array di tipo ParameterDefinition	True	Una serie di tipi di parametri supportati dall'applicazione.
`requiredCapabilities`	Array di tipo Capability	True	Un elenco di valori che è necessario specificare prima di poter distribuire determinate applicazioni. Alcune applicazioni potrebbero includere risorse che possono influire sulle autorizzazioni AWS dell'account, ad esempio creando nuovi AWS Identity and Access Management (IAM) utenti. Per tali applicazioni, è necessario riconoscerne esplicitamente le funzionalità specificando questo parametro. Gli unici valori validi sono`CAPABILITY_IAM`,`CAPABILITY_NAMED_IAM`, `CAPABILITY_RESOURCE_POLICY` e. `CAPABILITY_AUTO_EXPAND` Le seguenti risorse richiedono di specificare `CAPABILITY_IAM` or`CAPABILITY_NAMED_IAM`: AWS: :IAM: :Group, AWS: :IAM::, AWS: :IAM: InstanceProfile :Policy e AWS: :IAM: :Role. Se l'applicazione contiene risorse IAM, puoi specificare uno o. `CAPABILITY_IAM` `CAPABILITY_NAMED_IAM` Se l'applicazione include risorse IAM con nomi personalizzati, devi specificare `CAPABILITY_NAMED_IAM`. Le seguenti risorse richiedono di specificare`CAPABILITY_RESOURCE_POLICY`: AWS::Lambda: :Permission, AWS::,:: IAM:Policy ScalingPolicy, AWS AWS::ApplicationAutoScaling: :S3:: BucketPolicy, AWS: :SQS:: e AWS: :SNS:: QueuePolicy. TopicPolicy Le applicazioni che includono una o più applicazioni nidificate richiedono di specificare `CAPABILITY_AUTO_EXPAND`. Se il modello di applicazione contiene una delle risorse precedenti, ti consigliamo di esaminare tutte le autorizzazioni associate all'applicazione prima della distribuzione. Se non si specifica questo parametro per un'applicazione che richiede funzionalità, la chiamata avrà esito negativo.
`resourcesSupported`	booleano	True	Se tutte le AWS risorse contenute in questa applicazione sono supportate nella regione in cui viene recuperata.
`semanticVersion`	stringa	True	La versione semantica dell'applicazione: https://semver.org/
`sourceCodeArchiveUrl`	stringa	False	Un link all'oggetto S3 che contiene l'archivio ZIP del codice sorgente per questa versione dell'applicazione. Dimensione massima 50 MB
`sourceCodeUrl`	stringa	False	Un collegamento a un archivio pubblico per il codice sorgente dell'applicazione, ad esempio l'URL di un GitHub commit specifico.
`templateUrl`	stringa	True	Un link al AWS SAM modello preconfezionato della tua applicazione.

Consulta anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK e dei riferimenti specifici della lingua, consulta quanto segue:

CreateApplicationVersion

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Applicazioni, ApplicationID, Versioni

Cronologia dei documenti