Atualizar Origem de Dados (API REST da Pesquisa de IA do Azure)
Substitui uma definição de origem de dados existente por uma versão revista.
PUT https://[service name].search.windows.net/datasources/[data source name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Parâmetros do URI
Parâmetro | Description |
---|---|
nome do serviço | Obrigatório. Defina-o como o nome exclusivo definido pelo utilizador do seu serviço de pesquisa. |
nome da origem de dados | Obrigatório. O URI do pedido especifica o nome da origem de dados a atualizar. |
api-version | Obrigatório. A versão estável atual é api-version=2020-06-30 . Veja Versões da API para obter mais versões. |
Cabeçalhos de Pedido
A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.
Campos | Description |
---|---|
Content-Type | Obrigatório. Defina esta opção como application/json |
api-key | Opcional se estiver a utilizar funções do Azure e for fornecido um token de portador no pedido, caso contrário, é necessária uma chave. Uma chave de API é uma cadeia exclusiva gerada pelo sistema que autentica o pedido no seu serviço de pesquisa. Os pedidos de atualização têm de incluir um api-key cabeçalho definido para a sua chave de administrador (por oposição a uma chave de consulta). Veja Connect to Azure AI Search using key authentication (Ligar à Pesquisa de IA do Azure com a autenticação de chaves ) para obter detalhes. |
Corpo do Pedido
A sintaxe do corpo do pedido é a mesma que para Criar Origem de Dados.
Ao atualizar uma origem de dados existente, toda a definição é substituída pelo conteúdo do corpo do pedido. Em geral, o melhor padrão a utilizar para atualizações é obter a definição da origem de dados com um GET, modificá-la e, em seguida, atualizá-la com PUT.
Resposta
Para um pedido bem-sucedido: 201 Criado se tiver sido criada uma nova origem de dados e 204 Sem Conteúdo se uma origem de dados existente tiver sido atualizada
Nota
Algumas propriedades não podem ser atualizadas numa origem de dados existente. Por exemplo, não pode alterar o tipo de uma origem de dados existente.