Shared Private Link Resources - Create Or Update
Inicia a criação ou atualização de um recurso de link privado compartilhado gerenciado pelo serviço de pesquisa no grupo de recursos especificado.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}?api-version=2023-11-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos na assinatura atual. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal. |
search
|
path | True |
string |
O nome do serviço de pesquisa associado ao grupo de recursos especificado. |
shared
|
path | True |
string |
O nome do recurso de link privado compartilhado gerenciado pelo serviço de pesquisa dentro do grupo de recursos especificado. |
subscription
|
path | True |
string |
O identificador exclusivo para uma assinatura do Microsoft Azure. Você pode obter esse valor da API de Resource Manager do Azure, das ferramentas de linha de comando ou do portal. |
api-version
|
query | True |
string |
A versão da API a ser usada para cada solicitação. |
Cabeçalho da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
x-ms-client-request-id |
string uuid |
Um valor de GUID gerado pelo cliente que identifica esta solicitação. Se especificado, isso será incluído nas informações de resposta como uma maneira de acompanhar a solicitação. |
Corpo da solicitação
Nome | Tipo | Description |
---|---|---|
properties |
Descreve as propriedades de um Recurso de Link Privado Compartilhado gerenciado pelo serviço de pesquisa. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Os detalhes do recurso de link privado compartilhado que foi criado ou atualizado. |
|
202 Accepted |
A operação de criação ou atualização do recurso de link privado compartilhado foi aceita e será concluída de forma assíncrona. |
|
Other Status Codes |
HTTP 400 (Solicitação Incorreta): o nome do recurso de link privado compartilhado fornecido ou a definição de recurso de link privado compartilhado é inválido; Consulte o código de erro e a mensagem na resposta para obter detalhes. HTTP 404 (Não encontrado): não foi possível encontrar a assinatura, o grupo de recursos, o serviço de pesquisa ou o recurso de link privado compartilhado. HTTP 409 (Conflito): a assinatura especificada está desabilitada. |
Segurança
azure_auth
Microsoft Entra ID fluxo de autorização OAuth2.
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
SharedPrivateLinkResourceCreateOrUpdate
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource?api-version=2023-11-01
{
"properties": {
"requestMessage": "please approve",
"groupId": "blob",
"privateLinkResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
"resourceRegion": null
}
}
Resposta de exemplo
Location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2023-11-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2023-11-01
{
"name": "testResource",
"type": "Microsoft.Search/searchServices/sharedPrivateLinkResources",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource",
"properties": {
"requestMessage": "please approve",
"groupId": "blob",
"privateLinkResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
"status": "Pending",
"resourceRegion": null
}
}
Definições
Nome | Description |
---|---|
Cloud |
Contém informações sobre um erro de API. |
Cloud |
Descreve um erro de API específico com um código de erro e uma mensagem. |
Shared |
Descreve um recurso de Link Privado compartilhado gerenciado pelo serviço de pesquisa. |
Shared |
Descreve as propriedades de um recurso de Link Privado compartilhado existente gerenciado pelo serviço de pesquisa. |
Shared |
O estado de provisionamento do recurso de link privado compartilhado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto. |
Shared |
Status do recurso de link privado compartilhado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado. |
CloudError
Contém informações sobre um erro de API.
Nome | Tipo | Description |
---|---|---|
error |
Descreve um erro de API específico com um código de erro e uma mensagem. |
CloudErrorBody
Descreve um erro de API específico com um código de erro e uma mensagem.
Nome | Tipo | Description |
---|---|---|
code |
string |
Um código de erro que descreve a condição de erro com mais precisão do que um código de status HTTP. Pode ser usado para lidar programaticamente com casos de erro específicos. |
details |
Contém erros aninhados relacionados a esse erro. |
|
message |
string |
Uma mensagem que descreve o erro em detalhes e fornece informações de depuração. |
target |
string |
O destino do erro específico (por exemplo, o nome da propriedade em erro). |
SharedPrivateLinkResource
Descreve um recurso de Link Privado compartilhado gerenciado pelo serviço de pesquisa.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
O nome do recurso |
properties |
Descreve as propriedades de um Recurso de Link Privado Compartilhado gerenciado pelo serviço de pesquisa. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceProperties
Descreve as propriedades de um recurso de Link Privado compartilhado existente gerenciado pelo serviço de pesquisa.
Nome | Tipo | Description |
---|---|---|
groupId |
string |
A ID do grupo do provedor de recursos para o qual o recurso de link privado compartilhado serve. |
privateLinkResourceId |
string |
A ID do recurso para o qual o recurso de link privado compartilhado serve. |
provisioningState |
O estado de provisionamento do recurso de link privado compartilhado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto. |
|
requestMessage |
string |
A mensagem de solicitação para solicitar a aprovação do recurso de link privado compartilhado. |
resourceRegion |
string |
Opcional. Pode ser usado para especificar o Azure Resource Manager local do recurso ao qual um link privado compartilhado deve ser criado. Isso só é necessário para esses recursos cuja configuração de DNS é regional (como Serviço de Kubernetes do Azure). |
status |
Status do recurso de link privado compartilhado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado. |
SharedPrivateLinkResourceProvisioningState
O estado de provisionamento do recurso de link privado compartilhado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto.
Nome | Tipo | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Incomplete |
string |
|
Succeeded |
string |
|
Updating |
string |
SharedPrivateLinkResourceStatus
Status do recurso de link privado compartilhado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado.
Nome | Tipo | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |