aws-cdk-lib
Version:
Version 2 of the AWS Cloud Development Kit library
801 lines (800 loc) • 40.5 kB
TypeScript
import * as cdk from "../../core/lib";
import * as constructs from "constructs";
import * as cfn_parse from "../../core/lib/helpers-internal";
import { AgentSpaceReference, AssociationReference, IAgentSpaceRef, IAssociationRef } from "../../interfaces/generated/aws-devopsagent-interfaces.generated";
/**
* The `AWS::DevOpsAgent::AgentSpace` resource specifies an Agent Space for the AWS DevOps Agent Service.
*
* @cloudformationResource AWS::DevOpsAgent::AgentSpace
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsagent-agentspace.html
*/
export declare class CfnAgentSpace extends cdk.CfnResource implements cdk.IInspectable, IAgentSpaceRef {
/**
* The CloudFormation resource type name for this resource class.
*/
static readonly CFN_RESOURCE_TYPE_NAME: string;
/**
* Build a CfnAgentSpace from CloudFormation properties
*
* A factory method that creates a new instance of this class from an object
* containing the CloudFormation properties of this resource.
* Used in the @aws-cdk/cloudformation-include module.
*
* @internal
*/
static _fromCloudFormation(scope: constructs.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnAgentSpace;
/**
* Checks whether the given object is a CfnAgentSpace
*/
static isCfnAgentSpace(x: any): x is CfnAgentSpace;
static arnForAgentSpace(resource: IAgentSpaceRef): string;
/**
* The unique identifier of the Agent Space.
*
* @cloudformationAttribute AgentSpaceId
*/
readonly attrAgentSpaceId: string;
/**
* The Amazon Resource Name (ARN) of the Agent Space.
*
* @cloudformationAttribute Arn
*/
readonly attrArn: string;
/**
* The timestamp when the resource was created.
*
* @cloudformationAttribute CreatedAt
*/
readonly attrCreatedAt: string;
/**
* The timestamp when the resource was last updated.
*
* @cloudformationAttribute UpdatedAt
*/
readonly attrUpdatedAt: string;
/**
* The description of the Agent Space.
*/
description?: string;
/**
* The name of the Agent Space.
*/
name: string;
/**
* Create a new `AWS::DevOpsAgent::AgentSpace`.
*
* @param scope Scope in which this resource is defined
* @param id Construct identifier for this resource (unique in its scope)
* @param props Resource properties
*/
constructor(scope: constructs.Construct, id: string, props: CfnAgentSpaceProps);
get agentSpaceRef(): AgentSpaceReference;
protected get cfnProperties(): Record<string, any>;
/**
* Examines the CloudFormation resource and discloses attributes
*
* @param inspector tree inspector to collect and process attributes
*/
inspect(inspector: cdk.TreeInspector): void;
protected renderProperties(props: Record<string, any>): Record<string, any>;
}
/**
* Properties for defining a `CfnAgentSpace`
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsagent-agentspace.html
*/
export interface CfnAgentSpaceProps {
/**
* The description of the Agent Space.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsagent-agentspace.html#cfn-devopsagent-agentspace-description
*/
readonly description?: string;
/**
* The name of the Agent Space.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsagent-agentspace.html#cfn-devopsagent-agentspace-name
*/
readonly name: string;
}
/**
* The `AWS::DevOpsAgent::Association` resource specifies an association between an Agent Space and a service, defining how the Agent Space interacts with external services like GitHub, Slack, AWS accounts, and others.
*
* @cloudformationResource AWS::DevOpsAgent::Association
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsagent-association.html
*/
export declare class CfnAssociation extends cdk.CfnResource implements cdk.IInspectable, IAssociationRef {
/**
* The CloudFormation resource type name for this resource class.
*/
static readonly CFN_RESOURCE_TYPE_NAME: string;
/**
* Build a CfnAssociation from CloudFormation properties
*
* A factory method that creates a new instance of this class from an object
* containing the CloudFormation properties of this resource.
* Used in the @aws-cdk/cloudformation-include module.
*
* @internal
*/
static _fromCloudFormation(scope: constructs.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnAssociation;
/**
* Checks whether the given object is a CfnAssociation
*/
static isCfnAssociation(x: any): x is CfnAssociation;
/**
* The unique identifier of the association.
*
* @cloudformationAttribute AssociationId
*/
readonly attrAssociationId: string;
/**
* The timestamp when the association was created.
*
* @cloudformationAttribute CreatedAt
*/
readonly attrCreatedAt: string;
/**
* The timestamp when the association was last updated.
*
* @cloudformationAttribute UpdatedAt
*/
readonly attrUpdatedAt: string;
/**
* The unique identifier of the Agent Space.
*/
agentSpaceId: string;
/**
* The configuration that directs how the Agent Space interacts with the given service.
*/
configuration: cdk.IResolvable | CfnAssociation.ServiceConfigurationProperty;
/**
* Set of linked association IDs for parent-child relationships.
*/
linkedAssociationIds?: Array<string>;
/**
* The identifier for the associated service.
*/
serviceId: string;
/**
* Create a new `AWS::DevOpsAgent::Association`.
*
* @param scope Scope in which this resource is defined
* @param id Construct identifier for this resource (unique in its scope)
* @param props Resource properties
*/
constructor(scope: constructs.Construct, id: string, props: CfnAssociationProps);
get associationRef(): AssociationReference;
protected get cfnProperties(): Record<string, any>;
/**
* Examines the CloudFormation resource and discloses attributes
*
* @param inspector tree inspector to collect and process attributes
*/
inspect(inspector: cdk.TreeInspector): void;
protected renderProperties(props: Record<string, any>): Record<string, any>;
}
export declare namespace CfnAssociation {
/**
* The configuration that directs how Agent Space interacts with the given service.
*
* You can specify only one configuration type per association.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html
*/
interface ServiceConfigurationProperty {
/**
* Configuration for AWS monitor account integration.
*
* Specifies the account ID, assumable role ARN, and resources to be monitored in the primary monitoring account.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-aws
*/
readonly aws?: CfnAssociation.AWSConfigurationProperty | cdk.IResolvable;
/**
* Configuration for Dynatrace monitoring integration.
*
* Specifies the environment ID, resources to monitor, and webhook settings to enable the Agent Space to access Dynatrace metrics, traces, and logs.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-dynatrace
*/
readonly dynatrace?: CfnAssociation.DynatraceConfigurationProperty | cdk.IResolvable;
/**
* Configuration for Event Channel integration.
*
* Specifies webhook settings to enable the Agent Space to receive and process real-time events from external systems.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-eventchannel
*/
readonly eventChannel?: CfnAssociation.EventChannelConfigurationProperty | cdk.IResolvable;
/**
* Configuration for GitHub repository integration.
*
* Specifies the repository name, repository ID, owner, and owner type to enable the Agent Space to access code, pull requests, and issues.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-github
*/
readonly gitHub?: CfnAssociation.GitHubConfigurationProperty | cdk.IResolvable;
/**
* Configuration for GitLab project integration.
*
* Specifies the project ID, project path, instance identifier, and webhook settings to enable the Agent Space to access code, merge requests, and issues.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-gitlab
*/
readonly gitLab?: CfnAssociation.GitLabConfigurationProperty | cdk.IResolvable;
/**
* Configuration for custom MCP (Model Context Protocol) server integration.
*
* Specifies the server name, endpoint URL, available tools, description, and webhook settings to enable the Agent Space to interact with custom MCP servers.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-mcpserver
*/
readonly mcpServer?: cdk.IResolvable | CfnAssociation.MCPServerConfigurationProperty;
/**
* Configuration for Datadog MCP server integration.
*
* Specifies the server name, endpoint URL, optional description, and webhook settings to enable the Agent Space to query metrics, traces, and logs from Datadog.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-mcpserverdatadog
*/
readonly mcpServerDatadog?: cdk.IResolvable | CfnAssociation.MCPServerDatadogConfigurationProperty;
/**
* Configuration for New Relic MCP server integration.
*
* Specifies the New Relic account ID and MCP endpoint URL to enable the Agent Space to query metrics, traces, and logs from New Relic.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-mcpservernewrelic
*/
readonly mcpServerNewRelic?: cdk.IResolvable | CfnAssociation.MCPServerNewRelicConfigurationProperty;
/**
* Configuration for Splunk MCP server integration.
*
* Specifies the server name, endpoint URL, optional description, and webhook settings to enable the Agent Space to query logs, metrics, and events from Splunk.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-mcpserversplunk
*/
readonly mcpServerSplunk?: cdk.IResolvable | CfnAssociation.MCPServerSplunkConfigurationProperty;
/**
* Configuration for ServiceNow instance integration.
*
* Specifies the instance URL, instance ID, and webhook settings to enable the Agent Space to create, update, and manage ServiceNow incidents and change requests.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-servicenow
*/
readonly serviceNow?: cdk.IResolvable | CfnAssociation.ServiceNowConfigurationProperty;
/**
* Configuration for Slack workspace integration.
*
* Specifies the workspace ID, workspace name, and transmission targets to enable the Agent Space to send notifications to designated Slack channels.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-slack
*/
readonly slack?: cdk.IResolvable | CfnAssociation.SlackConfigurationProperty;
/**
* Configuration for AWS source account integration.
*
* Specifies the account ID, assumable role ARN, and resources to be monitored in the source account.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-serviceconfiguration.html#cfn-devopsagent-association-serviceconfiguration-sourceaws
*/
readonly sourceAws?: cdk.IResolvable | CfnAssociation.SourceAwsConfigurationProperty;
}
/**
* Configuration for AWS source account integration.
*
* Specifies the account ID, assumable role ARN, and resources to be monitored in the source account.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-sourceawsconfiguration.html
*/
interface SourceAwsConfigurationProperty {
/**
* Account ID corresponding to the provided resources.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-sourceawsconfiguration.html#cfn-devopsagent-association-sourceawsconfiguration-accountid
*/
readonly accountId: string;
/**
* Account Type 'source' for AWS DevOps Agent monitoring.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-sourceawsconfiguration.html#cfn-devopsagent-association-sourceawsconfiguration-accounttype
*/
readonly accountType: string;
/**
* Role ARN to be assumed by AWS DevOps Agent to operate on behalf of customer.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-sourceawsconfiguration.html#cfn-devopsagent-association-sourceawsconfiguration-assumablerolearn
*/
readonly assumableRoleArn: string;
/**
* List of resources to monitor.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-sourceawsconfiguration.html#cfn-devopsagent-association-sourceawsconfiguration-resources
*/
readonly resources?: Array<CfnAssociation.AWSResourceProperty | cdk.IResolvable> | cdk.IResolvable;
/**
* List of tags as key-value pairs, used to identify resources for topology crawl.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-sourceawsconfiguration.html#cfn-devopsagent-association-sourceawsconfiguration-tags
*/
readonly tags?: Array<CfnAssociation.KeyValuePairProperty>;
}
/**
* Defines an AWS resource to be monitored, including its type, ARN, and optional metadata.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-awsresource.html
*/
interface AWSResourceProperty {
/**
* The Amazon Resource Name (ARN) of the resource.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-awsresource.html#cfn-devopsagent-association-awsresource-resourcearn
*/
readonly resourceArn: string;
/**
* Additional metadata specific to the resource.
*
* This is an optional JSON object that can include resource-specific information to provide additional context for monitoring and management.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-awsresource.html#cfn-devopsagent-association-awsresource-resourcemetadata
*/
readonly resourceMetadata?: any | cdk.IResolvable;
/**
* Resource type.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-awsresource.html#cfn-devopsagent-association-awsresource-resourcetype
*/
readonly resourceType?: string;
}
/**
* A key-value pair for tags.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-keyvaluepair.html
*/
interface KeyValuePairProperty {
/**
* The key name of the tag.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-keyvaluepair.html#cfn-devopsagent-association-keyvaluepair-key
*/
readonly key: string;
/**
* The value for the tag.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-keyvaluepair.html#cfn-devopsagent-association-keyvaluepair-value
*/
readonly value: string;
}
/**
* Configuration for AWS monitor account integration.
*
* Specifies the account ID, assumable role ARN, and resources to be monitored in the primary monitoring account.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-awsconfiguration.html
*/
interface AWSConfigurationProperty {
/**
* Account ID corresponding to the provided resources.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-awsconfiguration.html#cfn-devopsagent-association-awsconfiguration-accountid
*/
readonly accountId: string;
/**
* Account Type 'monitor' for AWS DevOps Agent monitoring.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-awsconfiguration.html#cfn-devopsagent-association-awsconfiguration-accounttype
*/
readonly accountType: string;
/**
* Role ARN used by AWS DevOps Agent to access resources in the primary account.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-awsconfiguration.html#cfn-devopsagent-association-awsconfiguration-assumablerolearn
*/
readonly assumableRoleArn: string;
/**
* List of resources to monitor.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-awsconfiguration.html#cfn-devopsagent-association-awsconfiguration-resources
*/
readonly resources?: Array<CfnAssociation.AWSResourceProperty | cdk.IResolvable> | cdk.IResolvable;
/**
* List of tags as key-value pairs, used to identify resources for topology crawl.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-awsconfiguration.html#cfn-devopsagent-association-awsconfiguration-tags
*/
readonly tags?: Array<CfnAssociation.KeyValuePairProperty>;
}
/**
* Configuration for GitHub repository integration.
*
* Defines the repository name, numeric repository ID, owner name, and owner type (user or organization) required for the Agent Space to access and interact with the GitHub repository.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-githubconfiguration.html
*/
interface GitHubConfigurationProperty {
/**
* Repository owner.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-githubconfiguration.html#cfn-devopsagent-association-githubconfiguration-owner
*/
readonly owner: string;
/**
* Type of repository owner.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-githubconfiguration.html#cfn-devopsagent-association-githubconfiguration-ownertype
*/
readonly ownerType: string;
/**
* Associated Github repo ID.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-githubconfiguration.html#cfn-devopsagent-association-githubconfiguration-repoid
*/
readonly repoId: string;
/**
* Associated Github repo name.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-githubconfiguration.html#cfn-devopsagent-association-githubconfiguration-reponame
*/
readonly repoName: string;
}
/**
* Configuration for Slack workspace integration.
*
* Defines the workspace ID, workspace name, and transmission targets that specify which Slack channels receive notifications.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-slackconfiguration.html
*/
interface SlackConfigurationProperty {
/**
* Transmission targets for agent notifications.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-slackconfiguration.html#cfn-devopsagent-association-slackconfiguration-transmissiontarget
*/
readonly transmissionTarget: cdk.IResolvable | CfnAssociation.SlackTransmissionTargetProperty;
/**
* Associated Slack workspace ID.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-slackconfiguration.html#cfn-devopsagent-association-slackconfiguration-workspaceid
*/
readonly workspaceId: string;
/**
* Associated Slack workspace name.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-slackconfiguration.html#cfn-devopsagent-association-slackconfiguration-workspacename
*/
readonly workspaceName: string;
}
/**
* Defines the Slack channels where different types of agent notifications will be sent.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-slacktransmissiontarget.html
*/
interface SlackTransmissionTargetProperty {
/**
* Destination for AWS DevOps Agent Incident Response.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-slacktransmissiontarget.html#cfn-devopsagent-association-slacktransmissiontarget-incidentresponsetarget
*/
readonly incidentResponseTarget: cdk.IResolvable | CfnAssociation.SlackChannelProperty;
}
/**
* Represents a Slack channel with its unique identifier and optional display name.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-slackchannel.html
*/
interface SlackChannelProperty {
/**
* Slack channel ID.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-slackchannel.html#cfn-devopsagent-association-slackchannel-channelid
*/
readonly channelId: string;
/**
* Slack channel name.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-slackchannel.html#cfn-devopsagent-association-slackchannel-channelname
*/
readonly channelName?: string;
}
/**
* Configuration for Dynatrace monitoring integration.
*
* Defines the Dynatrace environment ID, list of resources to monitor, and webhook update settings required for the Agent Space to access metrics, traces, and logs from Dynatrace.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-dynatraceconfiguration.html
*/
interface DynatraceConfigurationProperty {
/**
* When set to true, enables the Agent Space to create and update webhooks for receiving notifications and events from the service.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-dynatraceconfiguration.html#cfn-devopsagent-association-dynatraceconfiguration-enablewebhookupdates
*/
readonly enableWebhookUpdates?: boolean | cdk.IResolvable;
/**
* Dynatrace environment id.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-dynatraceconfiguration.html#cfn-devopsagent-association-dynatraceconfiguration-envid
*/
readonly envId: string;
/**
* List of Dynatrace resources to monitor.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-dynatraceconfiguration.html#cfn-devopsagent-association-dynatraceconfiguration-resources
*/
readonly resources?: Array<string>;
}
/**
* Configuration for ServiceNow integration.
*
* Defines the ServiceNow instance URL, instance ID, and webhook update settings required for the Agent Space to create, update, and manage incidents and change requests.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-servicenowconfiguration.html
*/
interface ServiceNowConfigurationProperty {
/**
* When set to true, enables the Agent Space to create and update webhooks for receiving notifications and events from the service.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-servicenowconfiguration.html#cfn-devopsagent-association-servicenowconfiguration-enablewebhookupdates
*/
readonly enableWebhookUpdates?: boolean | cdk.IResolvable;
/**
* ServiceNow instance ID.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-servicenowconfiguration.html#cfn-devopsagent-association-servicenowconfiguration-instanceid
*/
readonly instanceId?: string;
}
/**
* Configuration for MCP (Model Context Protocol) server integration.
*
* Defines the server name, endpoint URL, available tools, optional description, and webhook update settings for custom MCP servers.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverconfiguration.html
*/
interface MCPServerConfigurationProperty {
/**
* The description of the MCP server.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverconfiguration.html#cfn-devopsagent-association-mcpserverconfiguration-description
*/
readonly description?: string;
/**
* When set to true, enables the Agent Space to create and update webhooks for receiving notifications and events from the service.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverconfiguration.html#cfn-devopsagent-association-mcpserverconfiguration-enablewebhookupdates
*/
readonly enableWebhookUpdates?: boolean | cdk.IResolvable;
/**
* MCP server endpoint URL.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverconfiguration.html#cfn-devopsagent-association-mcpserverconfiguration-endpoint
*/
readonly endpoint: string;
/**
* The name of the MCP server.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverconfiguration.html#cfn-devopsagent-association-mcpserverconfiguration-name
*/
readonly name: string;
/**
* List of MCP tools that can be used with the association.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverconfiguration.html#cfn-devopsagent-association-mcpserverconfiguration-tools
*/
readonly tools: Array<string>;
}
/**
* Configuration for GitLab project integration.
*
* Defines the numeric project ID, full project path (namespace/project-name), GitLab instance identifier, and webhook update settings required for the Agent Space to access and interact with the GitLab project.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-gitlabconfiguration.html
*/
interface GitLabConfigurationProperty {
/**
* When set to true, enables the Agent Space to create and update webhooks for receiving notifications and events from the service.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-gitlabconfiguration.html#cfn-devopsagent-association-gitlabconfiguration-enablewebhookupdates
*/
readonly enableWebhookUpdates?: boolean | cdk.IResolvable;
/**
* GitLab instance identifier (e.g., gitlab.com).
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-gitlabconfiguration.html#cfn-devopsagent-association-gitlabconfiguration-instanceidentifier
*/
readonly instanceIdentifier?: string;
/**
* GitLab numeric project ID.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-gitlabconfiguration.html#cfn-devopsagent-association-gitlabconfiguration-projectid
*/
readonly projectId: string;
/**
* Full GitLab project path (e.g., namespace/project-name).
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-gitlabconfiguration.html#cfn-devopsagent-association-gitlabconfiguration-projectpath
*/
readonly projectPath: string;
}
/**
* Configuration for Datadog MCP server integration.
*
* Defines the server name, endpoint URL, optional description, and webhook update settings.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverdatadogconfiguration.html
*/
interface MCPServerDatadogConfigurationProperty {
/**
* The description of the MCP server.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverdatadogconfiguration.html#cfn-devopsagent-association-mcpserverdatadogconfiguration-description
*/
readonly description?: string;
/**
* When set to true, enables the Agent Space to create and update webhooks for receiving notifications and events from the service.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverdatadogconfiguration.html#cfn-devopsagent-association-mcpserverdatadogconfiguration-enablewebhookupdates
*/
readonly enableWebhookUpdates?: boolean | cdk.IResolvable;
/**
* MCP server endpoint URL.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverdatadogconfiguration.html#cfn-devopsagent-association-mcpserverdatadogconfiguration-endpoint
*/
readonly endpoint: string;
/**
* The name of the MCP server.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserverdatadogconfiguration.html#cfn-devopsagent-association-mcpserverdatadogconfiguration-name
*/
readonly name: string;
}
/**
* Configuration for Splunk MCP server integration.
*
* Defines the server name, endpoint URL, optional description, and webhook update settings.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserversplunkconfiguration.html
*/
interface MCPServerSplunkConfigurationProperty {
/**
* The description of the MCP server.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserversplunkconfiguration.html#cfn-devopsagent-association-mcpserversplunkconfiguration-description
*/
readonly description?: string;
/**
* When set to true, enables the Agent Space to create and update webhooks for receiving notifications and events from the service.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserversplunkconfiguration.html#cfn-devopsagent-association-mcpserversplunkconfiguration-enablewebhookupdates
*/
readonly enableWebhookUpdates?: boolean | cdk.IResolvable;
/**
* MCP server endpoint URL.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserversplunkconfiguration.html#cfn-devopsagent-association-mcpserversplunkconfiguration-endpoint
*/
readonly endpoint: string;
/**
* The name of the MCP server.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpserversplunkconfiguration.html#cfn-devopsagent-association-mcpserversplunkconfiguration-name
*/
readonly name: string;
}
/**
* Configuration for New Relic MCP server integration.
*
* Defines the New Relic account ID and MCP server endpoint URL required for the Agent Space to authenticate and query observability data from New Relic.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpservernewrelicconfiguration.html
*/
interface MCPServerNewRelicConfigurationProperty {
/**
* New Relic Account ID.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpservernewrelicconfiguration.html#cfn-devopsagent-association-mcpservernewrelicconfiguration-accountid
*/
readonly accountId: string;
/**
* MCP server endpoint URL (e.g., https://mcp.newrelic.com/mcp/).
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-mcpservernewrelicconfiguration.html#cfn-devopsagent-association-mcpservernewrelicconfiguration-endpoint
*/
readonly endpoint: string;
}
/**
* Configuration for Event Channel integration.
*
* Defines webhook update settings to enable the Agent Space to receive real-time event notifications from event channel integrations.
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-eventchannelconfiguration.html
*/
interface EventChannelConfigurationProperty {
/**
* When set to true, enables the Agent Space to create and update webhooks for receiving notifications and events from the service.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-devopsagent-association-eventchannelconfiguration.html#cfn-devopsagent-association-eventchannelconfiguration-enablewebhookupdates
*/
readonly enableWebhookUpdates?: boolean | cdk.IResolvable;
}
}
/**
* Properties for defining a `CfnAssociation`
*
* @struct
* @stability external
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsagent-association.html
*/
export interface CfnAssociationProps {
/**
* The unique identifier of the Agent Space.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsagent-association.html#cfn-devopsagent-association-agentspaceid
*/
readonly agentSpaceId: string;
/**
* The configuration that directs how the Agent Space interacts with the given service.
*
* You can specify only one configuration type per association.
*
* *Allowed Values* : `SourceAws` | `Aws` | `GitHub` | `GitLab` | `Slack` | `Dynatrace` | `ServiceNow` | `MCPServer` | `MCPServerNewRelic` | `MCPServerDatadog` | `MCPServerSplunk` | `EventChannel`
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsagent-association.html#cfn-devopsagent-association-configuration
*/
readonly configuration: cdk.IResolvable | CfnAssociation.ServiceConfigurationProperty;
/**
* Set of linked association IDs for parent-child relationships.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsagent-association.html#cfn-devopsagent-association-linkedassociationids
*/
readonly linkedAssociationIds?: Array<string>;
/**
* The identifier for the associated service.
*
* For `SourceAws` and `Aws` configurations, this must be `aws` . For all other service types, this is a UUID generated from the RegisterService command.
*
* @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsagent-association.html#cfn-devopsagent-association-serviceid
*/
readonly serviceId: string;
}
export type { IAgentSpaceRef, AgentSpaceReference };
export type { IAssociationRef, AssociationReference };