UpdateRecoveryPointIndexSettings - AWS Backup
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

UpdateRecoveryPointIndexSettings

Dieser Vorgang aktualisiert die Einstellungen eines Wiederherstellungspunktindexes.

Erforderlich: BackupVaultName RecoveryPointArn, und IAMRole Arn

Anforderungssyntax

POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
Content-type: application/json

{
   "IamRoleArn": "string",
   "Index": "string"
}

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

backupVaultName

Der Name eines logischen Containers, in dem die Sicherungen gespeichert werden. Backup-Tresore werden durch Namen identifiziert, die für das Konto, mit dem sie erstellt wurden, und die -Region, in der sie erstellt wurden, eindeutig sind.

Zu den zulässigen Zeichen gehören Kleinbuchstaben, Zahlen und Bindestriche.

Pattern: ^[a-zA-Z0-9\-\_]{2,50}$

Erforderlich: Ja

recoveryPointArn

Ein ARN, der einen Wiederherstellungspunkt eindeutig identifiziert, z. B. arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

Erforderlich: Ja

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

IamRoleArn

Dies gibt den ARN der IAM-Rolle an, der für diesen Vorgang verwendet wird.

Zum Beispiel arn:aws:iam: :123456789012:role/S3Access

Typ: Zeichenfolge

Erforderlich: Nein

Index

Der Index kann einen von 2 möglichen Werten haben, entweder oder. ENABLED DISABLED

Um einen Backup-Index für einen geeigneten ACTIVE Recovery Point zu erstellen, der noch keinen Backup-Index hat, legen Sie den Wert auf festENABLED.

Um einen Backup-Index zu löschen, legen Sie den Wert auf festDISABLED.

Typ: Zeichenfolge

Zulässige Werte: ENABLED | DISABLED

Erforderlich: Ja

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultName": "string",
   "Index": "string",
   "IndexStatus": "string",
   "RecoveryPointArn": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

BackupVaultName

Der Name eines logischen Containers, in dem die Sicherungen gespeichert werden. Backup-Tresore werden durch Namen identifiziert, die für das Konto, mit dem sie erstellt wurden, und die -Region, in der sie erstellt wurden, eindeutig sind.

Typ: Zeichenfolge

Pattern: ^[a-zA-Z0-9\-\_]{2,50}$

Index

Der Index kann einen von 2 möglichen Werten haben, entweder ENABLED oderDISABLED.

Der Wert ENABLED bedeutet, dass ein Backup-Index für einen geeigneten ACTIVE Recovery Point erstellt wurde.

Der Wert DISABLED bedeutet, dass ein Backup-Index gelöscht wurde.

Typ: Zeichenfolge

Zulässige Werte: ENABLED | DISABLED

IndexStatus

Dies ist der aktuelle Status für den Backup-Index, der dem angegebenen Wiederherstellungspunkt zugeordnet ist.

Die Status sind: PENDING | | ACTIVE | FAILED DELETING

Ein Wiederherstellungspunkt mit einem Index, der den Status von hat, ACTIVE kann in eine Suche aufgenommen werden.

Typ: Zeichenfolge

Zulässige Werte: PENDING | ACTIVE | FAILED | DELETING

RecoveryPointArn

Ein ARN, der einen Wiederherstellungspunkt eindeutig identifiziert, z. B. arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

Typ: Zeichenfolge

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

InvalidParameterValueException

Zeigt an, dass etwas mit dem Wert eines Parameters nicht stimmt. Beispielsweise liegt der Wert außerhalb des zulässigen Bereichs.

Context

Type

HTTP Status Code: 400

InvalidRequestException

Zeigt an, dass etwas mit der Eingabe für die Anforderung nicht stimmt. Beispielsweise ist ein Parameter vom falschen Typ.

Context

Type

HTTP Status Code: 400

MissingParameterValueException

Zeigt an, dass ein erforderlicher Parameter fehlt.

Context

Type

HTTP Status Code: 400

ResourceNotFoundException

Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden.

Context

Type

HTTP Status Code: 400

ServiceUnavailableException

Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.

Context

Type

HTTP Status Code: 500

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: