Connections - List Connections

บริการ:: Admin

เวอร์ชัน API:: v1

แสดงรายการของการเชื่อมต่อในผู้เช่า

Note

Fabric การจัดการการเชื่อมต่อผู้ดูแลผู้เช่าอยู่ในการแสดงตัวอย่าง (เรียนรู้เพิ่มเติม)

Permissions

ผู้เรียกต้องเป็นผู้ดูแลระบบ Fabric หรือรับรองความถูกต้องโดยใช้โครงร่างสําคัญของบริการ

จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์

Tenant.Read.All หรือ Tenant.ReadWrite.All

Limitations

ไม่มี

Microsoft Entra ข้อมูลประจําตัวที่ได้รับการสนับสนุน

API นี้สนับสนุน Microsoft identitiesที่ระบุในส่วนนี้

Identity	การสนับสนุน
ผู้ใช้	ใช่
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ	ใช่

Interface

GET https://api.fabric.microsoft.com/v1/admin/connections

ด้วยพารามิเตอร์ที่เลือกได้:

GET https://api.fabric.microsoft.com/v1/admin/connections?continuationToken={continuationToken}

พารามิเตอร์ URI

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
continuationToken	query		string	โทเค็นสําหรับการเรียกใช้หน้าถัดไปของผลลัพธ์

การตอบสนอง

ชื่อ พิมพ์ คำอธิบาย

200 OK

ชื่อ	พิมพ์	คำอธิบาย
200 OK	ListConnectionsResponse	ตกลง, ได้ การดําเนินการสําเร็จ
429 Too Many Requests	ErrorResponse	เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ `Retry-After` ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม ส่วนหัว Retry-After: integer
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: ไม่ได้รับอนุญาต - ผู้เรียกไม่มีสิทธิ์ในการเรียกใช้ API InternalServerError - ข้อผิดพลาดเซิร์ฟเวอร์ที่ไม่คาดคิด

ListConnectionsResponse

ตกลง, ได้ การดําเนินการสําเร็จ

429 Too Many Requests

ErrorResponse

เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ Retry-After ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม

ส่วนหัว

Retry-After: integer

Other Status Codes

ErrorResponse

รหัสข้อผิดพลาดทั่วไป:

ไม่ได้รับอนุญาต - ผู้เรียกไม่มีสิทธิ์ในการเรียกใช้ API
InternalServerError - ข้อผิดพลาดเซิร์ฟเวอร์ที่ไม่คาดคิด

ตัวอย่าง

List connections as admin example

คำขอตัวอย่าง

HTTP

GET https://api.fabric.microsoft.com/v1/admin/connections

คำตอบตัวอย่าง

รหัสสถานะ:: 200

{
  "value": [
    {
      "id": "6952a7b2-aea3-414f-9d85-6c0fe5d34539",
      "displayName": "ContosoConnection1",
      "gatewayId": "8f72eea3-d989-4a5a-aeed-02b3aaa2ddd0",
      "connectivityType": "ShareableCloud",
      "connectionDetails": {
        "type": "Web",
        "path": "https://www.contoso.com"
      },
      "privacyLevel": "Public",
      "credentialDetails": {
        "credentialType": "Anonymous",
        "singleSignOnType": "None",
        "connectionEncryption": "NotEncrypted",
        "skipTestConnection": false
      },
      "connectionRecency": {
        "createdDateTime": "2023-05-23T16:22:20Z",
        "lastBoundDateTime": "2023-05-26T16:22:20Z",
        "lastCredentialUsedDateTime": "2023-05-27T16:22:20Z",
        "myLastBoundDateTime": "2023-05-24T16:22:20Z",
        "myLastCredentialUsedDateTime": "2023-05-25T16:22:20Z"
      }
    },
    {
      "id": "f6a39b76-9816-4e4b-b93a-f42e405017b7",
      "displayName": "ContosoConnection2",
      "gatewayId": "58376c10-5f61-4024-887e-748df4beae45",
      "connectivityType": "OnPremisesGateway",
      "connectionDetails": {
        "type": "SQL",
        "path": "contoso.database.windows.net;sales"
      },
      "privacyLevel": "Organizational",
      "credentialDetails": {
        "credentialType": "Basic",
        "singleSignOnType": "None",
        "connectionEncryption": "Any",
        "skipTestConnection": false
      },
      "connectionRecency": {
        "createdDateTime": "2023-05-23T16:22:20Z",
        "lastBoundDateTime": "2023-05-26T16:22:20Z",
        "lastCredentialUsedDateTime": "2023-05-27T16:22:20Z",
        "myLastBoundDateTime": "2023-05-24T16:22:20Z",
        "myLastCredentialUsedDateTime": "2023-05-25T16:22:20Z"
      }
    },
    {
      "id": "a3b4c5d6-7e8f-4a5b-9c0d-1e2f3a4b5c6d",
      "displayName": "ContosoStreamingVirtualNetworkGatewayConnection",
      "gatewayId": "3f8d6a4b-1c2e-4f5a-9b7c-2d6e8f1a3b9d",
      "connectivityType": "StreamingVirtualNetworkGateway",
      "connectionDetails": {
        "type": "SQL",
        "path": "contoso.database.windows.net;marketing"
      },
      "privacyLevel": "Organizational",
      "credentialDetails": {
        "credentialType": "Basic",
        "singleSignOnType": "None",
        "connectionEncryption": "Encrypted",
        "skipTestConnection": false
      }
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/connections?continuationToken=LDEsMTAwMDAwLDA%3D"
}

คำจำกัดความ

ชื่อ	คำอธิบาย
ConnectionEncryption	ชนิดการเข้ารหัสลับการเชื่อมต่อของการเชื่อมต่อ อาจมีการเพิ่มค่าการเข้ารหัสลับการเชื่อมต่อเพิ่มเติมเมื่อเวลาผ่านไป
ConnectionRecency	แสดงรายละเอียดเงินคืนเกี่ยวกับการเชื่อมต่อ
ConnectionRole	บทบาทการเชื่อมต่อ บทบาทการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
ConnectivityType	ชนิดการเชื่อมต่อของการเชื่อมต่อ ประเภทการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
CredentialType	ชนิดข้อมูลประจําตัวของการเชื่อมต่อ อาจมีการเพิ่มชนิดข้อมูลประจําตัวเพิ่มเติมเมื่อเวลาผ่านไป
ErrorParameter	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
ListConnectionDetails	รายละเอียดการเชื่อมต่อผลลัพธ์สําหรับการดําเนินการรายการ
ListConnectionsResponse
ListCredentialDetails	รายละเอียดข้อมูลประจําตัวส่งกลับเมื่อดึงข้อมูลการเชื่อมต่อ
OnPremisesGatewayConnection	การเชื่อมต่อที่เชื่อมต่อผ่านเกตเวย์ข้อมูลภายในองค์กร
OnPremisesGatewayPersonalConnection	การเชื่อมต่อที่เชื่อมต่อผ่านเกตเวย์ข้อมูลภายในองค์กรส่วนบุคคล
PersonalCloudConnection	การเชื่อมต่อที่เชื่อมต่อผ่านระบบคลาวด์และไม่สามารถแชร์ได้
PrivacyLevel	การตั้งค่าระดับความเป็นส่วนตัวของการเชื่อมต่อ อาจมีการเพิ่มระดับความเป็นส่วนตัวเพิ่มเติมเมื่อเวลาผ่านไป
ShareableCloudConnection	การเชื่อมต่อที่เชื่อมต่อผ่านระบบคลาวด์
SingleSignOnType	ชนิดการลงชื่อเข้าระบบครั้งเดียวของการเชื่อมต่อ อาจมีการเพิ่มการลงชื่อเข้าระบบครั้งเดียวเพิ่มเติมเมื่อเวลาผ่านไป
StreamingVirtualNetworkGatewayConnection	การเชื่อมต่อที่เชื่อมต่อผ่านเกตเวย์ข้อมูลเครือข่ายเสมือนการสตรีม
VirtualNetworkGatewayConnection	การเชื่อมต่อที่เชื่อมต่อผ่านเกตเวย์ข้อมูลเครือข่ายเสมือน

ConnectionEncryption

การแจงนับ

ชนิดการเข้ารหัสลับการเชื่อมต่อของการเชื่อมต่อ อาจมีการเพิ่มค่าการเข้ารหัสลับการเชื่อมต่อเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Encrypted	มีความพยายามในการเชื่อมต่อโดยใช้การเชื่อมต่อที่เข้ารหัสลับ
Any	ความพยายามในการเชื่อมต่อจะทําครั้งแรกโดยใช้การเชื่อมต่อที่เข้ารหัสลับ แล้วถอยกลับไปยังการเชื่อมต่อที่ไม่ได้เข้ารหัสลับถ้าไม่สําเร็จ
NotEncrypted	มีความพยายามในการเชื่อมต่อโดยใช้การเชื่อมต่อที่ไม่ได้เข้ารหัสลับ

ConnectionRecency

วัตถุ

แสดงรายละเอียดเงินคืนเกี่ยวกับการเชื่อมต่อ

ชื่อ	พิมพ์	คำอธิบาย
createdDateTime	string (date-time)	ประทับเวลาเมื่อการเชื่อมต่อถูกสร้างขึ้นใน UTC โดยใช้รูปแบบ YYYY-MM-DDTHH:mm:ssZ
lastBoundDateTime	string (date-time)	ประทับเวลาเมื่อมีการผูกการเชื่อมต่อล่าสุดกับรายการใด ๆ ใน UTC โดยใช้รูปแบบ YYYY-MM-DDTHH:mm:ssZ
lastCredentialUsedDateTime	string (date-time)	ประทับเวลาเมื่อมีการใช้ข้อมูลประจําตัวการเชื่อมต่อล่าสุดใน UTC โดยใช้รูปแบบ YYYY-MM-DDTHH:mm:ssZ
myLastBoundDateTime	string (date-time)	ประทับเวลาเมื่อมีการผูกการเชื่อมต่อไปยังรายการใด ๆ ล่าสุดโดยผู้ใช้ที่เรียกใช้ใน UTC โดยใช้รูปแบบ YYYY-MM-DDTHH:mm:ssZ
myLastCredentialUsedDateTime	string (date-time)	ประทับเวลาเมื่อมีการใช้ข้อมูลประจําตัวการเชื่อมต่อล่าสุดโดยผู้ใช้ที่เรียกใช้ใน UTC โดยใช้รูปแบบ YYYY-MM-DDTHH:mm:ssZ

ConnectionRole

การแจงนับ

บทบาทการเชื่อมต่อ บทบาทการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
User	เปิดใช้งานการเข้าถึงของผู้ใช้สําหรับการเชื่อมต่อ
UserWithReshare	ช่วยให้ผู้ใช้สามารถแชร์การเข้าถึงอีกครั้งสําหรับการเชื่อมต่อได้
Owner	เปิดใช้งานการเข้าถึงความเป็นเจ้าของสําหรับการเชื่อมต่อ
PendingOwner	ความเป็นเจ้าของการเชื่อมต่อยังไม่มีผล หลักต้องอัปเดตข้อมูลประจําตัวการเชื่อมต่อ (โดยใช้ API อัปเดตการเชื่อมต่อ) เพื่อทําให้มีประสิทธิภาพ

ConnectivityType

การแจงนับ

ชนิดการเชื่อมต่อของการเชื่อมต่อ ประเภทการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
ShareableCloud	การเชื่อมต่อเชื่อมต่อผ่านระบบคลาวด์และสามารถแชร์กับผู้อื่นได้
PersonalCloud	การเชื่อมต่อเชื่อมต่อผ่านระบบคลาวด์และไม่สามารถแชร์กับผู้อื่นได้
OnPremisesGateway	การเชื่อมต่อจะเชื่อมต่อผ่านเกตเวย์ข้อมูลภายในองค์กร
OnPremisesGatewayPersonal	การเชื่อมต่อจะเชื่อมต่อผ่านเกตเวย์ข้อมูลภายในองค์กรส่วนบุคคล
VirtualNetworkGateway	การเชื่อมต่อจะเชื่อมต่อผ่านเกตเวย์ข้อมูลเครือข่ายเสมือน
StreamingVirtualNetworkGateway	การเชื่อมต่อจะเชื่อมต่อผ่านเกตเวย์ข้อมูลเครือข่ายเสมือนการสตรีม
Automatic	การเชื่อมต่อเชื่อมต่อผ่านระบบคลาวด์โดยใช้การเชื่อมต่อข้อมูลโดยนัย ตัวเลือกนี้พร้อมใช้งานสําหรับสถานการณ์เฉพาะเช่น แบบจําลองความหมายที่ใช้ Sign-On เดี่ยว (SSO)"
None	การเชื่อมต่อไม่ถูกผูกไว้

CredentialType

การแจงนับ

ชนิดข้อมูลประจําตัวของการเชื่อมต่อ อาจมีการเพิ่มชนิดข้อมูลประจําตัวเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Windows	การเชื่อมต่อใช้การรับรองความถูกต้องของ Windows เพื่อเชื่อมต่อ สนับสนุนเฉพาะเกตเวย์ภายในองค์กรเท่านั้น
Anonymous	การเชื่อมต่อใช้การรับรองความถูกต้องแบบไม่ระบุชื่อเพื่อเชื่อมต่อ
Basic	การเชื่อมต่อใช้การรับรองความถูกต้องพื้นฐานเพื่อเชื่อมต่อ
Key	การเชื่อมต่อใช้การรับรองความถูกต้องคีย์เพื่อเชื่อมต่อ
OAuth2	การเชื่อมต่อใช้การรับรองความถูกต้อง OAuth 2.0 เพื่อเชื่อมต่อ
WindowsWithoutImpersonation	การเชื่อมต่อใช้ Windows (โดยไม่มีตัวเลือกสําหรับการรับรองความถูกต้องเลียนแบบ) เพื่อเชื่อมต่อ สนับสนุนเฉพาะเกตเวย์ภายในองค์กร (โหมดส่วนบุคคล)
SharedAccessSignature	การเชื่อมต่อใช้การรับรองความถูกต้องลายเซ็นการเข้าถึงที่ใช้ร่วมกัน (SAS) เพื่อเชื่อมต่อ
ServicePrincipal	การเชื่อมต่อใช้การรับรองความถูกต้องแบบโครงร่างสําคัญของบริการเพื่อเชื่อมต่อ
WorkspaceIdentity	การเชื่อมต่อใช้การรับรองความถูกต้องข้อมูลประจําตัวของพื้นที่ทํางานเพื่อเชื่อมต่อ
KeyPair	การเชื่อมต่อใช้การตรวจสอบความถูกต้องของการจับคู่คีย์เพื่อเชื่อมต่อ

ErrorParameter

วัตถุ

พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
message	string	คําอธิบายที่มนุษย์สามารถอ่านได้ของความหมายของพารามิเตอร์
name	string	ตัวระบุพารามิเตอร์
value	string	ค่าพารามิเตอร์

ErrorRelatedResource

วัตถุ

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

วัตถุ

การตอบสนองข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
isRetriable	boolean	เมื่อเป็นจริง สามารถลองคําขอใหม่ได้ ใช้ส่วนหัวการตอบสนอง `Retry-After` เพื่อกําหนดความล่าช้า ถ้ามี
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
parameters	ErrorParameter[]	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string (uuid)	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

วัตถุ

รายละเอียดการตอบสนองข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
parameters	ErrorParameter[]	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ListConnectionDetails

วัตถุ

รายละเอียดการเชื่อมต่อผลลัพธ์สําหรับการดําเนินการรายการ

ชื่อ	พิมพ์	คำอธิบาย
path	string	เส้นทางของการเชื่อมต่อ
type	string	ชนิดของการเชื่อมต่อ

ListConnectionsResponse

วัตถุ

ชื่อ	พิมพ์	คำอธิบาย
continuationToken	string	โทเค็นสําหรับชุดผลลัพธ์ชุดถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง
continuationUri	string	URI ของชุดงานชุดผลลัพธ์ถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง
value	Connection[]: OnPremisesGatewayConnection[] OnPremisesGatewayPersonalConnection[] PersonalCloudConnection[] ShareableCloudConnection[] StreamingVirtualNetworkGatewayConnection[] VirtualNetworkGatewayConnection[]	รายการของการเชื่อมต่อ

ListCredentialDetails

วัตถุ

รายละเอียดข้อมูลประจําตัวส่งกลับเมื่อดึงข้อมูลการเชื่อมต่อ

ชื่อ	พิมพ์	คำอธิบาย
connectionEncryption	ConnectionEncryption	การตั้งค่าการเข้ารหัสลับการเชื่อมต่อที่ใช้ในระหว่างการทดสอบการเชื่อมต่อ
credentialType	CredentialType	ชนิดข้อมูลประจําตัวของการเชื่อมต่อ
singleSignOnType	SingleSignOnType	ชนิดการลงชื่อเข้าระบบครั้งเดียวของการเชื่อมต่อ
skipTestConnection	boolean	การเชื่อมต่อควรข้ามการเชื่อมต่อทดสอบในระหว่างการสร้างและอัปเดตหรือไม่ True - ข้ามการเชื่อมต่อการทดสอบ เท็จ - อย่าข้ามการเชื่อมต่อการทดสอบ

OnPremisesGatewayConnection

วัตถุ

การเชื่อมต่อที่เชื่อมต่อผ่านเกตเวย์ข้อมูลภายในองค์กร

ชื่อ	พิมพ์	คำอธิบาย
connectionDetails	ListConnectionDetails	รายละเอียดการเชื่อมต่อของการเชื่อมต่อ
connectionRecency	ConnectionRecency	รายละเอียดการดําเนินการเกี่ยวกับการเชื่อมต่อ
connectivityType	string: OnPremisesGateway	ชนิดการเชื่อมต่อของการเชื่อมต่อ
credentialDetails	ListCredentialDetails	รายละเอียดข้อมูลประจําตัวของการเชื่อมต่อ
displayName	string	ชื่อที่แสดงของการเชื่อมต่อ
gatewayId	string (uuid)	ID ออบเจ็กต์เกตเวย์ที่ทําการเชื่อมต่อ สําหรับการเชื่อมต่อระบบคลาวด์ นี่คือ ID เกตเวย์เสมือน
id	string (uuid)	ID ออปเจ็กต์ของการเชื่อมต่อ
myRole	ConnectionRole	บทบาทที่มีผลบังคับใช้ของชื่อหลักบนการเชื่อมต่อ เมื่อโครงร่างสําคัญเป็นส่วนหนึ่งของกลุ่มความปลอดภัยหลายกลุ่มที่มีบทบาทที่แตกต่างกัน บทบาทสูงสุดจะถูกส่งกลับ ถ้าองค์ประกอบหลักของไม่มีบทบาทในการเชื่อมต่อ คุณสมบัตินี้จะไม่ถูกส่งกลับ
privacyLevel	PrivacyLevel	ระดับความเป็นส่วนตัวของการเชื่อมต่อ

OnPremisesGatewayPersonalConnection

วัตถุ

การเชื่อมต่อที่เชื่อมต่อผ่านเกตเวย์ข้อมูลภายในองค์กรส่วนบุคคล

ชื่อ	พิมพ์	คำอธิบาย
connectionDetails	ListConnectionDetails	รายละเอียดการเชื่อมต่อของการเชื่อมต่อ
connectionRecency	ConnectionRecency	รายละเอียดการดําเนินการเกี่ยวกับการเชื่อมต่อ
connectivityType	string: OnPremisesGatewayPersonal	ชนิดการเชื่อมต่อของการเชื่อมต่อ
credentialDetails	ListCredentialDetails	รายละเอียดข้อมูลประจําตัวของการเชื่อมต่อ
displayName	string	ชื่อที่แสดงของการเชื่อมต่อ
gatewayId	string (uuid)	ID ออบเจ็กต์เกตเวย์ที่ทําการเชื่อมต่อ สําหรับการเชื่อมต่อระบบคลาวด์ นี่คือ ID เกตเวย์เสมือน
id	string (uuid)	ID ออปเจ็กต์ของการเชื่อมต่อ
myRole	ConnectionRole	บทบาทที่มีผลบังคับใช้ของชื่อหลักบนการเชื่อมต่อ เมื่อโครงร่างสําคัญเป็นส่วนหนึ่งของกลุ่มความปลอดภัยหลายกลุ่มที่มีบทบาทที่แตกต่างกัน บทบาทสูงสุดจะถูกส่งกลับ ถ้าองค์ประกอบหลักของไม่มีบทบาทในการเชื่อมต่อ คุณสมบัตินี้จะไม่ถูกส่งกลับ
privacyLevel	PrivacyLevel	ระดับความเป็นส่วนตัวของการเชื่อมต่อ

PersonalCloudConnection

วัตถุ

การเชื่อมต่อที่เชื่อมต่อผ่านระบบคลาวด์และไม่สามารถแชร์ได้

ชื่อ	พิมพ์	คำอธิบาย
allowConnectionUsageInGateway	boolean	อนุญาตให้ใช้งานการเชื่อมต่อนี้กับเกตเวย์ข้อมูลภายในองค์กรหรือเกตเวย์ข้อมูล VNet
connectionDetails	ListConnectionDetails	รายละเอียดการเชื่อมต่อของการเชื่อมต่อ
connectionRecency	ConnectionRecency	รายละเอียดการดําเนินการเกี่ยวกับการเชื่อมต่อ
connectivityType	string: PersonalCloud	ชนิดการเชื่อมต่อของการเชื่อมต่อ
credentialDetails	ListCredentialDetails	รายละเอียดข้อมูลประจําตัวของการเชื่อมต่อ
displayName	string	ชื่อที่แสดงของการเชื่อมต่อ
gatewayId	string (uuid)	ID ออบเจ็กต์เกตเวย์ที่ทําการเชื่อมต่อ สําหรับการเชื่อมต่อระบบคลาวด์ นี่คือ ID เกตเวย์เสมือน
id	string (uuid)	ID ออปเจ็กต์ของการเชื่อมต่อ
myRole	ConnectionRole	บทบาทที่มีผลบังคับใช้ของชื่อหลักบนการเชื่อมต่อ เมื่อโครงร่างสําคัญเป็นส่วนหนึ่งของกลุ่มความปลอดภัยหลายกลุ่มที่มีบทบาทที่แตกต่างกัน บทบาทสูงสุดจะถูกส่งกลับ ถ้าองค์ประกอบหลักของไม่มีบทบาทในการเชื่อมต่อ คุณสมบัตินี้จะไม่ถูกส่งกลับ
privacyLevel	PrivacyLevel	ระดับความเป็นส่วนตัวของการเชื่อมต่อ

PrivacyLevel

การแจงนับ

การตั้งค่าระดับความเป็นส่วนตัวของการเชื่อมต่อ อาจมีการเพิ่มระดับความเป็นส่วนตัวเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
None	ไม่มีการกําหนดค่าการตั้งค่าระดับความเป็นส่วนตัว
Private	การเชื่อมต่อที่ตั้งค่าเป็นส่วนตัวประกอบด้วยข้อมูลที่สําคัญหรือเป็นความลับ ความสามารถในการมองเห็นสามารถจํากัดให้กับผู้ใช้ที่ได้รับอนุญาตได้ ข้อมูลจากการเชื่อมต่อส่วนตัวจะไม่พับเข้ากับการเชื่อมต่ออื่น ๆ รวมถึงการเชื่อมต่อส่วนตัวอื่น ๆ ด้วย
Organizational	การเชื่อมต่อที่ตั้งค่าเป็นองค์กรสามารถพับเป็นการเชื่อมต่อส่วนตัวและองค์กรอื่น ๆ ได้ พวกเขาไม่สามารถพับเข้ากับการเชื่อมต่อสาธารณะได้ การมองเห็นถูกตั้งค่าเป็นกลุ่มที่เชื่อถือได้
Public	ไฟล์ การเชื่อมต่ออินเทอร์เน็ต และข้อมูลในเวิร์กบุ๊กสามารถตั้งค่าเป็นสาธารณะได้ ข้อมูลสามารถพับในการเชื่อมต่ออื่น ๆ ได้ ทุกคนสามารถมองเห็นได้

ShareableCloudConnection

วัตถุ

การเชื่อมต่อที่เชื่อมต่อผ่านระบบคลาวด์

ชื่อ	พิมพ์	คำอธิบาย
allowConnectionUsageInGateway	boolean	อนุญาตให้ใช้งานการเชื่อมต่อนี้กับเกตเวย์ข้อมูลภายในองค์กรหรือเกตเวย์ข้อมูล VNet
allowUsageInUserControlledCode	boolean	อนุญาตให้เชื่อมต่อนี้กับรายการที่อนุญาตให้มีการควบคุมรหัสผู้ใช้เช่นสมุดบันทึก
connectionDetails	ListConnectionDetails	รายละเอียดการเชื่อมต่อของการเชื่อมต่อ
connectionRecency	ConnectionRecency	รายละเอียดการดําเนินการเกี่ยวกับการเชื่อมต่อ
connectivityType	string: ShareableCloud	ชนิดการเชื่อมต่อของการเชื่อมต่อ
credentialDetails	ListCredentialDetails	รายละเอียดข้อมูลประจําตัวของการเชื่อมต่อ
displayName	string	ชื่อที่แสดงของการเชื่อมต่อ
gatewayId	string (uuid)	ID ออบเจ็กต์เกตเวย์ที่ทําการเชื่อมต่อ สําหรับการเชื่อมต่อระบบคลาวด์ นี่คือ ID เกตเวย์เสมือน
id	string (uuid)	ID ออปเจ็กต์ของการเชื่อมต่อ
myRole	ConnectionRole	บทบาทที่มีผลบังคับใช้ของชื่อหลักบนการเชื่อมต่อ เมื่อโครงร่างสําคัญเป็นส่วนหนึ่งของกลุ่มความปลอดภัยหลายกลุ่มที่มีบทบาทที่แตกต่างกัน บทบาทสูงสุดจะถูกส่งกลับ ถ้าองค์ประกอบหลักของไม่มีบทบาทในการเชื่อมต่อ คุณสมบัตินี้จะไม่ถูกส่งกลับ
privacyLevel	PrivacyLevel	ระดับความเป็นส่วนตัวของการเชื่อมต่อ

SingleSignOnType

การแจงนับ

ชนิดการลงชื่อเข้าระบบครั้งเดียวของการเชื่อมต่อ อาจมีการเพิ่มการลงชื่อเข้าระบบครั้งเดียวเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
None	การเชื่อมต่อไม่ใช้การลงชื่อเข้าระบบครั้งเดียวเพื่อเชื่อมต่อ
Kerberos	การเชื่อมต่อใช้การลงชื่อเข้าระบบแบบครั้งเดียวของ Kerberos เพื่อเชื่อมต่อ
MicrosoftEntraID	การเชื่อมต่อใช้การลงชื่อเข้าระบบครั้งเดียวของ Microsoft Entra ID เพื่อเชื่อมต่อ
SecurityAssertionMarkupLanguage	การเชื่อมต่อใช้การลงชื่อเข้าระบบครั้งเดียว Assertion Markup Language (SAML) เพื่อเชื่อมต่อ
KerberosDirectQueryAndRefresh	การเชื่อมต่อใช้ Kerberos DirectQuery และการรีเฟรชการลงชื่อเข้าระบบครั้งเดียวเพื่อเชื่อมต่อ

StreamingVirtualNetworkGatewayConnection

วัตถุ

การเชื่อมต่อที่เชื่อมต่อผ่านเกตเวย์ข้อมูลเครือข่ายเสมือนการสตรีม

ชื่อ	พิมพ์	คำอธิบาย
connectionDetails	ListConnectionDetails	รายละเอียดการเชื่อมต่อของการเชื่อมต่อ
connectionRecency	ConnectionRecency	รายละเอียดการดําเนินการเกี่ยวกับการเชื่อมต่อ
connectivityType	string: StreamingVirtualNetworkGateway	ชนิดการเชื่อมต่อของการเชื่อมต่อ
credentialDetails	ListCredentialDetails	รายละเอียดข้อมูลประจําตัวของการเชื่อมต่อ
displayName	string	ชื่อที่แสดงของการเชื่อมต่อ
gatewayId	string (uuid)	ID ออปเจ็กต์เกตเวย์ของการเชื่อมต่อ
id	string (uuid)	ID ออปเจ็กต์ของการเชื่อมต่อ
myRole	ConnectionRole	บทบาทที่มีผลบังคับใช้ของชื่อหลักบนการเชื่อมต่อ เมื่อโครงร่างสําคัญเป็นส่วนหนึ่งของกลุ่มความปลอดภัยหลายกลุ่มที่มีบทบาทที่แตกต่างกัน บทบาทสูงสุดจะถูกส่งกลับ ถ้าองค์ประกอบหลักของไม่มีบทบาทในการเชื่อมต่อ คุณสมบัตินี้จะไม่ถูกส่งกลับ
privacyLevel	PrivacyLevel	ระดับความเป็นส่วนตัวของการเชื่อมต่อ

VirtualNetworkGatewayConnection

วัตถุ

การเชื่อมต่อที่เชื่อมต่อผ่านเกตเวย์ข้อมูลเครือข่ายเสมือน

ชื่อ	พิมพ์	คำอธิบาย
connectionDetails	ListConnectionDetails	รายละเอียดการเชื่อมต่อของการเชื่อมต่อ
connectionRecency	ConnectionRecency	รายละเอียดการดําเนินการเกี่ยวกับการเชื่อมต่อ
connectivityType	string: VirtualNetworkGateway	ชนิดการเชื่อมต่อของการเชื่อมต่อ
credentialDetails	ListCredentialDetails	รายละเอียดข้อมูลประจําตัวของการเชื่อมต่อ
displayName	string	ชื่อที่แสดงของการเชื่อมต่อ
gatewayId	string (uuid)	ID ออบเจ็กต์เกตเวย์ที่ทําการเชื่อมต่อ สําหรับการเชื่อมต่อระบบคลาวด์ นี่คือ ID เกตเวย์เสมือน
id	string (uuid)	ID ออปเจ็กต์ของการเชื่อมต่อ
myRole	ConnectionRole	บทบาทที่มีผลบังคับใช้ของชื่อหลักบนการเชื่อมต่อ เมื่อโครงร่างสําคัญเป็นส่วนหนึ่งของกลุ่มความปลอดภัยหลายกลุ่มที่มีบทบาทที่แตกต่างกัน บทบาทสูงสุดจะถูกส่งกลับ ถ้าองค์ประกอบหลักของไม่มีบทบาทในการเชื่อมต่อ คุณสมบัตินี้จะไม่ถูกส่งกลับ
privacyLevel	PrivacyLevel	ระดับความเป็นส่วนตัวของการเชื่อมต่อ