ServiceIntegration

A service integration is an integration that belongs to a service.

Example Usage

using Pulumi;
using Pagerduty = Pulumi.Pagerduty;

class MyStack : Stack
{
    public MyStack()
    {
        var exampleUser = new Pagerduty.User("exampleUser", new Pagerduty.UserArgs
        {
            Email = "125.greenholt.earline@graham.name",
            Teams = 
            {
                pagerduty_team.Example.Id,
            },
        });
        var foo = new Pagerduty.EscalationPolicy("foo", new Pagerduty.EscalationPolicyArgs
        {
            NumLoops = 2,
            Rules = 
            {
                new Pagerduty.Inputs.EscalationPolicyRuleArgs
                {
                    EscalationDelayInMinutes = 10,
                    Targets = 
                    {
                        new Pagerduty.Inputs.EscalationPolicyRuleTargetArgs
                        {
                            Type = "user",
                            Id = exampleUser.Id,
                        },
                    },
                },
            },
        });
        var exampleService = new Pagerduty.Service("exampleService", new Pagerduty.ServiceArgs
        {
            AutoResolveTimeout = "14400",
            AcknowledgementTimeout = "600",
            EscalationPolicy = pagerduty_escalation_policy.Example.Id,
        });
        var exampleServiceIntegration = new Pagerduty.ServiceIntegration("exampleServiceIntegration", new Pagerduty.ServiceIntegrationArgs
        {
            Type = "generic_events_api_inbound_integration",
            Service = exampleService.Id,
        });
        var apiv2 = new Pagerduty.ServiceIntegration("apiv2", new Pagerduty.ServiceIntegrationArgs
        {
            Type = "events_api_v2_inbound_integration",
            IntegrationKey = "12345678910testtesttesttesttes",
            Service = exampleService.Id,
        });
        var emailX = new Pagerduty.ServiceIntegration("emailX", new Pagerduty.ServiceIntegrationArgs
        {
            Type = "generic_email_inbound_integration",
            IntegrationEmail = "ecommerce@subdomain.pagerduty.com",
            Service = exampleService.Id,
        });
        var datadogVendor = Output.Create(Pagerduty.GetVendor.InvokeAsync(new Pagerduty.GetVendorArgs
        {
            Name = "Datadog",
        }));
        var datadogServiceIntegration = new Pagerduty.ServiceIntegration("datadogServiceIntegration", new Pagerduty.ServiceIntegrationArgs
        {
            Service = exampleService.Id,
            Vendor = datadogVendor.Apply(datadogVendor => datadogVendor.Id),
        });
        var cloudwatchVendor = Output.Create(Pagerduty.GetVendor.InvokeAsync(new Pagerduty.GetVendorArgs
        {
            Name = "Cloudwatch",
        }));
        var cloudwatchServiceIntegration = new Pagerduty.ServiceIntegration("cloudwatchServiceIntegration", new Pagerduty.ServiceIntegrationArgs
        {
            Service = exampleService.Id,
            Vendor = cloudwatchVendor.Apply(cloudwatchVendor => cloudwatchVendor.Id),
        });
    }

}

Coming soon!

import pulumi
import pulumi_pagerduty as pagerduty

example_user = pagerduty.User("exampleUser",
    email="125.greenholt.earline@graham.name",
    teams=[pagerduty_team["example"]["id"]])
foo = pagerduty.EscalationPolicy("foo",
    num_loops=2,
    rules=[pagerduty.EscalationPolicyRuleArgs(
        escalation_delay_in_minutes=10,
        targets=[pagerduty.EscalationPolicyRuleTargetArgs(
            type="user",
            id=example_user.id,
        )],
    )])
example_service = pagerduty.Service("exampleService",
    auto_resolve_timeout="14400",
    acknowledgement_timeout="600",
    escalation_policy=pagerduty_escalation_policy["example"]["id"])
example_service_integration = pagerduty.ServiceIntegration("exampleServiceIntegration",
    type="generic_events_api_inbound_integration",
    service=example_service.id)
apiv2 = pagerduty.ServiceIntegration("apiv2",
    type="events_api_v2_inbound_integration",
    integration_key="12345678910testtesttesttesttes",
    service=example_service.id)
email_x = pagerduty.ServiceIntegration("emailX",
    type="generic_email_inbound_integration",
    integration_email="ecommerce@subdomain.pagerduty.com",
    service=example_service.id)
datadog_vendor = pagerduty.get_vendor(name="Datadog")
datadog_service_integration = pagerduty.ServiceIntegration("datadogServiceIntegration",
    service=example_service.id,
    vendor=datadog_vendor.id)
cloudwatch_vendor = pagerduty.get_vendor(name="Cloudwatch")
cloudwatch_service_integration = pagerduty.ServiceIntegration("cloudwatchServiceIntegration",
    service=example_service.id,
    vendor=cloudwatch_vendor.id)
import * as pulumi from "@pulumi/pulumi";
import * as pagerduty from "@pulumi/pagerduty";

const exampleUser = new pagerduty.User("exampleUser", {
    email: "125.greenholt.earline@graham.name",
    teams: [pagerduty_team.example.id],
});
const foo = new pagerduty.EscalationPolicy("foo", {
    numLoops: 2,
    rules: [{
        escalationDelayInMinutes: 10,
        targets: [{
            type: "user",
            id: exampleUser.id,
        }],
    }],
});
const exampleService = new pagerduty.Service("exampleService", {
    autoResolveTimeout: 14400,
    acknowledgementTimeout: 600,
    escalationPolicy: pagerduty_escalation_policy.example.id,
});
const exampleServiceIntegration = new pagerduty.ServiceIntegration("exampleServiceIntegration", {
    type: "generic_events_api_inbound_integration",
    service: exampleService.id,
});
const apiv2 = new pagerduty.ServiceIntegration("apiv2", {
    type: "events_api_v2_inbound_integration",
    integrationKey: "12345678910testtesttesttesttes",
    service: exampleService.id,
});
const emailX = new pagerduty.ServiceIntegration("emailX", {
    type: "generic_email_inbound_integration",
    integrationEmail: "ecommerce@subdomain.pagerduty.com",
    service: exampleService.id,
});
const datadogVendor = pagerduty.getVendor({
    name: "Datadog",
});
const datadogServiceIntegration = new pagerduty.ServiceIntegration("datadogServiceIntegration", {
    service: exampleService.id,
    vendor: datadogVendor.then(datadogVendor => datadogVendor.id),
});
const cloudwatchVendor = pagerduty.getVendor({
    name: "Cloudwatch",
});
const cloudwatchServiceIntegration = new pagerduty.ServiceIntegration("cloudwatchServiceIntegration", {
    service: exampleService.id,
    vendor: cloudwatchVendor.then(cloudwatchVendor => cloudwatchVendor.id),
});

Create a ServiceIntegration Resource

new ServiceIntegration(name: string, args: ServiceIntegrationArgs, opts?: CustomResourceOptions);
@overload
def ServiceIntegration(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       integration_email: Optional[str] = None,
                       integration_key: Optional[str] = None,
                       name: Optional[str] = None,
                       service: Optional[str] = None,
                       type: Optional[str] = None,
                       vendor: Optional[str] = None)
@overload
def ServiceIntegration(resource_name: str,
                       args: ServiceIntegrationArgs,
                       opts: Optional[ResourceOptions] = None)
func NewServiceIntegration(ctx *Context, name string, args ServiceIntegrationArgs, opts ...ResourceOption) (*ServiceIntegration, error)
public ServiceIntegration(string name, ServiceIntegrationArgs args, CustomResourceOptions? opts = null)
name string
The unique name of the resource.
args ServiceIntegrationArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
args ServiceIntegrationArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args ServiceIntegrationArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args ServiceIntegrationArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.

ServiceIntegration Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.

Inputs

The ServiceIntegration resource accepts the following input properties:

Service string
The ID of the service the integration should belong to.
IntegrationEmail string
This is the unique fully-qualified email address used for routing emails to this integration for processing.
IntegrationKey string
This is the unique key used to route events to this integration when received via the PagerDuty Events API.
Name string
The name of the service integration.
Type string
The service type. Can be: aws_cloudwatch_inbound_integration, cloudkick_inbound_integration, event_transformer_api_inbound_integration, events_api_v2_inbound_integration (requires service alert_creation to be create_alerts_and_incidents), generic_email_inbound_integration, generic_events_api_inbound_integration, keynote_inbound_integration, nagios_inbound_integration, pingdom_inbound_integrationor sql_monitor_inbound_integration.
Vendor string
The ID of the vendor the integration should integrate with (e.g Datadog or Amazon Cloudwatch).
Service string
The ID of the service the integration should belong to.
IntegrationEmail string
This is the unique fully-qualified email address used for routing emails to this integration for processing.
IntegrationKey string
This is the unique key used to route events to this integration when received via the PagerDuty Events API.
Name string
The name of the service integration.
Type string
The service type. Can be: aws_cloudwatch_inbound_integration, cloudkick_inbound_integration, event_transformer_api_inbound_integration, events_api_v2_inbound_integration (requires service alert_creation to be create_alerts_and_incidents), generic_email_inbound_integration, generic_events_api_inbound_integration, keynote_inbound_integration, nagios_inbound_integration, pingdom_inbound_integrationor sql_monitor_inbound_integration.
Vendor string
The ID of the vendor the integration should integrate with (e.g Datadog or Amazon Cloudwatch).
service string
The ID of the service the integration should belong to.
integrationEmail string
This is the unique fully-qualified email address used for routing emails to this integration for processing.
integrationKey string
This is the unique key used to route events to this integration when received via the PagerDuty Events API.
name string
The name of the service integration.
type string
The service type. Can be: aws_cloudwatch_inbound_integration, cloudkick_inbound_integration, event_transformer_api_inbound_integration, events_api_v2_inbound_integration (requires service alert_creation to be create_alerts_and_incidents), generic_email_inbound_integration, generic_events_api_inbound_integration, keynote_inbound_integration, nagios_inbound_integration, pingdom_inbound_integrationor sql_monitor_inbound_integration.
vendor string
The ID of the vendor the integration should integrate with (e.g Datadog or Amazon Cloudwatch).
service str
The ID of the service the integration should belong to.
integration_email str
This is the unique fully-qualified email address used for routing emails to this integration for processing.
integration_key str
This is the unique key used to route events to this integration when received via the PagerDuty Events API.
name str
The name of the service integration.
type str
The service type. Can be: aws_cloudwatch_inbound_integration, cloudkick_inbound_integration, event_transformer_api_inbound_integration, events_api_v2_inbound_integration (requires service alert_creation to be create_alerts_and_incidents), generic_email_inbound_integration, generic_events_api_inbound_integration, keynote_inbound_integration, nagios_inbound_integration, pingdom_inbound_integrationor sql_monitor_inbound_integration.
vendor str
The ID of the vendor the integration should integrate with (e.g Datadog or Amazon Cloudwatch).

Outputs

All input properties are implicitly available as output properties. Additionally, the ServiceIntegration resource produces the following output properties:

HtmlUrl string
URL at which the entity is uniquely displayed in the Web app
Id string
The provider-assigned unique ID for this managed resource.
HtmlUrl string
URL at which the entity is uniquely displayed in the Web app
Id string
The provider-assigned unique ID for this managed resource.
htmlUrl string
URL at which the entity is uniquely displayed in the Web app
id string
The provider-assigned unique ID for this managed resource.
html_url str
URL at which the entity is uniquely displayed in the Web app
id str
The provider-assigned unique ID for this managed resource.

Look up an Existing ServiceIntegration Resource

Get an existing ServiceIntegration resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: ServiceIntegrationState, opts?: CustomResourceOptions): ServiceIntegration
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        html_url: Optional[str] = None,
        integration_email: Optional[str] = None,
        integration_key: Optional[str] = None,
        name: Optional[str] = None,
        service: Optional[str] = None,
        type: Optional[str] = None,
        vendor: Optional[str] = None) -> ServiceIntegration
func GetServiceIntegration(ctx *Context, name string, id IDInput, state *ServiceIntegrationState, opts ...ResourceOption) (*ServiceIntegration, error)
public static ServiceIntegration Get(string name, Input<string> id, ServiceIntegrationState? state, CustomResourceOptions? opts = null)
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.

The following state arguments are supported:

HtmlUrl string
URL at which the entity is uniquely displayed in the Web app
IntegrationEmail string
This is the unique fully-qualified email address used for routing emails to this integration for processing.
IntegrationKey string
This is the unique key used to route events to this integration when received via the PagerDuty Events API.
Name string
The name of the service integration.
Service string
The ID of the service the integration should belong to.
Type string
The service type. Can be: aws_cloudwatch_inbound_integration, cloudkick_inbound_integration, event_transformer_api_inbound_integration, events_api_v2_inbound_integration (requires service alert_creation to be create_alerts_and_incidents), generic_email_inbound_integration, generic_events_api_inbound_integration, keynote_inbound_integration, nagios_inbound_integration, pingdom_inbound_integrationor sql_monitor_inbound_integration.
Vendor string
The ID of the vendor the integration should integrate with (e.g Datadog or Amazon Cloudwatch).
HtmlUrl string
URL at which the entity is uniquely displayed in the Web app
IntegrationEmail string
This is the unique fully-qualified email address used for routing emails to this integration for processing.
IntegrationKey string
This is the unique key used to route events to this integration when received via the PagerDuty Events API.
Name string
The name of the service integration.
Service string
The ID of the service the integration should belong to.
Type string
The service type. Can be: aws_cloudwatch_inbound_integration, cloudkick_inbound_integration, event_transformer_api_inbound_integration, events_api_v2_inbound_integration (requires service alert_creation to be create_alerts_and_incidents), generic_email_inbound_integration, generic_events_api_inbound_integration, keynote_inbound_integration, nagios_inbound_integration, pingdom_inbound_integrationor sql_monitor_inbound_integration.
Vendor string
The ID of the vendor the integration should integrate with (e.g Datadog or Amazon Cloudwatch).
htmlUrl string
URL at which the entity is uniquely displayed in the Web app
integrationEmail string
This is the unique fully-qualified email address used for routing emails to this integration for processing.
integrationKey string
This is the unique key used to route events to this integration when received via the PagerDuty Events API.
name string
The name of the service integration.
service string
The ID of the service the integration should belong to.
type string
The service type. Can be: aws_cloudwatch_inbound_integration, cloudkick_inbound_integration, event_transformer_api_inbound_integration, events_api_v2_inbound_integration (requires service alert_creation to be create_alerts_and_incidents), generic_email_inbound_integration, generic_events_api_inbound_integration, keynote_inbound_integration, nagios_inbound_integration, pingdom_inbound_integrationor sql_monitor_inbound_integration.
vendor string
The ID of the vendor the integration should integrate with (e.g Datadog or Amazon Cloudwatch).
html_url str
URL at which the entity is uniquely displayed in the Web app
integration_email str
This is the unique fully-qualified email address used for routing emails to this integration for processing.
integration_key str
This is the unique key used to route events to this integration when received via the PagerDuty Events API.
name str
The name of the service integration.
service str
The ID of the service the integration should belong to.
type str
The service type. Can be: aws_cloudwatch_inbound_integration, cloudkick_inbound_integration, event_transformer_api_inbound_integration, events_api_v2_inbound_integration (requires service alert_creation to be create_alerts_and_incidents), generic_email_inbound_integration, generic_events_api_inbound_integration, keynote_inbound_integration, nagios_inbound_integration, pingdom_inbound_integrationor sql_monitor_inbound_integration.
vendor str
The ID of the vendor the integration should integrate with (e.g Datadog or Amazon Cloudwatch).

Import

Services can be imported using their related service id and service integration id separated by a dot, e.g.

 $ pulumi import pagerduty:index/serviceIntegration:ServiceIntegration main PLSSSSS.PLIIIII

Package Details

Repository
https://github.com/pulumi/pulumi-pagerduty
License
Apache-2.0
Notes
This Pulumi package is based on the pagerduty Terraform Provider.