Registro y activación de un tipo de módulo o un recurso privado de terceros en su cuenta - AWS CloudFormation

Registro y activación de un tipo de módulo o un recurso privado de terceros en su cuenta

En este tema se describen los pasos para registrar un módulo o tipo de recurso privado de terceros que se haya compartido con usted y, a continuación, activarlo a través del registro de AWS CloudFormation mediante la línea de comandos. Una vez activada la extensión, estará disponible para todas las plantillas de CloudFormation de la cuenta y la región en las que se registró.

nota

Antes de continuar, confirme que tiene los requisitos Permisos de IAM para registrar una extensión privada.

Registro de un módulo o un tipo de recurso privado compartido con usted (AWS CLI)

  1. Busque el bucket de Amazon S3 que contiene el paquete de proyecto para el módulo o tipo de recurso privado que desea registrar en la cuenta.

  2. Utilice el comando register-type para registrar el tipo de recurso privado en la cuenta.

    Por ejemplo, el siguiente comando registra el tipo de recurso My::Resource::Example en la Cuenta de AWS especificada.

    aws cloudformation register-type --type RESOURCE \
  --type-name My::Resource::Example \
  --schema-handler-package [s3 object path] --region us-west-2

    RegisterType es una operación asíncrona y devuelve un token de registro que puede utilizar para hacer un seguimiento del progreso de la solicitud de registro.

    {
    "RegistrationToken": "f5525280-104e-4d35-bef5-8f1fexample"
}

    Si su extensión llama a las API de AWS como parte de su funcionalidad, debe crear un rol de ejecución de IAM que incluya los permisos necesarios para llamar a esas API de AWS y aprovisionar ese rol de ejecución en la cuenta. A continuación, puede especificar este rol de ejecución mediante la opción --execution-role-arn. CloudFormation asume entonces ese rol de ejecución para proporcionar las credenciales adecuadas a su tipo de recurso.

    --execution-role-arn arn:aws:iam::111122223333:role/MyIAMRole

  3. (Opcional) Utilice el token de registro con el comando describe-type-registration para realizar un seguimiento del progreso de su solicitud de registro.

    Cuando CloudFormation completa la solicitud de registro, establece el estado de progreso de la solicitud en COMPLETE.

    En el siguiente ejemplo, se utiliza el token de registro devuelto por el comando describe-type-registration anterior para devolver información de estado de registro.

    aws cloudformation describe-type-registration \
  --registration-token f5525280-104e-4d35-bef5-8f1fexample \
  --region us-west-2

    El comando devuelve el resultado siguiente.

    {
    "ProgressStatus": "COMPLETE",
    "TypeArn": "arn:aws:cloudformation:us-east-1:012345678910:type/resource/My-Resource-Example",
    "Description": "Deployment is currently in DEPLOY_STAGE of status COMPLETED; ",
    "TypeVersionArn": "arn:aws:cloudformation:us-east-1:111122223333:type/resource/My-Resource-Example/00000001"
}