Custom Models - Copy

서비스:

Azure AI Services

API 버전:

2.1

이 리소스(원본)에 저장된 사용자 지정 모델을 사용자가 지정한 대상 Form Recognizer 리소스에 복사합니다.

POST {endpoint}/formrecognizer/v2.1/custom/models/{modelId}/copy

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus2.api.cognitive.microsoft.com).
modelId	path	True	string uuid	모델 식별자입니다.

요청 헤더

Name	필수	형식	Description
Ocp-Apim-Subscription-Key	True	string

요청 본문

Name	필수	형식	Description
copyAuthorization	True	CopyAuthorizationResult	클레임을 인코딩하여 복사 요청에 권한을 부여하는 엔터티입니다.
targetResourceId	True	string	모델이 복사되는 대상 Form Recognizer 리소스의 Azure 리소스 ID입니다.
targetResourceRegion	True	string	대상 Azure 리소스의 위치입니다. Cognitive Services에서 지원하는 유효한 Azure 지역 이름입니다.

응답

Name	형식	Description
202 Accepted		복사 요청이 성공적으로 큐에 대기됩니다. 헤더 Operation-Location: string
Other Status Codes	ErrorResponse	오류에 대한 추가 세부 정보를 포함하는 성공하지 못한 응답과 함께 제공되는 응답 엔터티입니다.

보안

Ocp-Apim-Subscription-Key

형식: apiKey
In(다음 안에): header

예제

Copy custom model

샘플 요청

HTTP

POST {endpoint}/formrecognizer/v2.1/custom/models/f973e3c1-1148-43bb-bea8-49d0603ab3a8/copy


{
  "targetResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{resourceName}",
  "targetResourceRegion": "westus2",
  "copyAuthorization": {
    "modelId": "f973e3c1-1148-43bb-bea8-49d0603ab3a8",
    "accessToken": "{accessToken}",
    "expirationDateTimeTicks": 86400
  }
}

샘플 응답

상태 코드:

202

Operation-Location: {endpoint}/formrecognizer/v2.1/custom/models/f973e3c1-1148-43bb-bea8-49d0603ab3a8/copyResults/3b1e6c5b-e113-4114-ab6b-ce65dfe8050f

정의

Name	Description
CopyAuthorizationResult	복사 작업에 대한 권한 부여 클레임을 포함하는 요청 매개 변수입니다.
CopyRequest	원본 리소스에서 리소스 ID로 참조되는 대상 리소스로 기존 사용자 지정 모델을 복사하는 요청 매개 변수입니다.
ErrorInformation
ErrorResponse

CopyAuthorizationResult

복사 작업에 대한 권한 부여 클레임을 포함하는 요청 매개 변수입니다.

Name	형식	Description
accessToken	string	요청에 권한을 부여하는 데 사용되는 토큰 클레임입니다.
expirationDateTimeTicks	integer	액세스 토큰이 만료되는 시간입니다. 날짜는 1970-01-01T0:0:0Z UTC부터 만료 시간까지 기간(초)으로 표시됩니다.
modelId	string	모델 식별자입니다.

CopyRequest

원본 리소스에서 리소스 ID로 참조되는 대상 리소스로 기존 사용자 지정 모델을 복사하는 요청 매개 변수입니다.

Name	형식	Description
copyAuthorization	CopyAuthorizationResult	클레임을 인코딩하여 복사 요청에 권한을 부여하는 엔터티입니다.
targetResourceId	string	모델이 복사되는 대상 Form Recognizer 리소스의 Azure 리소스 ID입니다.
targetResourceRegion	string	대상 Azure 리소스의 위치입니다. Cognitive Services에서 지원하는 유효한 Azure 지역 이름입니다.

ErrorInformation

Name	형식	Description
code	string
message	string

ErrorResponse

Name	형식	Description
error	ErrorInformation