1. Packages
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. devopsagent
  6. getService

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.74.1
published on Monday, Aug 3, 2026 by Pulumi
aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.74.1
published on Monday, Aug 3, 2026 by Pulumi

    The AWS::DevOpsAgent::Service resource registers external services (like Dynatrace, MCP servers, GitLab) for integration with DevOpsAgent.

    Using getService

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getService(args: GetServiceArgs, opts?: InvokeOptions): Promise<GetServiceResult>
    function getServiceOutput(args: GetServiceOutputArgs, opts?: InvokeOptions): Output<GetServiceResult>
    def get_service(service_id: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetServiceResult
    def get_service_output(service_id: pulumi.Input[Optional[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetServiceResult]
    func LookupService(ctx *Context, args *LookupServiceArgs, opts ...InvokeOption) (*LookupServiceResult, error)
    func LookupServiceOutput(ctx *Context, args *LookupServiceOutputArgs, opts ...InvokeOption) LookupServiceResultOutput

    > Note: This function is named LookupService in the Go SDK.

    public static class GetService 
    {
        public static Task<GetServiceResult> InvokeAsync(GetServiceArgs args, InvokeOptions? opts = null)
        public static Output<GetServiceResult> Invoke(GetServiceInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetServiceResult> getService(GetServiceArgs args, InvokeOptions options)
    public static Output<GetServiceResult> getService(GetServiceArgs args, InvokeOptions options)
    
    fn::invoke:
      function: aws-native:devopsagent:getService
      arguments:
        # arguments dictionary
    data "aws-native_devopsagent_get_service" "name" {
        # arguments
    }

    The following arguments are supported:

    ServiceId string
    The unique identifier of the service
    ServiceId string
    The unique identifier of the service
    service_id string
    The unique identifier of the service
    serviceId String
    The unique identifier of the service
    serviceId string
    The unique identifier of the service
    service_id str
    The unique identifier of the service
    serviceId String
    The unique identifier of the service

    getService Result

    The following output properties are available:

    AccessibleResources List<ImmutableDictionary<string, string>>
    List of accessible resources for this service
    AdditionalServiceDetails Pulumi.AwsNative.DevOpsAgent.Outputs.ServiceAdditionalServiceDetails
    Additional details specific to the service type
    Arn string
    The Amazon Resource Name (ARN) of the Service.
    ServiceId string
    The unique identifier of the service
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    An array of key-value pairs to apply to this resource.
    AccessibleResources []map[string]string
    List of accessible resources for this service
    AdditionalServiceDetails ServiceAdditionalServiceDetails
    Additional details specific to the service type
    Arn string
    The Amazon Resource Name (ARN) of the Service.
    ServiceId string
    The unique identifier of the service
    Tags Tag
    An array of key-value pairs to apply to this resource.
    accessible_resources list(map(string))
    List of accessible resources for this service
    additional_service_details object
    Additional details specific to the service type
    arn string
    The Amazon Resource Name (ARN) of the Service.
    service_id string
    The unique identifier of the service
    tags list(object)
    An array of key-value pairs to apply to this resource.
    accessibleResources List<Map<String,String>>
    List of accessible resources for this service
    additionalServiceDetails ServiceAdditionalServiceDetails
    Additional details specific to the service type
    arn String
    The Amazon Resource Name (ARN) of the Service.
    serviceId String
    The unique identifier of the service
    tags List<Tag>
    An array of key-value pairs to apply to this resource.
    accessibleResources {[key: string]: string}[]
    List of accessible resources for this service
    additionalServiceDetails ServiceAdditionalServiceDetails
    Additional details specific to the service type
    arn string
    The Amazon Resource Name (ARN) of the Service.
    serviceId string
    The unique identifier of the service
    tags Tag[]
    An array of key-value pairs to apply to this resource.
    accessible_resources Sequence[Mapping[str, str]]
    List of accessible resources for this service
    additional_service_details ServiceAdditionalServiceDetails
    Additional details specific to the service type
    arn str
    The Amazon Resource Name (ARN) of the Service.
    service_id str
    The unique identifier of the service
    tags Sequence[root_Tag]
    An array of key-value pairs to apply to this resource.
    accessibleResources List<Map<String>>
    List of accessible resources for this service
    additionalServiceDetails Property Map
    Additional details specific to the service type
    arn String
    The Amazon Resource Name (ARN) of the Service.
    serviceId String
    The unique identifier of the service
    tags List<Property Map>
    An array of key-value pairs to apply to this resource.

    Supporting Types

    ServiceAdditionalServiceDetails

    AzureIdentity Pulumi.AwsNative.DevOpsAgent.Inputs.ServiceRegisteredAzureIdentityDetails
    Dynatrace Pulumi.AwsNative.DevOpsAgent.Inputs.ServiceRegisteredDynatraceDetails
    GitLab Pulumi.AwsNative.DevOpsAgent.Inputs.ServiceRegisteredGitLabServiceDetails
    McpServer Pulumi.AwsNative.DevOpsAgent.Inputs.ServiceRegisteredMcpServerDetails
    McpServerGrafana Pulumi.AwsNative.DevOpsAgent.Inputs.ServiceRegisteredMcpServerGrafanaDetails
    McpServerNewRelic Pulumi.AwsNative.DevOpsAgent.Inputs.ServiceRegisteredNewRelicDetails
    McpServerSigV4 Pulumi.AwsNative.DevOpsAgent.Inputs.ServiceRegisteredMcpServerSigV4Details
    McpServerSplunk Pulumi.AwsNative.DevOpsAgent.Inputs.ServiceRegisteredMcpServerDetails
    PagerDuty Pulumi.AwsNative.DevOpsAgent.Inputs.ServiceRegisteredPagerDutyDetails
    ServiceNow Pulumi.AwsNative.DevOpsAgent.Inputs.ServiceRegisteredServiceNowDetails

    ServiceRegisteredAzureIdentityDetails

    ClientId string
    Azure AD application client ID
    TenantId string
    Azure AD tenant ID
    WebIdentityRoleArn string
    ARN of the IAM role for web identity token exchange
    WebIdentityTokenAudiences List<string>
    List of audiences for the web identity token
    ClientId string
    Azure AD application client ID
    TenantId string
    Azure AD tenant ID
    WebIdentityRoleArn string
    ARN of the IAM role for web identity token exchange
    WebIdentityTokenAudiences []string
    List of audiences for the web identity token
    client_id string
    Azure AD application client ID
    tenant_id string
    Azure AD tenant ID
    web_identity_role_arn string
    ARN of the IAM role for web identity token exchange
    web_identity_token_audiences list(string)
    List of audiences for the web identity token
    clientId String
    Azure AD application client ID
    tenantId String
    Azure AD tenant ID
    webIdentityRoleArn String
    ARN of the IAM role for web identity token exchange
    webIdentityTokenAudiences List<String>
    List of audiences for the web identity token
    clientId string
    Azure AD application client ID
    tenantId string
    Azure AD tenant ID
    webIdentityRoleArn string
    ARN of the IAM role for web identity token exchange
    webIdentityTokenAudiences string[]
    List of audiences for the web identity token
    client_id str
    Azure AD application client ID
    tenant_id str
    Azure AD tenant ID
    web_identity_role_arn str
    ARN of the IAM role for web identity token exchange
    web_identity_token_audiences Sequence[str]
    List of audiences for the web identity token
    clientId String
    Azure AD application client ID
    tenantId String
    Azure AD tenant ID
    webIdentityRoleArn String
    ARN of the IAM role for web identity token exchange
    webIdentityTokenAudiences List<String>
    List of audiences for the web identity token

    ServiceRegisteredDynatraceDetails

    AccountUrn string
    Dynatrace resource account URN
    AccountUrn string
    Dynatrace resource account URN
    account_urn string
    Dynatrace resource account URN
    accountUrn String
    Dynatrace resource account URN
    accountUrn string
    Dynatrace resource account URN
    account_urn str
    Dynatrace resource account URN
    accountUrn String
    Dynatrace resource account URN

    ServiceRegisteredGitLabServiceDetails

    TargetUrl string
    GitLab instance URL
    TokenType Pulumi.AwsNative.DevOpsAgent.ServiceRegisteredGitLabServiceDetailsTokenType
    Type of GitLab access token
    GroupId string
    Optional GitLab group ID for group-level access tokens
    TargetUrl string
    GitLab instance URL
    TokenType ServiceRegisteredGitLabServiceDetailsTokenType
    Type of GitLab access token
    GroupId string
    Optional GitLab group ID for group-level access tokens
    target_url string
    GitLab instance URL
    token_type "personal" | "group"
    Type of GitLab access token
    group_id string
    Optional GitLab group ID for group-level access tokens
    targetUrl String
    GitLab instance URL
    tokenType ServiceRegisteredGitLabServiceDetailsTokenType
    Type of GitLab access token
    groupId String
    Optional GitLab group ID for group-level access tokens
    targetUrl string
    GitLab instance URL
    tokenType ServiceRegisteredGitLabServiceDetailsTokenType
    Type of GitLab access token
    groupId string
    Optional GitLab group ID for group-level access tokens
    target_url str
    GitLab instance URL
    token_type ServiceRegisteredGitLabServiceDetailsTokenType
    Type of GitLab access token
    group_id str
    Optional GitLab group ID for group-level access tokens
    targetUrl String
    GitLab instance URL
    tokenType "personal" | "group"
    Type of GitLab access token
    groupId String
    Optional GitLab group ID for group-level access tokens

    ServiceRegisteredGitLabServiceDetailsTokenType

    ServiceRegisteredMcpServerDetails

    AuthorizationMethod Pulumi.AwsNative.DevOpsAgent.ServiceRegisteredMcpServerDetailsAuthorizationMethod
    MCP server authorization method
    Endpoint string
    MCP server endpoint URL
    Name string
    MCP server name
    ApiKeyHeader string
    API key header name if using API key authentication
    Description string
    Optional description for the MCP server
    AuthorizationMethod ServiceRegisteredMcpServerDetailsAuthorizationMethod
    MCP server authorization method
    Endpoint string
    MCP server endpoint URL
    Name string
    MCP server name
    ApiKeyHeader string
    API key header name if using API key authentication
    Description string
    Optional description for the MCP server
    authorization_method "oauth-client-credentials" | "api-key" | "bearer-token"
    MCP server authorization method
    endpoint string
    MCP server endpoint URL
    name string
    MCP server name
    api_key_header string
    API key header name if using API key authentication
    description string
    Optional description for the MCP server
    authorizationMethod ServiceRegisteredMcpServerDetailsAuthorizationMethod
    MCP server authorization method
    endpoint String
    MCP server endpoint URL
    name String
    MCP server name
    apiKeyHeader String
    API key header name if using API key authentication
    description String
    Optional description for the MCP server
    authorizationMethod ServiceRegisteredMcpServerDetailsAuthorizationMethod
    MCP server authorization method
    endpoint string
    MCP server endpoint URL
    name string
    MCP server name
    apiKeyHeader string
    API key header name if using API key authentication
    description string
    Optional description for the MCP server
    authorization_method ServiceRegisteredMcpServerDetailsAuthorizationMethod
    MCP server authorization method
    endpoint str
    MCP server endpoint URL
    name str
    MCP server name
    api_key_header str
    API key header name if using API key authentication
    description str
    Optional description for the MCP server
    authorizationMethod "oauth-client-credentials" | "api-key" | "bearer-token"
    MCP server authorization method
    endpoint String
    MCP server endpoint URL
    name String
    MCP server name
    apiKeyHeader String
    API key header name if using API key authentication
    description String
    Optional description for the MCP server

    ServiceRegisteredMcpServerDetailsAuthorizationMethod

    ServiceRegisteredMcpServerGrafanaDetails

    AuthorizationMethod Pulumi.AwsNative.DevOpsAgent.ServiceRegisteredMcpServerGrafanaDetailsAuthorizationMethod
    MCP server authorization method
    Endpoint string
    MCP server endpoint URL
    Description string
    Optional description for the MCP server
    Name string
    MCP server name
    AuthorizationMethod ServiceRegisteredMcpServerGrafanaDetailsAuthorizationMethod
    MCP server authorization method
    Endpoint string
    MCP server endpoint URL
    Description string
    Optional description for the MCP server
    Name string
    MCP server name
    authorization_method "bearer-token"
    MCP server authorization method
    endpoint string
    MCP server endpoint URL
    description string
    Optional description for the MCP server
    name string
    MCP server name
    authorizationMethod ServiceRegisteredMcpServerGrafanaDetailsAuthorizationMethod
    MCP server authorization method
    endpoint String
    MCP server endpoint URL
    description String
    Optional description for the MCP server
    name String
    MCP server name
    authorizationMethod ServiceRegisteredMcpServerGrafanaDetailsAuthorizationMethod
    MCP server authorization method
    endpoint string
    MCP server endpoint URL
    description string
    Optional description for the MCP server
    name string
    MCP server name
    authorization_method ServiceRegisteredMcpServerGrafanaDetailsAuthorizationMethod
    MCP server authorization method
    endpoint str
    MCP server endpoint URL
    description str
    Optional description for the MCP server
    name str
    MCP server name
    authorizationMethod "bearer-token"
    MCP server authorization method
    endpoint String
    MCP server endpoint URL
    description String
    Optional description for the MCP server
    name String
    MCP server name

    ServiceRegisteredMcpServerGrafanaDetailsAuthorizationMethod

    ServiceRegisteredMcpServerSigV4Details

    Endpoint string
    The MCP server endpoint URL
    Name string
    The MCP server name
    Region string
    AWS region for SigV4 signing
    RoleArn string
    Deprecated - use McpRoleArn instead. IAM role ARN for SigV4 signing
    Service string
    AWS service name for SigV4 signing
    CustomHeaders Dictionary<string, string>
    Custom headers for the SigV4 MCP server
    Description string
    Optional description for the MCP server
    McpRoleArn string
    IAM role ARN for SigV4 signing. Absent when no dedicated role is configured.
    Endpoint string
    The MCP server endpoint URL
    Name string
    The MCP server name
    Region string
    AWS region for SigV4 signing
    RoleArn string
    Deprecated - use McpRoleArn instead. IAM role ARN for SigV4 signing
    Service string
    AWS service name for SigV4 signing
    CustomHeaders map[string]string
    Custom headers for the SigV4 MCP server
    Description string
    Optional description for the MCP server
    McpRoleArn string
    IAM role ARN for SigV4 signing. Absent when no dedicated role is configured.
    endpoint string
    The MCP server endpoint URL
    name string
    The MCP server name
    region string
    AWS region for SigV4 signing
    role_arn string
    Deprecated - use McpRoleArn instead. IAM role ARN for SigV4 signing
    service string
    AWS service name for SigV4 signing
    custom_headers map(string)
    Custom headers for the SigV4 MCP server
    description string
    Optional description for the MCP server
    mcp_role_arn string
    IAM role ARN for SigV4 signing. Absent when no dedicated role is configured.
    endpoint String
    The MCP server endpoint URL
    name String
    The MCP server name
    region String
    AWS region for SigV4 signing
    roleArn String
    Deprecated - use McpRoleArn instead. IAM role ARN for SigV4 signing
    service String
    AWS service name for SigV4 signing
    customHeaders Map<String,String>
    Custom headers for the SigV4 MCP server
    description String
    Optional description for the MCP server
    mcpRoleArn String
    IAM role ARN for SigV4 signing. Absent when no dedicated role is configured.
    endpoint string
    The MCP server endpoint URL
    name string
    The MCP server name
    region string
    AWS region for SigV4 signing
    roleArn string
    Deprecated - use McpRoleArn instead. IAM role ARN for SigV4 signing
    service string
    AWS service name for SigV4 signing
    customHeaders {[key: string]: string}
    Custom headers for the SigV4 MCP server
    description string
    Optional description for the MCP server
    mcpRoleArn string
    IAM role ARN for SigV4 signing. Absent when no dedicated role is configured.
    endpoint str
    The MCP server endpoint URL
    name str
    The MCP server name
    region str
    AWS region for SigV4 signing
    role_arn str
    Deprecated - use McpRoleArn instead. IAM role ARN for SigV4 signing
    service str
    AWS service name for SigV4 signing
    custom_headers Mapping[str, str]
    Custom headers for the SigV4 MCP server
    description str
    Optional description for the MCP server
    mcp_role_arn str
    IAM role ARN for SigV4 signing. Absent when no dedicated role is configured.
    endpoint String
    The MCP server endpoint URL
    name String
    The MCP server name
    region String
    AWS region for SigV4 signing
    roleArn String
    Deprecated - use McpRoleArn instead. IAM role ARN for SigV4 signing
    service String
    AWS service name for SigV4 signing
    customHeaders Map<String>
    Custom headers for the SigV4 MCP server
    description String
    Optional description for the MCP server
    mcpRoleArn String
    IAM role ARN for SigV4 signing. Absent when no dedicated role is configured.

    ServiceRegisteredNewRelicDetails

    AccountId string
    New Relic account ID
    Region Pulumi.AwsNative.DevOpsAgent.ServiceRegisteredNewRelicDetailsRegion
    New Relic region
    Description string
    Optional user description
    AccountId string
    New Relic account ID
    Region ServiceRegisteredNewRelicDetailsRegion
    New Relic region
    Description string
    Optional user description
    account_id string
    New Relic account ID
    region "US" | "EU"
    New Relic region
    description string
    Optional user description
    accountId String
    New Relic account ID
    region ServiceRegisteredNewRelicDetailsRegion
    New Relic region
    description String
    Optional user description
    accountId string
    New Relic account ID
    region ServiceRegisteredNewRelicDetailsRegion
    New Relic region
    description string
    Optional user description
    account_id str
    New Relic account ID
    region ServiceRegisteredNewRelicDetailsRegion
    New Relic region
    description str
    Optional user description
    accountId String
    New Relic account ID
    region "US" | "EU"
    New Relic region
    description String
    Optional user description

    ServiceRegisteredNewRelicDetailsRegion

    ServiceRegisteredPagerDutyDetails

    Scopes List<string>
    The scopes assigned to the service
    Scopes []string
    The scopes assigned to the service
    scopes list(string)
    The scopes assigned to the service
    scopes List<String>
    The scopes assigned to the service
    scopes string[]
    The scopes assigned to the service
    scopes Sequence[str]
    The scopes assigned to the service
    scopes List<String>
    The scopes assigned to the service

    ServiceRegisteredServiceNowDetails

    InstanceUrl string
    ServiceNow instance URL
    InstanceUrl string
    ServiceNow instance URL
    instance_url string
    ServiceNow instance URL
    instanceUrl String
    ServiceNow instance URL
    instanceUrl string
    ServiceNow instance URL
    instance_url str
    ServiceNow instance URL
    instanceUrl String
    ServiceNow instance URL

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.74.1
    published on Monday, Aug 3, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial