Contoh Amazon SWF menggunakan AWS CLI

Menghitung Eksekusi Alur Kerja Tertutup

Anda dapat menggunakan swf count-closed-workflow-executions untuk mengambil jumlah eksekusi alur kerja tertutup untuk domain tertentu. Anda dapat menentukan filter untuk menghitung kelas eksekusi tertentu.

Itu --domain dan salah satu --close-time-filter atau --start-time-filter argumen diperlukan. Semua argumen lainnya adalah opsional.

aws swf count-closed-workflow-executions \
    --domain DataFrobtzz \
    --close-time-filter "{ \"latestDate\" : 1377129600, \"oldestDate\" : 1370044800 }"

Output:

{
    "count": 2,
    "truncated": false
}

Jika “terpotong”true, maka “hitung” mewakili jumlah maksimum yang dapat dikembalikan oleh Amazon SWF. Hasil lebih lanjut terpotong.

Untuk mengurangi jumlah hasil yang dikembalikan, Anda dapat:

memodifikasi --close-time-filter atau --start-time-filter nilai untuk mempersempit rentang waktu yang dicari. Masing-masing dari ini saling eksklusif: Anda hanya dapat menentukan salah satunya dalam request.use the--close-status-filter,--execution-filter, --tag-filter atau --type-filter argumen untuk memfilter hasil lebih lanjut. Namun, argumen ini juga saling eksklusif.

Lihat Juga CountClosedWorkflowExecutionsdi Referensi API Layanan Alur Kerja Sederhana Amazon

Menghitung Eksekusi Alur Kerja Terbuka

Anda dapat menggunakan swf count-open-workflow-executions untuk mengambil jumlah eksekusi alur kerja terbuka untuk domain tertentu. Anda dapat menentukan filter untuk menghitung kelas eksekusi tertentu.

--start-time-filterArgumen --domain dan diperlukan. Semua argumen lainnya adalah opsional.

aws swf count-open-workflow-executions \
    --domain DataFrobtzz \
    --start-time-filter "{ \"latestDate\" : 1377129600, \"oldestDate\" : 1370044800 }"

Output:

{
    "count": 4,
    "truncated": false
}

Jika “terpotong”true, maka “hitung” mewakili jumlah maksimum yang dapat dikembalikan oleh Amazon SWF. Hasil lebih lanjut terpotong.

Untuk mengurangi jumlah hasil yang dikembalikan, Anda dapat:

memodifikasi --start-time-filter nilai untuk mempersempit rentang waktu yang dicari. Gunakan--close-status-filter,--execution-filter, --tag-filter atau --type-filter argumen untuk memfilter hasil lebih lanjut. Masing-masing saling eksklusif: Anda hanya dapat menentukan salah satunya dalam permintaan.

Untuk informasi selengkapnya, lihat CountOpenWorkflowExecutions di Referensi API Amazon Simple Workflow Service

Mengakhiri Domain

Untuk menghentikan domain (Anda masih dapat melihatnya, tetapi tidak dapat membuat eksekusi alur kerja baru atau mendaftarkan jenis di dalamnya), gunakan. swf deprecate-domain Ini memiliki parameter tunggal yang diperlukan--name, yang mengambil nama domain untuk dihentikan.

aws swf deprecate-domain \
    --name MyNeatNewDomain ""

Seperti halnyaregister-domain, tidak ada output yang dikembalikan. Namun, jika Anda menggunakan list-domains untuk melihat domain terdaftar, Anda akan melihat bahwa domain tersebut telah usang dan tidak lagi muncul di data yang dikembalikan.

aws swf list-domains \
    --registration-status REGISTERED
        {
            "domainInfos": [
                {
                    "status": "REGISTERED",
                    "name": "DataFrobotz"
                },
                {
                    "status": "REGISTERED",
                    "name": "erontest"
                }
            ]
        }

Jika Anda menggunakan --registration-status DEPRECATED denganlist-domains, Anda akan melihat domain Anda yang tidak digunakan lagi.

aws swf list-domains \
    --registration-status DEPRECATED
        {
            "domainInfos": [
                {
                    "status": "DEPRECATED",
                    "name": "MyNeatNewDomain"
                }
            ]
        }

Anda masih dapat menggunakan describe-domain untuk mendapatkan informasi tentang domain usang.

aws swf describe-domain \
    --name MyNeatNewDomain
        {
            "domainInfo": {
                "status": "DEPRECATED",
                "name": "MyNeatNewDomain"
            },
            "configuration": {
                "workflowExecutionRetentionPeriodInDays": "0"
            }
        }

Lihat Juga DeprecateDomaindi Referensi API Layanan Alur Kerja Sederhana Amazon

Mendapatkan Informasi Tentang Domain

Untuk mendapatkan informasi terperinci tentang domain tertentu, gunakan swf describe-domain perintah. Ada satu parameter yang diperlukan:--name, yang mengambil nama domain yang Anda inginkan informasi tentang.

aws swf describe-domain \
    --name DataFrobotz
        {
            "domainInfo": {
                "status": "REGISTERED",
                "name": "DataFrobotz"
            },
            "configuration": {
                "workflowExecutionRetentionPeriodInDays": "1"
            }
        }

Anda juga dapat menggunakan describe-domain untuk mendapatkan informasi tentang domain usang.

aws swf describe-domain \
    --name MyNeatNewDomain
        {
            "domainInfo": {
                "status": "DEPRECATED",
                "name": "MyNeatNewDomain"
            },
            "configuration": {
                "workflowExecutionRetentionPeriodInDays": "0"
            }
        }

Lihat Juga DescribeDomaindi Referensi API Layanan Alur Kerja Sederhana Amazon

Jenis Kegiatan Daftar

Untuk mendapatkan daftar jenis aktivitas untuk domain, gunakanswf list-activity-types. --registration-statusArgumen --domain dan diperlukan.

aws swf list-activity-types \
    --domain DataFrobtzz \
    --registration-status REGISTERED

Output:

{
    "typeInfos": [
        {
            "status": "REGISTERED",
            "creationDate": 1371454150.451,
            "activityType": {
                "version": "1",
                "name": "confirm-user-email"
            },
            "description": "subscribe confirm-user-email activity"
        },
        {
            "status": "REGISTERED",
            "creationDate": 1371454150.709,
            "activityType": {
                "version": "1",
                "name": "confirm-user-phone"
            },
            "description": "subscribe confirm-user-phone activity"
        },
        {
            "status": "REGISTERED",
            "creationDate": 1371454149.871,
            "activityType": {
                "version": "1",
                "name": "get-subscription-info"
            },
            "description": "subscribe get-subscription-info activity"
        },
        {
            "status": "REGISTERED",
            "creationDate": 1371454150.909,
            "activityType": {
                "version": "1",
                "name": "send-subscription-success"
            },
            "description": "subscribe send-subscription-success activity"
        },
        {
            "status": "REGISTERED",
            "creationDate": 1371454150.085,
            "activityType": {
                "version": "1",
                "name": "subscribe-user-sns"
            },
            "description": "subscribe subscribe-user-sns activity"
        }
    ]
}

Anda dapat menggunakan --name argumen untuk memilih hanya jenis aktivitas dengan nama tertentu:

aws swf list-activity-types \
    --domain DataFrobtzz \
    --registration-status REGISTERED \
    --name "send-subscription-success"

Output:

{
    "typeInfos": [
        {
            "status": "REGISTERED",
            "creationDate": 1371454150.909,
            "activityType": {
                "version": "1",
                "name": "send-subscription-success"
            },
            "description": "subscribe send-subscription-success activity"
        }
    ]
}

Untuk mengambil hasil di halaman, Anda dapat mengatur --maximum-page-size argumen. Jika lebih banyak hasil yang dikembalikan daripada yang akan muat di halaman hasil, nextPageToken "" akan dikembalikan dalam kumpulan hasil:

aws swf list-activity-types \
    --domain DataFrobtzz \
    --registration-status REGISTERED \
    --maximum-page-size 2

Output:

{
    "nextPageToken": "AAAAKgAAAAEAAAAAAAAAA1Gp1BelJq+PmHvAnDxJYbup8+0R4LVtbXLDl7QNY7C3OpHo9Sz06D/GuFz1OyC73umBQ1tOPJ/gC/aYpzDMqUIWIA1T9W0s2DryyZX4OC/6Lhk9/o5kdsuWMSBkHhgaZjgwp3WJINIFJFdaSMxY2vYAX7AtRtpcqJuBDDRE9RaRqDGYqIYUMltarkiqpSY1ZVveBasBvlvyUb/WGAaqehiDz7/JzLT/wWNNUMOd+Nhe",
    "typeInfos": [
        {
            "status": "REGISTERED",
            "creationDate": 1371454150.451,
            "activityType": {
                "version": "1",
                "name": "confirm-user-email"
            },
            "description": "subscribe confirm-user-email activity"
        },
        {
            "status": "REGISTERED",
            "creationDate": 1371454150.709,
            "activityType": {
                "version": "1",
                "name": "confirm-user-phone"
            },
            "description": "subscribe confirm-user-phone activity"
        }
    ]
}

Anda dapat meneruskan nextPageToken nilai ke panggilan berikutnya list-activity-types dalam --next-page-token argumen, mengambil halaman hasil berikutnya:

aws swf list-activity-types \
    --domain DataFrobtzz \
    --registration-status REGISTERED \
    --maximum-page-size 2 \
    --next-page-token "AAAAKgAAAAEAAAAAAAAAA1Gp1BelJq+PmHvAnDxJYbup8+0R4LVtbXLDl7QNY7C3OpHo9Sz06D/GuFz1OyC73umBQ1tOPJ/gC/aYpzDMqUIWIA1T9W0s2DryyZX4OC/6Lhk9/o5kdsuWMSBkHhgaZjgwp3WJINIFJFdaSMxY2vYAX7AtRtpcqJuBDDRE9RaRqDGYqIYUMltarkiqpSY1ZVveBasBvlvyUb/WGAaqehiDz7/JzLT/wWNNUMOd+Nhe"

Output:

{
    "nextPageToken": "AAAAKgAAAAEAAAAAAAAAAw+7LZ4GRZPzTqBHsp2wBxWB8m1sgLCclgCuq3J+h/m3+vOfFqtkcjLwV5cc4OjNAzTCuq/XcylPumGwkjbajtqpZpbqOcVNfjFxGoi0LB2Olbvv0krbUISBvlpFPmSWpDSZJsxg5UxCcweteSlFn1PNSZ/MoinBZo8OTkjMuzcsTuKOzH9wCaR8ITcALJ3SaqHU3pyIRS5hPmFA3OLIc8zaAepjlaujo6hntNSCruB4"
    "typeInfos": [
        {
            "status": "REGISTERED",
            "creationDate": 1371454149.871,
            "activityType": {
                "version": "1",
                "name": "get-subscription-info"
            },
            "description": "subscribe get-subscription-info activity"
        },
        {
            "status": "REGISTERED",
            "creationDate": 1371454150.909,
            "activityType": {
                "version": "1",
                "name": "send-subscription-success"
            },
            "description": "subscribe send-subscription-success activity"
        }
    ]
}

Jika masih ada lebih banyak hasil untuk dikembalikan, nextPageToken "" akan dikembalikan dengan hasilnya. Ketika tidak ada lagi halaman hasil untuk dikembalikan, "nextPageToken" tidak akan dikembalikan dalam set hasil.

Anda dapat menggunakan --reverse-order argumen untuk membalikkan urutan hasil yang dikembalikan. Ini juga mempengaruhi hasil halaman.

aws swf list-activity-types \
    --domain DataFrobtzz \
    --registration-status REGISTERED \
    --maximum-page-size 2 \
    --reverse-order

Output:

{
    "nextPageToken": "AAAAKgAAAAEAAAAAAAAAAwXcpu5ePSyQkrC+8WMbmSrenuZC2ZkIXQYBPB/b9xIOVkj+bMEFhGj0KmmJ4rF7iddhjf7UMYCsfGkEn7mk+yMCgVc1JxDWmB0EH46bhcmcLmYNQihMDmUWocpr7To6/R7CLu0St1gkFayxOidJXErQW0zdNfQaIWAnF/cwioBbXlkz1fQzmDeU3M5oYGMPQIrUqkPq7pMEW0q0lK5eDN97NzFYdZZ/rlcLDWPZhUjY",
    "typeInfos": [
        {
            "status": "REGISTERED",
            "creationDate": 1371454150.085,
            "activityType": {
                "version": "1",
                "name": "subscribe-user-sns"
            },
            "description": "subscribe subscribe-user-sns activity"
        },
        {
            "status": "REGISTERED",
            "creationDate": 1371454150.909,
            "activityType": {
                "version": "1",
                "name": "send-subscription-success"
            },
            "description": "subscribe send-subscription-success activity"
        }
    ]
}

Lihat Juga ListActivityTypesdi Referensi API Layanan Alur Kerja Sederhana Amazon

Contoh 1: Untuk membuat daftar domain terdaftar

Contoh list-domains perintah berikut mencantumkan domain REGISTERED SWF yang telah Anda daftarkan untuk akun Anda.

aws swf list-domains \
    --registration-status REGISTERED

Output:

{
  "domainInfos": [
    {
      "status": "REGISTERED",
      "name": "DataFrobotz"
    },
    {
      "status": "REGISTERED",
      "name": "erontest"
    }
  ]
}

Untuk informasi selengkapnya, lihat ListDomainsdi Referensi API Amazon Simple Workflow Service

Contoh 2: Untuk mencantumkan domain Anda yang tidak digunakan lagi

Contoh list-domains perintah berikut mencantumkan domain DEPRECATED SWF yang telah Anda daftarkan untuk akun Anda. Domain usang adalah domain yang tidak dapat mendaftarkan alur kerja atau aktivitas baru, tetapi masih dapat ditanyakan.

aws swf list-domains \
    --registration-status DEPRECATED

Output:

{
  "domainInfos": [
    {
      "status": "DEPRECATED",
      "name": "MyNeatNewDomain"
    }
  ]
}

Untuk informasi selengkapnya, lihat ListDomainsdi Referensi API Amazon Simple Workflow Service

Contoh 3: Untuk daftar halaman pertama domain terdaftar

Contoh list-domains perintah berikut mencantumkan domain REGISTERED SWF halaman pertama yang telah Anda daftarkan untuk akun Anda menggunakan opsi. --maximum-page-size

aws swf list-domains \
    --registration-status REGISTERED \
    --maximum-page-size 1

Output:

{
    "domainInfos": [
        {
            "status": "REGISTERED",
            "name": "DataFrobotz"
        }
    ],
"nextPageToken": "AAAAKgAAAAEAAAAAAAAAA2QJKNtidVgd49TTeNwYcpD+QKT2ynuEbibcQWe2QKrslMGe63gpS0MgZGpcpoKttL4OCXRFn98Xif557it+wSZUsvUDtImjDLvguyuyyFdIZtvIxIKEOPm3k2r4OjAGaFsGOuVbrKljvla7wdU7FYH3OlkNCP8b7PBj9SBkUyGoiAghET74P93AuVIIkdKGtQ=="
}

Untuk informasi selengkapnya, lihat ListDomainsdi Referensi API Amazon Simple Workflow Service

Contoh 4: Untuk daftar satu halaman tertentu dari domain terdaftar

Contoh list-domains perintah berikut mencantumkan domain REGISTERED SWF halaman pertama yang telah Anda daftarkan untuk akun Anda menggunakan opsi. --maximum-page-size

Ketika Anda membuat panggilan lagi, kali ini memberikan nilai nextPageToken dalam --next-page-token argumen, Anda akan mendapatkan halaman lain dari hasil.

aws swf list-domains \
    --registration-status REGISTERED \
    --maximum-page-size 1 \
    --next-page-token "AAAAKgAAAAEAAAAAAAAAA2QJKNtidVgd49TTeNwYcpD+QKT2ynuEbibcQWe2QKrslMGe63gpS0MgZGpcpoKttL4OCXRFn98Xif557it+wSZUsvUDtImjDLvguyuyyFdIZtvIxIKEOPm3k2r4OjAGaFsGOuVbrKljvla7wdU7FYH3OlkNCP8b7PBj9SBkUyGoiAghET74P93AuVIIkdKGtQ=="

Output:

{
    "domainInfos": [
        {
            "status": "REGISTERED",
            "name": "erontest"
        }
    ]
}

Ketika tidak ada halaman hasil lebih lanjut untuk diambil, tidak nextPageToken akan dikembalikan dalam hasil.

Untuk informasi selengkapnya, lihat ListDomainsdi Referensi API Amazon Simple Workflow Service

Daftar Jenis Alur Kerja

Untuk mendapatkan daftar jenis alur kerja untuk domain, gunakanswf list-workflow-types. --registration-statusArgumen --domain dan diperlukan. Berikut adalah contoh sederhana.

aws swf list-workflow-types \
    --domain DataFrobtzz \
    --registration-status REGISTERED

Output:

{
    "typeInfos": [
        {
            "status": "REGISTERED",
            "creationDate": 1371454149.598,
            "description": "DataFrobtzz subscribe workflow",
            "workflowType": {
                "version": "v3",
                "name": "subscribe"
            }
        }
    ]
}

Seperti halnyalist-activity-types, Anda dapat menggunakan --name argumen untuk memilih hanya jenis alur kerja dengan nama tertentu, dan menggunakan --maximum-page-size argumen dalam koordinasi dengan --next-page-token hasil halaman. Untuk membalikkan urutan pengembalian hasil, gunakan--reverse-order.

Lihat Juga ListWorkflowTypesdi Referensi API Layanan Alur Kerja Sederhana Amazon

Mendaftarkan Domain

Anda dapat menggunakan AWS CLI untuk mendaftarkan domain baru. Gunakan perintah swf register-domain. Ada dua parameter yang diperlukan--name, yang mengambil nama domain, dan--workflow-execution-retention-period-in-days, yang membutuhkan bilangan bulat untuk menentukan jumlah hari untuk menyimpan data eksekusi alur kerja pada domain ini, hingga periode maksimum 90 hari (untuk informasi lebih lanjut, lihat FAQ SWF < faqs/ #retain_limit >). https://aws.amazon.com/swf/ Data eksekusi alur kerja tidak akan disimpan setelah jumlah hari yang ditentukan telah berlalu.

aws swf register-domain \
    --name MyNeatNewDomain \
    --workflow-execution-retention-period-in-days 0
    ""

Ketika Anda mendaftarkan domain, tidak ada yang dikembalikan (“”), tetapi Anda dapat swf describe-domain menggunakan swf list-domains atau melihat domain baru.

aws swf list-domains \
    --registration-status REGISTERED
        {
            "domainInfos": [
                {
                    "status": "REGISTERED",
                    "name": "DataFrobotz"
                },
                {
                    "status": "REGISTERED",
                    "name": "MyNeatNewDomain"
                },
                {
                    "status": "REGISTERED",
                    "name": "erontest"
                }
            ]
        }

Menggunakanswf describe-domain :

aws swf describe-domain --name MyNeatNewDomain
{
    "domainInfo": {
        "status": "REGISTERED",
        "name": "MyNeatNewDomain"
    },
    "configuration": {
        "workflowExecutionRetentionPeriodInDays": "0"
    }
}

Lihat Juga RegisterDomaindi Referensi API Layanan Alur Kerja Sederhana Amazon

Mendaftarkan Jenis Alur Kerja

Untuk mendaftarkan tipe Workflow dengan AWS CLI, gunakan swf register-workflow-type perintah.

aws swf register-workflow-type \
    --domain DataFrobtzz \
    --name "MySimpleWorkflow" \
    --workflow-version "v1"

Jika berhasil, perintah tidak menghasilkan output.

Pada kesalahan (misalnya, jika Anda mencoba mendaftarkan tipe alur kerja yang sama, atau menentukan domain yang tidak ada), Anda akan mendapatkan respons di JSON.

{
    "message": "WorkflowType=[name=MySimpleWorkflow, version=v1]",
    "__type": "com.amazonaws.swf.base.model#TypeAlreadyExistsFault"
}

Itu--domain, --name dan --workflow-version diperlukan. Anda juga dapat mengatur deskripsi alur kerja, batas waktu, dan kebijakan alur kerja anak.

Untuk informasi selengkapnya, lihat RegisterWorkflowTypedi Referensi API Amazon Simple Workflow Service