Atualizar fonte de dados (API REST do Azure AI Search)
Substitui uma definição de fonte de dados existente por uma versão revisada.
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 de URI
Parâmetro | Descrição |
---|---|
nome do serviço | Obrigatórios. Defina isso como o nome exclusivo definido pelo usuário do serviço de pesquisa. |
nome da fonte de dados | Obrigatórios. O URI de solicitação especifica o nome da fonte de dados a ser atualizada. |
api-version | Obrigatórios. A versão estável atual é api-version=2020-06-30 . Confira Versões de API para obter mais versões. |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos de solicitação necessários e opcionais
Campos | Descrição |
---|---|
Tipo de conteúdo | Obrigatórios. Defina-o como application/json |
chave de API | Opcional se você estiver usando funções do Azure e um token de portador for fornecido na solicitação, caso contrário, uma chave será necessária. Uma chave de api é uma cadeia de caracteres exclusiva gerada pelo sistema que autentica a solicitação para o serviço de pesquisa. As solicitações de atualização devem incluir um api-key cabeçalho definido como sua chave de administrador (em vez de uma chave de consulta). Confira Conectar-se ao Azure AI Search usando a autenticação de chave para obter detalhes. |
Corpo da solicitação
A sintaxe do corpo da solicitação é a mesma que para Criar Fonte de Dados.
Ao atualizar uma fonte de dados existente, toda a definição é substituída pelo conteúdo do corpo da solicitação. Em geral, o melhor padrão a ser usado para atualizações é recuperar a definição da fonte de dados com um GET, modificá-la e atualizá-la com PUT.
Resposta
Para uma solicitação bem-sucedida: 201 Criado se uma nova fonte de dados foi criada e 204 Nenhum Conteúdo se uma fonte de dados existente foi atualizada
Observação
Algumas propriedades não podem ser atualizadas em uma fonte de dados existente. Por exemplo, você não pode alterar o tipo de fonte de dados existente.