APIContoh Cloud Control menggunakan AWS CLI - AWS SDKContoh Kode
Tindakan

Ada lebih banyak AWS SDK contoh yang tersedia di GitHub repo SDKContoh AWS Dokumen.

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

APIContoh Cloud Control menggunakan AWS CLI

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

Tindakan adalah 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.

Tindakan

Contoh kode berikut menunjukkan cara menggunakancreate-resource.

AWS CLI

Untuk membuat sumber daya

create-resourceContoh 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 di Panduan API Pengguna Kontrol Cloud.

  • Untuk API detailnya, lihat CreateResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-resource.

AWS CLI

Untuk menghapus sumber daya

delete-resourceContoh 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 di Panduan API Pengguna Kontrol Cloud.

  • Untuk API detailnya, lihat DeleteResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-resource-request-status.

AWS CLI

Untuk mendapatkan informasi status permintaan sumber daya

get-resource-request-statusContoh 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 di Panduan API Pengguna Kontrol Cloud.

Contoh kode berikut menunjukkan cara menggunakanget-resource.

AWS CLI

Untuk mendapatkan status sumber daya saat ini

get-resourceContoh 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 di Panduan API Pengguna Kontrol Cloud.

  • Untuk API detailnya, lihat GetResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-resource-requests.

AWS CLI

Untuk membuat daftar permintaan operasi sumber daya aktif

list-resource-requestsContoh berikut mencantumkan permintaan sumber daya CREATE dan UPDATE operasi 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 di Panduan API Pengguna Kontrol Cloud.

Contoh kode berikut menunjukkan cara menggunakanlist-resources.

AWS CLI

Untuk membuat daftar sumber daya dari jenis tertentu

list-resourcesContoh 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 di Panduan API Pengguna Kontrol Cloud.

  • Untuk API detailnya, lihat ListResourcesdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-resource.

AWS CLI

Untuk memperbarui properti sumber daya yang ada

update-resourceContoh 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 di Panduan API Pengguna Kontrol Cloud.

  • Untuk API detailnya, lihat UpdateResourcedi Referensi AWS CLI Perintah.