URI Metodi HTTP Schemi Proprietà Consulta anche

Applications ApplicationID Changesets

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`	String	True	Il nome della risorsa Amazon (ARN) dell'applicazione.

Risposte
Codice di stato	Modello di risposta	Descrizione
`201`	`ChangeSetDetails`	Riuscito
`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 servizio AWS Serverless Application Repository ha riscontrato un errore interno.

OPTIONS

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

Risposte
Codice di stato	Modello di risposta	Descrizione
`200`	None	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"
}

Proprietà

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:/] *
`Versione semantica`	stringa	True	La versione semantica dell'applicazione: https://semver.org/
`ID dello stack`	stringa	True	L'ID univoco dello stack.

CreateCloudFormationChangeSetInput

Crea una richiesta di set di modifiche all'applicazione.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`capacità`	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_IAMCAPABILITY_RESOURCE_POLICY`, e. `CAPABILITY_AUTO_EXPAND` Le seguenti risorse richiedono di specificare `CAPABILITY_IAM` o`CAPABILITY_NAMED_IAM`: AWS::IAM::Group AWS::IAM::InstanceProfile, AWS::IAM::Policy, e AWS::IAM::Role. Se l'applicazione contiene risorse IAM, puoi specificare `CAPABILITY_IAM` o`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,, AWS::ApplicationAutoScaling::ScalingPolicy AWS::S3::BucketPolicy, AWS::SQS::QueuePolicye AWS: :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 di cui sopra, ti consigliamo di rivedere 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.
`changeSetName`	stringa	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormationCreateChangeSetAPI.
`clientToken`	stringa	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormationCreateChangeSetAPI.
`description`	stringa	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormationCreateChangeSetAPI.
`Notifica (ARNS)`	Array di tipo string	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'API. AWS CloudFormationCreateChangeSet
`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 per l'API. AWS CloudFormationCreateChangeSet
`Configurazione Rollback`	RollbackConfiguration	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormationCreateChangeSetAPI.
`Versione semantica`	stringa	False	La versione semantica dell'applicazione: https://semver.org/
`Nome dello stack`	stringa	True	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormationCreateChangeSetAPI.
`tags`	Array di tipo Tag	False	Questa proprietà corrisponde al parametro con lo stesso nome per l'AWS CloudFormationCreateChangeSetAPI.
`TemplateID`	stringa	False	L'UUID restituito da. CreateCloudFormationTemplate Modello: [0-9a-Fa-F] {8}\ - [0-9a-fa-F] {4}\ - [0-9a-fa-F] {4}\ - [0-9a-fa-F] {4}\ - [0-9a-fa-F] {12}

ForbiddenException

Il client non è autenticato.

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

InternalServerErrorException

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

Proprietà	Tipo	Campo obbligatorio	Descrizione
`errorCode`	stringa	False	500
`message`	stringa	False	Il servizio AWS Serverless Application Repository 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, AWS 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 AWS CloudFormationRollbackConfigurationdati.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`monitoringTimeInMinuti`	integer	False	Questa proprietà corrisponde al contenuto con lo stesso nome per il tipo di AWS CloudFormationRollbackConfigurationdati.
`RollbackTriggers`	Array di tipo RollbackTrigger	False	Questa proprietà corrisponde al contenuto dello stesso nome per il AWS CloudFormationRollbackConfigurationtipo di dati.

RollbackTrigger

Questa proprietà corrisponde al tipo di AWS CloudFormationRollbackTriggerdati.

Proprietà	Tipo	Campo obbligatorio	Descrizione
`arn`	stringa	True	Questa proprietà corrisponde al contenuto dello stesso nome per il tipo di AWS CloudFormationRollbackTriggerdati.
`type`	stringa	True	Questa proprietà corrisponde al contenuto dello stesso nome per il tipo di AWS CloudFormationRollbackTriggerdati.

Tag

Questa proprietà corrisponde al tipo di dati del AWS CloudFormationtag.

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

TooManyRequestsException

Il client invia più del numero consentito di richieste 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 SDK AWS per linguaggi specifici, consulta le risorse seguenti:

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

ApplicationID delle applicazioni

Applications applicationId Dependencies