

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.

# Verbindungen teilen mit AWS-Konten
<a name="connections-share"></a>

Sie können Resource Sharing mit verwenden AWS RAM , um eine bestehende Verbindung mit einer anderen Person AWS-Konto oder mit Konten in Ihrer Organisation zu teilen. Sie können Ihre gemeinsame Verbindung mit Ressourcen verwenden AWS , die Sie für Quellverbindungen von Drittanbietern verwalten, z. B. in CodePipeline.

**Wichtig**  
Die gemeinsame Nutzung von Verbindungen wird für `codestar-connections ` Ressourcen nicht unterstützt. Dies wird nur für `codeconnections` Ressourcen unterstützt.

Bevor Sie beginnen:
+ Sie müssen bereits eine Verbindung mit Ihrem hergestellt haben AWS-Konto.
+ Sie müssen die gemeinsame Nutzung von Ressourcen aktiviert haben.
+ Sie müssen die erforderlichen Berechtigungen konfiguriert haben. Weitere Informationen finden Sie unter [Unterstützte Berechtigungen für die gemeinsame Nutzung von Verbindungen](security-iam.md#permissions-reference-connections-sharing).

**Anmerkung**  
Um die Verbindung gemeinsam nutzen zu können, müssen Sie der Eigentümer der Organisation oder des Repositorys sein, sofern Sie keiner Organisation angehören. Das Konto, mit dem Sie die Daten teilen, benötigt ebenfalls Berechtigungen für das Repository.

**Topics**
+ [Eine Verbindung teilen (Konsole)](#connections-share-console)
+ [Eine Verbindung teilen (CLI)](#connections-share-cli)
+ [Geteilte Verbindungen anzeigen (Konsole)](#connections-view-console)
+ [Geteilte Verbindungen anzeigen (CLI)](#connections-view-cli)

## Eine Verbindung teilen (Konsole)
<a name="connections-share-console"></a>

Sie können die Konsole verwenden, um gemeinsam genutzte Verbindungsressourcen zu erstellen.

1. Melden Sie sich bei der an AWS-Managementkonsole.

   Wählen Sie auf der Seite **[Von mir geteilt: Gemeinsam genutzte Ressourcen](https://console.aws.amazon.com/ram/home#OwnedResources:)** in der AWS RAM Konsole die Option **Ressourcenfreigabe erstellen** aus.

1. Da es in bestimmten AWS-Regionen AWS RAM Ressourcenfreigaben gibt, wählen Sie die entsprechende AWS-Region aus der Dropdownliste in der oberen rechten Ecke der Konsole aus. Um Ressourcenfreigaben zu erstellen, die globale Ressourcen enthalten, müssen Sie die AWS-Region auf USA Ost (Nord-Virginia) festlegen. 

   Weitere Informationen zur gemeinsamen Nutzung globaler Ressourcen finden Sie unter [Gemeinsame Nutzung regionaler Ressourcen im Vergleich zu globalen Ressourcen](https://docs.aws.amazon.com/ram/latest/userguide/working-with-regional-vs-global.html).

1. Geben Sie auf der Erstellungsseite im Feld **Name** einen Namen für Ihre gemeinsam genutzte Ressource ein. Wählen Sie unter **Ressourcen** die Option **Codeverbindungen** aus.  
![Fügen Sie eine Ressourcenfreigabe hinzu, indem Sie die Ressource auf der Erstellungsseite auswählen](http://docs.aws.amazon.com/de_de/dtconsole/latest/userguide/images/connections-share-create.png)

1. Wählen Sie Ihre Verbindungsressource und weisen Sie die Principals zu, mit denen Sie sie teilen möchten.

1. Wählen Sie **Erstellen** aus.

## Eine Verbindung teilen (CLI)
<a name="connections-share-cli"></a>

Sie können das AWS Command Line Interface (AWS CLI) verwenden, um eine bestehende Verbindung mit anderen Konten zu teilen und Verbindungen anzuzeigen, die Ihnen gehören oder die Sie mit Ihnen geteilt haben.

Verwenden Sie dazu die `accept-resource-share-invitation ` Befehle **create-resource-share** und für AWS RAM.

**Um eine Verbindung gemeinsam zu nutzen**

1. Melden Sie sich mit dem Konto an, das die Verbindung teilen wird.

1. Öffnen Sie die Eingabeaufforderung (Windows) oder das Terminal (Linux, macOS oder Unix). Verwenden Sie den, AWS CLI um den **create-resource-share** Befehl auszuführen, und geben Sie dabei `--name``--resource-arns`, und `--principals` für Ihre Verbindungsfreigabe an. In diesem Beispiel ist der Name `my-shared-resource` und der angegebene Verbindungsname steht `MyConnection` im Ressourcen-ARN. Geben Sie `principals` unter das Zielkonto oder die Zielkonten an, mit denen Sie Inhalte teilen.

   ```
   aws ram create-resource-share --name my-shared-resource --resource-arns {{connection_ARN}} --principals {{destination_account}}
   ```

   Wenn der Befehl erfolgreich ausgeführt wurde, gibt er die ARN-Informationen der Verbindung ähnlich der folgenden zurück.

   ```
   {
       "resourceShare": {
           "resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/4476c27d-8feb-4b21-afe9-7de23EXAMPLE",
           "name": "MyNewResourceShare",
           "owningAccountId": "111111111111",
           "allowExternalPrincipals": true,
           "status": "ACTIVE",
           "creationTime": 1634586271.302,
           "lastUpdatedTime": 1634586271.302
       }
   }
   ```

1. Anfragen zum Teilen können akzeptiert werden, wie im nächsten Verfahren beschrieben.

**Um die Verbindung zu authentifizieren und zu akzeptieren, teilen Sie sie mit dem Zielkonto**

Das folgende Verfahren ist optional für Zielkonten, die derselben Organisation angehören und für die die gemeinsame Nutzung von Ressourcen in Organizations aktiviert ist.

1. Melden Sie sich mit dem Zielkonto an, das die Einladung erhalten soll.

1. Öffnen Sie die Eingabeaufforderung (Windows) oder das Terminal (Linux, macOS oder Unix). Verwenden Sie den AWS CLI , um den **get-resource-share-invitations** Befehl auszuführen.

   ```
   aws ram get-resource-share-invitations
   ```

   Erfassen Sie den ARN für die Einladung zur Ressourcenfreigabe für den nächsten Schritt.

1. Führen Sie den **accept-resource-share-invitation** Befehl aus und geben Sie den an`--resource-share-invitation-arn`.

   ```
   aws ram accept-resource-share-invitation --resource-share-invitation-arn {{invitation_ARN}}
   ```

   Bei Erfolg gibt dieser Befehl die folgende Ausgabe zurück.

   ```
   {
       "resourceShareInvitation": {
           "resourceShareInvitationArn": "arn:aws:ram:us-west-2:111111111111:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE",
           "resourceShareName": "MyResourceShare",
           "resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE",
           "senderAccountId": "111111111111",
           "receiverAccountId": "222222222222",
           "invitationTimestamp": "2021-09-22T15:07:35.620000-07:00",
           "status": "ACCEPTED"
       }
   }
   ```

## Geteilte Verbindungen anzeigen (Konsole)
<a name="connections-view-console"></a>

Sie können die Konsole verwenden, um gemeinsam genutzte Verbindungsressourcen anzuzeigen.

1. Melden Sie sich bei der an AWS-Managementkonsole.

   Öffnen Sie die Seite **[Von mir gemeinsam genutzt: Gemeinsam genutzte Ressourcen](https://console.aws.amazon.com/ram/home#OwnedResources:)** in der AWS-RAM-Konsole.

1. Da AWS-RAM-Ressourcenfreigaben in bestimmten AWS-Regionen existieren, wählen Sie die entsprechende AWS-Region aus der Dropdownliste in der oberen rechten Ecke der Konsole aus. Um Ressourcenfreigaben zu sehen, die globale Ressourcen enthalten, müssen Sie die AWS-Region auf USA Ost (Nord-Virginia) festlegen. 

   Weitere Informationen zur gemeinsamen Nutzung globaler Ressourcen finden Sie unter [Gemeinsame Nutzung regionaler Ressourcen im Vergleich zu globalen Ressourcen](https://docs.aws.amazon.com/ram/latest/userguide/working-with-regional-vs-global.html).

1. Für jede freigegebene Ressource sind die folgenden Informationen verfügbar:
   + **Ressourcen-ID** — Die ID der Ressource. Wählen Sie die ID einer Ressource, um einen neuen Browser-Tab zu öffnen und die Ressource in der nativen Servicekonsole anzuzeigen.
   + **Ressourcentyp** — Der Ressourcentyp.
   + **Datum der letzten gemeinsamen** Nutzung — Das Datum, an dem die Ressource zuletzt gemeinsam genutzt wurde.
   + **Ressourcenfreigaben** — Die Anzahl der Ressourcenfreigaben, zu denen die Ressource gehört. Um die Liste der Ressourcenfreigaben zu sehen, wählen Sie die Anzahl aus.
   + **Principals** — Die Anzahl der Principals, die auf die Ressource zugreifen können. Wählen Sie den Wert, um die Principals anzuzeigen.

## Geteilte Verbindungen anzeigen (CLI)
<a name="connections-view-cli"></a>

Sie können die verwenden AWS CLI , um Verbindungen anzuzeigen, die Ihnen gehören oder die Sie mit Ihnen geteilt haben.

Verwenden Sie dazu den Befehl **get-resource-shares**.

**Um geteilte Verbindungen anzuzeigen**
+ Öffnen Sie die Eingabeaufforderung (Windows) oder das Terminal (Linux, macOS oder Unix). Verwenden Sie den AWS CLI , um den **get-resource-shares** Befehl auszuführen.

  ```
  aws ram get-resource-shares
  ```

  Die Ausgabe gibt eine Liste der Ressourcenfreigaben für Ihr Konto zurück.