AddApplicationVpcConfiguration - Amazon Managed Service para Apache Flink (anteriormente Amazon Kinesis Data Analytics para Apache Flink)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AddApplicationVpcConfiguration

Añade una configuración de nube privada virtual (VPC) a la aplicación. Las aplicaciones se pueden utilizar VPCs para almacenar y acceder a los recursos de forma segura.

Tenga en cuenta lo siguiente sobre las configuraciones de VPC para las aplicaciones de Managed Service para Apache Flink:

  • Las configuraciones de VPC no son compatibles con las aplicaciones SQL.

  • Cuando agrega una VPC a una aplicación de Managed Service para Apache Flink, ya no podrá acceder a la aplicación directamente desde Internet. Para habilitar el acceso a la aplicación a través de Internet, añada una puerta de enlace de Internet a la VPC.

Sintaxis de la solicitud

{ "ApplicationName": "string", "ConditionalToken": "string", "CurrentApplicationVersionId": number, "VpcConfiguration": { "SecurityGroupIds": [ "string" ], "SubnetIds": [ "string" ] } }

Parámetros de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

ApplicationName

El nombre de una aplicación existente.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.

Patrón: [a-zA-Z0-9_.-]+

Obligatorio: sí

ConditionalToken

El valor que utiliza para implementar una simultaneidad sólida en las actualizaciones de las aplicaciones. Debe proporcionar el ApplicationVersionID o el ConditionalToken. Obtiene el ConditionalToken actual de la aplicación mediante DescribeApplication. Para una mejor compatibilidad con la simultaneidad, utilice el parámetro ConditionalToken en lugar de CurrentApplicationVersionId.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es 512.

Patrón: [a-zA-Z0-9-_+/=]+

Obligatorio: no

CurrentApplicationVersionId

La versión de la aplicación a la que desea añadir la configuración de VPC. Debe proporcionar el CurrentApplicationVersionId o el ConditionalToken. Puede utilizar la operación DescribeApplication para obtener la versión actual de la aplicación. Si la versión especificada no es la actual, se devuelve la ConcurrentModificationException. Para una mejor compatibilidad con la simultaneidad, utilice el parámetro ConditionalToken en lugar de CurrentApplicationVersionId.

Tipo: largo

Rango válido: valor mínimo de 1. Valor máximo de 999 999 999.

Obligatorio: no

VpcConfiguration

La descripción de la VPC que se va a añadir a la aplicación.

Tipo: objeto VpcConfiguration

Obligatorio: sí

Sintaxis de la respuesta

{ "ApplicationARN": "string", "ApplicationVersionId": number, "OperationId": "string", "VpcConfigurationDescription": { "SecurityGroupIds": [ "string" ], "SubnetIds": [ "string" ], "VpcConfigurationId": "string", "VpcId": "string" } }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

ApplicationARN

El ARN de la aplicación.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.

Patrón: arn:.*

ApplicationVersionId

Otorga la versión actual de la aplicación. El servicio gestionado para Apache Flink se actualiza ApplicationVersionId cada vez que se actualiza la aplicación.

Tipo: largo

Rango válido: valor mínimo de 1. Valor máximo de 999999999.

OperationId

El ID de operación que se puede usar para rastrear la solicitud.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.

VpcConfigurationDescription

Los parámetros de la nueva configuración de VPC.

Tipo: objeto VpcConfigurationDescription

Errores

ConcurrentModificationException

Excepción que se produce como resultado de modificaciones simultáneas en una aplicación. El error puede deberse a un intento de modificar una aplicación sin utilizar el ID de la aplicación actual.

Código de estado HTTP: 400

InvalidApplicationConfigurationException

La configuración de la aplicación proporcionada por el usuario no es válida.

Código de estado HTTP: 400

InvalidArgumentException

El valor del parámetro de entrada especificado no es válido.

Código de estado HTTP: 400

ResourceInUseException

La aplicación no está disponible para esta operación.

Código de estado HTTP: 400

ResourceNotFoundException

No se encuentra la aplicación especificada.

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: