Registrieren und aktivieren Sie ein privates Modul oder einen Ressourcentyp eines Drittanbieters in Ihrem Konto - AWS CloudFormation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Registrieren und aktivieren Sie ein privates Modul oder einen Ressourcentyp eines Drittanbieters in Ihrem Konto

In diesem Thema werden die Schritte zur Registrierung eines privaten Moduls oder Ressourcentyps eines Drittanbieters beschrieben, der für Sie freigegeben wurde, und zur anschließenden Aktivierung über die AWS CloudFormation Registrierung mithilfe der Befehlszeile. Sobald die Erweiterung aktiviert ist, steht sie allen CloudFormation Vorlagen in dem Konto und der Region zur Verfügung, in der sie registriert wurde.

Anmerkung

Bevor Sie fortfahren, vergewissern Sie sich, dass Sie über die erforderlichen Voraussetzungen IAMBerechtigungen für die Registrierung einer privaten Erweiterung verfügen.

Um ein privates Modul oder einen Ressourcentyp zu registrieren, der mit Ihnen geteilt wurde (AWS CLI)

  1. Suchen Sie den Amazon S3 S3-Bucket, der das Projektpaket für das private Modul oder den Ressourcentyp enthält, den Sie in Ihrem Konto registrieren möchten.

  2. Verwenden Sie den Befehl register-type, um den privaten Ressourcentyp in Ihrem Konto zu registrieren.

    Mit dem folgenden Befehl wird beispielsweise der My::Resource::Example Ressourcentyp im angegebenen Verzeichnis registriert. AWS-Konto

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

    RegisterType ist ein asynchroner Vorgang und gibt ein Registrierungs-Token zurück, mit dem Sie den Fortschritt Ihrer Registrierungs-Anforderung verfolgen können.

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

    Wenn Ihre Erweiterung im AWS APIs Rahmen ihrer Funktionalität aufgerufen wird, müssen Sie eine IAM Ausführungsrolle erstellen, die die erforderlichen Berechtigungen für deren Aufruf enthält AWS APIs, und diese Ausführungsrolle in Ihrem Konto bereitstellen. Sie können diese Ausführungsrolle dann mithilfe der --execution-role-arn Option angeben. CloudFormation geht dann davon aus, dass diese Ausführungsrolle Ihrem Ressourcentyp die entsprechenden Anmeldeinformationen zur Verfügung stellt.

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

  3. (Optional) Verwenden Sie das Registrierungstoken mit describe-type-registrationBefehl, um den Fortschritt Ihrer Registrierungsanfrage zu verfolgen.

    Wenn die Registrierungsanfrage CloudFormation abgeschlossen ist, wird der Fortschrittsstatus der Anfrage auf gesetztCOMPLETE.

    Im folgenden Beispiel wird das vom oben genannten describe-type-registration Befehl zurückgegebene Registrierungs-Token verwendet, um Registrierungs-Statusinformationen zurückzugeben.

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

    Der Befehl gibt die folgende Ausgabe zurück.

    {
    "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"
}