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

Modifica la política de copia de seguridad avanzada.

Descripción de la operación

La copia de seguridad con georredundancia solo se aplica a las instancias de conjunto de réplicas de disco en la nube y de clúster fragmentado de disco en la nube.

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

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.	dds-2zeb2d64cb46xxxx
PreferredBackupTime	string	No	La hora para realizar la copia de seguridad. Especifique la hora en formato HH:mmZ-HH:mmZ (UTC). Nota El intervalo de tiempo está limitado a 1 hora.	09:00Z-10:00Z
SnapshotBackupType	string	No	El tipo de copia de seguridad de instantánea. Valores válidos: Flash: Copia de seguridad en segundos. Standard: Copia de seguridad estándar (predeterminada). Valores válidos: Standard : Copia de seguridad estándar (predeterminada) Flash : Copia de seguridad en segundos.	Standard
BackupRetentionPolicyOnClusterDeletion	integer	Sí	La política de retención de datos de copia de seguridad. 0: Elimina todos los conjuntos de copia de seguridad inmediatamente cuando se libera la instancia. 1: Aplica la retención a largo plazo (LTR) al último conjunto de copia de seguridad cuando se libera la instancia. 2: Aplica la retención a largo plazo (LTR) a todos los conjuntos de copia de seguridad cuando se libera la instancia. Valores válidos: 0 : Elimina todos los conjuntos de copia de seguridad inmediatamente. 1 : Aplica la retención a largo plazo (LTR) al último conjunto de copia de seguridad. 2 : Aplica la retención a largo plazo (LTR) a todos los conjuntos de copia de seguridad.	0
AdvancedBackupDataPolicies	array<object>	No	La lista de políticas de copia de seguridad.
	object	No
PolicyId	string	No	El ID de la política de copia de seguridad. Importante Este parámetro es obligatorio cuando ActionType no está establecido en CREATE.	xxxxxx
ActionType	string	Sí	El tipo de acción. Valores válidos: CREATE: Crear. UPDATE: Actualizar. DELETE: Eliminar. En este caso, solo se requiere el parámetro PolicyId. Valores válidos: DELETE : Eliminar. CREATE : Crear. UPDATE : Actualizar.	CREATE
RetentionType	string	No	El tipo de período de retención para los conjuntos de copia de seguridad. never: Retención a largo plazo (LTR). delay: Retención por un número fijo de días. Importante Este parámetro es obligatorio cuando ActionType no está establecido en DELETE. Valores válidos: never : Retención a largo plazo (LTR). delay : Retención por un número fijo de días.	delay
RetentionPeriod	integer	No	El número de días para retener el plan de copia de seguridad. Copia de seguridad en la misma región: de 7 a 7300 días. Copia de seguridad con georredundancia: de 3 a 1825 días. Importante Este parámetro es obligatorio cuando RetentionType está establecido en delay.	7
BackupPolicy	string	No	El tipo de programación de la política avanzada. Valores válidos: dayOfWeek: programación semanal. dayOfMonth: programación mensual. dayOfYear: programación anual. backupInterval: programación de intervalo fijo (copia de seguridad de alta frecuencia). Nota No se admiten múltiples políticas de copia de seguridad de alta frecuencia. No se admiten múltiples políticas de copia de seguridad con georredundancia, y las políticas de copia de seguridad con georredundancia solo admiten dayOfWeek. Importante Este parámetro es obligatorio cuando ActionType no está establecido en DELETE. Valores válidos: dayOfWeek : Programación semanal. dayOfMonth : Programación mensual. dayOfYear : Programación anual. backupInterval : Programación de intervalo fijo (copia de seguridad de alta frecuencia)	dayOfWeek
PreferredBackupPeriod	string	No	El ciclo de copia de seguridad. Si BackupPolicy está establecido en dayOfWeek: 1,2,3,4,5,6,7 indica de lunes a domingo. Se requieren al menos 2 copias de seguridad por semana. Si BackupPolicy está establecido en dayOfMonth: 1,3,-1 indica el día 1, el día 3 y el último día de cada mes. -1 indica el último día de cada mes. Si BackupPolicy está establecido en dayOfYear: 01-07 indica el 7 de enero. Solo se puede seleccionar un día. Si BackupPolicy está establecido en backupInterval: especifique uno de los siguientes valores en minutos. Para instancias de clúster fragmentado, los valores válidos son 30, 60, 120, 180, 240, 360, 480 y 720. Para instancias de conjunto de réplicas, los valores válidos son 15, 30, 60, 120, 180, 240, 360, 480 y 720. Importante Este parámetro es obligatorio cuando ActionType no está establecido en DELETE. Las políticas de copia de seguridad con georredundancia solo admiten dayOfWeek.	1,4,6
SrcRegion	string	No	La región donde reside la instancia. Importante Este parámetro es obligatorio cuando ActionType no está establecido en DELETE.	cn-guangzhou
SrcType	string	No	El tipo de origen de la política de copia de seguridad. db: copia de seguridad en la misma región. level1: copia de seguridad entre regiones. Importante Este parámetro es obligatorio cuando ActionType no está establecido en DELETE. Valores válidos: level1 : Copia de seguridad entre regiones. db : Copia de seguridad en la misma región.	db
DestRegion	string	No	La región de destino de la política de copia de seguridad. Importante Este parámetro es obligatorio cuando ActionType no está establecido en DELETE.	cn-guangzhou
DestType	string	No	El tipo de destino de la política de copia de seguridad. level1: copia de seguridad en la misma región. level2Cross: copia de seguridad entre regiones. Importante Este parámetro es obligatorio cuando ActionType no está establecido en DELETE. Valores válidos: level1 : Copia de seguridad en la misma región. level2Cross : Copia de seguridad entre regiones.	level1
PreserveOneEachHour	boolean	No	Especifica si se debe habilitar la copia de seguridad dispersa por hora. true: Cuando la frecuencia de copia de seguridad es a nivel de minutos, se retienen todas las instantáneas dentro de 1 hora a partir de la hora actual. Para las instantáneas que tienen más de 1 hora pero menos de 24 horas a partir de la hora actual, solo se retiene la primera instantánea después de cada hora completa. false: Se retienen todas las instantáneas dentro del período de retención de copia de seguridad de alta frecuencia.	False
AdvancedBackupLogPolicies	array<object>	No	La lista de políticas de copia de seguridad de registros.
	object	No
EnableLogBackup	integer	Sí	Especifica si se debe habilitar la copia de seguridad de registros. 1: Habilitado. 0: Deshabilitado. Nota La copia de seguridad de registros debe estar habilitada para las instancias de clúster fragmentado. La copia de seguridad de registros entre regiones requiere que la copia de seguridad de registros en la misma región esté habilitada primero. Valores válidos: 0 : Deshabilitado. 1 : Habilitado.	1
RetentionType	string	No	El tipo de período de retención para las copias de seguridad de registros. never: Retención a largo plazo (LTR). delay: Retención por un número fijo de días. Valores válidos: never : Retención a largo plazo (LTR). delay : Retención por un número fijo de días.	delay
RetentionPeriod	integer	No	El número de días para retener las copias de seguridad de registros. Este parámetro surte efecto cuando RetentionType está establecido en delay. Copia de seguridad en la misma región: de 7 a 7300 días. Copia de seguridad entre regiones: de 3 a 1825 días. El valor debe ser menor que el período de retención de copia de seguridad de la política de copia de seguridad con georredundancia.	7
SrcRegion	string	No	La región donde reside la instancia de origen.	cn-hangzhou
SrcType	string	No	El tipo de origen de la política de copia de seguridad de registros. db: copia de seguridad en la misma región. level1: copia de seguridad entre regiones. Valores válidos: level1 : Copia de seguridad entre regiones. db : Copia de seguridad en la misma región.	db
DestRegion	string	No	La región donde reside la copia de seguridad de registros entre regiones. Nota Este parámetro es obligatorio para la copia de seguridad con georredundancia.	cn-huhehaote
DestType	string	No	El tipo de destino de la política de copia de seguridad de registros. level1: copia de seguridad en la misma región. level2Cross: copia de seguridad entre regiones. Valores válidos: level1 : Copia de seguridad en la misma región. level2Cross : Copia de seguridad entre regiones.	level1
PolicyId	string	No	El ID de la política de copia de seguridad de registros. Este parámetro solo existe para las políticas de copia de seguridad de registros entre regiones y es obligatorio.	xxxx
ActionType	string	Sí	El tipo de acción. CREATE: Crear. UPDATE: Actualizar. Importante Este parámetro solo se aplica a la copia de seguridad con georredundancia. Para eliminar una copia de seguridad con georredundancia, use UPDATE y establezca EnableLogBackup en 0. Valores válidos: CREATE : Crear. UPDATE : Actualizar.	CREATE

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	2F42BB4E-461F-5B55-A37C-53B1141C****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "2F42BB4E-461F-5B55-A37C-53B1141C****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidPreferredBackupPeriod.Malformed	Specified parameter PreferredBackupPeriod is not valid.
400	InvalidPreferredBackupTime.Malformed	Specified parameter PreferredBackupTime is not valid.

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.