

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.

# Bauprojekte teilen
<a name="project-sharing"></a>

Das Teilen von Projekten ermöglicht es Projektinhabern, ihre AWS CodeBuild Projekte mit anderen AWS Konten oder Benutzern zu teilen. In diesem Modell gibt das Konto, das Eigentümer des Projekts (Eigentümer) ist, ein Projekt für andere Konten (Verbraucher) frei. Ein Verbraucher kann kein Projekt bearbeiten oder ausführen.

**Topics**
+ [Teilen Sie ein Projekt](#project-sharing-share)
+ [Zugehörige Services](#project-sharing-related)
+ [Greife auf CodeBuild Projekte zu, die mit dir geteilt wurden](project-sharing-access-prereqs.md)
+ [Teilen Sie ein geteiltes Projekt nicht mehr mit anderen](project-sharing-unshare.md)
+ [Identifizieren Sie ein geteiltes Projekt](project-sharing-identify.md)
+ [Berechtigungen für freigegebene Projekte](project-sharing-perms.md)

## Teilen Sie ein Projekt
<a name="project-sharing-share"></a>

Der Kunde kann sowohl die als auch die AWS CLI AWS CodeBuild Konsole verwenden, um sich das Projekt und die Builds anzusehen, die Sie geteilt haben. Der Verbraucher kann das Projekt nicht bearbeiten oder ausführen.

Sie können ein Projekt zu einer vorhandenen Ressourcenfreigabe hinzufügen oder in der [AWS RAM -Konsole](https://console.aws.amazon.com/ram) erstellen.

**Anmerkung**  
Sie können kein Projekt mit Builds löschen, das einer Ressourcenfreigabe hinzugefügt wurde. 

Um ein Projekt für Organisationseinheiten oder eine ganze Organisation freizugeben, müssen Sie die Freigabe mit AWS Organizations aktivieren. Weitere Informationen finden Sie unter [ Freigabe für AWS Organizations aktivieren](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html) im *AWS RAM -Benutzerhandbuch*.

Sie können die AWS CodeBuild Konsole, AWS RAM die Konsole oder die verwenden, AWS CLI um ein Projekt, das Ihnen gehört, mit anderen zu teilen.

**Voraussetzungen für die Freigabe von Projekten**  
Bevor Sie mit dem Teilen eines Projekts beginnen, stellen Sie sicher, dass es Ihrem AWS Konto gehört. Sie können kein Projekt freigeben, das für Sie freigegeben wurde. 

**Um ein Projekt zu teilen, das Ihnen gehört (CodeBuild Konsole)**

1. Öffnen Sie die AWS CodeBuild Konsole unter [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1. Wählen Sie im linken Navigationsbereich **Build projects** aus.
**Anmerkung**  
Standardmäßig werden nur die letzten 10 Build-Projekte angezeigt. Zur Anzeige von weiteren Build-Projekten wählen Sie das Zahnradsymbol und einen anderen Wert für **Projects per page (Projekte je Seite)** aus oder verwenden die Vorwärts- und Rückwärtspfeile.

1. Wählen Sie das Projekt aus, das Sie freigeben möchten, und klicken Sie dann auf **Share (Freigeben)**. Weitere Informationen finden Sie unter [Erstellen einer Ressourcenfreigabe](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-create) im *AWS RAM -Benutzerhandbuch*. 

**Um ein Projekt zu teilen, das Ihnen gehört (Konsole)AWS RAM**  
Weitere Informationen finden Sie unter [Erstellen einer Ressourcenfreigabe](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) im *AWS RAM -Benutzerhandbuch*.

**Um ein Projekt, das Ihnen gehört, mit anderen zu teilen (AWS RAM Befehl)**  
Verwenden Sie den Befehl [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).

**So geben Sie ein Projekt frei, dessen Eigentümer Sie sind (CodeBuild-Befehl)**<a name="codebuild-command"></a>

Verwenden Sie den [-Befehl:put-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/put-resource-policy.html)

1. Erstellen Sie eine Datei mit dem Namen `policy.json` und kopieren Sie Folgendes in diese Datei. 

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement":[{
       "Effect":"Allow",
       "Action":[
         "codebuild:BatchGetProjects",
         "codebuild:BatchGetBuilds",
         "codebuild:ListBuildsForProject"],
       "Resource":"arn:aws:iam::*:role/Service*"
     }]
   }
   ```

------

1. Aktualisieren Sie `policy.json` mit dem Projekt-ARN und Bezeichnern für die Freigabe. Im folgenden Beispiel wird dem Root-Benutzer nur Lesezugriff für das durch 123456789012 identifizierte AWS Konto gewährt. 

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement":[{
       "Effect":"Allow",
       "Principal":{
         "AWS": [
           "123456789012"
         ]
       },
       "Action":[
         "codebuild:BatchGetProjects",
         "codebuild:BatchGetBuilds",
         "codebuild:ListBuildsForProject"],
       "Resource":"arn:aws:codebuild:us-west-2:123456789012:project/my-project"
     }]
   }
   ```

------

1. Führen Sie den Befehl [put-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/put-resource-policy.html) aus.

   ```
   aws codebuild put-resource-policy --resource-arn <project-arn> --policy file://policy.json
   ```

1. Holen Sie sich den AWS RAM Resource Share ARN.

   ```
   aws ram list-resources --resource-owner SELF --resource-arns <project-arn>
   ```

   Dies wird eine Antwort ähnlich der folgenden zurückgeben:

   ```
   {
     "resources": [
       {
         "arn": "<project-arn>",
         "type": "<type>",
         "resourceShareArn": "<resource-share-arn>",
         "creationTime": "<creation-time>",
         "lastUpdatedTime": "<last-update-time>"
       }
     ]
   }
   ```

   Kopieren Sie aus der Antwort den *<resource-share-arn>* Wert, der im nächsten Schritt verwendet werden soll.

1. Führen Sie den Befehl AWS RAM [promote-resource-share-created-from-policy aus](https://docs.aws.amazon.com/cli/latest/reference/ram/promote-resource-share-created-from-policy.html).

   ```
   aws ram promote-resource-share-created-from-policy --resource-share-arn <resource-share-arn>
   ```

## Zugehörige Services
<a name="project-sharing-related"></a>

Project Sharing ist in AWS Resource Access Manager (AWS RAM) integriert, einen Dienst, der es Ihnen ermöglicht, Ihre AWS Ressourcen mit jedem beliebigen AWS Konto oder über AWS Organizations Mit AWS RAM können Sie Ressourcen gemeinsam nutzen, indem Sie eine *Ressourcenfreigabe* erstellen, die die Ressourcen und die Verbraucher angibt, für die sie freigegeben werden sollen. Bei den Verbrauchern kann es sich um einzelne AWS Konten AWS Organizations, Organisationseinheiten oder eine gesamte Organisation handeln AWS Organizations.

Weitere Informationen finden Sie im *[AWS RAM -Benutzerhandbuch](https://docs.aws.amazon.com/ram/latest/userguide/)*.

# Greife auf CodeBuild Projekte zu, die mit dir geteilt wurden
<a name="project-sharing-access-prereqs"></a>

Für den Zugriff auf ein geteiltes Projekt ist für die IAM-Rolle eines Verbrauchers die `BatchGetProjects` entsprechende Genehmigung erforderlich. Sie können die folgende Richtlinie an ihre IAM-Rolle anhängen: 

```
{
    "Effect": "Allow",
    "Resource": [
        "*"
    ],
    "Action": [
        "codebuild:BatchGetProjects"
    ]
}
```

 Weitere Informationen finden Sie unter [Verwendung identitätsbasierter Richtlinien für AWS CodeBuild](auth-and-access-control-iam-identity-based-access-control.md). 

# Teilen Sie ein geteiltes Projekt nicht mehr mit anderen
<a name="project-sharing-unshare"></a>

Auf ein nicht mehr freigegebenes Projekt, einschließlich seiner Builds, kann nur sein Eigentümer zugreifen. Wenn Sie die gemeinsame Nutzung eines Projekts rückgängig machen, können alle AWS Konten oder Benutzer, mit denen Sie es zuvor geteilt haben, nicht auf das Projekt oder seine Builds zugreifen.

Um die Freigabe eines freigegebenen Projektes, dessen Eigentümer Sie sind, aufzuheben, müssen Sie es aus der Ressourcenfreigabe entfernen. Sie können dafür die AWS CodeBuild AWS RAM Konsole, die Konsole oder AWS CLI verwenden.

**Um die Freigabe eines geteilten Projekts rückgängig zu machen, das Ihnen gehört (AWS RAM Konsole)**  
Siehe [Aktualisieren einer Ressourcenfreigabe](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-update) im *AWS RAM -Benutzerhandbuch*.

**So heben Sie die Freigabe eines freigegebenen Projekts auf, dessen Eigentümer Sie sind (AWS CLI)**  
Verwenden Sie den Befehl [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).

 **Um die gemeinsame Nutzung eines Projekts rückgängig zu machen, dessen Eigentümer Sie sind (Befehl) CodeBuild ** 

Führen Sie den [delete-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/delete-resource-policy.html)Befehl aus und geben Sie den ARN des Projekts an, dessen Freigabe Sie rückgängig machen möchten:

```
aws codebuild delete-resource-policy --resource-arn project-arn
```

# Identifizieren Sie ein geteiltes Projekt
<a name="project-sharing-identify"></a>

Eigentümer und Verbraucher können das verwenden AWS CLI , um gemeinsame Projekte zu identifizieren.

**Um Projekte zu identifizieren, die mit deinem AWS Konto oder Nutzer geteilt wurden (AWS CLI)**  
Verwenden Sie den [list-shared-projects](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-shared-projects.html)Befehl, um die Projekte zurückzugeben, die mit Ihnen geteilt wurden.

# Berechtigungen für freigegebene Projekte
<a name="project-sharing-perms"></a>

## Berechtigungen für Besitzer
<a name="project-perms-owner"></a>

Ein Projekteigentümer kann das Projekt bearbeiten und es zum Ausführen von Builds verwenden.

## Berechtigungen für Konsumenten
<a name="project-perms-consumer"></a>

Ein Projektverbraucher kann ein Projekt und seine Builds anzeigen, es jedoch nicht bearbeiten oder damit Builds ausführen.