Registra un'estensione privata di terze parti nel tuo account

Individua il bucket Amazon S3 che contiene il pacchetto di progetto per l'estensione privata che desideri registrare nel tuo account.

Utilizzo dell'register-typecomando per registrare l'estensione privata nel tuo account.

Ad esempio, il comando seguente registra il tipo di My::Resource::Example risorsa nel campo specificato Account AWS.

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

RegisterType è un'operazione asincrona e restituisce un token di registrazione che è possibile utilizzare per monitorare lo stato di avanzamento della richiesta di registrazione.

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

Se la tua estensione chiama AWS APIs come parte della sua funzionalità, devi creare un ruolo di esecuzione IAM che includa le autorizzazioni necessarie per chiamarle AWS APIs e fornire tale ruolo di esecuzione nel tuo account. È quindi possibile specificare questo ruolo di esecuzione utilizzando l'--execution-role-arnopzione. CloudFormation assume quindi quel ruolo di esecuzione per fornire al tipo di risorsa le credenziali appropriate.

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

(Facoltativo) Utilizzate il token di registrazione con describe-type-registrationcomando per tracciare lo stato di avanzamento della richiesta di registrazione.

Quando CloudFormation completa la richiesta di registrazione, imposta lo stato di avanzamento della richiesta su. COMPLETE

Nell'esempio seguente viene utilizzato il token di registrazione restituito dal comando describe-type-registration sopra per restituire le informazioni sullo stato della registrazione.

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

Questo comando restituisce il seguente output.

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

Ottieni l'ARN per il tuo Hook e salvalo. Puoi ottenere l'ARN di un Hook usando o. AWS Management Console AWS CLI Per ulteriori informazioni, consulta Visualizza le estensioni disponibili e attivate nel CloudFormation registro.

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

Utilizzo dell'set-type-configurationcomando per specificare i dati di configurazione. Il JSON richiesto --configuration deve essere convalidato rispetto allo schema di configurazione di Hook. Per attivare l'Hook, è necessario impostare la HookInvocationStatus proprietà su ENABLED nella HookConfiguration sezione.

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

Per ulteriori informazioni, vedere il riferimento alla sintassi dello schema di configurazione di Hook nella Guida per l'utente di AWS CloudFormation Hooks.