Workspaces - Set Inbound Azure Resource Rules

บริการ:: Core

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

ตั้งค่า Azure ขาเข้ากฎอินสแตนซ์ของทรัพยากรสําหรับพื้นที่ทํางาน API นี้ช่วยให้ผู้ดูแลระบบพื้นที่ทํางานสามารถตั้งค่าขาเข้า Azure กฎอินสแตนซ์ของทรัพยากรที่ควบคุมว่าอินสแตนซ์ทรัพยากรใด Azure อยู่ในรายการที่ได้รับอนุญาตสําหรับพื้นที่ทํางาน ขณะนี้ คุณลักษณะนี้อยู่ในการการแสดงตัวอย่าง

Note

API นี้เป็นส่วนหนึ่งของการเผยแพร่ตัวอย่าง และมีไว้เพื่อวัตถุประสงค์ในการประเมินและการพัฒนาเท่านั้น ซึ่งอาจเปลี่ยนแปลงตามคําติชมและไม่แนะนําสําหรับการใช้งานด้านการผลิต

การอนุญาต

ผู้เรียกต้องมีบทบาทพื้นที่ทํางาน ของผู้ดูแลระบบ

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

Workspace.ReadWrite.All

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

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

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

ส่วนติดต่อ

PUT https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/networking/communicationPolicy/inbound/azureResources

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน

เนื้อความของคำขอ

ชื่อ	พิมพ์	คำอธิบาย
rules	WorkspaceInboundAzureResourceRule[]	อาร์เรย์ของ Azure กฎอินสแตนซ์ของทรัพยากรขาเข้าที่เชื่อมโยงกับพื้นที่ทํางาน

การตอบสนอง

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

200 OK

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

คําขอเสร็จสมบูรณ์

429 Too Many Requests

ErrorResponse

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

ส่วนหัว

Retry-After: integer

Other Status Codes

ErrorResponse

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

UnknownError - เกิดข้อผิดพลาด

ตัวอย่าง

Set workspace resource instance example

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

HTTP

PUT https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/networking/communicationPolicy/inbound/azureResources

{
  "rules": [
    {
      "displayName": "SQL Server - testsql1",
      "resourceId": "/subscriptions/2374e516-d28b-4898-a39c-6070e078ae31/resourceGroups/testrg/providers/Microsoft.Sql/servers/testsql1"
    },
    {
      "displayName": "Storage Account - teststorageacct",
      "resourceId": "/subscriptions/2374e516-d28b-4898-a39c-6070e078ae31/resourceGroups/testrg/providers/Microsoft.Storage/storageAccounts/teststorageacct"
    }
  ]
}

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

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

คำจำกัดความ

ชื่อ	คำอธิบาย
ErrorParameter	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
WorkspaceInboundAzureResourceRule	แสดงถึงกฎอินสแตนซ์ของ Azure ทรัพยากรขาเข้าเดียวที่ระบุอินสแตนซ์ทรัพยากร Azure ที่ได้รับอนุญาตสําหรับพื้นที่ทํางาน
WorkspaceInboundAzureResourceRules	แสดงคอลเลกชันของขาเข้า Azure กฎอินสแตนซ์ของทรัพยากรที่กําหนดค่าไว้สําหรับพื้นที่ทํางาน กฎเหล่านี้กําหนดว่า Azure อินสแตนซ์ทรัพยากรใดที่ได้รับอนุญาตให้เข้าถึงพื้นที่ทํางาน

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	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

WorkspaceInboundAzureResourceRule

วัตถุ

แสดงถึงกฎอินสแตนซ์ของ Azure ทรัพยากรขาเข้าเดียวที่ระบุอินสแตนซ์ทรัพยากร Azure ที่ได้รับอนุญาตสําหรับพื้นที่ทํางาน

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงที่ใช้งานง่ายสําหรับกฎ ชื่อนี้ใช้สําหรับแสดงเท่านั้น และไม่มีผลต่อฟังก์ชันการทํางานของกฎ
resourceId	string	ID ทรัพยากร Azure Resource Manager (ARM) แบบเต็มของทรัพยากรภายในกฎ นี่คือตัวระบุที่ไม่ซ้ํากันในรูปแบบ: `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}` คุณสามารถเรียกใช้ได้จาก Azure Portal (คุณสมบัติทรัพยากร), Azure CLI (แสดงทรัพยากร az) หรือเทมเพลต ARM

WorkspaceInboundAzureResourceRules

วัตถุ

แสดงคอลเลกชันของขาเข้า Azure กฎอินสแตนซ์ของทรัพยากรที่กําหนดค่าไว้สําหรับพื้นที่ทํางาน กฎเหล่านี้กําหนดว่า Azure อินสแตนซ์ทรัพยากรใดที่ได้รับอนุญาตให้เข้าถึงพื้นที่ทํางาน

ชื่อ	พิมพ์	คำอธิบาย
rules	WorkspaceInboundAzureResourceRule[]	อาร์เรย์ของ Azure กฎอินสแตนซ์ของทรัพยากรขาเข้าที่เชื่อมโยงกับพื้นที่ทํางาน