CodeConnections esempi utilizzando AWS CLI

Come creare una connessione

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

Una connessione creata tramite la AWS CLI o AWS CloudFormation è in sospeso per impostazione predefinita. Dopo aver creato una connessione con la CLI o AWS CloudFormation, utilizza la console per modificare la connessione e renderne lo stato 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 degli strumenti per sviluppatori.

Come 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 installato da terze parti è GitHub Enterprise Server.

Per impostazione predefinita, un host creato tramite la AWS CLI è 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 Creazione di un host (CLI) nella Guida per l’utente della console degli strumenti per sviluppatori.

Come 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 Eliminazione di una connessione (CLI) nella Guida per l’utente della console degli strumenti per sviluppatori.

Come 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 degli 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 Visualizzare i dettagli di connessione nella Guida per l’utente della console degli 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 Visualizzare i dettagli dell’host (CLI) nella Guida per l’utente della console degli strumenti per sviluppatori.

Come 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 degli strumenti per sviluppatori.

Come elencare gli host

L’esempio list-hosts seguente recupera un elenco di tutti gli host nell’account in uso.

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 Elencare gli host (CLI) nella Guida per l’utente della console degli strumenti per sviluppatori.

Come 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 degli strumenti per sviluppatori.

Come taggare 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 degli strumenti per sviluppatori.

Per rimuovere i AWS tag da una risorsa di connessione

L’esempio untag-resource seguente 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 degli strumenti per sviluppatori.