Text Authoring Project - Copy Project Authorization

Serviço:

Azure AI Services

Versão da API:

2025-05-15-preview

Gera uma autorização de operação de projeto de cópia para o recurso do Azure de destino atual.

POST {Endpoint}/language/authoring/analyze-text/projects/{projectName}/:authorize-copy?api-version=2025-05-15-preview

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
Endpoint	path	True	string (url)	Ponto de extremidade dos Serviços Cognitivos com suporte, por exemplo, https://.api.cognitiveservices.azure.com.
projectName	path	True	string	O novo nome do projeto.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
projectKind	True	ProjectKind	Representa o tipo de projeto.
allowOverwrite		boolean	Se deseja permitir que um projeto existente seja substituído usando a autorização de cópia resultante.
storageInputContainerName		string	O nome do contêiner de armazenamento.

Respostas

Nome	Tipo	Description
200 OK	TextAnalysisAuthoringCopyProjectOptions	A solicitação foi bem-sucedida.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Uma resposta de erro inesperada. Cabeçalhos x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

OAuth2Auth

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize
URL do Token: https://login.microsoftonline.com/common/oauth2/token

Escopos

Nome	Description
https://cognitiveservices.azure.com/.default

Exemplos

SuccessfulCopyProjectAuthorization

Solicitação de exemplo

HTTP

POST {Endpoint}/language/authoring/analyze-text/projects/LoanAgreements/:authorize-copy?api-version=2025-05-15-preview

{
  "projectKind": "CustomEntityRecognition",
  "storageInputContainerName": "loanagreements",
  "allowOverwrite": false
}

Resposta de exemplo

Código de status:

200

{
  "projectKind": "CustomEntityRecognition",
  "targetProjectName": "LoanAgreements",
  "accessToken": "c0b13e0c-e9fe-4afa-aa11-db3b9b28f5e2",
  "expiresAt": "2022-04-18T13:53:03Z",
  "targetResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu",
  "targetResourceRegion": "westeurope"
}

Definições

Nome	Description
Azure.Core.Foundations.Error	O objeto de erro.
Azure.Core.Foundations.ErrorResponse	Uma resposta que contém detalhes do erro.
Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
ProjectKind
TextAnalysisAuthoringCopyAuthorizationOptions	Representa as opções para autorizar uma cópia de projeto para o recurso atual do Azure.
TextAnalysisAuthoringCopyProjectOptions	Representa as opções para copiar um projeto existente para outro recurso do Azure.

Azure.Core.Foundations.Error

Objeto

O objeto de erro.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
details	Azure.Core.Foundations.Error[]	Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
innererror	Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação legível pelo ser humano do erro.
target	string	O destino do erro.

Azure.Core.Foundations.ErrorResponse

Objeto

Uma resposta que contém detalhes do erro.

Nome	Tipo	Description
error	Azure.Core.Foundations.Error	O objeto de erro.

Azure.Core.Foundations.InnerError

Objeto

Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
innererror	Azure.Core.Foundations.InnerError	Erro interno.

ProjectKind

Enumeração

Valor	Description
CustomAbstractiveSummarization	Para criar um resumo abstrativo de modelos que são capazes de resumir documentos longos.
CustomEntityRecognition	Para criar um modelo de extração para identificar suas categorias de domínio usando seus próprios dados.
CustomHealthcare	Para criar uma análise de texto para o modelo de integridade para identificar seus dados de domínio de integridade.
CustomMultiLabelClassification	Para criar um modelo de classificação para classificar o texto usando seus próprios dados. Cada arquivo pode ter um ou muitos rótulos. Por exemplo, o arquivo 1 é classificado como A, B e C e o arquivo 2 são classificados como B e C.
CustomSingleLabelClassification	Para criar um modelo de classificação para classificar o texto usando seus próprios dados. Cada arquivo terá apenas um rótulo. Por exemplo, o arquivo 1 é classificado como A e o arquivo 2 é classificado como B.
CustomTextSentiment	Para criar modelos de sentimento que são capazes de extrair sentimento para documentos longos.

TextAnalysisAuthoringCopyAuthorizationOptions

Objeto

Representa as opções para autorizar uma cópia de projeto para o recurso atual do Azure.

Nome	Tipo	Description
allowOverwrite	boolean	Se deseja permitir que um projeto existente seja substituído usando a autorização de cópia resultante.
projectKind	ProjectKind	Representa o tipo de projeto.
storageInputContainerName	string	O nome do contêiner de armazenamento.

TextAnalysisAuthoringCopyProjectOptions

Objeto

Representa as opções para copiar um projeto existente para outro recurso do Azure.

Nome	Tipo	Description
accessToken	string	O token de acesso.
expiresAt	string (date-time)	A expiração do token de acesso.
projectKind	ProjectKind	Representa o tipo de projeto.
targetProjectName	string	O nome do projeto a ser copiado.
targetResourceId	string	Representa a ID de recurso do Azure de destino.
targetResourceRegion	string	Representa a região de recurso do Azure de destino.