Endpoints - Get
Dapatkan detail titik akhir layanan.
GET https://dev.azure.com/{organization}/{project}/_apis/serviceendpoint/endpoints/{endpointId}?api-version=7.1-preview.4
GET https://dev.azure.com/{organization}/{project}/_apis/serviceendpoint/endpoints/{endpointId}?actionFilter={actionFilter}&api-version=7.1-preview.4
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
endpoint
|
path | True |
string uuid |
Id titik akhir layanan. |
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. |
action
|
query |
Filter tindakan untuk koneksi layanan. Ini menentukan tindakan yang dapat dilakukan pada koneksi layanan. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
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 endpoint details
Sample Request
GET https://dev.azure.com/{organization}/{project}/_apis/serviceendpoint/endpoints/{endpointId}?api-version=7.1-preview.4
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": "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",
"password": null
},
"scheme": "UsernamePassword"
},
"isShared": false,
"isReady": true,
"owner": "Library",
"serviceEndpointProjectReferences": [
{
"projectReference": {
"id": "c7e5f0b3-71fa-4429-9fb3-3321963a7c06",
"name": "TestProject"
},
"name": "MyNewServiceEndpoint"
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Endpoint |
Mewakili otorisasi yang digunakan untuk titik akhir layanan. |
Identity |
|
JObject |
Mewakili objek JSON. |
JToken |
Mewakili token JSON abstrak. |
Project |
|
Reference |
Kelas untuk mewakili kumpulan tautan referensi REST. |
Service |
Mewakili titik akhir yang dapat digunakan oleh pekerjaan orkestrasi. |
Service |
Filter tindakan untuk koneksi layanan. Ini menentukan tindakan yang dapat dilakukan pada koneksi layanan. |
Service |
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 |
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 mengidentifikasi subjek grafik yang sama secara unik 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" 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 |
Mewakili token JSON abstrak. |
|
type |
string |
Mendapatkan jenis node untuk JToken ini. |
JToken
Mewakili token JSON abstrak.
Nama | Jenis | Deskripsi |
---|---|---|
first |
Dapatkan token anak pertama dari token ini. |
|
hasValues |
boolean |
Mendapatkan nilai yang menunjukkan apakah token ini memiliki token anak. |
item |
Mewakili token JSON abstrak. |
|
last |
Dapatkan token anak terakhir dari token ini. |
|
next |
Mendapatkan token saudara kandung berikutnya dari simpul ini. |
|
parent |
string |
Mendapatkan atau mengatur induk. |
path |
string |
Mendapatkan jalur token JSON. |
previous |
Mendapatkan token saudara kandung sebelumnya dari simpul ini. |
|
root |
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 dibaca saja, kami hanya ingin mengeksposnya sebagai baca-saja. |
ServiceEndpoint
Mewakili titik akhir yang dapat digunakan oleh pekerjaan orkestrasi.
Nama | Jenis | Deskripsi |
---|---|---|
administratorsGroup |
Ini adalah bidang yang tidak digunakan lagi. |
|
authorization |
Mendapatkan atau mengatur data otorisasi untuk berbicara dengan titik akhir. |
|
createdBy |
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 |
Pesan kesalahan selama pembuatan/penghapusan titik akhir |
|
owner |
string |
Pemilik titik akhir Nilai yang didukung adalah "library", "agentcloud" |
readersGroup |
Mendapatkan atau mengatur referensi identitas untuk grup pembaca titik akhir layanan. |
|
serviceEndpointProjectReferences |
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. |
ServiceEndpointActionFilter
Filter tindakan untuk koneksi layanan. Ini menentukan tindakan yang dapat dilakukan pada koneksi layanan.
Nama | Jenis | Deskripsi |
---|---|---|
manage |
string |
|
none |
string |
|
use |
string |
|
view |
string |
ServiceEndpointProjectReference
Nama | Jenis | Deskripsi |
---|---|---|
description |
string |
Mendapatkan atau menetapkan deskripsi titik akhir layanan. |
name |
string |
Mendapatkan atau menetapkan nama titik akhir layanan. |
projectReference |
Mendapatkan atau mengatur referensi proyek titik akhir layanan. |