Endpoints - Get Service Endpoints By Names

Referensi

Service:: Service Endpoint

API Version:: 7.1-preview.4

Dapatkan titik akhir layanan berdasarkan nama.

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

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/serviceendpoint/endpoints?endpointNames={endpointNames}&type={type}&authSchemes={authSchemes}&owner={owner}&includeFailed={includeFailed}&includeDetails={includeDetails}&api-version=7.1-preview.4

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
organization	path	True	string	Nama organisasi Azure DevOps.
project	path	True	string	ID proyek atau nama proyek
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.4' untuk menggunakan versi api ini.
endpointNames	query	True	string array (string)	Nama titik akhir layanan.
authSchemes	query		string array (string)	Skema otorisasi yang digunakan untuk titik akhir layanan.
includeDetails	query		boolean	Bendera untuk menyertakan detail selengkapnya untuk titik akhir layanan. Ini hanya untuk penggunaan internal dan bendera akan diperlakukan sebagai false untuk semua permintaan lainnya
includeFailed	query		boolean	Bendera gagal untuk titik akhir layanan.
owner	query		string	Pemilik untuk titik akhir layanan.
type	query		string	Jenis titik akhir layanan.

Respons

Nama	Jenis	Deskripsi
200 OK	ServiceEndpoint[]	operasi berhasil

Keamanan

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

Nama	Deskripsi
vso.serviceendpoint	Memberikan kemampuan untuk membaca titik akhir layanan.

Contoh

Get service endpoints by names

Sample Request

HTTP

GET https://dev.azure.com/{organization}/{project}/_apis/serviceendpoint/endpoints?endpointNames=MyNewServiceEndpoint&api-version=7.1-preview.4

Sample Response

Status code:: 200

{
  "count": 1,
  "value": [
    {
      "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": "e18a1f0a-b112-67fd-a9e0-e3bb081da49e",
        "uniqueName": "fabfiber@outlook.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll",
        "descriptor": "msa.ZTE4YTFmMGEtYjExMi03N2ZkLWE5ZTAtZTNiYjA4MWRhNDll"
      },
      "description": "",
      "authorization": {
        "parameters": {
          "username": "myusername"
        },
        "scheme": "UsernamePassword"
      },
      "isShared": false,
      "isReady": true,
      "owner": "Library",
      "serviceEndpointProjectReferences": [
        {
          "projectReference": {
            "id": "c7e5f0b3-71fa-4429-9fb3-3321963a7c06",
            "name": "TestProject"
          },
          "name": "MyNewServiceEndpoint"
        }
      ]
    }
  ]
}

Definisi

Nama	Deskripsi
EndpointAuthorization	Mewakili otorisasi yang digunakan untuk titik akhir layanan.
IdentityRef
JObject	Mewakili objek JSON.
JToken	Mewakili token JSON abstrak.
ProjectReference
ReferenceLinks	Kelas untuk mewakili kumpulan tautan referensi REST.
ServiceEndpoint	Mewakili titik akhir yang dapat digunakan oleh pekerjaan orkestrasi.
ServiceEndpointProjectReference

EndpointAuthorization

Mewakili otorisasi yang digunakan untuk titik akhir layanan.

Nama	Jenis	Deskripsi
parameters	object	Mendapatkan atau mengatur parameter untuk skema otorisasi yang dipilih.
scheme	string	Mendapatkan atau mengatur skema yang digunakan untuk autentikasi titik akhir layanan.

IdentityRef

Nama	Jenis	Deskripsi
_links	ReferenceLinks	Bidang ini berisi nol atau lebih tautan menarik tentang subjek grafik. Tautan ini dapat dipanggil untuk mendapatkan hubungan tambahan atau informasi lebih rinci tentang subjek grafik ini.
descriptor	string	Deskriptor adalah cara utama untuk mereferensikan subjek grafik saat sistem berjalan. Bidang ini akan secara unik mengidentifikasi subjek grafik yang sama di seluruh Akun dan Organisasi.
directoryAlias	string	Tidak digunakan lagi - Dapat diambil dengan mengkueri pengguna Graph yang direferensikan dalam entri "mandiri" kamus IdentityRef "_links"
displayName	string	Ini adalah nama tampilan subjek grafik yang tidak unik. Untuk mengubah bidang ini, Anda harus mengubah nilainya di penyedia sumber.
id	string
imageUrl	string	Tidak digunakan lagi - Tersedia dalam entri "avatar" kamus IdentityRef "_links"
inactive	boolean	Tidak digunakan lagi - Dapat diambil dengan mengkueri status keanggotaan Graph yang direferensikan dalam entri "membershipState" dari kamus "_links" GraphUser
isAadIdentity	boolean	Tidak digunakan lagi - Dapat disimpulkan dari jenis subjek deskriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Tidak digunakan lagi - Dapat disimpulkan dari jenis subjek deskriptor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Tidak digunakan lagi - tidak digunakan dalam sebagian besar implementasi ToIdentityRef yang sudah ada sebelumnya
uniqueName	string	Tidak digunakan lagi - gunakan Domain+PrincipalName sebagai gantinya
url	string	Url ini adalah rute lengkap ke sumber daya sumber subjek grafik ini.

JObject

Mewakili objek JSON.

Nama	Jenis	Deskripsi
item	JToken	Mewakili token JSON abstrak.
type	string	Mendapatkan jenis node untuk JToken ini.

JToken

Mewakili token JSON abstrak.

Nama	Jenis	Deskripsi
first	JToken	Dapatkan token anak pertama dari token ini.
hasValues	boolean	Mendapatkan nilai yang menunjukkan apakah token ini memiliki token anak.
item	JToken	Mewakili token JSON abstrak.
last	JToken	Dapatkan token anak terakhir dari token ini.
next	JToken	Mendapatkan token saudara kandung berikutnya dari simpul ini.
parent	string	Mendapatkan atau mengatur induk.
path	string	Mendapatkan jalur token JSON.
previous	JToken	Mendapatkan token saudara kandung sebelumnya dari simpul ini.
root	JToken	Mendapatkan JToken akar dari JToken ini.
type	string	Mendapatkan jenis node untuk JToken ini.

ProjectReference

Nama	Jenis	Deskripsi
id	string
name	string

ReferenceLinks

Kelas untuk mewakili kumpulan tautan referensi REST.

Nama	Jenis	Deskripsi
links	object	Tampilan baca-saja dari tautan. Karena tautan Referensi bersifat baca-saja, kami hanya ingin mengeksposnya sebagai baca saja.

ServiceEndpoint

Mewakili titik akhir yang dapat digunakan oleh pekerjaan orkestrasi.

Nama	Jenis	Deskripsi
administratorsGroup	IdentityRef	Ini adalah bidang yang tidak digunakan lagi.
authorization	EndpointAuthorization	Mendapatkan atau mengatur data otorisasi untuk berbicara dengan titik akhir.
createdBy	IdentityRef	Mendapatkan atau mengatur referensi identitas untuk pengguna yang membuat titik akhir Layanan.
data	object
description	string	Mendapatkan atau mengatur deskripsi titik akhir.
groupScopeId	string	Ini adalah bidang yang tidak digunakan lagi.
id	string	Mendapatkan atau mengatur pengidentifikasi titik akhir ini.
isReady	boolean	Indikator status Titik Akhir
isShared	boolean	Menunjukkan apakah titik akhir layanan dibagikan dengan proyek lain atau tidak.
name	string	Mendapatkan atau mengatur nama titik akhir yang mudah diingat.
operationStatus	JObject	Pesan kesalahan selama pembuatan/penghapusan titik akhir
owner	string	Pemilik titik akhir Nilai yang didukung adalah "library", "agentcloud"
readersGroup	IdentityRef	Mendapatkan atau mengatur referensi identitas untuk grup pembaca titik akhir layanan.
serviceEndpointProjectReferences	ServiceEndpointProjectReference[]	Semua referensi proyek lainnya tempat titik akhir layanan dibagikan.
type	string	Mendapatkan atau mengatur jenis titik akhir.
url	string	Mendapatkan atau mengatur url titik akhir.

ServiceEndpointProjectReference

Nama	Jenis	Deskripsi
description	string	Mendapatkan atau menetapkan deskripsi titik akhir layanan.
name	string	Mendapatkan atau menetapkan nama titik akhir layanan.
projectReference	ProjectReference	Mendapatkan atau mengatur referensi proyek titik akhir layanan.

Bagikan melalui