Atualizar um serviço de ponto de extremidade privado para um provedor

REMENDO /api/atlas/v1.0/groups/{groupId}/privateEndpoint/endpointService/{endpointServiceId}

Atualiza o serviço de endpoint privado especificado para o projeto. O provedor de serviços de nuvem gerencia o serviço de endpoints privados que pertence ao projeto.

Requisitos de função

Proprietário do projeto

parâmetros de caminho

groupId string Obrigatório

Sequência única de 24dígitos hexadecimais que identifica seu projeto. Use o endpoint /groups para extrair todos os projetos aos quais o usuário autenticado tem acesso.

AVISO: grupos e projetos são termos sinônimos. O ID do seu grupo é igual ao ID do seu projeto. Para grupos existentes, o ID do grupo/projeto permanece o mesmo. O recurso e os endpoints correspondentes usam o termo grupos.

O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.
endpointServiceId string Obrigatório

String exclusiva de 24dígitos hexadecimais que identifica o serviço de ponto de extremidade privado que você deseja atualizar.

O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.

parâmetros de query

envelope booleano

Sinalizador que indica se o aplicativo empacota a resposta em um objeto JSON envelope. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na consulta. Os endpoints que retornam uma lista de resultados usam o objeto de resultados como um envelope. O aplicativo adiciona o parâmetro de status ao corpo da resposta.

O valor padrão é false.
pretty booleano

Sinalizador que indica se o corpo da resposta deve estar no formato prettyprint.

O valor padrão é false.

Prettyprint

aplicação/json

corpo, corpo Obrigatório

Atualizações a serem aplicadas ao serviço de pontos de extremidade privados.

cloudProvider string Obrigatório

Etiqueta legível por humanos que identifica o provedor de serviços de nuvem para o serviço de ponto de extremidade privado que você deseja atualizar.

O valor é AWS.
suportadoRemoteRegions array[string] | null

Lista de regiões suportadas pelo serviço de pontos de extremidade. O suporte nativo entre regiões é implementado apenas para a AWS.

Não mais do que 35 elementos.

Respostas

200 aplicação/json

OK
Um dos seguintes:
objeto AWS objeto AZURE objeto GCP
Grupo de configurações do Private Endpoint Service.

Ocultar atributos Mostrar atributos

cloudProvider string Obrigatório Discriminador

Fornecedor de serviços de nuvem que atende ao serviço de endpoint solicitado.

O valor é AWS.

Mensagem de erro string

Mensagem de erro retornada ao solicitar recurso de conexão privada. O recurso retornará null se a solicitação for bem-sucedida.

id string

String única de 24dígitos hexadecimais que identifica o serviço de endpoints privados.

O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.

regionName string

Região do provedor de nuvem que gerencia esse serviço de endpoint privado.

Status string

Estado da conexão do Private Endpoint Service quando o MongoDB Cloud recebeu esta solicitação.

Os valores são INITIATING, AVAILABLE, WAITING_FOR_USER, FAILED ou DELETING.

endpointServiceName string

String exclusiva que identifica o serviço de endpoints do Amazon Web Services (AWS) PrivateLink. O MongoDB Cloud retorna nulo enquanto cria o serviço endpoint.

O formato deve corresponder ao seguinte padrão: ^com\.amazonaws\.vpce\.[a-z-0-9]+\.vpce-svc-[0-9a-f]{17}.

interfaceEndpoints array[string] Obrigatório

Lista de strings que identificam interfaces de endpoint privadas aplicadas ao projeto especificado.

O formato de cada um deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.

suportadoRemoteRegions array[string] | null

Lista de regiões suportadas pelo serviço de pontos de extremidade. O suporte nativo entre regiões é implementado apenas para a AWS.

Não mais do que 35 elementos.
Grupo de configurações do Private Endpoint Service.

Ocultar atributos Mostrar atributos

cloudProvider string Obrigatório Discriminador

Fornecedor de serviços de nuvem que atende ao serviço de endpoint solicitado.

O valor é AZURE.

Mensagem de erro string

Mensagem de erro retornada ao solicitar recurso de conexão privada. O recurso retornará null se a solicitação for bem-sucedida.

id string

String única de 24dígitos hexadecimais que identifica o serviço de endpoints privados.

O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.

regionName string

Região do provedor de nuvem que gerencia esse serviço de endpoint privado.

Status string

Estado da conexão do Private Endpoint Service quando o MongoDB Cloud recebeu esta solicitação.

Os valores são INITIATING, AVAILABLE, WAITING_FOR_USER, FAILED ou DELETING.

privateEndpoints array[string]

Lista de endpoints privados atribuídos a este serviço de link privado do Azure.

O formato de cada um deve corresponder ao seguinte padrão: ^\/subscriptions\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\/resource[gG]roups\/([-\w._()]+)\/providers\/Microsoft\.Network\/privateEndpoints\/([-\w._()]+).

privateLinkServiceName string

String exclusiva que identifica o serviço de link privado do Azure que o MongoDB Cloud gerencia.

O formato deve corresponder ao seguinte padrão: ^pls_[0-9a-f]{24}$.

privateLinkServiceResourceId string

Caminho relativo à raiz que se identifica pelo Serviço de Link Privado do Azure que o MongoDB Cloud gerencia. Use esse valor para criar uma conexão de endpoint privada para uma VNet do Azure.
Grupo de configurações do Private Endpoint Service.

Ocultar atributos Mostrar atributos

cloudProvider string Obrigatório Discriminador

Fornecedor de serviços de nuvem que atende ao serviço de endpoint solicitado.

O valor é GCP.

Mensagem de erro string

Mensagem de erro retornada ao solicitar recurso de conexão privada. O recurso retornará null se a solicitação for bem-sucedida.

id string

String única de 24dígitos hexadecimais que identifica o serviço de endpoints privados.

O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.

regionName string

Região do provedor de nuvem que gerencia esse serviço de endpoint privado.

Status string

Estado da conexão do Private Endpoint Service quando o MongoDB Cloud recebeu esta solicitação.

Os valores são INITIATING, AVAILABLE, WAITING_FOR_USER, FAILED ou DELETING.

endpointGroupNames array[string]

Lista de grupos de pontos de extremidade de rede do Google Cloud que correspondem ao serviço de ponto de extremidade Private Service Connect. Se esse serviço de ponto de extremidade usar o mapeamento de porta PSC, esse campo conterá apenas uma lista de um ponto de extremidade.

portaMappingEnabled booleano

Sinalizador que indica se este serviço de ponto de extremidade usa o mapeamento de porta PSC.

serviceAttachmentNames array[string]

Lista de localizadores uniformes de recursos (URLs) que identificam pontos de extremidade que o MongoDB Cloud pode usar para acessar um Google Cloud Service em uma rede Virtual Private Connection (VPC) do Google Cloud. Se esse serviço de ponto de extremidade usar o mapeamento de porta PSC, esse campo conterá apenas uma lista de um anexo de serviço.

O formato de cada um deve corresponder ao seguinte padrão: https:\/\/([a-z0-9\.]+)+\.[a-z]{2,}(\/[a-z0-9\-]+)+\/projects\/p-[a-z0-9]+\/regions\/[a-z\-0-9]+\/serviceAttachments\/[a-z0-9\-]+.
400 aplicação/json

Solicitação inválida.
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- badRequestDetail objeto
  
  Detalhes da solicitação inválida.
  
  Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
  
  Campos array[objeto]
  
  Descreve todas as violações em uma solicitação do cliente .
  
  Ocultar atributos de campos Mostrar atributos dos campos objeto
  
  Descrição string Obrigatório
  
  Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.
  
  Campo string Obrigatório
  
  Um caminho que leva a um campo no corpo da solicitação.
- detalhe string
  
  Descreve as condições ou os motivos específicos que causam cada tipo de erro.
- Erro integer(int32) Obrigatório
  
  O código de status HTTP retornado com este erro.
  
  Documentação externa
- Código de erro string Obrigatório
  
  Código de erro do aplicativo retornado com esse erro.
- Parâmetros array[objeto]
  
  Parâmetros usados para fornecer mais informações sobre o erro.
- Razão string
  
  Mensagens de erro de aplicativo retornadas com este erro.
401 aplicação/json

Não autorizado.
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- badRequestDetail objeto
  
  Detalhes da solicitação inválida.
  
  Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
  
  Campos array[objeto]
  
  Descreve todas as violações em uma solicitação do cliente .
  
  Ocultar atributos de campos Mostrar atributos dos campos objeto
  
  Descrição string Obrigatório
  
  Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.
  
  Campo string Obrigatório
  
  Um caminho que leva a um campo no corpo da solicitação.
- detalhe string
  
  Descreve as condições ou os motivos específicos que causam cada tipo de erro.
- Erro integer(int32) Obrigatório
  
  O código de status HTTP retornado com este erro.
  
  Documentação externa
- Código de erro string Obrigatório
  
  Código de erro do aplicativo retornado com esse erro.
- Parâmetros array[objeto]
  
  Parâmetros usados para fornecer mais informações sobre o erro.
- Razão string
  
  Mensagens de erro de aplicativo retornadas com este erro.
403 aplicação/json

Forbidden.
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- badRequestDetail objeto
  
  Detalhes da solicitação inválida.
  
  Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
  
  Campos array[objeto]
  
  Descreve todas as violações em uma solicitação do cliente .
  
  Ocultar atributos de campos Mostrar atributos dos campos objeto
  
  Descrição string Obrigatório
  
  Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.
  
  Campo string Obrigatório
  
  Um caminho que leva a um campo no corpo da solicitação.
- detalhe string
  
  Descreve as condições ou os motivos específicos que causam cada tipo de erro.
- Erro integer(int32) Obrigatório
  
  O código de status HTTP retornado com este erro.
  
  Documentação externa
- Código de erro string Obrigatório
  
  Código de erro do aplicativo retornado com esse erro.
- Parâmetros array[objeto]
  
  Parâmetros usados para fornecer mais informações sobre o erro.
- Razão string
  
  Mensagens de erro de aplicativo retornadas com este erro.
404 aplicação/json

Não encontrado.
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- badRequestDetail objeto
  
  Detalhes da solicitação inválida.
  
  Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
  
  Campos array[objeto]
  
  Descreve todas as violações em uma solicitação do cliente .
  
  Ocultar atributos de campos Mostrar atributos dos campos objeto
  
  Descrição string Obrigatório
  
  Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.
  
  Campo string Obrigatório
  
  Um caminho que leva a um campo no corpo da solicitação.
- detalhe string
  
  Descreve as condições ou os motivos específicos que causam cada tipo de erro.
- Erro integer(int32) Obrigatório
  
  O código de status HTTP retornado com este erro.
  
  Documentação externa
- Código de erro string Obrigatório
  
  Código de erro do aplicativo retornado com esse erro.
- Parâmetros array[objeto]
  
  Parâmetros usados para fornecer mais informações sobre o erro.
- Razão string
  
  Mensagens de erro de aplicativo retornadas com este erro.
500 aplicação/json

Erro interno do servidor.
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- badRequestDetail objeto
  
  Detalhes da solicitação inválida.
  
  Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
  
  Campos array[objeto]
  
  Descreve todas as violações em uma solicitação do cliente .
  
  Ocultar atributos de campos Mostrar atributos dos campos objeto
  
  Descrição string Obrigatório
  
  Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.
  
  Campo string Obrigatório
  
  Um caminho que leva a um campo no corpo da solicitação.
- detalhe string
  
  Descreve as condições ou os motivos específicos que causam cada tipo de erro.
- Erro integer(int32) Obrigatório
  
  O código de status HTTP retornado com este erro.
  
  Documentação externa
- Código de erro string Obrigatório
  
  Código de erro do aplicativo retornado com esse erro.
- Parâmetros array[objeto]
  
  Parâmetros usados para fornecer mais informações sobre o erro.
- Razão string
  
  Mensagens de erro de aplicativo retornadas com este erro.

PATCH /api/atlas/v1.0/groups/{groupId}/privateEndpoint/endpointService/{endpointServiceId}

curl \
 --request PATCH 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/privateEndpoint/endpointService/{endpointServiceId}' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"cloudProvider":"AWS","supportedRemoteRegions":["string"]}'

Exemplos de solicitação

{
  "cloudProvider": "AWS",
  "supportedRemoteRegions": [
    "string"
  ]
}

Exemplos de resposta (200)

{
  "cloudProvider": "AWS",
  "errorMessage": "string",
  "id": "32b6e34b3d91647abb20e7b8",
  "regionName": "string",
  "status": "INITIATING",
  "endpointServiceName": "string",
  "interfaceEndpoints": [
    "32b6e34b3d91647abb20e7b8"
  ],
  "supportedRemoteRegions": [
    "string"
  ]
}

{
  "cloudProvider": "AZURE",
  "errorMessage": "string",
  "id": "32b6e34b3d91647abb20e7b8",
  "regionName": "string",
  "status": "INITIATING",
  "privateEndpoints": [
    "string"
  ],
  "privateLinkServiceName": "string",
  "privateLinkServiceResourceId": "/subscriptions/ae349d51-d12b-ee3d-2a27-7d53f6479cf0/resourcegroups/KObGGz/providers/Microsoft.Network/privateLinkServices/pls_d1820713f8153388d533e9de"
}

{
  "cloudProvider": "GCP",
  "errorMessage": "string",
  "id": "32b6e34b3d91647abb20e7b8",
  "regionName": "string",
  "status": "INITIATING",
  "endpointGroupNames": [
    "string"
  ],
  "portMappingEnabled": true,
  "serviceAttachmentNames": [
    "string"
  ]
}

Exemplos de resposta (400)

{
  "detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
  "error": 400,
  "errorCode": "VALIDATION_ERROR",
  "reason": "Bad Request"
}

Exemplos de resposta (401)

{
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "error": 401,
  "errorCode": "NOT_ORG_GROUP_CREATOR",
  "reason": "Unauthorized"
}

Exemplos de resposta (403)

{
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "error": 403,
  "errorCode": "CANNOT_CHANGE_GROUP_NAME",
  "reason": "Forbidden"
}

Exemplos de resposta (404)

{
  "detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
  "error": 404,
  "errorCode": "RESOURCE_NOT_FOUND",
  "reason": "Not Found"
}

Exemplos de resposta (500)

{
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "error": 500,
  "errorCode": "UNEXPECTED_ERROR",
  "reason": "Internal Server Error"
}