azuredevops.ServiceEndpointGitHubEnterprise
Explore with Pulumi AI
Manages a GitHub Enterprise Server service endpoint within Azure DevOps.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as azuredevops from "@pulumi/azuredevops";
const example = new azuredevops.Project("example", {
    name: "Example Project",
    visibility: "private",
    versionControl: "Git",
    workItemTemplate: "Agile",
    description: "Managed by Pulumi",
});
const exampleServiceEndpointGitHubEnterprise = new azuredevops.ServiceEndpointGitHubEnterprise("example", {
    projectId: example.id,
    serviceEndpointName: "Example GitHub Enterprise",
    url: "https://github.contoso.com",
    description: "Managed by Pulumi",
    authPersonal: {
        personalAccessToken: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    },
});
import pulumi
import pulumi_azuredevops as azuredevops
example = azuredevops.Project("example",
    name="Example Project",
    visibility="private",
    version_control="Git",
    work_item_template="Agile",
    description="Managed by Pulumi")
example_service_endpoint_git_hub_enterprise = azuredevops.ServiceEndpointGitHubEnterprise("example",
    project_id=example.id,
    service_endpoint_name="Example GitHub Enterprise",
    url="https://github.contoso.com",
    description="Managed by Pulumi",
    auth_personal={
        "personal_access_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    })
package main
import (
	"github.com/pulumi/pulumi-azuredevops/sdk/v3/go/azuredevops"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := azuredevops.NewProject(ctx, "example", &azuredevops.ProjectArgs{
			Name:             pulumi.String("Example Project"),
			Visibility:       pulumi.String("private"),
			VersionControl:   pulumi.String("Git"),
			WorkItemTemplate: pulumi.String("Agile"),
			Description:      pulumi.String("Managed by Pulumi"),
		})
		if err != nil {
			return err
		}
		_, err = azuredevops.NewServiceEndpointGitHubEnterprise(ctx, "example", &azuredevops.ServiceEndpointGitHubEnterpriseArgs{
			ProjectId:           example.ID(),
			ServiceEndpointName: pulumi.String("Example GitHub Enterprise"),
			Url:                 pulumi.String("https://github.contoso.com"),
			Description:         pulumi.String("Managed by Pulumi"),
			AuthPersonal: &azuredevops.ServiceEndpointGitHubEnterpriseAuthPersonalArgs{
				PersonalAccessToken: pulumi.String("xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureDevOps = Pulumi.AzureDevOps;
return await Deployment.RunAsync(() => 
{
    var example = new AzureDevOps.Project("example", new()
    {
        Name = "Example Project",
        Visibility = "private",
        VersionControl = "Git",
        WorkItemTemplate = "Agile",
        Description = "Managed by Pulumi",
    });
    var exampleServiceEndpointGitHubEnterprise = new AzureDevOps.ServiceEndpointGitHubEnterprise("example", new()
    {
        ProjectId = example.Id,
        ServiceEndpointName = "Example GitHub Enterprise",
        Url = "https://github.contoso.com",
        Description = "Managed by Pulumi",
        AuthPersonal = new AzureDevOps.Inputs.ServiceEndpointGitHubEnterpriseAuthPersonalArgs
        {
            PersonalAccessToken = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        },
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azuredevops.Project;
import com.pulumi.azuredevops.ProjectArgs;
import com.pulumi.azuredevops.ServiceEndpointGitHubEnterprise;
import com.pulumi.azuredevops.ServiceEndpointGitHubEnterpriseArgs;
import com.pulumi.azuredevops.inputs.ServiceEndpointGitHubEnterpriseAuthPersonalArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var example = new Project("example", ProjectArgs.builder()
            .name("Example Project")
            .visibility("private")
            .versionControl("Git")
            .workItemTemplate("Agile")
            .description("Managed by Pulumi")
            .build());
        var exampleServiceEndpointGitHubEnterprise = new ServiceEndpointGitHubEnterprise("exampleServiceEndpointGitHubEnterprise", ServiceEndpointGitHubEnterpriseArgs.builder()
            .projectId(example.id())
            .serviceEndpointName("Example GitHub Enterprise")
            .url("https://github.contoso.com")
            .description("Managed by Pulumi")
            .authPersonal(ServiceEndpointGitHubEnterpriseAuthPersonalArgs.builder()
                .personalAccessToken("xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
                .build())
            .build());
    }
}
resources:
  example:
    type: azuredevops:Project
    properties:
      name: Example Project
      visibility: private
      versionControl: Git
      workItemTemplate: Agile
      description: Managed by Pulumi
  exampleServiceEndpointGitHubEnterprise:
    type: azuredevops:ServiceEndpointGitHubEnterprise
    name: example
    properties:
      projectId: ${example.id}
      serviceEndpointName: Example GitHub Enterprise
      url: https://github.contoso.com
      description: Managed by Pulumi
      authPersonal:
        personalAccessToken: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Relevant Links
Create ServiceEndpointGitHubEnterprise Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new ServiceEndpointGitHubEnterprise(name: string, args: ServiceEndpointGitHubEnterpriseArgs, opts?: CustomResourceOptions);@overload
def ServiceEndpointGitHubEnterprise(resource_name: str,
                                    args: ServiceEndpointGitHubEnterpriseArgs,
                                    opts: Optional[ResourceOptions] = None)
@overload
def ServiceEndpointGitHubEnterprise(resource_name: str,
                                    opts: Optional[ResourceOptions] = None,
                                    auth_personal: Optional[ServiceEndpointGitHubEnterpriseAuthPersonalArgs] = None,
                                    project_id: Optional[str] = None,
                                    service_endpoint_name: Optional[str] = None,
                                    url: Optional[str] = None,
                                    description: Optional[str] = None)func NewServiceEndpointGitHubEnterprise(ctx *Context, name string, args ServiceEndpointGitHubEnterpriseArgs, opts ...ResourceOption) (*ServiceEndpointGitHubEnterprise, error)public ServiceEndpointGitHubEnterprise(string name, ServiceEndpointGitHubEnterpriseArgs args, CustomResourceOptions? opts = null)
public ServiceEndpointGitHubEnterprise(String name, ServiceEndpointGitHubEnterpriseArgs args)
public ServiceEndpointGitHubEnterprise(String name, ServiceEndpointGitHubEnterpriseArgs args, CustomResourceOptions options)
type: azuredevops:ServiceEndpointGitHubEnterprise
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ServiceEndpointGitHubEnterpriseArgs
- 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 ServiceEndpointGitHubEnterpriseArgs
- 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 ServiceEndpointGitHubEnterpriseArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ServiceEndpointGitHubEnterpriseArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ServiceEndpointGitHubEnterpriseArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var serviceEndpointGitHubEnterpriseResource = new AzureDevOps.ServiceEndpointGitHubEnterprise("serviceEndpointGitHubEnterpriseResource", new()
{
    AuthPersonal = new AzureDevOps.Inputs.ServiceEndpointGitHubEnterpriseAuthPersonalArgs
    {
        PersonalAccessToken = "string",
    },
    ProjectId = "string",
    ServiceEndpointName = "string",
    Url = "string",
    Description = "string",
});
example, err := azuredevops.NewServiceEndpointGitHubEnterprise(ctx, "serviceEndpointGitHubEnterpriseResource", &azuredevops.ServiceEndpointGitHubEnterpriseArgs{
	AuthPersonal: &azuredevops.ServiceEndpointGitHubEnterpriseAuthPersonalArgs{
		PersonalAccessToken: pulumi.String("string"),
	},
	ProjectId:           pulumi.String("string"),
	ServiceEndpointName: pulumi.String("string"),
	Url:                 pulumi.String("string"),
	Description:         pulumi.String("string"),
})
var serviceEndpointGitHubEnterpriseResource = new ServiceEndpointGitHubEnterprise("serviceEndpointGitHubEnterpriseResource", ServiceEndpointGitHubEnterpriseArgs.builder()
    .authPersonal(ServiceEndpointGitHubEnterpriseAuthPersonalArgs.builder()
        .personalAccessToken("string")
        .build())
    .projectId("string")
    .serviceEndpointName("string")
    .url("string")
    .description("string")
    .build());
service_endpoint_git_hub_enterprise_resource = azuredevops.ServiceEndpointGitHubEnterprise("serviceEndpointGitHubEnterpriseResource",
    auth_personal={
        "personal_access_token": "string",
    },
    project_id="string",
    service_endpoint_name="string",
    url="string",
    description="string")
const serviceEndpointGitHubEnterpriseResource = new azuredevops.ServiceEndpointGitHubEnterprise("serviceEndpointGitHubEnterpriseResource", {
    authPersonal: {
        personalAccessToken: "string",
    },
    projectId: "string",
    serviceEndpointName: "string",
    url: "string",
    description: "string",
});
type: azuredevops:ServiceEndpointGitHubEnterprise
properties:
    authPersonal:
        personalAccessToken: string
    description: string
    projectId: string
    serviceEndpointName: string
    url: string
ServiceEndpointGitHubEnterprise Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The ServiceEndpointGitHubEnterprise resource accepts the following input properties:
- AuthPersonal Pulumi.Azure Dev Ops. Inputs. Service Endpoint Git Hub Enterprise Auth Personal 
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- ProjectId string
- The ID of the project.
- ServiceEndpoint stringName 
- The Service Endpoint name.
- Url string
- GitHub Enterprise Server Url.
- Description string
- AuthPersonal ServiceEndpoint Git Hub Enterprise Auth Personal Args 
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- ProjectId string
- The ID of the project.
- ServiceEndpoint stringName 
- The Service Endpoint name.
- Url string
- GitHub Enterprise Server Url.
- Description string
- authPersonal ServiceEndpoint Git Hub Enterprise Auth Personal 
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- projectId String
- The ID of the project.
- serviceEndpoint StringName 
- The Service Endpoint name.
- url String
- GitHub Enterprise Server Url.
- description String
- authPersonal ServiceEndpoint Git Hub Enterprise Auth Personal 
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- projectId string
- The ID of the project.
- serviceEndpoint stringName 
- The Service Endpoint name.
- url string
- GitHub Enterprise Server Url.
- description string
- auth_personal ServiceEndpoint Git Hub Enterprise Auth Personal Args 
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- project_id str
- The ID of the project.
- service_endpoint_ strname 
- The Service Endpoint name.
- url str
- GitHub Enterprise Server Url.
- description str
- authPersonal Property Map
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- projectId String
- The ID of the project.
- serviceEndpoint StringName 
- The Service Endpoint name.
- url String
- GitHub Enterprise Server Url.
- description String
Outputs
All input properties are implicitly available as output properties. Additionally, the ServiceEndpointGitHubEnterprise resource produces the following output properties:
- Dictionary<string, string>
- Id string
- The provider-assigned unique ID for this managed resource.
- map[string]string
- Id string
- The provider-assigned unique ID for this managed resource.
- Map<String,String>
- id String
- The provider-assigned unique ID for this managed resource.
- {[key: string]: string}
- id string
- The provider-assigned unique ID for this managed resource.
- Mapping[str, str]
- id str
- The provider-assigned unique ID for this managed resource.
- Map<String>
- id String
- The provider-assigned unique ID for this managed resource.
Look up Existing ServiceEndpointGitHubEnterprise Resource
Get an existing ServiceEndpointGitHubEnterprise 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?: ServiceEndpointGitHubEnterpriseState, opts?: CustomResourceOptions): ServiceEndpointGitHubEnterprise@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        auth_personal: Optional[ServiceEndpointGitHubEnterpriseAuthPersonalArgs] = None,
        authorization: Optional[Mapping[str, str]] = None,
        description: Optional[str] = None,
        project_id: Optional[str] = None,
        service_endpoint_name: Optional[str] = None,
        url: Optional[str] = None) -> ServiceEndpointGitHubEnterprisefunc GetServiceEndpointGitHubEnterprise(ctx *Context, name string, id IDInput, state *ServiceEndpointGitHubEnterpriseState, opts ...ResourceOption) (*ServiceEndpointGitHubEnterprise, error)public static ServiceEndpointGitHubEnterprise Get(string name, Input<string> id, ServiceEndpointGitHubEnterpriseState? state, CustomResourceOptions? opts = null)public static ServiceEndpointGitHubEnterprise get(String name, Output<String> id, ServiceEndpointGitHubEnterpriseState state, CustomResourceOptions options)resources:  _:    type: azuredevops:ServiceEndpointGitHubEnterprise    get:      id: ${id}- 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.
- 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.
- AuthPersonal Pulumi.Azure Dev Ops. Inputs. Service Endpoint Git Hub Enterprise Auth Personal 
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- Dictionary<string, string>
- Description string
- ProjectId string
- The ID of the project.
- ServiceEndpoint stringName 
- The Service Endpoint name.
- Url string
- GitHub Enterprise Server Url.
- AuthPersonal ServiceEndpoint Git Hub Enterprise Auth Personal Args 
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- map[string]string
- Description string
- ProjectId string
- The ID of the project.
- ServiceEndpoint stringName 
- The Service Endpoint name.
- Url string
- GitHub Enterprise Server Url.
- authPersonal ServiceEndpoint Git Hub Enterprise Auth Personal 
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- Map<String,String>
- description String
- projectId String
- The ID of the project.
- serviceEndpoint StringName 
- The Service Endpoint name.
- url String
- GitHub Enterprise Server Url.
- authPersonal ServiceEndpoint Git Hub Enterprise Auth Personal 
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- {[key: string]: string}
- description string
- projectId string
- The ID of the project.
- serviceEndpoint stringName 
- The Service Endpoint name.
- url string
- GitHub Enterprise Server Url.
- auth_personal ServiceEndpoint Git Hub Enterprise Auth Personal Args 
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- Mapping[str, str]
- description str
- project_id str
- The ID of the project.
- service_endpoint_ strname 
- The Service Endpoint name.
- url str
- GitHub Enterprise Server Url.
- authPersonal Property Map
- An auth_personalblock as documented below. Allows connecting using a personal access token.
- Map<String>
- description String
- projectId String
- The ID of the project.
- serviceEndpoint StringName 
- The Service Endpoint name.
- url String
- GitHub Enterprise Server Url.
Supporting Types
ServiceEndpointGitHubEnterpriseAuthPersonal, ServiceEndpointGitHubEnterpriseAuthPersonalArgs              
- PersonalAccess stringToken 
- The Personal Access Token for GitHub.
- PersonalAccess stringToken 
- The Personal Access Token for GitHub.
- personalAccess StringToken 
- The Personal Access Token for GitHub.
- personalAccess stringToken 
- The Personal Access Token for GitHub.
- personal_access_ strtoken 
- The Personal Access Token for GitHub.
- personalAccess StringToken 
- The Personal Access Token for GitHub.
Import
Azure DevOps GitHub Enterprise Server Service Endpoint can be imported using projectID/serviceEndpointID or projectName/serviceEndpointID
$ pulumi import azuredevops:index/serviceEndpointGitHubEnterprise:ServiceEndpointGitHubEnterprise example 00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000000
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure DevOps pulumi/pulumi-azuredevops
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the azuredevopsTerraform Provider.