Membuat OpsItems secara manual (AWS CLI)

Prosedur berikut menjelaskan cara membuat OpsItem dengan menggunakan AWS Command Line Interface (AWS CLI).

Untuk membuat OpsItem menggunakan AWS CLI

1. Instal dan konfigurasikan AWS Command Line Interface (AWS CLI), jika Anda belum melakukannya.

   Untuk selengkapnya, lihat Menginstal atau memperbarui versi terbaru AWS CLI.

2. Buka AWS CLI dan jalankan perintah berikut untuk membuat OpsItem. Ganti masing-masing example resource placeholder dengan informasi Anda sendiri.

   aws ssm create-ops-item \
       --title "Descriptive_title" \
       --description "Information_about_the_issue" \
       --priority Number_between_1_and_5 \
       --source Source_of_the_issue \
       --operational-data Up_to_20_KB_of_data_or_path_to_JSON_file \
       --notifications Arn="SNS_ARN_in_same_Region" \
       --tags "Key=key_name,Value=a_value"

   Tentukan data operasional dari file

   Saat Anda membuat OpsItem, Anda dapat menentukan data operasional dari file. File tersebut harus berupa JSON file, dan isi file harus menggunakan format berikut.

   {
     "key_name": {
       "Type": "SearchableString",
       "Value": "Up to 20 KB of data"
     }
   }

   Inilah contohnya.

   aws ssm create-ops-item ^
       --title "EC2 instance disk full" ^
       --description "Log clean up may have failed which caused the disk to be full" ^
       --priority 2 ^
       --source ec2 ^
       --operational-data file:///Users/TestUser1/Desktop/OpsItems/opsData.json ^
       --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" ^
       --tags "Key=EC2,Value=Production"

   catatan

   Untuk informasi tentang cara memasukkan parameter berformat JSON pada baris perintah pada sistem operasi lokal yang berbeda, lihat Menggunakan tanda kutip dengan string di dalam Panduan Pengguna. AWS CLIAWS Command Line Interface

   Sistem mengembalikan informasi seperti berikut ini.

   {
       "OpsItemId": "oi-1a2b3c4d5e6f"
   }

3. Jalankan perintah berikut untuk melihat detail tentang OpsItem yang kamu ciptakan.

   aws ssm get-ops-item --ops-item-id ID

   Sistem mengembalikan informasi seperti berikut ini.

   {
       "OpsItem": {
           "CreatedBy": "arn:aws:iam::12345678:user/TestUser",
           "CreatedTime": 1558386334.995,
           "Description": "Log clean up may have failed which caused the disk to be full",
           "LastModifiedBy": "arn:aws:iam::12345678:user/TestUser",
           "LastModifiedTime": 1558386334.995,
           "Notifications": [
               {
                   "Arn": "arn:aws:sns:us-west-1:12345678:TestUser"
               }
           ],
           "Priority": 2,
           "RelatedOpsItems": [],
           "Status": "Open",
           "OpsItemId": "oi-1a2b3c4d5e6f",
           "Title": "EC2 instance disk full",
           "Source": "ec2",
           "OperationalData": {
               "EC2": {
                   "Value": "12345",
                   "Type": "SearchableString"
               }
           }
       }
   }

4. Jalankan perintah berikut untuk memperbarui OpsItem. Perintah ini mengubah status dari Open (default) menjadiInProgress.

   aws ssm update-ops-item --ops-item-id ID --status InProgress

   Perintah tidak memiliki output.

5. Jalankan perintah berikut lagi untuk memverifikasi bahwa status berubah menjadiInProgress.

   aws ssm get-ops-item --ops-item-id ID

Contoh membuat OpsItem

Contoh kode berikut menunjukkan cara membuat OpsItem dengan menggunakan Linux portal manajemen, macOS, atau Windows.

Linux portal manajemen atau macOS

Perintah berikut menciptakan OpsItem saat disk instans Amazon Elastic Compute Cloud (Amazon EC2) penuh.

aws ssm create-ops-item \
    --title "EC2 instance disk full" \
    --description "Log clean up may have failed which caused the disk to be full" \
    --priority 2 \
    --source ec2 \
    --operational-data '{"EC2":{"Value":"12345","Type":"SearchableString"}}' \
    --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" \
    --tags "Key=EC2,Value=ProductionServers"

Perintah berikut menggunakan /aws/resources kunci OperationalData untuk membuat OpsItem dengan sumber daya terkait Amazon DynamoDB.

aws ssm create-ops-item \
    --title "EC2 instance disk full" \
    --description "Log clean up may have failed which caused the disk to be full" \
    --priority 2 \
    --source ec2 \
    --operational-data '{"/aws/resources":{"Value":"[{\"arn\": \"arn:aws:dynamodb:us-west-2:12345678:table/OpsItems\"}]","Type":"SearchableString"}}' \
    --notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser"

Perintah berikut menggunakan /aws/automations kunci OperationalData untuk membuat OpsItem yang menentukan AWS-ASGEnterStandby dokumen sebagai runbook Otomasi terkait.

aws ssm create-ops-item \
    --title "EC2 instance disk full" \
    --description "Log clean up may have failed which caused the disk to be full" \
    --priority 2 \
    --source ec2 \
    --operational-data '{"/aws/automations":{"Value":"[{\"automationId\": \"AWS-ASGEnterStandby\", \"automationType\": \"AWS::SSM::Automation\"}]","Type":"SearchableString"}}' \
    --notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser"

Windows

Perintah berikut menciptakan OpsItem ketika instans Amazon Relational Database Service (Amazon RDS) tidak merespons.

aws ssm create-ops-item ^
    --title "RDS instance not responding" ^
    --description "RDS instance not responding to ping" ^
    --priority 1 ^
    --source RDS ^
    --operational-data={\"RDS\":{\"Value\":\"abcd\",\"Type\":\"SearchableString\"}} ^
    --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" ^
    --tags "Key=RDS,Value=ProductionServers"

Perintah berikut menggunakan /aws/resources kunci OperationalData untuk membuat OpsItem dengan sumber daya terkait EC2 instans Amazon.

aws ssm create-ops-item ^
    --title "EC2 instance disk full" ^
    --description "Log clean up may have failed which caused the disk to be full" ^
    --priority 2 ^
    --source ec2 ^
    --operational-data={\"/aws/resources\":{\"Value\":\"[{\\"""arn\\""":\\"""arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0\\"""}]\",\"Type\":\"SearchableString\"}}

Perintah berikut menggunakan /aws/automations kunci OperationalData untuk membuat OpsItem yang menentukan AWS-RestartEC2Instance runbook sebagai runbook Otomasi terkait.

aws ssm create-ops-item ^
    --title "EC2 instance disk full" ^
    --description "Log clean up may have failed which caused the disk to be full" ^
    --priority 2 ^
    --source ec2 ^
    --operational-data={\"/aws/automations\":{\"Value\":\"[{\\"""automationId\\""":\\"""AWS-RestartEC2Instance\\”"",\\"""automationType\\""":\\"""AWS::SSM::Automation\\"""}]\",\"Type\":\"SearchableString\"}}