CodeConnections Beispiele mit AWS CLI

Um eine Verbindung herzustellen

Das folgende create-connection Beispiel zeigt, wie eine Verbindung zu einem Repository eines Drittanbieters 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 finden Sie im Benutzerhandbuch für die Developer Tools-Konsole unter Verbindung erstellen.

Um einen Host zu erstellen

Das folgende create-host Beispiel zeigt, wie Sie einen Host erstellen, der den Endpunkt für die Infrastruktur darstellt, in der Ihr 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 einen Host mit der CLI erstellt haben, verwenden Sie die Konsole oder die CLI, um den Host so einzurichten, dass er seinen Status Verfügbar erhält.

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 Create a Host (CLI) im Developer Tools-Konsolen-Benutzerhandbuch.

Um eine Verbindung zu löschen

Das folgende delete-connection Beispiel zeigt, wie eine Verbindung gelöscht wird.

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) im Developer Tools-Konsolen-Benutzerhandbuch.

Um einen Host zu löschen

Das folgende delete-host Beispiel zeigt, 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) im Developer Tools-Konsolen-Benutzerhandbuch.

Um Informationen über eine Verbindung zu erhalten

Das folgende get-connection Beispiel 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 finden Sie im Benutzerhandbuch für die Developer Tools Console unter Verbindungsdetails anzeigen.

Um Informationen über einen Host zu erhalten

Das folgende get-host Beispiel 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 Host-Details anzeigen (CLI) im Developer Tools-Konsolen-Benutzerhandbuch.

Um Verbindungen aufzulisten

Im folgenden list-connections Beispiel wird eine Liste aller Verbindungen in deinem 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 finden Sie unter Verbindungen auflisten (CLI) im Developer Tools-Konsolen-Benutzerhandbuch.

Um Hosts aufzulisten

Im folgenden list-hosts Beispiel 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 finden Sie unter Hosts auflisten (CLI) im Developer Tools-Konsolen-Benutzerhandbuch.

Um Tags aufzulisten

Im folgenden list-tags-for-resource Beispiel wird eine Liste aller Tags abgerufen, die an die angegebene Verbindungsressource angehängt 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 finden Sie im Benutzerhandbuch für die Developer Tools-Konsole unter Tags für eine Verbindungsressource anzeigen.

Um eine Ressource zu taggen

Das folgende tag-resource Beispiel verknüpft einen Satz bereitgestellter Tags mit einer Verbindung. 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 finden Sie im Benutzerhandbuch für die Developer Tools-Konsole unter Hinzufügen von Tags zu einer Verbindungsressource.

Um AWS Tags aus einer Verbindungsressource zu entfernen

Im Folgenden untag-resource 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 finden Sie unter Entfernen von Tags aus einer Verbindungsressource im Benutzerhandbuch für die Developer Tools-Konsole.