AWS CodeStar Contoh pemberitahuan menggunakan AWS CLI

Untuk membuat aturan notifikasi

create-notification-ruleContoh berikut menggunakan file JSON bernama rule.json untuk membuat aturan notifikasi bernama MyNotificationRule untuk repositori bernama MyDemoRepo dalam akun tertentu. AWS Pemberitahuan dengan jenis FULL detail dikirim ke topik Amazon SNS target yang ditentukan saat cabang dan tag dibuat.

aws codestar-notifications create-notification-rule \
    --cli-input-json file://rule.json

Isi dari rule.json:

{
    "Name": "MyNotificationRule",
    "EventTypeIds": [
        "codecommit-repository-branches-and-tags-created"
    ],
    "Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo",
    "Targets": [
        {
            "TargetType": "SNS",
            "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
        }
    ],
    "Status": "ENABLED",
    "DetailType": "FULL"
}

Output:

{
    "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}

Untuk selengkapnya, lihat Membuat aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk menghapus aturan pemberitahuan

delete-notification-ruleContoh berikut menghapus aturan pemberitahuan yang ditentukan.

aws codestar-notifications delete-notification-rule \
    --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE

Output:

{
    "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}

Untuk selengkapnya, lihat Menghapus Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk menghapus target aturan notifikasi

delete-targetContoh berikut menghapus target yang ditentukan dari semua aturan notifikasi yang dikonfigurasi untuk menggunakannya sebagai target, dan kemudian menghapus target.

aws codestar-notifications  delete-target \
    --target-address arn:aws:sns:us-east-1:123456789012:MyNotificationTopic \
    --force-unsubscribe-all

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menghapus Target Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk mengambil rincian aturan notifikasi

describe-notification-ruleContoh berikut mengambil rincian aturan pemberitahuan yang ditentukan.

aws codestar-notifications describe-notification-rule \
    --arn arn:aws:codestar-notifications:us-west-2:123456789012:notificationrule/dc82df7a-EXAMPLE

Output:

{
    "LastModifiedTimestamp": 1569199844.857,
    "EventTypes": [
        {
            "ServiceName": "CodeCommit",
            "EventTypeName": "Branches and tags: Created",
            "ResourceType": "Repository",
            "EventTypeId": "codecommit-repository-branches-and-tags-created"
        }
    ],
    "Status": "ENABLED",
    "DetailType": "FULL",
    "Resource": "arn:aws:codecommit:us-west-2:123456789012:MyDemoRepo",
    "Arn": "arn:aws:codestar-notifications:us-west-w:123456789012:notificationrule/dc82df7a-EXAMPLE",
    "Targets": [
        {
            "TargetStatus": "ACTIVE",
            "TargetAddress": "arn:aws:sns:us-west-2:123456789012:MyNotificationTopic",
            "TargetType": "SNS"
        }
    ],
    "Name": "MyNotificationRule",
    "CreatedTimestamp": 1569199844.857,
    "CreatedBy": "arn:aws:iam::123456789012:user/Mary_Major"
}

Untuk selengkapnya, lihat Melihat Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk mendapatkan daftar jenis acara untuk aturan notifikasi

list-event-typesContoh berikut mengambil daftar yang difilter dari semua jenis acara pemberitahuan yang tersedia untuk CodeDeploy aplikasi. Jika sebaliknya Anda tidak menggunakan filter, perintah mengembalikan semua jenis acara notifikasi untuk semua jenis sumber daya.

aws codestar-notifications list-event-types \
    --filters Name=SERVICE_NAME,Value=CodeDeploy

Output:

{
    "EventTypes": [
        {
            "EventTypeId": "codedeploy-application-deployment-succeeded",
            "ServiceName": "CodeDeploy",
            "EventTypeName": "Deployment: Succeeded",
            "ResourceType": "Application"
        },
        {
            "EventTypeId": "codedeploy-application-deployment-failed",
            "ServiceName": "CodeDeploy",
            "EventTypeName": "Deployment: Failed",
            "ResourceType": "Application"
        },
        {
            "EventTypeId": "codedeploy-application-deployment-started",
            "ServiceName": "CodeDeploy",
            "EventTypeName": "Deployment: Started",
            "ResourceType": "Application"
        }
    ]
}

Untuk selengkapnya, lihat Membuat Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk mengambil daftar aturan pemberitahuan

list-notification-rulesContoh berikut mengambil daftar semua aturan notifikasi di AWS Wilayah tertentu.

aws codestar-notifications list-notification-rules --region us-east-1

Output:

{
    "NotificationRules": [
        {
            "Id": "dc82df7a-EXAMPLE",
            "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
        },
        {
            "Id": "8d1f0983-EXAMPLE",
            "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/8d1f0983-EXAMPLE"
        }
    ]
}

Untuk selengkapnya, lihat Melihat Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk mendapatkan daftar tag yang dilampirkan pada aturan notifikasi

list-tags-for-resourceContoh berikut mengambil daftar semua tag yang dilampirkan pada aturan pemberitahuan yang ditentukan. Dalam contoh ini, aturan notifikasi saat ini tidak memiliki tag yang terkait dengannya.

aws codestar-notifications list-tags-for-resource \
    --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE

Output:

{
    "Tags": {}
}

Untuk selengkapnya, lihat Membuat Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk mengambil daftar target aturan pemberitahuan

list-targetsContoh berikut mengambil daftar semua target aturan notifikasi di AWS Wilayah tertentu.

aws codestar-notifications list-targets \
    --region us-east-1

Output:

{
    "Targets": [
        {
            "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MySNSTopicForNotificationRules",
            "TargetType": "SNS",
            "TargetStatus": "ACTIVE"
        },
        {
            "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MySNSTopicForNotificationsAboutMyDemoRepo",
            "TargetType": "SNS",
            "TargetStatus": "ACTIVE"
        }
    ]
}

Untuk informasi selengkapnya, lihat Melihat Target Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk menambahkan target ke aturan notifikasi

subscribeContoh berikut menambahkan topik Amazon SNS sebagai target untuk aturan notifikasi yang ditentukan.

aws codestar-notifications subscribe \
    --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE \
    --target TargetType=SNS,TargetAddress=arn:aws:sns:us-east-1:123456789012:MyNotificationTopic

Output:

{
    "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}

Untuk selengkapnya, lihat Menambahkan atau Menghapus Topik Amazon SNS sebagai Target untuk Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk menambahkan tag ke aturan notifikasi

tag-resourceContoh berikut menambahkan tag dengan nama kunci Team dan nilai Li_Juan untuk aturan pemberitahuan yang ditentukan.

aws codestar-notifications tag-resource \
    --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE \
    --tags Team=Li_Juan

Output:

{
    "Tags": {
        "Team": "Li_Juan"
    }
}

Untuk selengkapnya, lihat Membuat Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk menghapus target dari aturan notifikasi

unsubscribeContoh berikut menghapus topik Amazon SNS sebagai target dari aturan notifikasi yang ditentukan.

aws codestar-notifications unsubscribe \
    --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE \
    --target TargetType=SNS,TargetAddress=arn:aws:sns:us-east-1:123456789012:MyNotificationTopic

Output:

{
    "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
    "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
}

Untuk selengkapnya, lihat Menambahkan atau Menghapus Topik Amazon SNS sebagai Target untuk Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk menghapus tag dari aturan pemberitahuan

untag-resourceContoh berikut menghapus tag dengan nama kunci Team dari aturan pemberitahuan yang ditentukan.

aws codestar-notifications untag-resource \
    --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE \
    --tag-keys Team

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengedit Aturan Pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.

Untuk memperbarui aturan pemberitahuan

update-notification-ruleContoh berikut memperbarui aturan notifikasi bernama MyNotificationRule di AWS akun 123456789012 menggunakan file JSON bernamaupdate.json.

aws codestar-notifications update-notification-rule \
    --cli-input-json file://update.json

Isi dari update.json:

{
    "Name": "MyUpdatedNotificationRule",
    "EventTypeIds": [
        "codecommit-repository-branches-and-tags-created"
    ],
    "Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo",
    "Targets": [
        {
            "TargetType": "SNS",
            "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
        }
    ],
    "Status": "ENABLED",
    "DetailType": "FULL"
}

Output:

{
    "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}

Untuk informasi selengkapnya, lihat Mengedit aturan pemberitahuan di Panduan Pengguna Konsol Alat AWS Pengembang.