Incident Manager Contacts

4 resource kinds. Generated from the operator's CRD schemas.

API Group: aws.konfig.io/v1alpha1

SSMContactsContact # CLOUD CONTROL · AWS::SSMContacts::Contact

SSMContactsContact manages AWS::SSMContacts::Contact through the AWS Cloud Control API.

kubectl get ssmcontactscontacts · example on GitHub

Example

# SSMContactsContact — Incident Manager Contacts
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/ssmcontacts.html#ssmcontactscontact
apiVersion: aws.konfig.io/v1alpha1
kind: SSMContactsContact
metadata:
  name: example-ssmcontactscontact
  namespace: default
spec:
  alias: example
  displayName: example-ssmcontactscontact
  plan:
  - durationInMinutes: 1
    rotationIds:
    - example
  providerRef:
    name: example-ssmcontactscontact
    region: us-east-1
  tags:
  - key: example
    value: example
  type: PERSONAL

Spec

Field	Type	Required	Description
`alias`	string	yes	Alias of the contact.
`displayName`	string	yes	Name of the contact.
`plan`	array<object>	—	The stages that an escalation plan or engagement plan engages contacts and contact methods in.
`plan[].durationInMinutes`	integer	—	The time to wait until beginning the next stage.
`plan[].rotationIds`	array<string>	—	List of Rotation Ids to associate with Contact
`plan[].targets`	array<object>	—	The contacts or contact methods that the escalation plan or engagement plan is engaging.
`plan[].targets[].channelTargetInfo`	object	—	SSMContactsContactChannelTargetInfo is a nested property type of AWS::SSMContacts::Contact.
`plan[].targets[].channelTargetInfo.channelId`	string	yes	The Amazon Resource Name (ARN) of the contact channel.
`plan[].targets[].channelTargetInfo.retryIntervalInMinutes`	integer	yes	The number of minutes to wait to retry sending engagement in the case the engagement initially fails.
`plan[].targets[].contactTargetInfo`	object	—	SSMContactsContactContactTargetInfo is a nested property type of AWS::SSMContacts::Contact.
`plan[].targets[].contactTargetInfo.contactId`	string	yes	The Amazon Resource Name (ARN) of the contact.
`plan[].targets[].contactTargetInfo.isEssential`	boolean	yes	A Boolean value determining if the contact's acknowledgement stops the progress of stages in the plan.
`providerRef`	object	—	ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
`providerRef.name`	string	yes	Name of a cluster-scoped AWSProvider.
`providerRef.region`	string	—	Region overrides the provider's region for this resource only.
`tags`	array<object>	—
`tags[].key`	string	yes
`tags[].value`	string	yes
`type`	enum	yes	Contact type, which specify type of contact. Allowed: `PERSONAL, ESCALATION, ONCALL_SCHEDULE`

Status

Field	Type	Required	Description
`arn`	string	—	The Amazon Resource Name (ARN) of the contact.
`attempt`	integer	—	Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
`awsProvider`	object	—	AWSProvider confirms the account and region this resource was reconciled against.
`awsProvider.accountId`	string	—	AccountID the resource lives in.
`awsProvider.name`	string	—	Name of the AWSProvider used; empty when the operator's own credentials were used.
`awsProvider.region`	string	—	Region the resource lives in (empty for global services).
`conditions`	array<object>	—	Conditions describe the current state of the resource.
`conditions[].lastTransitionTime`	string	yes	lastTransitionTime is the last time the condition transitioned from one status to another.
`conditions[].message`	string	yes	message is a human readable message indicating details about the transition.
`conditions[].observedGeneration`	integer	—	observedGeneration represents the .metadata.generation that the condition was set based upon.
`conditions[].reason`	string	yes	reason contains a programmatic identifier indicating the reason for the condition's last transition.
`conditions[].status`	enum	yes	status of the condition, one of True, False, Unknown. Allowed: `True, False, Unknown`
`conditions[].type`	string	yes	type of condition in CamelCase or in foo.example.com/CamelCase.
`identifier`	string	—	Identifier is the Cloud Control primary identifier of the resource.
`lastSyncTime`	string	—
`observedGeneration`	integer	—
`operation`	string	—	Operation is the in-flight operation (CREATE, UPDATE, DELETE).
`operationStatus`	string	—	OperationStatus is the last reported operation status.
`requestToken`	string	—	RequestToken tracks an in-flight asynchronous operation.

SSMContactsContactChannel # CLOUD CONTROL · AWS::SSMContacts::ContactChannel

SSMContactsContactChannel manages AWS::SSMContacts::ContactChannel through the AWS Cloud Control API.

kubectl get ssmcontactscontactchannels · example on GitHub

Example

# SSMContactsContactChannel — Incident Manager Contacts
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/ssmcontacts.html#ssmcontactscontactchannel
apiVersion: aws.konfig.io/v1alpha1
kind: SSMContactsContactChannel
metadata:
  name: example-ssmcontactscontactchannel
  namespace: default
spec:
  channelAddress: example
  channelName: example-ssmcontactscontactchannel
  channelType: SMS
  deferActivation: false
  providerRef:
    name: example-ssmcontactscontactchannel
    region: us-east-1

Spec

Field	Type	Required	Description
`channelAddress`	string	—	The details that SSM Incident Manager uses when trying to engage the contact channel.
`channelName`	string	—	The device name.
`channelType`	enum	—	Device type, which specify notification channel. Allowed: `SMS, VOICE, EMAIL`
`contactId`	string	—	ARN of the contact resource Create-only in AWS: changing it requires replacing the resource.
`deferActivation`	boolean	—	If you want to activate the channel at a later time, you can choose to defer activation.
`providerRef`	object	—	ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
`providerRef.name`	string	yes	Name of a cluster-scoped AWSProvider.
`providerRef.region`	string	—	Region overrides the provider's region for this resource only.

Status

Field	Type	Required	Description
`arn`	string	—	The Amazon Resource Name (ARN) of the engagement to a contact channel.
`attempt`	integer	—	Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
`awsProvider`	object	—	AWSProvider confirms the account and region this resource was reconciled against.
`awsProvider.accountId`	string	—	AccountID the resource lives in.
`awsProvider.name`	string	—	Name of the AWSProvider used; empty when the operator's own credentials were used.
`awsProvider.region`	string	—	Region the resource lives in (empty for global services).
`conditions`	array<object>	—	Conditions describe the current state of the resource.
`conditions[].lastTransitionTime`	string	yes	lastTransitionTime is the last time the condition transitioned from one status to another.
`conditions[].message`	string	yes	message is a human readable message indicating details about the transition.
`conditions[].observedGeneration`	integer	—	observedGeneration represents the .metadata.generation that the condition was set based upon.
`conditions[].reason`	string	yes	reason contains a programmatic identifier indicating the reason for the condition's last transition.
`conditions[].status`	enum	yes	status of the condition, one of True, False, Unknown. Allowed: `True, False, Unknown`
`conditions[].type`	string	yes	type of condition in CamelCase or in foo.example.com/CamelCase.
`identifier`	string	—	Identifier is the Cloud Control primary identifier of the resource.
`lastSyncTime`	string	—
`observedGeneration`	integer	—
`operation`	string	—	Operation is the in-flight operation (CREATE, UPDATE, DELETE).
`operationStatus`	string	—	OperationStatus is the last reported operation status.
`requestToken`	string	—	RequestToken tracks an in-flight asynchronous operation.

SSMContactsPlan # CLOUD CONTROL · AWS::SSMContacts::Plan

SSMContactsPlan manages AWS::SSMContacts::Plan through the AWS Cloud Control API.

kubectl get ssmcontactsplans · example on GitHub

Example

# SSMContactsPlan — Incident Manager Contacts
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/ssmcontacts.html#ssmcontactsplan
apiVersion: aws.konfig.io/v1alpha1
kind: SSMContactsPlan
metadata:
  name: example-ssmcontactsplan
  namespace: default
spec:
  providerRef:
    name: example-ssmcontactsplan
    region: us-east-1
  rotationIds:
  - example
  stages:
  - durationInMinutes: 1

Spec

Field	Type	Required	Description
`contactId`	string	—	Contact ID for the AWS SSM Incident Manager Contact to associate the plan.
`providerRef`	object	—	ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
`providerRef.name`	string	yes	Name of a cluster-scoped AWSProvider.
`providerRef.region`	string	—	Region overrides the provider's region for this resource only.
`rotationIds`	array<string>	—	Rotation Ids to associate with Oncall Contact for engagement.
`stages`	array<object>	—	The stages that an escalation plan or engagement plan engages contacts and contact methods in.
`stages[].durationInMinutes`	integer	yes	The time to wait until beginning the next stage.
`stages[].targets`	array<object>	—	The contacts or contact methods that the escalation plan or engagement plan is engaging.
`stages[].targets[].channelTargetInfo`	object	—	SSMContactsPlanChannelTargetInfo is a nested property type of AWS::SSMContacts::Plan.
`stages[].targets[].channelTargetInfo.channelId`	string	yes	The Amazon Resource Name (ARN) of the contact channel.
`stages[].targets[].channelTargetInfo.retryIntervalInMinutes`	integer	yes	The number of minutes to wait to retry sending engagement in the case the engagement initially fails.
`stages[].targets[].contactTargetInfo`	object	—	SSMContactsPlanContactTargetInfo is a nested property type of AWS::SSMContacts::Plan.
`stages[].targets[].contactTargetInfo.contactId`	string	yes	The Amazon Resource Name (ARN) of the contact.
`stages[].targets[].contactTargetInfo.isEssential`	boolean	yes	A Boolean value determining if the contact's acknowledgement stops the progress of stages in the plan.

Status

Field	Type	Required	Description
`arn`	string	—	The Amazon Resource Name (ARN) of the contact.
`attempt`	integer	—	Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
`awsProvider`	object	—	AWSProvider confirms the account and region this resource was reconciled against.
`awsProvider.accountId`	string	—	AccountID the resource lives in.
`awsProvider.name`	string	—	Name of the AWSProvider used; empty when the operator's own credentials were used.
`awsProvider.region`	string	—	Region the resource lives in (empty for global services).
`conditions`	array<object>	—	Conditions describe the current state of the resource.
`conditions[].lastTransitionTime`	string	yes	lastTransitionTime is the last time the condition transitioned from one status to another.
`conditions[].message`	string	yes	message is a human readable message indicating details about the transition.
`conditions[].observedGeneration`	integer	—	observedGeneration represents the .metadata.generation that the condition was set based upon.
`conditions[].reason`	string	yes	reason contains a programmatic identifier indicating the reason for the condition's last transition.
`conditions[].status`	enum	yes	status of the condition, one of True, False, Unknown. Allowed: `True, False, Unknown`
`conditions[].type`	string	yes	type of condition in CamelCase or in foo.example.com/CamelCase.
`identifier`	string	—	Identifier is the Cloud Control primary identifier of the resource.
`lastSyncTime`	string	—
`observedGeneration`	integer	—
`operation`	string	—	Operation is the in-flight operation (CREATE, UPDATE, DELETE).
`operationStatus`	string	—	OperationStatus is the last reported operation status.
`requestToken`	string	—	RequestToken tracks an in-flight asynchronous operation.

SSMContactsRotation # CLOUD CONTROL · AWS::SSMContacts::Rotation

SSMContactsRotation manages AWS::SSMContacts::Rotation through the AWS Cloud Control API.

kubectl get ssmcontactsrotations · example on GitHub

Example

# SSMContactsRotation — Incident Manager Contacts
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/ssmcontacts.html#ssmcontactsrotation
apiVersion: aws.konfig.io/v1alpha1
kind: SSMContactsRotation
metadata:
  name: example-ssmcontactsrotation
  namespace: default
spec:
  contactIds:
  - example
  name: example-ssmcontactsrotation
  providerRef:
    name: example-ssmcontactsrotation
    region: us-east-1
  recurrence:
    dailySettings:
    - example
    monthlySettings:
    - dayOfMonth: 1
      handOffTime: '2026-01-01T00:00:00Z'
    numberOfOnCalls: 1
    recurrenceMultiplier: 1
    shiftCoverages:
    - coverageTimes:
      - endTime: '2026-01-01T00:00:00Z'
        startTime: '2026-01-01T00:00:00Z'
      dayOfWeek: MON
    weeklySettings:
    - dayOfWeek: MON
      handOffTime: '2026-01-01T00:00:00Z'
  startTime: '2026-01-01T00:00:00Z'
  tags:
  - key: example
    value: example
  timeZoneId: example-id

Spec

Field	Type	Required	Description
`contactIds`	array<string>	yes	Members of the rotation
`name`	string	yes	Name of the Rotation
`providerRef`	object	—	ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
`providerRef.name`	string	yes	Name of a cluster-scoped AWSProvider.
`providerRef.region`	string	—	Region overrides the provider's region for this resource only.
`recurrence`	object	yes	SSMContactsRotationRecurrenceSettings is a nested property type of AWS::SSMContacts::Rotation.
`recurrence.dailySettings`	array<string>	—	Information about on-call rotations that recur daily.
`recurrence.monthlySettings`	array<object>	—	Information about on-call rotations that recur monthly.
`recurrence.monthlySettings[].dayOfMonth`	integer	yes	The day of the month when monthly recurring on-call rotations begin.
`recurrence.monthlySettings[].handOffTime`	string	yes
`recurrence.numberOfOnCalls`	integer	—	Number of Oncalls per shift.
`recurrence.recurrenceMultiplier`	integer	—	The number of days, weeks, or months a single rotation lasts.
`recurrence.shiftCoverages`	array<object>	—	Information about the days of the week included in on-call rotation coverage.
`recurrence.shiftCoverages[].coverageTimes`	array<object>	yes	Information about when an on-call shift begins and ends.
`recurrence.shiftCoverages[].coverageTimes[].endTime`	string	yes
`recurrence.shiftCoverages[].coverageTimes[].startTime`	string	yes
`recurrence.shiftCoverages[].dayOfWeek`	enum	yes	Allowed: `MON, TUE, WED, THU, FRI, SAT, SUN`
`recurrence.weeklySettings`	array<object>	—	Information about on-call rotations that recur weekly.
`recurrence.weeklySettings[].dayOfWeek`	enum	yes	Allowed: `MON, TUE, WED, THU, FRI, SAT, SUN`
`recurrence.weeklySettings[].handOffTime`	string	yes
`startTime`	string	yes	Start time of the first shift of Oncall Schedule
`tags`	array<object>	—
`tags[].key`	string	yes
`tags[].value`	string	yes
`timeZoneId`	string	yes	TimeZone Identifier for the Oncall Schedule

Status

Field	Type	Required	Description
`arn`	string	—	The Amazon Resource Name (ARN) of the rotation.
`attempt`	integer	—	Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
`awsProvider`	object	—	AWSProvider confirms the account and region this resource was reconciled against.
`awsProvider.accountId`	string	—	AccountID the resource lives in.
`awsProvider.name`	string	—	Name of the AWSProvider used; empty when the operator's own credentials were used.
`awsProvider.region`	string	—	Region the resource lives in (empty for global services).
`conditions`	array<object>	—	Conditions describe the current state of the resource.
`conditions[].lastTransitionTime`	string	yes	lastTransitionTime is the last time the condition transitioned from one status to another.
`conditions[].message`	string	yes	message is a human readable message indicating details about the transition.
`conditions[].observedGeneration`	integer	—	observedGeneration represents the .metadata.generation that the condition was set based upon.
`conditions[].reason`	string	yes	reason contains a programmatic identifier indicating the reason for the condition's last transition.
`conditions[].status`	enum	yes	status of the condition, one of True, False, Unknown. Allowed: `True, False, Unknown`
`conditions[].type`	string	yes	type of condition in CamelCase or in foo.example.com/CamelCase.
`identifier`	string	—	Identifier is the Cloud Control primary identifier of the resource.
`lastSyncTime`	string	—
`observedGeneration`	integer	—
`operation`	string	—	Operation is the in-flight operation (CREATE, UPDATE, DELETE).
`operationStatus`	string	—	OperationStatus is the last reported operation status.
`requestToken`	string	—	RequestToken tracks an in-flight asynchronous operation.