Acciones, recursos y claves de condición para AWS Systems Manager Incident Manager Contacts
AWS Systems Manager Incident Manager Contacts (prefijo de servicio: ssm-contacts) proporciona los siguientes recursos, acciones y claves de contexto de condición específicos del servicio para usarse en las políticas de permisos de IAM.
Referencias:
-
Obtenga información para configurar este servicio.
-
Vea una lista de las operaciones de API disponibles para este servicio.
-
Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos de IAM.
Temas
Acciones definidas por AWS Systems Manager Incident Manager Contacts
Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.
La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.
La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.
nota
Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.
Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.
| Acciones | Descripción | Nivel de acceso | Tipos de recursos (*necesarios) | Claves de condición | Acciones dependientes |
|---|---|---|---|---|---|
| AcceptPage | Concede permiso para aceptar una página | Write | |||
| ActivateContactChannel | Concede permiso para activar el canal de contacto de un contacto | Write | |||
| AssociateContact [solo permiso] | Concede permiso para usar un contacto en un plan de escalado | Permissions management | |||
| CreateContact | Concede permiso para crear un contacto | Write |
ssm-contacts:AssociateContact |
||
| CreateContactChannel | Concede permiso para crear un canal de contacto para un contacto | Escritura | |||
| CreateRotation | Concede permiso para crear una rotación en un horario de guardia | Escritura | |||
| CreateRotationOverride | Concede permiso para crear una anulación de una rotación en un horario de guardia | Escritura | |||
| DeactivateContactChannel | Concede permiso para desactivar el canal de contacto de un contacto | Write | |||
| DeleteContact | Concede permiso para eliminar un contacto | Write | |||
| DeleteContactChannel | Concede permiso para eliminar el canal de contacto de un contacto | Escritura | |||
| DeleteRotation | Concede permiso para eliminar una rotación | Escritura | |||
| DeleteRotationOverride | Concede permiso para eliminar la anulación de rotación de una rotación | Escritura | |||
| DescribeEngagement | Concede permiso para describir un compromiso | Read | |||
| DescribePage | Concede permiso para describir una página | Read | |||
| GetContact | Concede permiso para obtener un contacto | Read | |||
| GetContactChannel | Concede permiso para obtener el canal de contacto de un contacto | Leer | |||
| GetContactPolicy | Concede permiso para obtener la política de recursos de un contacto | Leer | |||
| GetRotation | Concede permiso para recuperar información acerca de un horario de guardia | Leer | |||
| GetRotationOverride | Concede permiso para recuperar información acerca de una anulación en un horario de guardia | Leer | |||
| ListContactChannels | Concede permiso para enumerar todos los canales de contacto de un contacto | List | |||
| ListContacts | Concede permiso para enumerar todos los contactos | List | |||
| ListEngagements | Concede permiso para enumerar todas las interacciones | List | |||
| ListPageReceipts | Concede permiso para enumerar todos los recibos de una página | Enumeración | |||
| ListPageResolutions | Otorga permiso para enumerar la ruta de resolución de una interacción | Enumeración | |||
| ListPagesByContact | Concede permiso para enumerar todas las páginas enviadas a un contacto | List | |||
| ListPagesByEngagement | Concede permiso para enumerar todas las páginas creadas en una interacción | Enumeración | |||
| ListPreviewRotationShifts | Concede permiso para recuperar una lista de turnos en función de los parámetros de configuración de rotación | Enumeración | |||
| ListRotationOverrides | Concede permiso para recuperar una lista de anulaciones especificadas para una rotación de guardia | Enumeración | |||
| ListRotationShifts | Concede permiso para recuperar una lista de turnos de rotación en un horario de guardia | Enumeración | |||
| ListRotations | Concede permiso para recuperar una lista de rotaciones de guardia | Enumeración | |||
| ListTagsForResource | Concede permiso para ver una lista de etiquetas de recurso para un recurso especificado | Leer | |||
| PutContactPolicy | Concede permiso para agregar una política de recursos a un contacto | Write | |||
| SendActivationCode | Concede permiso para enviar el código de activación del canal de contacto de un contacto | Write | |||
| StartEngagement | Concede permiso para iniciar una interacción | Write | |||
| StopEngagement | Concede permiso para detener una interacción | Escritura | |||
| TagResource | Otorga permiso para agregar etiquetas al recurso especificado | Etiquetado | |||
| UntagResource | Concede permiso para eliminar etiquetas del recurso especificado | Etiquetado | |||
| UpdateContact | Concede permiso para actualizar un contacto | Write |
ssm-contacts:AssociateContact |
||
| UpdateContactChannel | Concede permiso para actualizar el canal de contacto de un contacto | Escritura | |||
| UpdateRotation | Concede permiso para actualizar la información especificada para una rotación de guardia | Escritura |
Tipos de recursos definidos por AWS Systems Manager Incident Manager Contacts
Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.
| Tipos de recurso | ARN | Claves de condición |
|---|---|---|
| contact |
arn:${Partition}:ssm-contacts:${Region}:${Account}:contact/${ContactAlias}
|
|
| contactchannel |
arn:${Partition}:ssm-contacts:${Region}:${Account}:contactchannel/${ContactAlias}/${ContactChannelId}
|
|
| engagement |
arn:${Partition}:ssm-contacts:${Region}:${Account}:engagement/${ContactAlias}/${EngagementId}
|
|
| page |
arn:${Partition}:ssm-contacts:${Region}:${Account}:page/${ContactAlias}/${PageId}
|
|
| rotation |
arn:${Partition}:ssm-contacts:${Region}:${Account}:rotation/${RotationId}
|
Claves de condición para AWS Systems Manager Incident Manager Contacts
AWS Systems Manager Incident Manager Contacts define las siguientes claves de condición que pueden utilizarse en el elemento Condition de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla de Claves de condición.
Para ver las claves de condición globales que están disponibles para todos los servicios, consulte Claves de condición globales disponibles.
| Claves de condición | Descripción | Tipo |
|---|---|---|
| aws:RequestTag/${TagKey} | Filtra el acceso por las etiquetas que se pasan en la solicitud | Cadena |
| aws:ResourceTag/${TagKey} | Filtra el acceso por las etiquetas asociadas al recurso | Cadena |
| aws:TagKeys | Filtra el acceso por las claves de etiquetas que se pasan en la solicitud | ArrayOfString |
