Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar. 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. # CodeConnections Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CodeConnections. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-connection` Das folgende Codebeispiel zeigt, wie Sie`create-connection`. **AWS CLI** **Um eine Verbindung herzustellen** Das folgende Beispiel für `create-connection` zeigt, wie eine Verbindung mit einem Drittanbieter-Repository hergestellt wird. In diesem Beispiel wird eine Verbindung hergestellt, bei der der Drittanbieter Bitbucket ist. Eine Verbindung, die über die AWS CLI erstellt wurde oder AWS CloudFormation sich standardmäßig im Status Ausstehend befindet. Nachdem Sie eine Verbindung mit der CLI oder mit der Konsole hergestellt haben AWS CloudFormation, bearbeiten Sie die Verbindung, um ihren Status Verfügbar zu machen. ``` aws codestar-connections create-connection \ --provider-type Bitbucket \ --connection-name MyConnection ``` Ausgabe: ``` { "ConnectionArn": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f" } ``` Weitere Informationen zu Verbindungen finden Sie unter [Eine Verbindung erstellen](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [CreateConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/create-connection.html)in der *AWS CLI Befehlsreferenz*. ### `create-host` Das folgende Codebeispiel zeigt die Verwendung`create-host`. **AWS CLI** **So erstellen Sie einen Host** Das folgende Beispiel für `create-host` zeigt, wie Sie einen Host erstellen, der den Endpunkt für die Infrastruktur darstellt, in der der Drittanbieter installiert ist. In diesem Beispiel wird ein Host erstellt, auf dem GitHub Enterprise Server als Drittanbieter installiert ist. Ein über die AWS CLI erstellter Host hat standardmäßig den Status Ausstehend. Nachdem Sie mit der CLI einen Host erstellt haben, richten Sie mit der Konsole oder der CLI den Host so ein, dass er sich im Status „Verfügbar“ befindet. ``` aws codestar-connections create-host \ --name MyHost \ --provider-type GitHubEnterpriseServer \ --provider-endpoint "https://my-instance.dev" ``` Ausgabe: ``` { "HostArn": "arn:aws:codestar-connections:us-east-1:123456789012:host/My-Host-28aef605" } ``` Weitere Informationen finden Sie unter [Erstellen eines Hosts (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [CreateHost](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/create-host.html)in der *AWS CLI Befehlsreferenz*. ### `delete-connection` Das folgende Codebeispiel zeigt die Verwendung`delete-connection`. **AWS CLI** **So löschen Sie eine Verbindung** Das folgende Beispiel für `delete-connection` zeigt, wie Sie eine Verbindung löschen. ``` aws codestar-connections delete-connection \ --connection-arn arn:aws:codestar-connections:us-west-2:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen einer Verbindung (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-delete.html#connections-delete-cli) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/delete-connection.html)in der *AWS CLI Befehlsreferenz*. ### `delete-host` Das folgende Codebeispiel zeigt die Verwendung`delete-host`. **AWS CLI** **So löschen Sie einen Host** Im folgenden Beispiel für `delete-host` wird gezeigt, wie ein Host gelöscht wird. Bevor Sie einen Host löschen können, müssen Sie alle Verbindungen löschen, die mit dem Host verknüpft sind. ``` aws codestar-connections delete-host \ --host-arn "arn:aws:codestar-connections:us-east-1 :123456789012:host/My-Host-28aef605" ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Löschen eines Hosts (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html#connections-host-delete-cli) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [DeleteHost](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/delete-host.html)in der *AWS CLI Befehlsreferenz*. ### `get-connection` Das folgende Codebeispiel zeigt die Verwendung`get-connection`. **AWS CLI** **So rufen Sie Informationen zu einer Verbindung ab** Das folgende Beispiel für `get-connection` zeigt Details zu einer Verbindung. ``` aws codestar-connections get-connection \ --connection-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f ``` Ausgabe: ``` { "Connection": { "ConnectionName": "MyConnection", "ConnectionArn": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f", "ProviderType": "Bitbucket", "OwnerAccountId": "123456789012", "ConnectionStatus": "AVAILABLE" } } ``` Weitere Informationen zu Verbindungen finden Sie unter [Anzeigen von Verbindungsdetails](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-view-details.html) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [GetConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/get-connection.html)in der *AWS CLI Befehlsreferenz*. ### `get-host` Das folgende Codebeispiel zeigt die Verwendung`get-host`. **AWS CLI** **So rufen Sie Informationen zu einem Host ab** Das folgende Beispiel für `get-host` zeigt Details zu einem Host. ``` aws codestar-connections get-host \ --host-arn arn:aws:codestar-connections:us-east-1:123456789012:host/MyHost-28aef605 ``` Ausgabe: ``` { "Name": "MyHost", "Status": "AVAILABLE", "ProviderType": "GitHubEnterpriseServer", "ProviderEndpoint": "https://test-instance-1.dev/" } ``` Weitere Informationen finden Sie unter [View host details (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-view.html#connections-host-view-cli) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [GetHost](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/get-host.html)in der *AWS CLI Befehlsreferenz*. ### `list-connections` Das folgende Codebeispiel zeigt die Verwendung`list-connections`. **AWS CLI** **So listen Sie Verbindungen auf** Im folgenden Beispiel für `list-connections` wird eine Liste aller Verbindungen in Ihrem Konto für den Bitbucket-Anbietertyp abgerufen: ``` aws codestar-connections list-connections \ --provider-type Bitbucket \ --max-results 5 \ --next-token: next-token ``` Ausgabe: ``` { "Connections": [ { "ConnectionName": "my-connection", "ProviderType": "Bitbucket", "Status": "PENDING", "ARN": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f", "OwnerAccountId": "123456789012" }, { "ConnectionName": "my-other-connection", "ProviderType": "Bitbucket", "Status": "AVAILABLE", "ARN": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f", "OwnerAccountId": "123456789012" }, ], "NextToken": "next-token" } ``` Weitere Informationen zu Verbindungen finden Sie unter [Auflisten von Verbindungen (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-list.html#connections-list-cli) im *Benutzerhandbuch für die Entwickler-Tools-Konsole*. + Einzelheiten zur API finden Sie [ListConnections](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/list-connections.html)in der *AWS CLI Befehlsreferenz*. ### `list-hosts` Das folgende Codebeispiel zeigt die Verwendung`list-hosts`. **AWS CLI** **So listen Sie Hosts auf** Im folgenden Beispiel für `list-hosts` wird eine Liste aller Hosts in Ihrem Konto abgerufen. ``` aws codestar-connections list-hosts ``` Ausgabe: ``` { "Hosts": [ { "Name": "My-Host", "HostArn": "arn:aws:codestar-connections:us-east-1:123456789012:host/My-Host-28aef605", "ProviderType": "GitHubEnterpriseServer", "ProviderEndpoint": "https://my-instance.test.dev", "Status": "AVAILABLE" } ] } ``` Weitere Informationen zu Verbindungen finden Sie unter [Auflisten von Hosts (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-list.html) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [ListHosts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/list-hosts.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags auf** Im folgenden Beispiel für `list-tags-for-resource` wird eine Liste aller Tags abgerufen, die mit der angegebenen Verbindungsressource verknüpft sind. ``` aws codestar-connections list-tags-for-resource \ --resource-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f ``` Ausgabe: ``` { "Tags": [ { "Key": "Project", "Value": "ProjectA" }, { "Key": "ReadOnly", "Value": "true" } ] } ``` Weitere Informationen zu Verbindungen finden Sie unter [Anzeigen von Tags für eine Verbindungsressource](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-tag.html#connections-tag-view) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird ein Satz bereitgestellter Tags einer Verbindung zugeordnet. Verwenden Sie diesen Befehl, um Tags hinzuzufügen oder zu bearbeiten. ``` aws codestar-connections tag-resource \ --resource-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f \ --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen zu Verbindungen finden Sie unter [Hinzufügen von Tags zu einer Verbindungsressource](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-tag.html#connections-tag-add) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **Um AWS Tags aus einer Verbindungsressource zu entfernen** Mit dem folgenden `untag-resource`-Befehl wird ein Tag aus der angegebenen Ressource entfernt. ``` aws codestar-connections untag-resource \ --resource-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f \ --tag-keys Project ReadOnly ``` Ausgabe: ``` { "Tags": [] } ``` Weitere Informationen zu Verbindungen finden Sie unter [Entfernen von Tags aus einer Verbindungsressource](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-tag.html#connections-tag-delete) im *Benutzerhandbuch für die Entwicklertools-Konsole*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/untag-resource.html)in der *AWS CLI Befehlsreferenz*.