Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Cloud Control API-Beispiele mit AWS CLI
<a name="cli_cloudcontrol_code_examples"></a>

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe der AWS Command Line Interface with Cloud Control API Aktionen ausführen und allgemeine Szenarien implementieren.

*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.

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

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

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

Das folgende Codebeispiel zeigt, wie Sie`create-resource`.

**AWS CLI**  
**So erstellen Sie eine Ressource**  
Im folgenden `create-resource` Beispiel wird eine benannte AWS ResourceExample: :Kinesis: :Stream-Ressource mit einer Aufbewahrungsdauer von 168 Stunden und einer Shard-Anzahl von drei erstellt.  

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

```
{
    "ProgressEvent": {
        "EventTime": 1632506656.706,
        "TypeName": "AWS::Kinesis::Stream",
        "OperationStatus": "IN_PROGRESS",
        "Operation": "CREATE",
        "Identifier": "ResourceExample",
        "RequestToken": "20999d87-e304-4725-ad84-832dcbfd7fc5"
    }
}
```
Weitere Informationen finden Sie unter [Erstellen einer Ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html) im *Benutzerhandbuch für Cloud Control API*.  
+  *Einzelheiten zur API finden Sie in der Befehlsreferenz [CreateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/create-resource.html).AWS CLI * 

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

Das folgende Codebeispiel zeigt die Verwendung`delete-resource`.

**AWS CLI**  
**So löschen Sie eine Ressource**  
Im folgenden `delete-resource` Beispiel wird eine AWS: :Kinesis: :Stream-Ressource mit der ID ResourceExample aus Ihrem Konto gelöscht. AWS   

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

```
{
    "ProgressEvent": {
        "TypeName": "AWS::Kinesis::Stream",
        "Identifier": "ResourceExample",
        "RequestToken": "e48f26ff-d0f9-4ab8-a878-120db1edf111",
        "Operation": "DELETE",
        "OperationStatus": "IN_PROGRESS",
        "EventTime": 1632950300.14
    }
}
```
Weitere Informationen finden Sie unter [Löschen einer Ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-delete.html) im *Benutzerhandbuch für Cloud Control API*.  
+  *Einzelheiten zur API finden Sie in der Befehlsreferenz [DeleteResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/delete-resource.html).AWS CLI * 

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

Das folgende Codebeispiel zeigt die Verwendung`get-resource-request-status`.

**AWS CLI**  
**So rufen Sie die Statusinformationen einer Ressourcenanforderung ab**  
Im folgenden Beispiel für `get-resource-request-status` werden Statusinformationen zur angegebenen Ressourcenanforderung abgerufen.  

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

```
{
    "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"
    }
}
```
Weitere Informationen finden Sie unter [Verwalten von Ressourcenoperationsanforderungen](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html) im *Benutzerhandbuch für Cloud Control API*.  
+  Einzelheiten zur API finden Sie [GetResourceRequestStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/get-resource-request-status.html)in der *AWS CLI Befehlsreferenz*. 

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

Das folgende Codebeispiel zeigt die Verwendung`get-resource`.

**AWS CLI**  
**So rufen Sie den aktuellen Status einer Ressource ab**  
Das folgende `get-resource` Beispiel gibt den aktuellen Status der benannten AWS: :Kinesis: :Stream-Ressource zurück. ResourceExample  

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

```
{
    "TypeName": "AWS::Kinesis::Stream",
    "ResourceDescription": {
        "Identifier": "ResourceExample",
        "Properties": "{\"Arn\":\"arn:aws:kinesis:us-west-2:099908667365:stream/ResourceExample\",\"RetentionPeriodHours\":168,\"Name\":\"ResourceExample\",\"ShardCount\":3}"
    }
}
```
Weitere Informationen finden Sie unter [Lesen des aktuellen Status einer Ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-read.html) im *Benutzerhandbuch für Cloud Control API*.  
+  *Einzelheiten zur API finden Sie unter Befehlsreferenz [GetResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/get-resource.html).AWS CLI * 

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

Das folgende Codebeispiel zeigt die Verwendung`list-resource-requests`.

**AWS CLI**  
**So listen Sie die aktiven Ressourcenoperationsanforderungen auf**  
Das folgende `list-resource-requests` Beispiel listet die Ressourcenanforderungen für CREATE- und UPDATE-Operationen auf, die in Ihrem AWS Konto fehlgeschlagen sind.  

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

```
{
    "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"
        }
    ]
}
```
Weitere Informationen finden Sie unter [Verwalten von Ressourcenoperationsanforderungen](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html) im *Benutzerhandbuch für Cloud Control API*.  
+  Einzelheiten zur API finden Sie [ListResourceRequests](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/list-resource-requests.html)unter *AWS CLI Befehlsreferenz*. 

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

Das folgende Codebeispiel zeigt die Verwendung`list-resources`.

**AWS CLI**  
**So listen Sie die Ressourcen eines bestimmten Typs auf**  
Das folgende `list-resources` Beispiel listet die AWS: :Kinesis: :Stream-Ressourcen auf, die in Ihrem Konto bereitgestellt werden. AWS   

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

```
{
    "TypeName": "AWS::Kinesis::Stream",
    "ResourceDescriptions": [
        {
            "Identifier": "MyKinesisStream",
            "Properties": "{\"Name\":\"MyKinesisStream\"}"
        },
        {
            "Identifier": "AnotherStream",
            "Properties": "{\"Name\":\"AnotherStream\"}"
        }
    ]
}
```
Weitere Informationen finden Sie unter [Ermitteln von Ressourcen](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-list.html) im *Benutzerhandbuch für Cloud Control API*.  
+  *Einzelheiten zur API finden Sie in der Befehlsreferenz [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/list-resources.html).AWS CLI * 

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

Das folgende Codebeispiel zeigt die Verwendung`update-resource`.

**AWS CLI**  
**So aktualisieren Sie die Eigenschaften einer vorhandenen Ressource**  
Im folgenden `update-resource` Beispiel wird die Aufbewahrungsrichtlinie einer AWS: :Logs:: LogGroup -Ressource mit dem Namen ExampleLogGroup auf 90 Tage aktualisiert.  

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

```
{
    "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"
    }
}
```
Weitere Informationen finden Sie unter [Aktualisieren einer Ressource](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-update.html) im *Benutzerhandbuch für Cloud Control API*.  
+  Einzelheiten zur API finden Sie [UpdateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/update-resource.html)in der *AWS CLI Befehlsreferenz.*