URI Metodi HTTP Schemi Properties Consulta anche

Applicazioni: set di modifiche agli ID delle applicazioni

URI

/applications/applicationId/changesets

Metodi HTTP

POST

ID dell'operazione: CreateCloudFormationChangeSet

Crea un set di AWS CloudFormation modifiche per l'applicazione specificata.

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

Risposte
Codice di stato	Modello di risposta	Description
`201`	`ChangeSetDetails`	Completato
`400`	`BadRequestException`	Uno dei parametri della richiesta non è valido.
`403`	`ForbiddenException`	Il client non è autenticato.
`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.

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

Schemi

Corpi della richiesta


{
  "stackName": "string",
  "semanticVersion": "string",
  "templateId": "string",
  "parameterOverrides": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "capabilities": [
    "string"
  ],
  "changeSetName": "string",
  "clientToken": "string",
  "description": "string",
  "notificationArns": [
    "string"
  ],
  "resourceTypes": [
    "string"
  ],
  "rollbackConfiguration": {
    "rollbackTriggers": [
      {
        "arn": "string",
        "type": "string"
      }
    ],
    "monitoringTimeInMinutes": integer
  },
  "tags": [
    {
      "key": "string",
      "value": "string"
    }
  ]
}

Corpi della risposta


{
  "applicationId": "string",
  "semanticVersion": "string",
  "changeSetId": "string",
  "stackId": "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.

ChangeSetDetails

Dettagli del set di modifiche.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`applicationId`	stringa	True	L'applicazione Amazon Resource Name (ARN).
`changeSetId`	stringa	True	L'Amazon Resource Name (ARN) del set di modifiche. Vincoli della lunghezza: lunghezza minima 1. Modello: ARN: [-a-zA-Z0-9:/] *
`semanticVersion`	stringa	True	La versione semantica dell'applicazione: https://semver.org/
`stackId`	stringa	True	L'ID univoco dello stack.

CreateCloudFormationChangeSetInput

Crea una richiesta di set di modifiche all'applicazione.

Proprietà	Tipo	Campo obbligatorio	Description
`capabilities`	Array di tipo string	False	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::,: AWS::ApplicationAutoScaling: IAM:Policy ScalingPolicy, AWS: :S3:: BucketPolicy, AWS: :SQS:: e AWS:: QueuePolicy. SNS: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 sopra indicate, ti consigliamo di esaminare tutte le autorizzazioni associate all'applicazione prima della distribuzione. Se non specifichi questo parametro per un'applicazione che richiede funzionalità, la chiamata avrà esito negativo.
`changeSetName`	stringa	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormation CreateChangeSetAPI.
`clientToken`	stringa	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormation CreateChangeSetAPI.
`description`	stringa	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormation CreateChangeSetAPI.
`notificationArns`	Array di tipo string	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormation CreateChangeSetAPI.
`parameterOverrides`	Array di tipo ParameterValue	False	Un elenco di valori dei parametri per i parametri dell'applicazione.
`resourceTypes`	Array di tipo string	False	Questa proprietà corrisponde al parametro con lo stesso nome dell'AWS CloudFormation CreateChangeSetAPI.
`rollbackConfiguration`	RollbackConfiguration	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormation CreateChangeSetAPI.
`semanticVersion`	stringa	False	La versione semantica dell'applicazione: https://semver.org/
`stackName`	stringa	True	Questa proprietà corrisponde al parametro con lo stesso nome per l'CloudFormation CreateChangeSetAPI.
`tags`	Array di tipo Tag	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormation CreateChangeSetAPI.
`templateId`	stringa	False	L'UUID restituito da. CreateCloudFormationTemplate Schema: [0-9a-fA-F] {8}\ - [0-9a-fA-F] {4}\ - [0-9a-f] {4}\ - [0-9a-fA-F] {4}\ - [A-F0-9a-f] {12} A-F

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.

ParameterValue

Valore del parametro dell'applicazione.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`name`	stringa	True	La chiave associata al parametro. Se non specificate una chiave e un valore per un particolare parametro, CloudFormation utilizza il valore predefinito specificato nel modello.
`value`	stringa	True	Il valore di input associato al parametro.

RollbackConfiguration

Questa proprietà corrisponde al tipo di CloudFormation RollbackConfiguration dati.

Proprietà	Tipo	Campo obbligatorio	Description
`monitoringTimeInMinutes`	intero	False	Questa proprietà corrisponde al contenuto con lo stesso nome per il tipo di AWS CloudFormation RollbackConfiguration dati.
`rollbackTriggers`	Array di tipo RollbackTrigger	False	Questa proprietà corrisponde al contenuto con lo stesso nome per il tipo di AWS CloudFormation RollbackConfiguration dati.

RollbackTrigger

Questa proprietà corrisponde al tipo di CloudFormation RollbackTrigger dati.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`arn`	stringa	True	Questa proprietà corrisponde al contenuto con lo stesso nome per il tipo di AWS CloudFormation RollbackTrigger dati.
`type`	stringa	True	Questa proprietà corrisponde al contenuto con lo stesso nome per il tipo di AWS CloudFormation RollbackTrigger dati.

Tag

Questa proprietà corrisponde al tipo di dati del CloudFormation tag.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`key`	stringa	True	Questa proprietà corrisponde al contenuto con lo stesso nome del tipo di dati del AWS CloudFormation tag.
`value`	stringa	True	Questa proprietà corrisponde al contenuto con lo stesso nome per il tipo di dati del AWS CloudFormation tag.

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.

Consulta anche

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

CreateCloudFormationChangeSet

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 (ID dell'applicazione)

Applicazioni ApplicationID e dipendenze