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

Consulta los registros de conmutación entre primario y secundario de una instancia de ApsaraDB for MongoDB.

Descripción de la operación

Antes de llamar a esta operación, asegúrese de que la instancia de ApsaraDB for MongoDB cumpla con los siguientes requisitos:

La instancia es una instancia de conjunto de réplicas o de clúster fragmentado.
La instancia utiliza discos físicos locales para almacenar datos.

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:DescribeDBInstanceSwitchLog

list

*Instance

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
StartTime	string	No	El inicio del intervalo de tiempo a consultar. Especifique la hora en formato ISO 8601 aaaa-mm-ddThh:mmZ. La hora debe estar en UTC.	2023-05-27T02:46Z
EndTime	string	No	El final del intervalo de tiempo a consultar. Especifique la hora en formato ISO 8601 aaaa-mm-ddThh:mmZ. La hora debe estar en UTC. La hora de finalización debe ser posterior a la hora de inicio.	2023-05-28T02:00Z
PageNumber	integer	No	El número de página a devolver. El valor debe ser un número entero mayor que 0 y menor o igual al valor máximo admitido por el tipo de datos entero. Valor predeterminado: 1.	1
PageSize	integer	No	El número de entradas a devolver en cada página. Valores válidos: 30, 50 y 100. Valor predeterminado: 30.	30
DBInstanceId	string	No	El ID de la instancia.	dds-uf68f1b5a57exxxx

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de respuesta.
RequestId	string	El ID de la solicitud.	ECBCA991-XXXX-XXXX-834C-B3E8007F33AA
DBInstanceId	string	El ID de la instancia.	dds-uf68f1b5a57exxxx
TotalCount	integer	El número de entradas de conmutación entre primario y secundario.	1
PageSize	integer	El número de entradas devueltas en cada página.	30
PageNumber	integer	El número de página devuelto.	1
LogItems	array<object>	Los registros de conmutación entre primario y secundario.
	object
SwitchStatus	string	El estado de la conmutación. Valores válidos: 1 y 0. El valor 1 indica una conmutación entre primario y secundario exitosa, y el valor 0 indica una conmutación entre primario y secundario fallida.	1
SwitchTime	string	El momento en que se realizó una conmutación entre primario y secundario. La hora sigue el estándar ISO 8601 en formato aaaa-mm-ddThh:mm:ssZ. La hora se muestra en UTC.	2023-02-07T18:00:00Z
SwitchCode	string	El código que indica el motivo de una conmutación entre primario y secundario. Valores válidos: USER_CONSOLE_OPERATION: La conmutación se realiza manualmente. OPERATION_AND_MAINTENANCE: Existen riesgos potenciales. MACHINE_DOWNTIME: El host está fuera de línea. PRIMARY_UNHEALTHY: Se produce una excepción en el nodo primario de la instancia. SECONDARY_UNHEALTHY: Se produce una excepción en el nodo secundario de la instancia. MULTIPLE_NODE_FAILURES: Se produce una excepción en varios nodos de la instancia.	USER_CONSOLE_OPERATION
NodeId	string	El ID de la instancia de conjunto de réplicas o el ID del nodo en el que se realiza una conmutación entre primario y secundario.	当实例为副本集实例：dds-uf68f1b5a57exxxx。当实例为分片集实例：d-uf652b73f554xxxx

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "ECBCA991-XXXX-XXXX-834C-B3E8007F33AA",
  "DBInstanceId": "dds-uf68f1b5a57exxxx",
  "TotalCount": 1,
  "PageSize": 30,
  "PageNumber": 1,
  "LogItems": [
    {
      "SwitchStatus": "1",
      "SwitchTime": "2023-02-07T18:00:00Z",
      "SwitchCode": "USER_CONSOLE_OPERATION",
      "NodeId": "NodeId-example-id-****"
    }
  ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParameterCombination	The end time must be greater than the start time	The start time must be earlier than the end time.

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.