Endpoints - Create

Service:: Service Endpoint

API Version:: 7.1

Creates a new service endpoint

POST https://dev.azure.com/{organization}/_apis/serviceendpoint/endpoints?api-version=7.1

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
api-version	query	True	string	Version of the API to use. This should be set to '7.1' to use this version of the api.

Request Body

Name	Type	Description
administratorsGroup	IdentityRef	This is a deprecated field.
authorization	EndpointAuthorization	Gets or sets the authorization data for talking to the endpoint.
createdBy	IdentityRef	Gets or sets the identity reference for the user who created the Service endpoint.
data	object
description	string	Gets or sets the description of endpoint.
groupScopeId	string (uuid)	This is a deprecated field.
id	string (uuid)	Gets or sets the identifier of this endpoint.
isReady	boolean	EndPoint state indicator
isShared	boolean	Indicates whether service endpoint is shared with other projects or not.
name	string	Gets or sets the friendly name of the endpoint.
operationStatus	JObject	Error message during creation/deletion of endpoint
owner	string	Owner of the endpoint Supported values are "library", "agentcloud"
readersGroup	IdentityRef	Gets or sets the identity reference for the readers group of the service endpoint.
serviceEndpointProjectReferences	ServiceEndpointProjectReference[]	All other project references where the service endpoint is shared.
type	string	Gets or sets the type of the endpoint.
url	string	Gets or sets the url of the endpoint.

Responses

Name	Type	Description
200 OK	ServiceEndpoint	successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name	Description
vso.serviceendpoint_manage	Grants the ability to read, query and manage service endpoints.

Examples

Create Azure RM service endpoint

Create service endpoint

Create Azure RM service endpoint

Sample request

HTTP

POST https://dev.azure.com/{organization}/_apis/serviceendpoint/endpoints?api-version=7.1

{
  "data": {
    "subscriptionId": "1272a66f-e2e8-4e88-ab43-487409186c3f",
    "subscriptionName": "subscriptionName",
    "environment": "AzureCloud",
    "scopeLevel": "Subscription",
    "creationMode": "Manual"
  },
  "name": "MyNewARMServiceEndpoint",
  "type": "AzureRM",
  "url": "https://management.azure.com/",
  "authorization": {
    "parameters": {
      "tenantid": "1272a66f-e2e8-4e88-ab43-487409186c3f",
      "serviceprincipalid": "1272a66f-e2e8-4e88-ab43-487409186c3f",
      "authenticationType": "spnKey",
      "serviceprincipalkey": "SomePassword"
    },
    "scheme": "ServicePrincipal"
  },
  "isShared": false,
  "isReady": true,
  "serviceEndpointProjectReferences": [
    {
      "projectReference": {
        "id": "c7e5f0b3-71fa-4429-9fb3-3321963a7c06",
        "name": "TestProject"
      },
      "name": "MyNewARMServiceEndpoint"
    }
  ]
}

Sample response

Status code:: 200

{
  "data": {
    "subscriptionId": "1272a66f-e2e8-4e88-ab43-487409186c3f",
    "subscriptionName": "subscriptionName",
    "environment": "AzureCloud",
    "scopeLevel": "Subscription",
    "creationMode": "Manual"
  },
  "id": "1dfdea68-9549-409e-abee-c5da69cfec5f",
  "name": "MyNewARMServiceEndpoint",
  "type": "AzureRM",
  "url": "https://management.azure.com/",
  "createdBy": {
    "displayName": "Chuck Reinhart",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e18a1f0a-b112-67fd-a9e0-e3bb081da49e",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
      }
    },
    "id": "e18a1f0a-b112-67fd-a9e0-e3bb081da49e",
    "uniqueName": "anpuri@outlook-int.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll",
    "descriptor": "msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
  },
  "authorization": {
    "parameters": {
      "tenantid": "1272a66f-e2e8-4e88-ab43-487409186c3f",
      "serviceprincipalid": "1272a66f-e2e8-4e88-ab43-487409186c3f",
      "authenticationType": "spnKey",
      "serviceprincipalkey": null
    },
    "scheme": "ServicePrincipal"
  },
  "isShared": false,
  "isReady": true,
  "owner": "library",
  "serviceEndpointProjectReferences": [
    {
      "projectReference": {
        "id": "c7e5f0b3-71fa-4429-9fb3-3321963a7c06",
        "name": "TestProject"
      },
      "name": "MyNewARMServiceEndpoint"
    }
  ]
}

Create service endpoint

Sample request

HTTP

POST https://dev.azure.com/{organization}/_apis/serviceendpoint/endpoints?api-version=7.1

{
  "data": {},
  "name": "MyNewServiceEndpoint",
  "type": "Generic",
  "url": "https://myserver",
  "authorization": {
    "parameters": {
      "username": "myusername",
      "password": "mysecretpassword"
    },
    "scheme": "UsernamePassword"
  },
  "isShared": false,
  "isReady": true,
  "serviceEndpointProjectReferences": [
    {
      "projectReference": {
        "id": "c7e5f0b3-71fa-4429-9fb3-3321963a7c06",
        "name": "TestProject"
      },
      "name": "MyNewServiceEndpoint"
    }
  ]
}

Sample response

Status code:: 200

{
  "data": {},
  "id": "5e47a0d8-c745-44f8-8f93-784f18ff31c4",
  "name": "MyNewServiceEndpoint",
  "type": "Generic",
  "url": "https://myserver",
  "createdBy": {
    "displayName": "Chuck Reinhart",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e18a1f0a-b112-67fd-a9e0-e3bb081da49e",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
      }
    },
    "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
    "uniqueName": "fabfiber@outlook.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll",
    "descriptor": "msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
  },
  "authorization": {
    "parameters": {
      "username": "myusername",
      "password": null
    },
    "scheme": "UsernamePassword"
  },
  "isShared": false,
  "isReady": true,
  "owner": "library",
  "serviceEndpointProjectReferences": [
    {
      "projectReference": {
        "id": "c7e5f0b3-71fa-4429-9fb3-3321963a7c06",
        "name": "TestProject"
      },
      "name": "MyNewServiceEndpoint"
    }
  ]
}

Definitions

Name	Description
EndpointAuthorization	Represents the authorization used for service endpoint.
IdentityRef
JObject	Represents a JSON object.
JToken	Represents an abstract JSON token.
ProjectReference
ReferenceLinks	The class to represent a collection of REST reference links.
ServiceEndpoint	Represents an endpoint which may be used by an orchestration job.
ServiceEndpointProjectReference

EndpointAuthorization

Object

Represents the authorization used for service endpoint.

Name	Type	Description
parameters	object	Gets or sets the parameters for the selected authorization scheme.
scheme	string	Gets or sets the scheme used for service endpoint authentication.

IdentityRef

Object

Name	Type	Description
_links	ReferenceLinks	This field contains zero or more interesting links about the graph subject. These links may be invoked to obtain additional relationships or more detailed information about this graph subject.
descriptor	string	The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.
directoryAlias	string	Deprecated - Can be retrieved by querying the Graph user referenced in the "self" entry of the IdentityRef "_links" dictionary
displayName	string	This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.
id	string
imageUrl	string	Deprecated - Available in the "avatar" entry of the IdentityRef "_links" dictionary
inactive	boolean	Deprecated - Can be retrieved by querying the Graph membership state referenced in the "membershipState" entry of the GraphUser "_links" dictionary
isAadIdentity	boolean	Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Deprecated - not in use in most preexisting implementations of ToIdentityRef
uniqueName	string	Deprecated - use Domain+PrincipalName instead
url	string	This url is the full route to the source resource of this graph subject.

JObject

Object

Represents a JSON object.

Name	Type	Description
item	JToken	Represents an abstract JSON token.
type	string (JTokenType)	Gets the node type for this JToken.

JToken

Object

Represents an abstract JSON token.

Name	Type	Description
first	JToken	Get the first child token of this token.
hasValues	boolean	Gets a value indicating whether this token has child tokens.
item	JToken	Represents an abstract JSON token.
last	JToken	Get the last child token of this token.
next	JToken	Gets the next sibling token of this node.
parent	string (JContainer)	Gets or sets the parent.
path	string	Gets the path of the JSON token.
previous	JToken	Gets the previous sibling token of this node.
root	JToken	Gets the root JToken of this JToken.
type	string (JTokenType)	Gets the node type for this JToken.

ProjectReference

Object

Name	Type	Description
id	string (uuid)
name	string

ReferenceLinks

Object

The class to represent a collection of REST reference links.

Name	Type	Description
links	object	The readonly view of the links. Because Reference links are readonly, we only want to expose them as read only.

ServiceEndpoint

Object

Represents an endpoint which may be used by an orchestration job.

Name	Type	Description
administratorsGroup	IdentityRef	This is a deprecated field.
authorization	EndpointAuthorization	Gets or sets the authorization data for talking to the endpoint.
createdBy	IdentityRef	Gets or sets the identity reference for the user who created the Service endpoint.
data	object
description	string	Gets or sets the description of endpoint.
groupScopeId	string (uuid)	This is a deprecated field.
id	string (uuid)	Gets or sets the identifier of this endpoint.
isReady	boolean	EndPoint state indicator
isShared	boolean	Indicates whether service endpoint is shared with other projects or not.
name	string	Gets or sets the friendly name of the endpoint.
operationStatus	JObject	Error message during creation/deletion of endpoint
owner	string	Owner of the endpoint Supported values are "library", "agentcloud"
readersGroup	IdentityRef	Gets or sets the identity reference for the readers group of the service endpoint.
serviceEndpointProjectReferences	ServiceEndpointProjectReference[]	All other project references where the service endpoint is shared.
type	string	Gets or sets the type of the endpoint.
url	string	Gets or sets the url of the endpoint.

ServiceEndpointProjectReference

Object

Name	Type	Description
description	string	Gets or sets description of the service endpoint.
name	string	Gets or sets name of the service endpoint.
projectReference	ProjectReference	Gets or sets project reference of the service endpoint.

Share via

Endpoints - Create

URI Parameters

Request Body

Responses

Security

oauth2

Scopes

Examples

Create Azure RM service endpoint

Sample request

Sample response

Create service endpoint

Sample request

Sample response

Definitions

EndpointAuthorization

IdentityRef

JObject

JToken

ProjectReference

ReferenceLinks

ServiceEndpoint

ServiceEndpointProjectReference