Items - List Restorable Deleted Databases

บริการ:: SQLDatabase

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

รับรายการของฐานข้อมูลที่ถูกลบที่สามารถกู้คืนได้ในพื้นที่ทํางาน

Note

PITR จากฐานข้อมูลที่ถูกลบอยู่ในตัวอย่าง (เรียนรู้เพิ่มเติม)

การอนุญาต

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

ผู้เรียกต้องมีสิทธิ์ ในการอ่านและเขียน สําหรับฐานข้อมูล SQL

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

SQLDatabase.ReadWrite.All หรือ Item.ReadWrite.All

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

API นี้สนับสนุนข้อมูลประจําตัวของ Microsoft แสดงรายการในส่วนนี้

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

ส่วนติดต่อ

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/restorableDeletedDatabases

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

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/restorableDeletedDatabases?recursive={recursive}&rootFolderId={rootFolderId}

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
workspaceId	path	True	string (uuid)	ตัวระบุพื้นที่ทํางาน
recursive	query		boolean	แสดงรายการข้อมูลในโฟลเดอร์และโฟลเดอร์ที่ซ้อนกัน หรือเพียงแค่โฟลเดอร์เท่านั้น True - รายการทั้งหมดในโฟลเดอร์และโฟลเดอร์ที่ซ้อนกันจะแสดงเป็นรายการ False - เฉพาะรายการในโฟลเดอร์เท่านั้นที่อยู่ในรายการ ค่าเริ่มต้นคือ จริง
rootFolderId	query		string (uuid)	พารามิเตอร์นี้ช่วยให้ผู้ใช้สามารถกรองรายการตามโฟลเดอร์รากที่ระบุ ถ้าไม่มี ให้ใช้พื้นที่ทํางานเป็นโฟลเดอร์ราก

การตอบสนอง

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

200 OK

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

RestorableDeletedSQLDatabases

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

429 Too Many Requests

ErrorResponse

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

ส่วนหัว

Retry-After: integer

Other Status Codes

ErrorResponse

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

ItemNotFound - ไม่พบรายการที่ร้องขอ

ตัวอย่าง

Get restorable deleted databases example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/sqlDatabases/restorableDeletedDatabases

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

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

{
  "value": [
    {
      "displayName": "SQLDatabase1",
      "properties": {
        "restorableDeletedDatabaseName": "SQLDatabase1,134140258788170000",
        "earliestRestorePoint": "2024-12-01T00:00:00.000Z",
        "latestRestorePoint": "2024-12-02T00:00:00.000Z",
        "deletionTimestamp": "2024-12-01T00:00:00.000Z"
      }
    },
    {
      "displayName": "SQLDatabase2",
      "properties": {
        "restorableDeletedDatabaseName": "SQLDatabase2,134140258788470000",
        "earliestRestorePoint": "2024-12-01T00:00:00.000Z",
        "latestRestorePoint": "2024-12-02T00:00:00.000Z",
        "deletionTimestamp": "2024-12-01T00:00:00.000Z"
      }
    }
  ]
}

คำจำกัดความ

ชื่อ	คำอธิบาย
ErrorParameter	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
RestorableDeletedSQLDatabase	วัตถุฐานข้อมูล SQL ที่ถูกลบและคืนค่าได้
RestorableDeletedSQLDatabaseProperties	คุณสมบัติฐานข้อมูล SQL ที่ถูกลบและคืนค่าได้
RestorableDeletedSQLDatabases	รายการของฐานข้อมูล SQL ที่ถูกลบและคืนค่าได้

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

RestorableDeletedSQLDatabase

วัตถุ

วัตถุฐานข้อมูล SQL ที่ถูกลบและคืนค่าได้

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงของฐานข้อมูล SQL ที่ถูกลบออกได้ของ Fabric
properties	RestorableDeletedSQLDatabaseProperties	คุณสมบัติฐานข้อมูล SQL ที่ถูกลบและคืนค่าได้

RestorableDeletedSQLDatabaseProperties

วัตถุ

คุณสมบัติฐานข้อมูล SQL ที่ถูกลบและคืนค่าได้

ชื่อ	พิมพ์	คำอธิบาย
deletionTimestamp	string	ประทับเวลา ISO 8601 สําหรับการลบฐานข้อมูลใน UTC (เช่น '2024-12-01T00:00:00Z')
earliestRestorePoint	string	ประทับเวลา ISO 8601 สําหรับจุดคืนค่าแรกสุดของฐานข้อมูลใน UTC (เช่น '2024-12-01T00:00:00Z')
latestRestorePoint	string	ประทับเวลา ISO 8601 สําหรับจุดคืนค่าล่าสุดของฐานข้อมูลใน UTC (เช่น '2024-12-02T00:00:00Z')
restorableDeletedDatabaseName	string	ชื่อของฐานข้อมูล SQL ที่ถูกลบคืนค่าได้ นี่คือชื่อที่จะใช้ในการสร้างส่วนข้อมูลเมื่อคืนค่าจากฐานข้อมูลที่ถูกลบซึ่งคืนค่าได้

RestorableDeletedSQLDatabases

วัตถุ

รายการของฐานข้อมูล SQL ที่ถูกลบและคืนค่าได้

ชื่อ	พิมพ์	คำอธิบาย
continuationToken	string	โทเค็นสําหรับชุดผลลัพธ์ชุดถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง
continuationUri	string	URI ของชุดงานชุดผลลัพธ์ถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง
value	RestorableDeletedSQLDatabase[]	คุณสมบัติของฐานข้อมูล SQL ที่ถูกลบและคืนค่าได้