As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # CreateBackupPlan Cria um plano de backup usando o nome do plano de backup e as regras de backup. Um plano de backup é um documento que contém informações AWS Backup usadas para agendar tarefas que criam pontos de recuperação para recursos. Se chamar `CreateBackupPlan` com um plano existente, você receberá uma exceção `AlreadyExistsException`. ## Sintaxe da Solicitação ``` 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, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean } } ], "EnableContinuousBackup": boolean, "IndexActions": [ { "ResourceTypes": [ "string" ] } ], "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "RecoveryPointTags": { "string" : "string" }, "RuleName": "string", "ScanActions": [ { "MalwareScanner": "string", "ScanMode": "string" } ], "ScheduleExpression": "string", "ScheduleExpressionTimezone": "string", "StartWindowMinutes": number, "TargetBackupVaultName": "string", "TargetLogicallyAirGappedBackupVaultArn": "string" } ], "ScanSettings": [ { "MalwareScanner": "string", "ResourceTypes": [ "string" ], "ScannerRoleArn": "string" } ] }, "BackupPlanTags": { "string" : "string" }, "CreatorRequestId": "string" } ``` ## Parâmetros da solicitação de URI A solicitação não usa nenhum parâmetro de URI. ## Corpo da Solicitação A solicitação aceita os dados a seguir no formato JSON. ** [BackupPlan](#API_CreateBackupPlan_RequestSyntax) ** O corpo de um plano de backup. Inclui um `BackupPlanName` e um ou mais conjuntos de `Rules`. Tipo: objeto [BackupPlanInput](API_BackupPlanInput.md) Obrigatório: Sim ** [BackupPlanTags](#API_CreateBackupPlan_RequestSyntax) ** As tags a serem atribuídas ao plano de backup. Tipo: mapa de string para string Obrigatório: não ** [CreatorRequestId](#API_CreateBackupPlan_RequestSyntax) ** Identifica a solicitação e permite que as solicitações com falha sejam repetidas sem o risco de a operação ser executada duas vezes. Se a solicitação incluir um `CreatorRequestId` que corresponda a um plano de backup existente, esse plano será retornado. Esse parâmetro é opcional. Se usado, esse parâmetro deve conter de 1 a 50 caracteres alfanuméricos ou “-\$1” . Tipo: string Obrigatório: não ## Sintaxe da resposta ``` HTTP/1.1 200 Content-type: application/json { "AdvancedBackupSettings": [ { "BackupOptions": { "string" : "string" }, "ResourceType": "string" } ], "BackupPlanArn": "string", "BackupPlanId": "string", "CreationDate": number, "VersionId": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [AdvancedBackupSettings](#API_CreateBackupPlan_ResponseSyntax) ** As configurações de um tipo de recurso. Essa opção só está disponível para trabalhos de backup do Serviço de Cópias de Sombra de Volume (VSS) do Windows. Tipo: matriz de objetos [AdvancedBackupSetting](API_AdvancedBackupSetting.md) ** [BackupPlanArn](#API_CreateBackupPlan_ResponseSyntax) ** Um Nome do recurso da Amazon (ARN) que identifica de forma exclusiva um plano de backup, por exemplo, `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`. Tipo: string ** [BackupPlanId](#API_CreateBackupPlan_ResponseSyntax) ** O ID do plano de backup. Tipo: string ** [CreationDate](#API_CreateBackupPlan_ResponseSyntax) ** A data e hora em que o plano de backup foi criado, em formato de hora Unix e Tempo Universal Coordenado (UTC). O valor de `CreationDate` tem precisão de milissegundos. Por exemplo, o valor 1516925490,087 representa sexta-feira, 26 de janeiro de 2018, 0:11:30,087. Tipo: Timestamp ** [VersionId](#API_CreateBackupPlan_ResponseSyntax) ** Strings Unicode exclusivas geradas aleatoriamente, codificadas em UTF-8 que têm no máximo 1.024 bytes. Eles não podem ser editados. Tipo: string ## Erros Para obter informações sobre os erros comuns a todas as ações, consulte [Tipos de erro comuns](CommonErrors.md). ** AlreadyExistsException ** O recurso necessário já existe. ** Arn ** ** Context ** ** CreatorRequestId ** ** Type ** Código de status HTTP: 400 ** InvalidParameterValueException ** Indica que há algo errado com o valor de um parâmetro. Por exemplo, o valor está fora do intervalo. ** Context ** ** Type ** Código de status HTTP: 400 ** LimitExceededException ** Um limite na solicitação foi excedido; por exemplo, o número máximo de itens permitidos em uma solicitação. ** Context ** ** Type ** Código de status HTTP: 400 ** MissingParameterValueException ** Indica que um parâmetro necessário está ausente. ** Context ** ** Type ** Código de status HTTP: 400 ** ServiceUnavailableException ** Houve falha na solicitação devido a um erro temporário do servidor. ** Context ** ** Type ** Código de status HTTP: 500 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupPlan) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupPlan) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupPlan) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupPlan)