ModifyMountTargetSecurityGroups - Amazon Elastic File System
AnforderungssyntaxURIParameter anfordernAnforderungstextAntwortsyntaxAntwortelementeFehlerBeispieleWeitere 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 Mount-Ziel erstellen, erstellt Amazon EFS auch eine neue Netzwerkschnittstelle. 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" ]
}

URIParameter anfordern

Die Anfrage 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 Anfrage akzeptiert die folgenden Daten im JSON Format.

SecurityGroups

Ein Array mit bis zu fünf VPC SicherheitsgruppenIDs.

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, sendet der Dienst eine HTTP 204-Antwort mit einem leeren HTTP Text 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.

HTTPStatuscode: 400

IncorrectMountTargetState

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

HTTPStatuscode: 409

InternalServerError

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

HTTPStatuscode: 500

MountTargetNotFound

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

HTTPStatuscode: 404

SecurityGroupLimitExceeded

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

HTTPStatuscode: 400

SecurityGroupNotFound

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

HTTPStatuscode: 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 API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: