Esempi per CodeConnections con AWS CLI

Per creare una connessione

L’esempio create-connection seguente mostra come creare una connessione a un repository di terze parti. Questo esempio crea una connessione in cui il provider di terze parti è Bitbucket.

Per impostazione predefinita una connessione creata tramite AWS CLI o AWS CloudFormation si trova nello stato In sospeso. Dopo aver creato una connessione con la CLI o AWS CloudFormation, utilizzare la console per modificare la connessione e impostarne lo stato su Disponibile.

aws codestar-connections create-connection \
    --provider-type Bitbucket \
    --connection-name MyConnection

Output:

{
    "ConnectionArn": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}

Per ulteriori informazioni, consulta Creazione di una connessione nella Guida per l’utente della console Strumenti per sviluppatori.

Per creare un host

L’esempio create-host seguente mostra come creare un host per rappresentare l’endpoint per l’infrastruttura in cui è installato il provider di terze parti. Questo esempio crea un host in cui il provider di terze parti installato è GitHub Enterprise Server.

Per impostazione predefinita, un host creato tramite la CLI di AWS si trova nello stato In sospeso. Dopo aver creato un host con la CLI, utilizza la console o la CLI per configurare l’host e impostarne lo stato su Disponibile.

aws codestar-connections create-host \
    --name MyHost \
    --provider-type GitHubEnterpriseServer \
    --provider-endpoint "https://my-instance.dev"

Output:

{
    "HostArn": "arn:aws:codestar-connections:us-east-1:123456789012:host/My-Host-28aef605"
}

Per ulteriori informazioni, consulta Create a host (CLI) nella Guida per l’utente della console Strumenti per sviluppatori.

Per eliminare una connessione

L’esempio delete-connection seguente mostra come eliminare una connessione.

aws codestar-connections delete-connection \
    --connection-arn arn:aws:codestar-connections:us-west-2:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Delete a connection (CLI) nella Guida per l’utente della console Strumenti per sviluppatori.

Per eliminare un host

L’esempio delete-host seguente mostra come eliminare un host. Per eliminare un host, è necessario eliminare tutte le connessioni associate all'host.

aws codestar-connections delete-host \
    --host-arn "arn:aws:codestar-connections:us-east-1 :123456789012:host/My-Host-28aef605"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminare un host (CLI) nella Guida per l’utente della console Strumenti per sviluppatori.

Come ottenere informazioni su una connessione

L’esempio get-connection seguente mostra i dettagli di una connessione.

aws codestar-connections get-connection \
    --connection-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f

Output:

{
    "Connection": {
        "ConnectionName": "MyConnection",
        "ConnectionArn": "arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f",
        "ProviderType": "Bitbucket",
        "OwnerAccountId": "123456789012",
        "ConnectionStatus": "AVAILABLE"
    }
}

Per ulteriori informazioni, consulta Visualizza i dettagli di connessione nella Guida per l’utente della console Strumenti per sviluppatori.

Come ottenere informazioni su un host

L’esempio get-host seguente mostra i dettagli di un host.

aws codestar-connections get-host \
    --host-arn arn:aws:codestar-connections:us-east-1:123456789012:host/MyHost-28aef605

Output:

{
    "Name": "MyHost",
    "Status": "AVAILABLE",
    "ProviderType": "GitHubEnterpriseServer",
    "ProviderEndpoint": "https://test-instance-1.dev/"
}

Per ulteriori informazioni, consulta View host details (CLI) nella Guida per l’utente della console Strumenti per sviluppatori.

Per elencare le connessioni

L’esempio list-connections seguente recupera un elenco di tutte le connessioni nell’account per il tipo di provider Bitbucket.

aws codestar-connections list-connections \
--provider-type Bitbucket \
--max-results 5 \
--next-token: next-token

Output:

{
    "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"
}

Per ulteriori informazioni, consulta Elenco delle connessioni (CLI) nella Guida per l’utente della console Strumenti per sviluppatori.

Come elencare gli host

Nell’esempio seguente list-hosts recupera un elenco di tutti i gruppi di host nell’account.

aws codestar-connections list-hosts

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Elenca gli host (CLI) nella Guida per l’utente della console Strumenti per sviluppatori.

Per elencare i tag

L’esempio list-tags-for-resource seguente recupera un elenco di tutti i tag associati alla risorsa di connessione specificata.

aws codestar-connections list-tags-for-resource \
    --resource-arn arn:aws:codestar-connections:us-east-1:123456789012:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f

Output:

{
    "Tags": [
        {
            "Key": "Project",
            "Value": "ProjectA"
        },
        {
            "Key": "ReadOnly",
            "Value": "true"
        }
    ]
}

Per ulteriori informazioni, consulta Visualizzazione dei tag per una risorsa di connessione nella Guida per l’utente della console Strumenti per sviluppatori.

Come aggiungere un tag a una risorsa

L’esempio tag-resource seguente associa un set di tag forniti a una connessione. Utilizza questo comando per aggiungere o modificare tag.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiunta dei tag a una risorsa di connessione nella Guida per l’utente della console Strumenti per sviluppatori.

Come rimuovere i tag AWS da una risorsa di connessione

Nell’esempio seguente untag-resource rimuove un tag dalla risorsa specificata.

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

Output:

{
    "Tags": []
}

Per ulteriori informazioni, consulta Rimozione dei tag da una risorsa di connessione nella Guida per l’utente della console Strumenti per sviluppatori.