Items - Update Copy Job Definition

Szolgáltatás:

CopyJob

API-verzió:

v1

Felülbírálja a megadott CopyJob definícióját.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

A CopyJob definíciójának frissítése nem befolyásolja a bizalmassági címkét.

Engedélyek

Az API-hívónak közreműködői vagy magasabb munkaterületi szerepkört kell tartalmaznia.

Kötelező delegált hatókörök

CopyJob.ReadWrite.All vagy Item.ReadWrite.All

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Személyazonosság	Támogatás
Felhasználó	Igen
szolgáltatásnév és felügyelt identitások	Igen

Interfész

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/copyJobs/{copyJobId}/updateDefinition

Opcionális paraméterekkel:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/copyJobs/{copyJobId}/updateDefinition?updateMetadata={updateMetadata}

URI-paraméterek

Name	In	Kötelező	Típus	Description
copyJobId	path	True	string (uuid)	A CopyJob azonosítója.
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.
updateMetadata	query		boolean	Ha igaz értékre van állítva, és a .platformfájl a definíció részeként van megadva, az elem metaadatai a .platformfájl metaadataival frissülnek

Kérelem törzse

Name	Kötelező	Típus	Description
definition	True	CopyJobDefinition	CopyJob public definition objektum. A CopyJob nyilvános definíciójának elkészítésével kapcsolatos további részletekért tekintse meg Feladatdefiníció másolása.

Válaszok

Name	Típus	Description
200 OK		A kérés sikeresen befejeződött.
202 Accepted		A kérelem elfogadva. A frissítésdefiníció folyamatban van. Fejlécek Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Gyakori hibakódok: OperationNotSupportedForItem – A művelet nem támogatott a kért elemhez. CorruptedPayload – A megadott hasznos adatok sérültek.

Példák

Update a CopyJob public definition example

Mintakérelem

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/copyJobs/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "copyjob-content.json",
        "payload": "ewogICJwcm9wZXJ0aWVzIjogewogICAgImpvYk1vZGUiOiAiQ0RDIgogIH0sCiAgImFjdGl2aXRpZXMiOiBbXQp9",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Mintaválasz

Állapotkód:

200

Állapotkód:

202

Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

Definíciók

Name	Description
CopyJobDefinition	CopyJob public definition objektum. A CopyJob nyilvános definíciójának elkészítésével kapcsolatos további részletekért tekintse meg Feladatdefiníció másolása.
CopyJobDefinitionPart	CopyJob definition part object.
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
PayloadType	A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.
UpdateCopyJobDefinitionRequest	Frissítse a CopyJob nyilvános definíciós kérés hasznos adatait.

CopyJobDefinition

Objektum

CopyJob public definition objektum. A CopyJob nyilvános definíciójának elkészítésével kapcsolatos további részletekért tekintse meg Feladatdefiníció másolása.

Name	Típus	Description
format	string	Az elemdefiníció formátuma.
parts	CopyJobDefinitionPart[]	Definíciórészek listája.

CopyJobDefinitionPart

Objektum

CopyJob definition part object.

Name	Típus	Description
path	string	A CopyJob nyilvános definíció rész elérési útja.
payload	string	A CopyJob nyilvános definíciójának hasznos adatai.
payloadType	PayloadType	A hasznos adat típusa.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string	A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

PayloadType

Enumerálás

A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.

Érték	Description
InlineBase64	Beágyazott 64-es alap.

UpdateCopyJobDefinitionRequest

Objektum

Frissítse a CopyJob nyilvános definíciós kérés hasznos adatait.

Name	Típus	Description
definition	CopyJobDefinition	CopyJob public definition objektum. A CopyJob nyilvános definíciójának elkészítésével kapcsolatos további részletekért tekintse meg Feladatdefiníció másolása.