Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
AddApplicationVpcConfiguration
Aggiunge una configurazione Virtual Private Cloud (VPC) all'applicazione. Le applicazioni possono utilizzare i VPC per archiviare e accedere alle risorse in modo sicuro.
Nota quanto segue sulle configurazioni VPC per le applicazioni Managed Service for Apache Flink:
-
Le configurazioni VPC non sono supportate per le applicazioni SQL.
-
Quando un VPC viene aggiunto a un'applicazione Managed Service for Apache Flink, non è più possibile accedere all'applicazione direttamente da Internet. Per abilitare l'accesso a Internet all'applicazione, aggiungi un gateway Internet al tuo VPC.
Sintassi della richiesta
{
"ApplicationName": "string
",
"ConditionalToken": "string
",
"CurrentApplicationVersionId": number
,
"VpcConfiguration": {
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ]
}
}
Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ApplicationName
-
Nome di un'applicazione esistente.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
[a-zA-Z0-9_.-]+
Campo obbligatorio: sì
- ConditionalToken
-
Un valore da utilizzare per implementare una forte concorrenza per gli aggiornamenti delle applicazioni. È necessario fornire il
ApplicationVersionID
o ilConditionalToken
. Ottieni l'ConditionalToken
utilizzo corrente dell'applicazioneDescribeApplication. Per un migliore supporto alla concorrenza, utilizzate ilConditionalToken
parametro anzichéCurrentApplicationVersionId
.▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 512 caratteri.
Modello:
[a-zA-Z0-9-_+/=]+
Campo obbligatorio: no
- CurrentApplicationVersionId
-
La versione dell'applicazione a cui si desidera aggiungere la configurazione VPC. È necessario fornire il
CurrentApplicationVersionId
o ilConditionalToken
. È possibile utilizzare l'DescribeApplicationoperazione per ottenere la versione corrente dell'applicazione. Se la versione specificata non è la versione corrente, viene restituitoConcurrentModificationException
. Per un migliore supporto della concorrenza, utilizzate ilConditionalToken
parametro anzichéCurrentApplicationVersionId
.Tipo: long
Intervallo valido: valore minimo di 1. Valore massimo di 999.999.999.
Campo obbligatorio: no
- VpcConfiguration
-
Descrizione del VPC da aggiungere all'applicazione.
Tipo: oggetto VpcConfiguration
Campo obbligatorio: sì
Sintassi della risposta
{
"ApplicationARN": "string",
"ApplicationVersionId": number,
"OperationId": "string",
"VpcConfigurationDescription": {
"SecurityGroupIds": [ "string" ],
"SubnetIds": [ "string" ],
"VpcConfigurationId": "string",
"VpcId": "string"
}
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- ApplicationARN
-
L'ARN dell'applicazione.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.
Modello:
arn:.*
- ApplicationVersionId
-
Fornisce la versione corrente dell'applicazione. Managed Service for Apache Flink si aggiorna ApplicationVersionId ogni volta che si aggiorna l'applicazione.
Tipo: long
Intervallo valido: valore minimo di 1. Valore massimo di 999.999.999.
- OperationId
-
L'ID dell'operazione che può essere utilizzato per tenere traccia della richiesta.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
- VpcConfigurationDescription
-
I parametri della nuova configurazione VPC.
Tipo: oggetto VpcConfigurationDescription
Errori
- ConcurrentModificationException
-
Eccezione generata a seguito di modifiche simultanee a un'applicazione. Questo errore può essere il risultato del tentativo di modificare un'applicazione senza utilizzare l'ID dell'applicazione corrente.
Codice di stato HTTP: 400
- InvalidApplicationConfigurationException
-
La configurazione dell'applicazione fornita dall'utente non è valida.
Codice di stato HTTP: 400
- InvalidArgumentException
-
Il valore del parametro di input specificato non è valido.
Codice di stato HTTP: 400
- ResourceInUseException
-
L'applicazione non è disponibile per questa operazione.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
L'applicazione specificata non è stata trovata.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: