共用方式為


Endpoints - Create

建立新的服務端點

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

URI 參數

名稱 位於 必要 類型 Description
organization
path True

string

Azure DevOps 組織的名稱。

api-version
query True

string

要使用的 API 版本。 這應該設定為 '7.1-preview.4',以使用此版本的 API。

要求本文

名稱 類型 Description
administratorsGroup

IdentityRef

這是已被取代的欄位。

authorization

EndpointAuthorization

取得或設定與端點通訊的授權資料。

createdBy

IdentityRef

取得或設定建立服務端點之使用者的身分識別參考。

data

object

description

string

取得或設定端點的描述。

groupScopeId

string

這是已被取代的欄位。

id

string

取得或設定這個端點的識別碼。

isReady

boolean

EndPoint 狀態指示器

isShared

boolean

指出服務端點是否與其他專案共用。

name

string

取得或設定端點的易記名稱。

operationStatus

JObject

建立/刪除端點期間發生錯誤訊息

owner

string

端點的擁有者支援值為 「library」、「agentcloud」

readersGroup

IdentityRef

取得或設定服務端點讀取器群組的識別參考。

serviceEndpointProjectReferences

ServiceEndpointProjectReference[]

共用服務端點的所有其他專案參考。

type

string

取得或設定端點的類型。

url

string

取得或設定端點的 URL。

回應

名稱 類型 Description
200 OK

ServiceEndpoint

成功的作業

安全性

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

名稱 Description
vso.serviceendpoint_manage 授與讀取、查詢及管理服務端點的能力。

範例

Create Azure RM service endpoint
Create service endpoint

Create Azure RM service endpoint

Sample Request

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

{
  "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

{
  "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

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

{
  "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

{
  "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"
    }
  ]
}

定義

名稱 Description
EndpointAuthorization

表示用於服務端點的授權。

IdentityRef
JObject

表示 JSON 物件。

JToken

表示抽象 JSON 權杖。

ProjectReference
ReferenceLinks

表示 REST 參考連結集合的類別。

ServiceEndpoint

表示協調流程作業可能使用的端點。

ServiceEndpointProjectReference

EndpointAuthorization

表示用於服務端點的授權。

名稱 類型 Description
parameters

object

取得或設定所選授權配置的參數。

scheme

string

取得或設定用於服務端點驗證的配置。

IdentityRef

名稱 類型 Description
_links

ReferenceLinks

此欄位包含有關圖表主旨的零個或多個有趣連結。 您可以叫用這些連結來取得其他關聯性,或取得此圖表主體的詳細資訊。

descriptor

string

描述項是在系統執行時參考圖形主旨的主要方式。 此欄位可唯一識別帳戶和組織之間的相同圖表主旨。

directoryAlias

string

已淘汰 - 藉由查詢 IdentityRef 「_links」 字典之 「self」 專案中參考的 Graph 使用者,即可擷取

displayName

string

這是圖表主旨的非唯一顯示名稱。 若要變更此欄位,您必須在來源提供者中變更其值。

id

string

imageUrl

string

已淘汰 - 可在 IdentityRef 「_links」 字典的 「avatar」 專案中使用

inactive

boolean

已淘汰 - 您可以查詢 GraphUser 「_links」 字典的 「membershipState」 專案中參考的 Graph 成員資格狀態來擷取

isAadIdentity

boolean

已被取代 - 可以從描述元的主旨類型推斷 (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

已被取代 - 可以從描述元的主旨類型推斷 (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

已淘汰 - 不在 ToIdentityRef 的大多數既有實作中使用

uniqueName

string

已淘汰 - 請改用 Domain+PrincipalName

url

string

此 URL 是此圖表主體來源資源的完整路由。

JObject

表示 JSON 物件。

名稱 類型 Description
item

JToken

表示抽象 JSON 權杖。

type

string

取得這個 JToken 的節點類型。

JToken

表示抽象 JSON 權杖。

名稱 類型 Description
first

JToken

取得此權杖的第一個子權杖。

hasValues

boolean

取得值,指出這個權杖是否有子權杖。

item

JToken

表示抽象 JSON 權杖。

last

JToken

取得此權杖的最後一個子權杖。

next

JToken

取得這個節點的下一個同層級權杖。

parent

string

取得或設定父系。

path

string

取得 JSON 權杖的路徑。

previous

JToken

取得這個節點的上一個同層級權杖。

root

JToken

取得這個 JToken 的根 JToken。

type

string

取得這個 JToken 的節點類型。

ProjectReference

名稱 類型 Description
id

string

name

string

表示 REST 參考連結集合的類別。

名稱 類型 Description
links

object

連結的唯讀檢視。 因為參考連結是唯讀的,所以我們只想要將它們公開為唯讀。

ServiceEndpoint

表示協調流程作業可能使用的端點。

名稱 類型 Description
administratorsGroup

IdentityRef

這是已被取代的欄位。

authorization

EndpointAuthorization

取得或設定與端點通訊的授權資料。

createdBy

IdentityRef

取得或設定建立服務端點之使用者的身分識別參考。

data

object

description

string

取得或設定端點的描述。

groupScopeId

string

這是已被取代的欄位。

id

string

取得或設定這個端點的識別碼。

isReady

boolean

EndPoint 狀態指示器

isShared

boolean

指出服務端點是否與其他專案共用。

name

string

取得或設定端點的易記名稱。

operationStatus

JObject

建立/刪除端點期間發生錯誤訊息

owner

string

端點的擁有者支援值為 「library」、「agentcloud」

readersGroup

IdentityRef

取得或設定服務端點讀取器群組的識別參考。

serviceEndpointProjectReferences

ServiceEndpointProjectReference[]

共用服務端點的所有其他專案參考。

type

string

取得或設定端點的類型。

url

string

取得或設定端點的 URL。

ServiceEndpointProjectReference

名稱 類型 Description
description

string

取得或設定服務端點的描述。

name

string

取得或設定服務端點的名稱。

projectReference

ProjectReference

取得或設定服務端點的專案參考。