Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
PutBackupVaultNotifications
Activa las notificaciones en un almacén de copias de seguridad para el tema y los eventos especificados.
Sintaxis de la solicitud
PUT /backup-vaults/backupVaultName
/notification-configuration HTTP/1.1
Content-type: application/json
{
"BackupVaultEvents": [ "string
" ],
"SNSTopicArn": "string
"
}
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- backupVaultName
-
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copia de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región de AWS donde se crearon.
Patrón:
^[a-zA-Z0-9\-\_]{2,50}$
Obligatorio: sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- BackupVaultEvents
-
Una matriz de eventos que indica el estado de los trabajos para realizar copias de seguridad de recursos en el almacén de copia de seguridad. Para ver la lista de eventos compatibles, casos de uso comunes y ejemplos de código, consulta Opciones de notificación con AWS Backup.
nota
La siguiente lista incluye eventos compatibles y obsoletos que ya no se utilizan (como referencia). Los eventos obsoletos no devolverán estados ni notificaciones.
Tipo: matriz de cadenas
Valores válidos:
BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED | COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED | RECOVERY_POINT_MODIFIED | BACKUP_PLAN_CREATED | BACKUP_PLAN_MODIFIED | S3_BACKUP_OBJECT_FAILED | S3_RESTORE_OBJECT_FAILED
Obligatorio: sí
- SNSTopicArn
-
El nombre de recurso de Amazon (ARN) que especifica el tema de los eventos de un almacén de copias de seguridad; por ejemplo,
arn:aws:sns:us-west-2:111122223333:MyVaultTopic
.Tipo: cadena
Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InvalidParameterValueException
-
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.
Código de estado HTTP: 400
- MissingParameterValueException
-
Indica que falta un parámetro obligatorio.
Código de estado HTTP: 400
- ResourceNotFoundException
-
No existe un recurso necesario para la acción.
Código de estado HTTP: 400
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
Código de estado HTTP: 500
Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: