DescribeLogBackupPolicy - PolarDB - Centro de documentación de Alibaba Cloud

Consulta la política de retención de datos para las copias de seguridad de registros de un clúster de PolarDB.

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

polardb:DescribeLogBackupPolicy

get

*dbcluster

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DBClusterId	string	Sí	El ID del clúster. Nota Puede llamar a la operación DescribeDBClusters para consultar la información de todos los clústeres en una región específica, incluidos los ID de los clústeres.	pc-*****************

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
LogBackupRetentionPeriod	integer	El período de retención de la copia de seguridad de registros. Valores válidos: 3 a 7300: La copia de seguridad de registros se conserva durante 3 a 7300 días. -1: Las copias de seguridad de registros se conservan permanentemente. Nota Si la función de copia de seguridad avanzada está habilitada, no se recomienda usar este parámetro. Utilice el parámetro AdvancedLogPolicies en su lugar.	7
RequestId	string	El ID de la solicitud.	62EE0051-102B-488D-9C79-D607B8******
LogBackupAnotherRegionRetentionPeriod	string	El período de retención de la copia de seguridad de registros entre regiones. Valores válidos: 0: La función de copia de seguridad de registros entre regiones está deshabilitada. 30 a 7300: La copia de seguridad de registros entre regiones se conserva durante 30 a 7300 días. -1: Las copias de seguridad de registros entre regiones se conservan permanentemente. Nota Al crear un clúster, el valor predeterminado es 0. Este valor indica que la función de copia de seguridad de registros entre regiones está deshabilitada. Si la función de copia de seguridad avanzada está habilitada, no se recomienda usar este parámetro. Utilice el parámetro AdvancedLogPolicies en su lugar.	0
LogBackupAnotherRegionRegion	string	La región en la que se almacena la copia de seguridad de registros entre regiones. Para obtener información sobre las regiones que admiten copias de seguridad entre regiones, consulte Visión general. Nota Si la función de copia de seguridad avanzada está habilitada, no se recomienda usar este parámetro. Utilice el parámetro AdvancedLogPolicies en su lugar.	cn-beijing
EnableBackupLog	integer	Indica si la función de copia de seguridad de registros está habilitada. Valores válidos: 0: La función está deshabilitada. 1: La función está habilitada. De forma predeterminada, la función de copia de seguridad de registros está habilitada y no se puede deshabilitar. Nota Si la función de copia de seguridad avanzada está habilitada, no se recomienda usar este parámetro. Utilice el parámetro AdvancedLogPolicies en su lugar.	1
AdvancedLogPolicies	object
AdvancedLogPolicy	array<object>	Los detalles de la política avanzada de copia de seguridad de registros. Nota PolarDB for PostgreSQL (compatible con Oracle) y PolarDB for PostgreSQL no son compatibles con este parámetro.
	object
PolicyId	string	El ID de la política de copia de seguridad de registros. Nota Este parámetro solo se devuelve para los clústeres que tienen habilitada la función de copia de seguridad de registros entre regiones.	1c75zkmqczcd1vbf6f6d05***
LogRetentionType	string	El tipo de retención para la copia de seguridad de registros. Valores válidos: never: Las copias de seguridad de registros nunca caducan. delay: Las copias de seguridad de registros se conservan durante un número específico de días.	delay
LogRetentionValue	string	El número de días para conservar las copias de seguridad de registros. Valores válidos: 3 a 7300: El período de retención en días. -1: Las copias de seguridad de registros se conservan permanentemente.	7
SrcType	string	El tipo de origen para la política de copia de seguridad de registros. Valores válidos: db: clúster de base de datos level1: copia de seguridad de nivel 1 level2: copia de seguridad de nivel 2 level2Cross: copia de seguridad de nivel 2 entre regiones	level1
DestType	string	El tipo de destino para la política de copia de seguridad de registros. Valores válidos: level1: copia de seguridad de nivel 1 level2: copia de seguridad de nivel 2 level2Cross: copia de seguridad de nivel 2 entre regiones	level2
EnableLogBackup	integer	Indica si la función de copia de seguridad de registros está habilitada. El valor devuelto puede ser: 1: habilitada 0: deshabilitada	1
SrcRegion	string	La región de origen de la política de copia de seguridad de registros.	cn-hangzhou
DestRegion	string	La región de destino de la política de copia de seguridad de registros.	cn-shanghai

Ejemplos

Respuesta exitosa

JSON Formato

{
  "LogBackupRetentionPeriod": 7,
  "RequestId": "62EE0051-102B-488D-9C79-D607B8******",
  "LogBackupAnotherRegionRetentionPeriod": "0",
  "LogBackupAnotherRegionRegion": "cn-beijing",
  "EnableBackupLog": 1,
  "AdvancedLogPolicies": {
    "AdvancedLogPolicy": [
      {
        "PolicyId": "1c75zkmqczcd1vbf6f6d05***",
        "LogRetentionType": "delay",
        "LogRetentionValue": "7",
        "SrcType": "level1",
        "DestType": "level2",
        "EnableLogBackup": 1,
        "SrcRegion": "cn-hangzhou",
        "DestRegion": "cn-shanghai"
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.
404	InvalidDBClusterId.NotFound	The DBInstanceId provided does not exist in our records.

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.