D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Exemples d'API Cloud Control utilisant AWS CLI
<a name="cli_2_cloudcontrol_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de l'API AWS Command Line Interface with Cloud Control.

Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `create-resource`
<a name="cloudcontrol_CreateResource_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`create-resource`.

**AWS CLI**  
**Pour créer une ressource**  
L'`create-resource`exemple suivant crée une ressource AWS : :Kinesis : :Stream, nommée ResourceExample, avec une période de rétention de 168 heures et un nombre de partitions de trois.  

```
aws cloudcontrol create-resource \
    --type-name AWS::Kinesis::Stream \
    --desired-state "{\"Name\": \"ResourceExample\",\"RetentionPeriodHours\":168, \"ShardCount\":3}"
```
Sortie :  

```
{
    "ProgressEvent": {
        "EventTime": 1632506656.706,
        "TypeName": "AWS::Kinesis::Stream",
        "OperationStatus": "IN_PROGRESS",
        "Operation": "CREATE",
        "Identifier": "ResourceExample",
        "RequestToken": "20999d87-e304-4725-ad84-832dcbfd7fc5"
    }
}
```
Pour plus d’informations, consultez [Création d’une ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html) dans le *Guide de l’utilisateur de l’API Cloud Control*.  
+  Pour plus de détails sur l'API, reportez-vous [CreateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/create-resource.html)à la section *Référence des AWS CLI commandes*. 

### `delete-resource`
<a name="cloudcontrol_DeleteResource_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`delete-resource`.

**AWS CLI**  
**Pour supprimer une ressource**  
L'`delete-resource`exemple suivant supprime une ressource AWS : :Kinesis : :Stream avec l'identifiant ResourceExample de votre compte. AWS   

```
aws cloudcontrol delete-resource \
    --type-name AWS::Kinesis::Stream \
    --identifier ResourceExample
```
Sortie :  

```
{
    "ProgressEvent": {
        "TypeName": "AWS::Kinesis::Stream",
        "Identifier": "ResourceExample",
        "RequestToken": "e48f26ff-d0f9-4ab8-a878-120db1edf111",
        "Operation": "DELETE",
        "OperationStatus": "IN_PROGRESS",
        "EventTime": 1632950300.14
    }
}
```
Pour plus d’informations, consultez [Suppression d’une ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-delete.html) dans le *Guide de l’utilisateur de l’API Cloud Control*.  
+  Pour plus de détails sur l'API, reportez-vous [DeleteResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/delete-resource.html)à la section *Référence des AWS CLI commandes*. 

### `get-resource-request-status`
<a name="cloudcontrol_GetResourceRequestStatus_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`get-resource-request-status`.

**AWS CLI**  
**Pour obtenir les informations de statut d’une demande de ressource**  
L’exemple `get-resource-request-status` suivant renvoie des informations de statut relatives à la demande de ressource spécifiée.  

```
aws cloudcontrol get-resource-request-status \
    --request-token "e1a6b86e-46bd-41ac-bfba-001234567890"
```
Sortie :  

```
{
    "ProgressEvent": {
        "TypeName": "AWS::Kinesis::Stream",
        "Identifier": "Demo",
        "RequestToken": "e1a6b86e-46bd-41ac-bfba-001234567890",
        "Operation": "CREATE",
        "OperationStatus": "FAILED",
        "EventTime": 1632950268.481,
        "StatusMessage": "Resource of type 'AWS::Kinesis::Stream' with identifier 'Demo' already exists.",
        "ErrorCode": "AlreadyExists"
    }
}
```
Pour plus d’informations, consultez [Gestion des demandes d’opérations de ressources](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html) dans le *Guide de l’utilisateur de l’API Cloud Control*.  
+  Pour plus de détails sur l'API, reportez-vous [GetResourceRequestStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/get-resource-request-status.html)à la section *Référence des AWS CLI commandes*. 

### `get-resource`
<a name="cloudcontrol_GetResource_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`get-resource`.

**AWS CLI**  
**Pour obtenir l’état actuel d’une ressource**  
L'`get-resource`exemple suivant renvoie l'état actuel de la ressource AWS : :Kinesis : :Stream nommée. ResourceExample  

```
aws cloudcontrol get-resource \
    --type-name AWS::Kinesis::Stream \
    --identifier ResourceExample
```
Sortie :  

```
{
    "TypeName": "AWS::Kinesis::Stream",
    "ResourceDescription": {
        "Identifier": "ResourceExample",
        "Properties": "{\"Arn\":\"arn:aws:kinesis:us-west-2:099908667365:stream/ResourceExample\",\"RetentionPeriodHours\":168,\"Name\":\"ResourceExample\",\"ShardCount\":3}"
    }
}
```
Pour plus d’informations, consultez [Lecture de l’état actuel d’une ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-read.html) dans le *Guide de l’utilisateur de l’API Cloud Control*.  
+  Pour plus de détails sur l'API, reportez-vous [GetResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/get-resource.html)à la section *Référence des AWS CLI commandes*. 

### `list-resource-requests`
<a name="cloudcontrol_ListResourceRequests_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-resource-requests`.

**AWS CLI**  
**Pour répertorier les demandes d’opérations de ressources actives**  
L'`list-resource-requests`exemple suivant répertorie les demandes de ressources pour les opérations CREATE et UPDATE qui ont échoué dans votre AWS compte.  

```
aws cloudcontrol list-resource-requests \
    --resource-request-status-filter Operations=CREATE,OperationStatuses=FAILED
```
Sortie :  

```
{
    "ResourceRequestStatusSummaries": [
        {
            "TypeName": "AWS::Kinesis::Stream",
            "Identifier": "Demo",
            "RequestToken": "e1a6b86e-46bd-41ac-bfba-633abcdfdbd7",
            "Operation": "CREATE",
            "OperationStatus": "FAILED",
            "EventTime": 1632950268.481,
            "StatusMessage": "Resource of type 'AWS::Kinesis::Stream' with identifier 'Demo' already exists.",
            "ErrorCode": "AlreadyExists"
        }
    ]
}
```
Pour plus d’informations, consultez [Gestion des demandes d’opérations de ressources](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html) dans le *Guide de l’utilisateur de l’API Cloud Control*.  
+  Pour plus de détails sur l'API, reportez-vous [ListResourceRequests](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/list-resource-requests.html)à la section *Référence des AWS CLI commandes*. 

### `list-resources`
<a name="cloudcontrol_ListResources_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-resources`.

**AWS CLI**  
**Pour répertorier les ressources d’un type donné**  
L'`list-resources`exemple suivant répertorie les ressources ::Kinesis AWS : :Stream mises en service dans votre compte. AWS   

```
aws cloudcontrol list-resources \
    --type-name AWS::Kinesis::Stream
```
Sortie :  

```
{
    "TypeName": "AWS::Kinesis::Stream",
    "ResourceDescriptions": [
        {
            "Identifier": "MyKinesisStream",
            "Properties": "{\"Name\":\"MyKinesisStream\"}"
        },
        {
            "Identifier": "AnotherStream",
            "Properties": "{\"Name\":\"AnotherStream\"}"
        }
    ]
}
```
Pour plus d’informations, consultez [Découverte des ressources](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-list.html) dans le *Guide de l’utilisateur de l’API Cloud Control*.  
+  Pour plus de détails sur l'API, reportez-vous [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/list-resources.html)à la section *Référence des AWS CLI commandes*. 

### `update-resource`
<a name="cloudcontrol_UpdateResource_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`update-resource`.

**AWS CLI**  
**Pour mettre à jour les propriétés d’une ressource existante**  
L'`update-resource`exemple suivant met à jour la politique de rétention d'une LogGroup ressource AWS : :Logs : : nommée ExampleLogGroup à 90 jours.  

```
aws cloudcontrol update-resource \
    --type-name AWS::Logs::LogGroup \
    --identifier ExampleLogGroup \
    --patch-document "[{\"op\":\"replace\",\"path\":\"/RetentionInDays\",\"value\":90}]"
```
Sortie :  

```
{
    "ProgressEvent": {
        "EventTime": "2021-08-09T18:17:15.219Z",
        "TypeName": "AWS::Logs::LogGroup",
        "OperationStatus": "IN_PROGRESS",
        "Operation": "UPDATE",
        "Identifier": "ExampleLogGroup",
        "RequestToken": "5f40c577-3534-4b20-9599-0b0123456789"
    }
}
```
Pour plus d’informations, consultez [Mise à jour d’une ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-update.html) dans le *Guide de l’utilisateur de l’API Cloud Control*.  
+  Pour plus de détails sur l'API, reportez-vous [UpdateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/update-resource.html)à la section *Référence des AWS CLI commandes*.