View a markdown version of this page

Gemeinsame Nutzung von AMI mit einer Organisation oder OU verwalten - Amazon Elastic Compute Cloud
Organisationen und OEs anzeigen, für die ein AMI freigegeben istEin AMI für eine Organisation oder einer OE freigebenSo beenden Sie die Freigabe eines AMI für eine Organisation oder OU

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.

Gemeinsame Nutzung von AMI mit einer Organisation oder OU verwalten

Verwalten Sie die gemeinsame AMI-Verwendung mit Organisationen und Organisationseinheiten (OUs), um zu kontrollieren, ob diese Amazon-EC2-Instances starten können.

Anzeigen der Organisationen und OEs, für die ein AMI freigegeben ist

Sie können die Organisationen und OUs suchen, für die Sie Ihr AMI freigegeben haben

Console
So überprüfen Sie, für welche Organisationen und OEs Sie Ihr AMI freigegeben haben

  1. Öffnen Sie die Amazon-EC2-Konsole unter https://console.aws.amazon.com/ec2/.

  2. Wählen Sie im Navigationsbereich die Option AMIs.

  3. Wählen Sie Ihr AMI in der Liste aus, wählen Sie den Tab Permissions und scrollen Sie nach unten zu Shared. organizations/OUs

    Um AMIs zu finden, die für Sie freigegeben wurden, lesen Sie Freigegebene AMIs zur Verwendung für Amazon-EC2-Instances suchen.

AWS CLI
So überprüfen Sie, für welche Organisationen und OEs Sie Ihr AMI freigegeben haben

Verwenden Sie den Befehl describe-image-attribute mit dem Attribut launchPermission.

aws ec2 describe-image-attribute \
    --image-id ami-0abcdef1234567890 \
    --attribute launchPermission

Nachfolgend finden Sie eine Beispielantwort.

{
    "ImageId": "ami-0abcdef1234567890",
    "LaunchPermissions": [
        {
            "OrganizationalUnitArn": "arn:aws:organizations::111122223333:ou/o-123example/ou-1234-5example"
        }
    ]
}
PowerShell
So überprüfen Sie, für welche Organisationen und OEs Sie Ihr AMI freigegeben haben

Verwenden Sie das cmdlet Get-EC2ImageAttribute.

Get-EC2ImageAttribute `
    -ImageId ami-0abcdef1234567890 `
    -Attribute launchPermission

Ein AMI für eine Organisation oder einer OE freigeben

Sie können ein AMI für eine Organisation oder einer OU freigeben

Anmerkung

Sie müssen die Amazon EBS-Snapshots, auf die ein AMI verweist, nicht teilen, um das AMI gemeinsam zu nutzen. Nur das AMI selbst muss freigegeben werden. Das System stellt automatisch Instance-Zugriff auf die referenzierten EBS-Snapshots für den Start bereit. Sie müssen jedoch die KMS-Schlüssel freigeben, die zum Verschlüsseln von Snapshots verwendet werden, auf die das AMI verweist. Weitere Informationen finden Sie unter Organisationen und OEs erlauben, einen KMS-Schlüssel zu verwenden.

Console
So geben Sie ein AMI für eine Organisation oder einer OE frei

  1. Öffnen Sie die Amazon-EC2-Konsole unter https://console.aws.amazon.com/ec2/.

  2. Wählen Sie im Navigationsbereich die Option AMIs.

  3. Wählen Sie das AMI in der Liste aus und wählen Sie dann Aktionen, AMI-Berechtigungen bearbeiten aus.

  4. Unter AMI-Verfügbarkeit wählen Sie Privat aus.

  5. Wählen Sie neben Shared organizations/OUs die Option Add organization/OU ARN aus.

  6. Geben Sie für Organization/OU ARN den Organisations-ARN oder OU-ARN ein, mit dem Sie das AMI teilen möchten, und wählen Sie dann Share AMI aus. Beachten Sie, dass Sie den vollständigen ARN angeben müssen, nicht nur die ID.

    Um dieses AMI für mehrere Organisationen oder OEs freizugeben, wiederholen Sie diesen Schritt, bis alle erforderlichen Organisationen oder OEs hinzugefügt wurden.

  7. Wählen Sie abschließend Save changes (Änderungen speichern) aus.

  8. (Optional) Um die Organisationen oder Organisationseinheiten anzuzeigen, mit denen Sie das AMI geteilt haben, wählen Sie das AMI in der Liste aus, wählen Sie die Registerkarte Berechtigungen und scrollen Sie nach unten zu Shared organizations/OUs. Um AMIs zu finden, die für Sie freigegeben wurden, lesen Sie Freigegebene AMIs zur Verwendung für Amazon-EC2-Instances suchen.

AWS CLI
So geben Sie ein AMI für eine Organisation frei

Verwenden Sie den Befehl modify-image-attribute, um der angegebenen Organisation Startberechtigungen für das angegebene AMI zu erteilen.

aws ec2 modify-image-attribute \
    --image-id ami-0abcdef1234567890 \
    --launch-permission "Add=[{OrganizationArn=arn:aws:organizations::123456789012:organization/o-123example}]"
So geben Sie ein AMI für eine OE frei

Der Befehl modify-image-attribute erteilt der angegebenen OE Startberechtigungen für das angegebene AMI. Beachten Sie, dass Sie den vollständigen ARN angeben müssen, nicht nur die ID.

aws ec2 modify-image-attribute \
    --image-id ami-0abcdef1234567890 \
    --launch-permission "Add=[{OrganizationalUnitArn=arn:aws:organizations::123456789012:ou/o-123example/ou-1234-5example}]"
PowerShell

Verwenden Sie den Edit-EC2ImageAttribute Befehl (Tools für Windows PowerShell), um ein AMI gemeinsam zu nutzen, wie in den folgenden Beispielen gezeigt.

So geben Sie ein AMI für eine Organisation oder einer OE frei

Der folgende Befehl erteilt der angegebenen Organisation Startberechtigungen für das angegebene AMI.

Edit-EC2ImageAttribute `
    -ImageId ami-0abcdef1234567890 `
    -Attribute launchPermission `
    -OperationType add `
    -OrganizationArn "arn:aws:organizations::123456789012:organization/o-123example"
So beenden Sie die Freigabe eines AMI für eine Organisation oder OE

Der folgende Befehl entfernt Startberechtigungen für das angegebene AMI von der angegebenen Organisation:

Edit-EC2ImageAttribute `
    -ImageId ami-0abcdef1234567890 `
    -Attribute launchPermission `
    -OperationType remove `
    -OrganizationArn "arn:aws:organizations::123456789012:organization/o-123example"
Um die gemeinsame Nutzung eines AMI mit allen Organisationen, Organisationseinheiten und AWS-Konten

Der folgende Befehl entfernt alle öffentlichen und expliziten Startberechtigungen vom angegebenen AMI. Hinweis: Der Besitzer des AMI hat immer Startberechtigungen und bleibt daher von dem Befehl unberührt.

Reset-EC2ImageAttribute `
    -ImageId ami-0abcdef1234567890 `
    -Attribute launchPermission

So beenden Sie die Freigabe eines AMI für eine Organisation oder OU

Sie können die Freigabe eines AMI für eine Organisation oder OU beenden.

Anmerkung

Sie können die Freigabe eines AMI für ein bestimmtes Konto nicht beenden, wenn es sich in einer Organisation oder OE befindet, für die ein AMI freigegeben ist. Wenn Sie versuchen, die Freigabe des AMI zu beenden, indem Sie die Startberechtigungen für das Konto entfernen, gibt Amazon EC2 eine Erfolgsmeldung zurück. Das AMI ist jedoch weiterhin für das Konto freigegeben.

Console
So beenden Sie die Freigabe eines AMI für eine Organisation oder OE

  1. Öffnen Sie die Amazon-EC2-Konsole unter https://console.aws.amazon.com/ec2/.

  2. Wählen Sie im Navigationsbereich die Option AMIs.

  3. Wählen Sie das AMI in der Liste aus und wählen Sie dann Aktionen, AMI-Berechtigungen bearbeiten aus.

  4. Wählen Sie unter Gemeinsam genutzt die Organisationen oder Organisationseinheiten aus organizations/OUs, für die Sie die gemeinsame Nutzung des AMI beenden möchten, und klicken Sie dann auf Ausgewählte entfernen.

  5. Wählen Sie abschließend Save changes (Änderungen speichern) aus.

  6. (Optional) Um zu bestätigen, dass Sie die gemeinsame Nutzung des AMI für die Organisationen oder Organisationseinheiten beendet haben, wählen Sie das AMI in der Liste aus, klicken Sie auf die Registerkarte Berechtigungen und scrollen Sie nach unten zu Shared organizations/OUs.

AWS CLI
So beenden Sie die Freigabe eines AMI für eine Organisation oder OE

Verwenden Sie den Befehl modify-image-attribute. Dieses Beispiel entfernt Startberechtigungen für das angegebene AMI von der angegebenen Organisation.

aws ec2 modify-image-attribute \
    --image-id ami-0abcdef1234567890 \
    --launch-permission "Remove=[{OrganizationArn=arn:aws:organizations::123456789012:organization/o-123example}]"
Um die gemeinsame Nutzung eines AMI mit allen Organisationen, Organisationseinheiten und AWS-Konten

Verwenden Sie den Befehl reset-image-attribute. Dieses Beispiel entfernt alle öffentlichen und expliziten Startberechtigungen vom angegebenen AMI. Hinweis: Der Besitzer des AMI hat immer Startberechtigungen und bleibt daher von dem Befehl unberührt.

aws ec2 reset-image-attribute \
    --image-id ami-0abcdef1234567890 \
    --attribute launchPermission
PowerShell
So beenden Sie die Freigabe eines AMI für eine Organisation oder OE

Verwenden Sie das cmdlet Edit-EC2ImageAttribute. Dieses Beispiel entfernt Startberechtigungen für das angegebene AMI von der angegebenen Organisation.

Edit-EC2ImageAttribute `
    -ImageId ami-0abcdef1234567890 `
    -Attribute launchPermission `
    -OperationType remove `
    -OrganizationArn "arn:aws:organizations::123456789012:organization/o-123example"
Um die gemeinsame Nutzung eines AMI mit allen Organisationen, Organisationseinheiten und AWS-Konten

Verwenden Sie das cmdlet Reset-EC2ImageAttribute. Dieses Beispiel entfernt alle öffentlichen und expliziten Startberechtigungen vom angegebenen AMI. Hinweis: Der Besitzer des AMI hat immer Startberechtigungen und bleibt daher von dem Befehl unberührt.

Reset-EC2ImageAttribute `
    -ImageId ami-0abcdef1234567890 `
    -Attribute LaunchPermission