Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Exemples de contacts du gestionnaire d'incidents utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide des contacts du gestionnaire d'incidents.
Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous montrent comment appeler des fonctions de service individuelles, vous pouvez les visualiser dans leur contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.
Rubriques
Actions
L'exemple de code suivant montre comment utiliseraccept-page
.
- AWS CLI
-
Pour accepter une page pendant un engagement
L'
accept-page
exemple suivant utilise un code d'acceptation envoyé au canal de contact pour accepter une page.aws ssm-contacts accept-page \ --page-id
"arn:aws:ssm-contacts:us-east-2:682428703967:page/akuam/94ea0c7b-56d9-46c3-b84a-a37c8b067ad3"
\ --accept-typeREAD
\ --accept-code425440
Cette commande ne produit aucune sortie
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir AcceptPage
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliseractivate-contact-channel
.
- AWS CLI
-
Activer le canal de contact d'un contact
L'
activate-contact-channel
exemple suivant active un canal de contact et le rend utilisable dans le cadre d'un incident.aws ssm-contacts activate-contact-channel \ --contact-channel-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d"
\ --activation-code"466136"
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir ActivateContactChannel
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercommand-name
.
- AWS CLI
-
Pour supprimer un contact
L'
command-name
exemple suivant supprime un contact. Le contact ne sera plus joignable à partir d'un plan d'escalade qui le désigne.aws ssm-contacts delete-contact \ --contact-id
"arn:aws:ssm-contacts:us-east-1:682428703967:contact/alejr"
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir CommandName
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-contact-channel
.
- AWS CLI
-
Pour créer un canal de contact
Crée un canal de contact de type SMS pour le contact Akua Mansa. Les canaux de contact peuvent être créés de type SMSEMAIL, ouVOICE.
aws ssm-contacts create-contact-channel \ --contact-id
"arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam"
\ --name"akuas sms-test"
\ --typeSMS
\ --delivery-address '{"SimpleAddress": "+15005550199"}
'Sortie :
{ "ContactChannelArn": "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/02f506b9-ea5d-4764-af89-2daa793ff024" }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir CreateContactChannel
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-contact
.
- AWS CLI
-
Pour créer un contact
L'
create-contact
exemple suivant crée un contact dans votre environnement avec un plan vierge. Le plan peut être mis à jour après avoir créé des canaux de contact. Utilisez la create-contact-channel commande avec le résultat ARN de cette commande. Après avoir créé des canaux de contact pour ce contact, utilisez update-contact pour mettre à jour le plan.aws ssm-contacts create-contact \ --alias
"akuam"
\ --display-name"Akua Mansa"
\ --typePERSONAL
\ --plan '{"Stages": []}
'Sortie :
{ "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam" }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir CreateContact
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdeactivate-contact-channel
.
- AWS CLI
-
Pour désactiver un canal de contact
L'
deactivate-contact-channel
exemple suivant désactive un canal de contact. La désactivation d'un canal de contact signifie que le canal de contact ne sera plus paginé lors d'un incident. Vous pouvez également réactiver un canal de contact à tout moment à l'aide de laactivate-contact-channel
commande.aws ssm-contacts deactivate-contact-channel \ --contact-channel-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d"
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir DeactivateContactChannel
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-contact-channel
.
- AWS CLI
-
Pour supprimer un canal de contact
L'
delete-contact-channel
exemple suivant supprime un canal de contact. La suppression d'un canal de contact garantit que le canal de contact ne sera pas paginé lors d'un incident.aws ssm-contacts delete-contact-channel \ --contact-channel-id
"arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/13149bad-52ee-45ea-ae1e-45857f78f9b2"
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir DeleteContactChannel
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-contact
.
- AWS CLI
-
Pour supprimer un contact
L'
delete-contact
exemple suivant supprime un contact. Le contact ne sera plus joignable à partir d'un plan d'escalade qui le désigne.aws ssm-contacts delete-contact \ --contact-id
"arn:aws:ssm-contacts:us-east-1:111122223333:contact/alejr"
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir DeleteContact
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-engagement
.
- AWS CLI
-
Pour décrire les détails d'un engagement
L'
describe-engagement
exemple suivant répertorie les détails d'un engagement auprès d'un contact ou d'un plan d'escalade. Le sujet et le contenu sont envoyés aux canaux de contact.aws ssm-contacts describe-engagement \ --engagement-id
"arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356"
Sortie :
{ "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356", "Sender": "cli", "Subject": "cli-test", "Content": "Testing engagements via CLI", "PublicSubject": "cli-test", "PublicContent": "Testing engagements va CLI", "StartTime": "2021-05-18T18:25:41.151000+00:00" }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir DescribeEngagement
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-page
.
- AWS CLI
-
Pour répertorier les détails d'une page sur un canal de contact
L'
describe-page
exemple suivant répertorie les détails d'une page sur un canal de contact. La page inclura le sujet et le contenu fournis.aws ssm-contacts describe-page \ --page-id
"arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93"
Sortie :
{ "PageArn": "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93", "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "Subject": "cli-test", "Content": "Testing engagements via CLI", "PublicSubject": "cli-test", "PublicContent": "Testing engagements va CLI", "SentTime": "2021-05-18T18:43:29.301000+00:00", "ReadTime": "2021-05-18T18:43:55.708000+00:00", "DeliveryTime": "2021-05-18T18:43:55.265000+00:00" }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir DescribePage
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-contact-channel
.
- AWS CLI
-
Pour répertorier les détails d'un canal de contact
L'
get-contact-channel
exemple suivant répertorie les détails d'un canal de contact.aws ssm-contacts get-contact-channel \ --contact-channel-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d"
Sortie :
{ "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", "Name": "akuas sms", "Type": "SMS", "DeliveryAddress": { "SimpleAddress": "+15005550199" }, "ActivationStatus": "ACTIVATED" }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir GetContactChannel
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-contact-policy
.
- AWS CLI
-
Pour répertorier les politiques de ressources d'un contact
L'
get-contact-policy
exemple suivant répertorie les politiques de ressources associées au contact spécifié.aws ssm-contacts get-contact-policy \ --contact-arn
"arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam"
Sortie :
{ "ContactArn": "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam", "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"SharePolicyForDocumentationDralia\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"222233334444\"},\"Action\":[\"ssm-contacts:GetContact\",\"ssm-contacts:StartEngagement\",\"ssm-contacts:DescribeEngagement\",\"ssm-contacts:ListPagesByEngagement\",\"ssm-contacts:StopEngagement\"],\"Resource\":[\"arn:aws:ssm-contacts:*:111122223333:contact/akuam\",\"arn:aws:ssm-contacts:*:111122223333:engagement/akuam/*\"]}]}" }
Pour plus d'informations, consultez la section Utilisation de contacts partagés et de plans de réponse dans le guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir GetContactPolicy
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-contact
.
- AWS CLI
-
Exemple 1 : Pour décrire un plan de contact
L'
get-contact
exemple suivant décrit un contact.aws ssm-contacts get-contact \ --contact-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam"
Sortie :
{ "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Alias": "akuam", "DisplayName": "Akua Mansa", "Type": "PERSONAL", "Plan": { "Stages": [ { "DurationInMinutes": 5, "Targets": [ { "ChannelTargetInfo": { "ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/beb25840-5ac8-4644-95cc-7a8de390fa65", "RetryIntervalInMinutes": 1 } } ] }, { "DurationInMinutes": 5, "Targets": [ { "ChannelTargetInfo": { "ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad", "RetryIntervalInMinutes": 1 } } ] }, { "DurationInMinutes": 5, "Targets": [ { "ChannelTargetInfo": { "ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/77d4f447-f619-4954-afff-85551e369c2a", "RetryIntervalInMinutes": 1 } } ] } ] } }
Exemple 2 : Pour décrire un plan d'escalade
L'
get-contact
exemple suivant décrit un plan d'escalade.aws ssm-contacts get-contact \ --contact-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation"
Sortie :
{ "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", "Alias": "example_escalation", "DisplayName": "Example Escalation", "Type": "ESCALATION", "Plan": { "Stages": [ { "DurationInMinutes": 5, "Targets": [ { "ContactTargetInfo": { "ContactId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "IsEssential": true } } ] }, { "DurationInMinutes": 5, "Targets": [ { "ContactTargetInfo": { "ContactId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/alejr", "IsEssential": false } } ] }, { "DurationInMinutes": 0, "Targets": [ { "ContactTargetInfo": { "ContactId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/anasi", "IsEssential": false } } ] } ] } }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir GetContact
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-contact-channels
.
- AWS CLI
-
Pour répertorier les canaux de contact d'un contact
L'
list-contact-channels
exemple suivant répertorie les canaux de contact disponibles pour le contact spécifié.aws ssm-contacts list-contact-channels \ --contact-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam"
Sortie :
{ [ { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Name": "akuas email", "Type": "EMAIL", "DeliveryAddress": { "SimpleAddress": "akuam@example.com" }, "ActivationStatus": "NOT_ACTIVATED" }, { "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Name": "akuas sms", "Type": "SMS", "DeliveryAddress": { "SimpleAddress": "+15005550100" }, "ActivationStatus": "ACTIVATED" } ] }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir ListContactChannels
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-contacts
.
- AWS CLI
-
Pour répertorier tous les plans d'escalade et les contacts
L'
list-contacts
exemple suivant répertorie les contacts et les plans d'escalade de votre compte.aws ssm-contacts list-contacts
Sortie :
{ "Contacts": [ { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Alias": "akuam", "DisplayName": "Akua Mansa", "Type": "PERSONAL" }, { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/alejr", "Alias": "alejr", "DisplayName": "Alejandro Rosalez", "Type": "PERSONAL" }, { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/anasi", "Alias": "anasi", "DisplayName": "Ana Carolina Silva", "Type": "PERSONAL" }, { "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", "Alias": "example_escalation", "DisplayName": "Example Escalation", "Type": "ESCALATION" } ] }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir ListContacts
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-engagements
.
- AWS CLI
-
Pour répertorier tous les engagements
L'
list-engagements
exemple suivant répertorie les engagements pris dans le cadre de plans d'escalade et de contacts. Vous pouvez également répertorier les engagements pour un seul incident.aws ssm-contacts list-engagements
Sortie :
{ "Engagements": [ { "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/91792571-0b53-4821-9f73-d25d13d9e529", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "StartTime": "2021-05-18T20:37:50.300000+00:00" }, { "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "StartTime": "2021-05-18T18:40:26.666000+00:00" }, { "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", "Sender": "cli", "StartTime": "2021-05-18T18:25:41.151000+00:00" }, { "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/607ced0e-e8fa-4ea7-8958-a237b8803f8f", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "StartTime": "2021-05-18T18:20:58.093000+00:00" } ] }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir ListEngagements
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-page-receipts
.
- AWS CLI
-
Pour répertorier les reçus de page
L'
command-name
exemple suivant indique si une page a été reçue ou non par un contact.aws ssm-contacts list-page-receipts \ --page-id
"arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/94ea0c7b-56d9-46c3-b84a-a37c8b067ad3"
Sortie :
{ "Receipts": [ { "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", "ReceiptType": "DELIVERED", "ReceiptInfo": "425440", "ReceiptTime": "2021-05-18T20:42:57.485000+00:00" }, { "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", "ReceiptType": "READ", "ReceiptInfo": "425440", "ReceiptTime": "2021-05-18T20:42:57.907000+00:00" }, { "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", "ReceiptType": "SENT", "ReceiptInfo": "SM6656c19132f1465f9c9c1123a5dde7c9", "ReceiptTime": "2021-05-18T20:40:52.962000+00:00" } ] }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir ListPageReceipts
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-pages-by-contact
.
- AWS CLI
-
Pour répertorier les pages par contact
L'
list-pages-by-contact
exemple suivant répertorie toutes les pages du contact spécifié.aws ssm-contacts list-pages-by-contact \ --contact-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam"
Sortie :
{ "Pages": [ { "PageArn": "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93", "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "SentTime": "2021-05-18T18:43:29.301000+00:00", "DeliveryTime": "2021-05-18T18:43:55.265000+00:00", "ReadTime": "2021-05-18T18:43:55.708000+00:00" } ] }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir ListPagesByContact
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-pages-by-engagement
.
- AWS CLI
-
Répertorier les pages permettant de contacter les canaux créés à partir d'un engagement.
L'
list-pages-by-engagement
exemple suivant répertorie les pages qui se sont produites lors de l'engagement du plan d'engagement défini.aws ssm-contacts list-pages-by-engagement \ --engagement-id
"arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0"
Sortie :
{ "Pages": [ { "PageArn": "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93", "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", "Sender": "cli", "SentTime": "2021-05-18T18:40:27.245000+00:00" } ] }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir ListPagesByEngagement
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-tags-for-resource
.
- AWS CLI
-
Pour répertorier les tags d'un contact
L'
list-tags-for-resource
exemple suivant répertorie les tags du contact spécifié.aws ssm-contacts list-tags-for-resource \ --resource-arn
"arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam"
Sortie :
{ "Tags": [ { "Key": "group1", "Value": "1" } ] }
Pour plus d'informations, consultez la section Balisage dans le guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir ListTagsForResource
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserput-contact-policy
.
- AWS CLI
-
Pour partager un contact et des engagements
L'
put-contact-policy
exemple suivant ajoute une politique de ressources au contact Akua qui partage le contact et les engagements associés avec le principal.aws ssm-contacts put-contact-policy \ --contact-arn
"arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam"
\ --policy "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"ExampleResourcePolicy\",\"Action\":[\"ssm-contacts:GetContact\",\"ssm-contacts:StartEngagement\",\"ssm-contacts:DescribeEngagement\",\"ssm-contacts:ListPagesByEngagement\",\"ssm-contacts:StopEngagement\"],\"Principal\":{\"AWS\":\"222233334444\"},\"Effect\":\"Allow\",\"Resource\":[\"arn:aws:ssm-contacts:*:111122223333:contact\/akuam\",\"arn:aws:ssm-contacts:*:111122223333:engagement\/akuam\/*\"]}]}"Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Utilisation de contacts partagés et de plans de réponse dans le guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir PutContactPolicy
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisersend-activation-code
.
- AWS CLI
-
Pour envoyer un code d'activation
L'
send-activation-code
exemple suivant envoie un code d'activation et un message au canal de contact spécifié.aws ssm-contacts send-activation-code \ --contact-channel-id
"arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/8ddae2d1-12c8-4e45-b852-c8587266c400"
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir SendActivationCode
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserstart-engagement
.
- AWS CLI
-
Exemple 1 : pour mettre en page les canaux de contact d'un contact
Les
start-engagement
pages suivantes permettent de contacter les canaux de contact. L'expéditeur, le sujet, le sujet public et le contenu public sont tous exempts de champs. Incident Manager envoie le sujet et le contenu aux canaux fournis VOICE ou aux canaux de EMAIL contact. Incident Manager envoie le sujet public et le contenu public aux canaux de SMS contact fournis. L'expéditeur est utilisé pour savoir qui a lancé l'engagement.aws ssm-contacts start-engagement \ --contact-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam"
\ --sender"cli"
\ --subject"cli-test"
\ --content"Testing engagements via CLI"
\ --public-subject"cli-test"
\ --public-content"Testing engagements va CLI"
Sortie :
{ "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/607ced0e-e8fa-4ea7-8958-a237b8803f8f" }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
Exemple 2 : paginer un contact dans le plan d'escalade fourni.
Ce qui suit
start-engagement
engage les contacts par le biais d'un plan d'escalade. Chaque contact est paginé en fonction de son plan d'engagement.aws ssm-contacts start-engagement \ --contact-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation"
\ --sender"cli"
\ --subject"cli-test"
\ --content"Testing engagements via CLI"
\ --public-subject"cli-test"
\ --public-content"Testing engagements va CLI"
Sortie :
{ "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356" }
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir StartEngagement
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserstop-engagement
.
- AWS CLI
-
Pour mettre fin à un engagement
L'
stop-engagement
exemple suivant empêche un engagement de paginer d'autres contacts et canaux de contact.aws ssm-contacts stop-engagement \ --engagement-id
"arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356"
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir StopEngagement
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisertag-resource
.
- AWS CLI
-
Pour étiqueter un contact
L'
tag-resource
exemple suivant étiquette un contact spécifié avec la paire clé-valeur de balise fournie.aws ssm-contacts tag-resource \ --resource-arn
"arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam"
\ --tags '[{"Key":"group1","Value":"1"}]
'Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Balisage dans le guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir TagResource
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliseruntag-resource
.
- AWS CLI
-
Pour supprimer les tags d'un contact
L'
untag-resource
exemple suivant supprime la balise group1 du contact spécifié.aws ssm-contacts untag-resource \ --resource-arn
"arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam"
\ --tag-keys"group1"
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Balisage dans le guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir UntagResource
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-contact-channel
.
- AWS CLI
-
Pour mettre à jour un canal de contact
L'
update-contact-channel
exemple suivant met à jour le nom et l'adresse de livraison d'un canal de contact.aws ssm-contacts update-contact-channel \ --contact-channel-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad"
\ --name"akuas voice channel"
\ --delivery-address '{"SimpleAddress": "+15005550198"}
'Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir UpdateContactChannel
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-contact
.
- AWS CLI
-
Pour mettre à jour le plan d'engagement, contactez
L'
update-contact
exemple suivant met à jour le plan d'engagement du contact Akua pour inclure les trois types de canaux de contacts. Cela se fait après avoir créé des canaux de contact pour Akua.aws ssm-contacts update-contact \ --contact-id
"arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam"
\ --plan '{"Stages": [{"DurationInMinutes": 5, "Targets": [{"ChannelTargetInfo": {"ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/beb25840-5ac8-4644-95cc-7a8de390fa65","RetryIntervalInMinutes": 1 }}]}, {"DurationInMinutes": 5, "Targets": [{"ChannelTargetInfo":{"ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad", "RetryIntervalInMinutes": 1}}]}, {"DurationInMinutes": 5, "Targets": [{"ChannelTargetInfo": {"ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/77d4f447-f619-4954-afff-85551e369c2a","RetryIntervalInMinutes": 1 }}]}]}
'Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Contacts du guide de l'utilisateur d'Incident Manager.
-
Pour API plus de détails, voir UpdateContact
la section Référence des AWS CLI commandes.
-