CodeConnections ejemplos que utilizan AWS CLI

Para crear una conexión

El siguiente create-connection ejemplo muestra cómo crear una conexión a un repositorio de terceros. En este ejemplo, se crea una conexión en la que el proveedor externo es Bitbucket.

Una conexión creada a través de AWS CLI o AWS CloudFormation está en estado Pendiente de forma predeterminada. Tras crear una conexión con el CLI o AWS CloudFormation, utilice la consola para editar la conexión y hacer que su estado sea Disponible.

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

Salida:

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

Para obtener más información, consulte Crear una conexión en la Guía del usuario de la consola Developer Tools.

Para crear un host

En el siguiente create-host ejemplo, se muestra cómo crear un host que represente el punto final de la infraestructura en la que está instalado el proveedor externo. En este ejemplo, se crea un host en el que el proveedor externo instalado es GitHub Enterprise Server.

Un host creado mediante el AWS CLI está en estado Pendiente de forma predeterminada. Después de crear un host con elCLI, utilice la consola o el CLI para configurar el host y hacer que su estado sea Disponible.

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

Salida:

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

Para obtener más información, consulte Crear un host (CLI) en la Guía del usuario de la consola Developer Tools.

Para eliminar una conexión

En el siguiente delete-connection ejemplo, se muestra cómo eliminar una conexión.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Eliminar una conexión (CLI) en la Guía del usuario de la consola de Developer Tools.

Para eliminar un host

En el siguiente delete-host ejemplo, se muestra cómo eliminar un host. Para poder eliminar un alojamiento, debe eliminar todas las conexiones asociadas al alojamiento.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Eliminar un host (CLI) en la Guía del usuario de la consola Developer Tools.

Para obtener información sobre una conexión

En el siguiente get-connection ejemplo, se muestran detalles sobre una conexión.

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

Salida:

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

Para obtener más información, consulte Ver los detalles de la conexión en la Guía del usuario de la consola Developer Tools.

Para obtener información sobre un anfitrión

En el siguiente get-host ejemplo, se muestran detalles sobre un anfitrión:

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

Salida:

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

Para obtener más información, consulte Ver los detalles del host (CLI) en la Guía del usuario de la consola Developer Tools.

Para enumerar las conexiones

En el siguiente list-connections ejemplo, se recupera una lista de todas las conexiones de tu cuenta para el tipo de proveedor de Bitbucket. :

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

Salida:

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

Para obtener más información, consulte Listar conexiones (CLI) en la Guía del usuario de la consola Developer Tools.

Para enumerar los hosts

En el siguiente list-hosts ejemplo, se recupera una lista de todos los hosts de su cuenta.

aws codestar-connections list-hosts

Salida:

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

Para obtener más información, consulte List hosts (CLI) en la Guía del usuario de la consola Developer Tools.

Para enumerar etiquetas

En el siguiente list-tags-for-resource ejemplo, se recupera una lista de todas las etiquetas adjuntas al recurso de conexiones especificado.

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

Salida:

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

Para obtener más información, consulte Ver las etiquetas de un recurso de conexiones en la Guía del usuario de la consola Developer Tools.

Para etiquetar un recurso

El siguiente tag-resource ejemplo asocia un conjunto de etiquetas proporcionadas a una conexión. Utilice este comando para añadir o editar etiquetas.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Añadir etiquetas a un recurso de conexiones en la Guía del usuario de la consola de Developer Tools.

Para eliminar AWS etiquetas de un recurso de conexiones

Lo siguiente untag-resource elimina una etiqueta del recurso especificado.

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

Salida:

{
    "Tags": []
}

Para obtener más información, consulte Eliminar etiquetas de un recurso de conexiones en la Guía del usuario de la consola de Developer Tools.