ModifyMountTargetSecurityGroups - Amazon Elastic File System
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerBeispieleWeitere 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.

ModifyMountTargetSecurityGroups

Ändert den Satz der Sicherheitsgruppen, die für ein Mountingziel gültig sind.

Wenn Sie ein Mountingziel erstellen, wird in Amazon EFS auch eine neue Netzwerkschnittstelle erstellt. Weitere Informationen finden Sie unter CreateMountTarget. Durch diese Operation werden die Sicherheitsgruppen, die für die einem Mountingziel zugeordnete Netzwerkschnittstelle gelten, durch die in der Anforderung angegebenen SecurityGroups ersetzt. Sie setzt voraus, dass die Netzwerkschnittstelle des Mountingziels erstellt wurde und der Lebenszyklusstatus des Mountingziels nicht deleted lautet.

Die Operation erfordert Berechtigungen für die folgende Dateisystemaktion:

  • Aktion elasticfilesystem:ModifyMountTargetSecurityGroups im Dateisystem des Mountingziels.

  • Aktion ec2:ModifyNetworkInterfaceAttribute in der Netzwerkschnittstelle des Mountingziels.

Anforderungssyntax

PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json

{
   "SecurityGroups": [ "string" ]
}

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

MountTargetId

Die ID des Mountingziels, dessen Sicherheitsgruppen Sie ändern möchten.

Längenbeschränkungen: Mindestlänge von 13. Maximale Länge beträgt 45 Zeichen.

Pattern: ^fsmt-[0-9a-f]{8,40}$

Erforderlich: Ja

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

SecurityGroups

Ein Array von bis zu fünf VPC-Sicherheitsgruppen-IDs.

Typ: Zeichenfolgen-Array

Array-Mitglieder: Maximale Anzahl von 100 Elementen.

Längenbeschränkungen: Mindestlänge von 11. Maximale Länge von 43.

Pattern: ^sg-[0-9a-f]{8,40}

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 204

Antwortelemente

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP-204-Antwort mit leerem HTTP-Textinhalt zurück.

Fehler

BadRequest

Wird zurückgegeben, wenn die Anfrage fehlerhaft ist oder einen Fehler enthält, z. B. einen ungültigen Parameterwert oder einen fehlenden erforderlichen Parameter.

HTTP Status Code: 400

IncorrectMountTargetState

Wird zurückgegeben, wenn das Mountingziel nicht den richtigen Status für die Operation aufweist.

HTTP-Statuscode: 409

InternalServerError

Wird zurückgegeben, wenn auf der Serverseite ein Fehler aufgetreten ist.

HTTP Status Code: 500

MountTargetNotFound

Wird zurückgegeben, wenn kein Mountingzel mit der angegebenen ID im AWS-Konto des Aufrufers gefunden wurde.

HTTP Status Code: 404

SecurityGroupLimitExceeded

Wird zurückgegeben, wenn die in der Anforderung SecurityGroups angegebene Größe den Wert fünf überschreitet.

HTTP Status Code: 400

SecurityGroupNotFound

Wird zurückgegeben, wenn eine der angegebenen Sicherheitsgruppen nicht in der Virtual Private Cloud (VPC) des Subnetzes vorhanden ist.

HTTP Status Code: 400

Beispiele

Ersetzen der Sicherheitsgruppen eines Mountingziels

Im folgenden Beispiel werden die Sicherheitsgruppen, die für die einem Mountingziel zugeordnete Netzwerkschnittstelle gelten, ersetzt.

Beispielanforderung

PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57

{
  "SecurityGroups" : [
  "sg-188d9f74"
  ]
}

Beispielantwort

HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef

Weitere Informationen finden Sie unter:

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