Sono disponibili altri esempi AWS SDK nel repository [AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples) Examples. GitHub
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# CodeConnections esempi che utilizzano AWS CLI
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with CodeConnections.
Le *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.
**Topics**
+ [Azioni](#actions)
## Azioni
### `create-connection`
Il seguente esempio di codice mostra come utilizzare`create-connection`.
**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](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta [CreateConnection AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/create-connection.html)*Command Reference.*
### `create-host`
Il seguente esempio di codice mostra come utilizzare`create-host`.
**AWS CLI**
**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)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [CreateHost](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/create-host.html)Reference*.
### `delete-connection`
Il seguente esempio di codice mostra come utilizzare`delete-connection`.
**AWS CLI**
**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)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-delete.html#connections-delete-cli) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta [DeleteConnection AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/delete-connection.html)*Command Reference*.
### `delete-host`
Il seguente esempio di codice mostra come utilizzare`delete-host`.
**AWS CLI**
**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)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html#connections-host-delete-cli) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta [DeleteHost AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/delete-host.html)*Command Reference*.
### `get-connection`
Il seguente esempio di codice mostra come utilizzare`get-connection`.
**AWS CLI**
**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](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-view-details.html) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta [GetConnection AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/get-connection.html)*Command Reference*.
### `get-host`
Il seguente esempio di codice mostra come utilizzare`get-host`.
**AWS CLI**
**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)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-view.html#connections-host-view-cli) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta [GetHost AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/get-host.html)*Command Reference*.
### `list-connections`
Il seguente esempio di codice mostra come utilizzare`list-connections`.
**AWS CLI**
**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)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-list.html#connections-list-cli) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta [ListConnections AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/list-connections.html)*Command Reference*.
### `list-hosts`
Il seguente esempio di codice mostra come utilizzare`list-hosts`.
**AWS CLI**
**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)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-list.html) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta [ListHosts AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/list-hosts.html)*Command Reference*.
### `list-tags-for-resource`
Il seguente esempio di codice mostra come utilizzare`list-tags-for-resource`.
**AWS CLI**
**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](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-tag.html#connections-tag-view) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/list-tags-for-resource.html)*Command Reference*.
### `tag-resource`
Il seguente esempio di codice mostra come utilizzare`tag-resource`.
**AWS CLI**
**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](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-tag.html#connections-tag-add) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta [TagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/tag-resource.html)*Command Reference*.
### `untag-resource`
Il seguente esempio di codice mostra come utilizzare`untag-resource`.
**AWS CLI**
**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](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-tag.html#connections-tag-delete) nella *Guida per l’utente della console degli strumenti per sviluppatori*.
+ Per i dettagli sull'API, consulta [UntagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-connections/untag-resource.html)*Command Reference*.