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.

# Création d'une ressource avec API de commande du Cloud AWS
<a name="resource-operations-create"></a>

Utilisez la `create-resource` commande pour créer une ressource.

## Composer l'état souhaité de la ressource
<a name="resource-operations-create-desiredstate"></a>

Pour que l'API Cloud Control crée une ressource, vous devez spécifier l'*état souhaité* de la ressource que vous souhaitez créer. L'état souhaité consiste en une liste des propriétés des ressources que vous souhaitez spécifier, ainsi que les valeurs souhaitées.

Les propriétés d'une ressource sont définies dans son schéma de type de ressource. Cela inclut si la propriété est obligatoire, les valeurs valides et d'autres contraintes de propriété. Pour plus d'informations sur l'affichage des définitions des propriétés des ressources, consultez[Affichage des schémas de types de ressources](resource-types.md#resource-types-schemas).

L'état souhaité que vous spécifiez doit être valide par rapport au schéma de type de ressource.

Par exemple, supposons que vous souhaitiez créer une [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html)ressource portant un nom spécifique et une politique de conservation de 90 jours. Dans un premier temps, vous devez composer l'état souhaité de la ressource, au format texte JSON.

```
{
  "LogGroupName": "CloudApiLogGroup",
  "RetentionInDays": 90
}
```

Lorsque vous appelez la `create-resource` commande, vous pouvez transmettre l'état souhaité directement en ligne sous forme de chaîne ou, pour des définitions d'état souhaitées plus complexes, spécifier un emplacement de fichier.

La commande suivante AWS Command Line Interface (AWS CLI) crée la ressource et indique dans le `desired-state` paramètre sur lequel la `RetentionInDays` propriété de la ressource est définie`90`, en plus de spécifier le nom du groupe de journaux.

```
$ aws cloudcontrol create-resource --type-name AWS::Logs::LogGroup \
    --desired-state '{"LogGroupName": "CloudApiLogGroup", "RetentionInDays":90}'
```

## Suivi de la progression d'une demande de création de ressource
<a name="resource-operations-create-progress"></a>

La `create-resource` commande renvoie un `ProgressEvent` objet que vous pouvez utiliser pour surveiller l'état actuel de votre demande de création de ressource. Pour de plus amples informations, veuillez consulter [Suivi de la progression des demandes d'exploitation des ressources](resource-operations-manage-requests.md#resource-operations-manage-requests-track).