ModifyDBInstanceConnectionString - ApsaraDB for MongoDB - Centro de documentación de Alibaba Cloud

Descripción de la operación

Puede modificar la dirección de conexión y el puerto para los siguientes tipos de instancias:

Puede modificar la dirección de conexión y el puerto para instancias que utilizan discos locales o discos en la nube.
Para instancias de clúster fragmentado, solo puede modificar la dirección de conexión de los nodos Mongos.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dds:ModifyDBInstanceConnectionString

update

*Instance

acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DBInstanceId	string	Sí	El ID de la instancia. Nota Si especifica el ID de una instancia de clúster fragmentado, también debe especificar el parámetro NodeId.	dds-bpxxxxxxxx
NodeId	string	No	El ID de un nodo Mongos en una instancia de clúster fragmentado. Solo puede especificar un ID de nodo Mongos por llamada. Nota Este parámetro es válido solo cuando DBInstanceId especifica el ID de una instancia de clúster fragmentado.	s-bpxxxxxxxx
CurrentConnectionString	string	No	La dirección de conexión actual, es decir, la dirección que se va a modificar.	s-bpxxxxxxxx.mongodb.rds.aliyuncs.com
NewConnectionString	string	No	La nueva dirección de conexión. Debe cumplir con los siguientes requisitos: Comenzar con una letra minúscula. Terminar con una letra minúscula o un dígito. Contener solo letras minúsculas, dígitos y guiones (-). Tener una longitud de 8 a 63 caracteres. Nota Especifique solo el prefijo de la dirección de conexión. No puede cambiar ninguna parte más allá del prefijo.	aliyuntest111
NewPort	integer	No	El nuevo número de puerto. Los valores válidos van de 1000 a 65535. Nota Este parámetro es válido solo cuando DBInstanceId especifica el ID de una instancia de disco en la nube.	3310
PortModifyOnly	boolean	No
NetworkType	string	No		vpc
ForceModifySuffix	boolean	No

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	FF36A84C-0694-42D0-861D-C383E8E4FAAF
ModifiedConnectionString	string

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "FF36A84C-0694-42D0-861D-C383E8E4FAAF",
  "ModifiedConnectionString": ""
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	NewConnectionString.NotSupport	Specified newConnectionString is not supported.	newConnectionString format
400	InvalidConnectionStringOrPort.Duplicate	Specified connection string or port already exists.	The specified connection string or port information already exists, please check and resubmit.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.