

Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh [SDK AWS Doc](https://github.com/awsdocs/aws-doc-sdk-examples). GitHub 

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Contoh Cloud Control API menggunakan AWS CLI
<a name="cli_2_cloudcontrol_code_examples"></a>

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum menggunakan AWS Command Line Interface with Cloud Control API.

*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

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

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

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

Contoh kode berikut menunjukkan cara menggunakan`create-resource`.

**AWS CLI**  
**Untuk membuat sumber daya**  
`create-resource`Contoh berikut membuat sumber daya AWS: :Kinesis: :Stream, bernama ResourceExample, dengan periode retensi 168 jam dan hitungan pecahan tiga.  

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

```
{
    "ProgressEvent": {
        "EventTime": 1632506656.706,
        "TypeName": "AWS::Kinesis::Stream",
        "OperationStatus": "IN_PROGRESS",
        "Operation": "CREATE",
        "Identifier": "ResourceExample",
        "RequestToken": "20999d87-e304-4725-ad84-832dcbfd7fc5"
    }
}
```
Untuk informasi selengkapnya, lihat [Membuat sumber daya](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html) di *Panduan Pengguna Cloud Control API*.  
+  Untuk detail API, lihat [CreateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/create-resource.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`delete-resource`.

**AWS CLI**  
**Untuk menghapus sumber daya**  
`delete-resource`Contoh berikut menghapus sumber daya AWS: :Kinesis: :Stream dengan pengenal ResourceExample dari akun Anda. AWS   

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

```
{
    "ProgressEvent": {
        "TypeName": "AWS::Kinesis::Stream",
        "Identifier": "ResourceExample",
        "RequestToken": "e48f26ff-d0f9-4ab8-a878-120db1edf111",
        "Operation": "DELETE",
        "OperationStatus": "IN_PROGRESS",
        "EventTime": 1632950300.14
    }
}
```
Untuk informasi selengkapnya, lihat [Menghapus sumber daya](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-delete.html) di *Panduan Pengguna Cloud Control API*.  
+  Untuk detail API, lihat [DeleteResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/delete-resource.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`get-resource-request-status`.

**AWS CLI**  
**Untuk mendapatkan informasi status permintaan sumber daya**  
`get-resource-request-status`Contoh berikut mengembalikan informasi status tentang permintaan sumber daya yang ditentukan.  

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

```
{
    "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"
    }
}
```
Untuk informasi selengkapnya, lihat [Mengelola permintaan pengoperasian sumber daya](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html) di *Panduan Pengguna Cloud Control API*.  
+  Untuk detail API, lihat [GetResourceRequestStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/get-resource-request-status.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`get-resource`.

**AWS CLI**  
**Untuk mendapatkan status sumber daya saat ini**  
`get-resource`Contoh berikut mengembalikan keadaan saat ini dari AWS: :Kinesis: :Stream sumber daya bernama. ResourceExample  

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

```
{
    "TypeName": "AWS::Kinesis::Stream",
    "ResourceDescription": {
        "Identifier": "ResourceExample",
        "Properties": "{\"Arn\":\"arn:aws:kinesis:us-west-2:099908667365:stream/ResourceExample\",\"RetentionPeriodHours\":168,\"Name\":\"ResourceExample\",\"ShardCount\":3}"
    }
}
```
Untuk informasi selengkapnya, lihat [Membaca status sumber daya saat ini](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-read.html) di *Panduan Pengguna Cloud Control API*.  
+  Untuk detail API, lihat [GetResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/get-resource.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`list-resource-requests`.

**AWS CLI**  
**Untuk membuat daftar permintaan operasi sumber daya aktif**  
`list-resource-requests`Contoh berikut mencantumkan permintaan sumber daya untuk operasi CREATE dan UPDATE yang gagal di AWS akun Anda.  

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

```
{
    "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"
        }
    ]
}
```
Untuk informasi selengkapnya, lihat [Mengelola permintaan pengoperasian sumber daya](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html) di *Panduan Pengguna Cloud Control API*.  
+  Untuk detail API, lihat [ListResourceRequests](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/list-resource-requests.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`list-resources`.

**AWS CLI**  
**Untuk membuat daftar sumber daya dari jenis tertentu**  
`list-resources`Contoh berikut mencantumkan sumber daya AWS: :Kinesis: :Stream yang disediakan di akun Anda. AWS   

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

```
{
    "TypeName": "AWS::Kinesis::Stream",
    "ResourceDescriptions": [
        {
            "Identifier": "MyKinesisStream",
            "Properties": "{\"Name\":\"MyKinesisStream\"}"
        },
        {
            "Identifier": "AnotherStream",
            "Properties": "{\"Name\":\"AnotherStream\"}"
        }
    ]
}
```
Untuk informasi selengkapnya, lihat [Menemukan sumber daya](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-list.html) di *Panduan Pengguna Cloud Control API*.  
+  Untuk detail API, lihat [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/list-resources.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`update-resource`.

**AWS CLI**  
**Untuk memperbarui properti sumber daya yang ada**  
`update-resource`Contoh berikut memperbarui kebijakan retensi LogGroup sumber daya AWS: :Logs:: yang diberi nama ExampleLogGroup menjadi 90 hari.  

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

```
{
    "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"
    }
}
```
Untuk informasi selengkapnya, lihat [Memperbarui sumber daya](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-update.html) di *Panduan Pengguna Cloud Control API*.  
+  Untuk detail API, lihat [UpdateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudcontrol/update-resource.html)di *Referensi AWS CLI Perintah*. 