Registro y activación de un enlace privado de terceros en su cuenta - AWS CloudFormation

Registro y activación de un enlace privado de terceros en su cuenta

En este tema, se explican los pasos para registrar un enlace privado de terceros que se haya compartido con usted y, después, activarlo a través del registro AWS CloudFormation mediante la línea de comandos. Una vez activado el enlace, estará disponible para todas las pilas de CloudFormation de la cuenta y la región en las que se registró.

nota

Antes de continuar, confirme que tiene una copia local del paquete de proyecto del enlace. Este paquete contiene todos los archivos fuente necesarios para el enlace que desea registrar.

Registro de un enlace privado que se comparte con usted (CFN-CLI)

  1. Asegúrese de tener instalada la CLI de CloudFormation. Para obtener más información, consulte Instalación de la CLI de CloudFormation en la Guía del usuario de la CLI de CloudFormation.

  2. Utilice el comando cfn submit para registrar el enlace y configurarlo como el enlace predeterminado para su cuenta en la región especificada. Este comando cargará el paquete del enlace desde el directorio actual a su Cuenta de AWS.

    cfn submit --set-default --region us-west-2

    Si la operación se realiza correctamente, el comando devuelve la siguiente salida.

    {‘ProgressStatus’: ‘COMPLETE’}

Una vez registrado el enlace, puede activarlo para su Cuenta de AWS al especificar sus datos de configuración.

Activación del enlace (AWS CLI)

  1. Obtenga del ARN para su enlace y guárdelo. Puede obtener el ARN de un enlace mediante AWS Management Console o AWS CLI. Para obtener más información, consulte Visualización de las extensiones disponibles y activadas en el registro de CloudFormation. 

    export HOOK_TYPE_ARN="arn:aws:cloudformation:us-east-1:123456789012:type/hook/Organization-Service-Hook/"

  2. Utilice el comando set-type-configuration para especificar los datos de configuración. El JSON que pase para --configuration debe validarse con el esquema de configuración del enlace. Para activar el enlace en todas las operaciones de pila, debe establecer la propiedad TargetStacks en ALL en la sección HookConfiguration.

    aws cloudformation set-type-configuration \
  --configuration "{"CloudFormationConfiguration":{"HookConfiguration":{"TargetStacks": "ALL", "FailureMode": "FAIL", "Properties":{}}}}" \
  --type-arn $HOOK_TYPE_ARN --region us-west-2

    Para obtener más información acerca de las opciones de configuración de HookConfiguration, consulte el Esquema de configuración del enlace en la Guía del usuario del enlace de AWS CloudFormation.