CreateBackupPlan - AWS Backup
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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.

CreateBackupPlan

Crea un plan de copia de seguridad con el nombre del plan y las reglas de copia de seguridad. Un plan de respaldo es un documento que contiene información que se AWS Backup utiliza para programar tareas que crean puntos de recuperación de los recursos.

Si llama a CreateBackupPlan con un plan que ya existe, recibirá una excepción AlreadyExistsException.

Sintaxis de la solicitud

PUT /backup/plans/ HTTP/1.1
Content-type: application/json

{
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleName": "string",
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string"
         }
      ]
   },
   "BackupPlanTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string"
}

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

BackupPlan

El cuerpo de un plan de copia de seguridad. Incluye un BackupPlanName y uno o más conjuntos de Rules.

Tipo: objeto BackupPlanInput

Obligatorio: sí

BackupPlanTags

Las etiquetas que se van a asignar al plan de copia de seguridad.

Tipo: mapa de cadena a cadena

Obligatorio: no

CreatorRequestId

Identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Si la solicitud incluye un CreatorRequestId que coincide con un plan de copia de seguridad existente, se devuelve ese plan. Este parámetro es opcional.

Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-_”. caracteres.

Tipo: cadena

Requerido: no

Sintaxis de la respuesta

HTTP/1.1 200
Content-type: application/json

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "VersionId": "string"
}

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

AdvancedBackupSettings

La configuración para un tipo de recurso. Esta opción solo está disponible para los trabajos de copia de seguridad de Volume Shadow Copy Service (VSS) de Windows.

Tipo: matriz de objetos AdvancedBackupSetting

BackupPlanArn

Un nombre de recurso de Amazon (ARN) que identifica de forma única un plan de copia de seguridad; por ejemplo, arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50.

Tipo: cadena

BackupPlanId

El ID del plan de copia de seguridad.

Tipo: cadena

CreationDate

La fecha y la hora en que se creó el plan de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de CreationDate tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.

Tipo: marca temporal

VersionId

Cadenas cifradas en UTF-8, Unicode, únicas, generadas aleatoriamente que tienen como máximo una longitud de 1024 bytes. No es posible editarlos.

Tipo: cadena

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

AlreadyExistsException

El recurso ya existe.

Código de estado HTTP: 400

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

LimitExceededException

Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.

Código de estado HTTP: 400

MissingParameterValueException

Indica que falta un parámetro obligatorio.

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: