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:ModifyMountTargetSecurityGroupsim Dateisystem des Mountingziels. -
Aktion
ec2:ModifyNetworkInterfaceAttributein 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
-
Eine Reihe von 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.
- ErrorCode
-
Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten.
- Message
-
Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren.
HTTP Status Code: 400
- IncorrectMountTargetState
-
Wird zurückgegeben, wenn das Mountingziel nicht den richtigen Status für die Operation aufweist.
- ErrorCode
-
Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten.
- Message
-
Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren.
HTTP-Statuscode: 409
- InternalServerError
-
Wird zurückgegeben, wenn auf der Serverseite ein Fehler aufgetreten ist.
- ErrorCode
-
Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten.
- Message
-
Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren.
HTTP Status Code: 500
- MountTargetNotFound
-
Wird zurückgegeben, wenn kein Mountingzel mit der angegebenen ID im AWS-Konto des Aufrufers gefunden wurde.
- ErrorCode
-
Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten.
- Message
-
Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren.
HTTP Status Code: 404
- SecurityGroupLimitExceeded
-
Wird zurückgegeben, wenn die in der Anfrage
SecurityGroupsangegebene Anzahl von Objekten das Limit überschreitet, das auf dem Kontingent basiert. Löschen Sie entweder einige Sicherheitsgruppen oder fordern Sie eine Erhöhung des Kontokontingents an. Weitere Informationen finden Sie unter Amazon VPC-Kontingente im Amazon VPC-Benutzerhandbuch (siehe Tabelle mit Sicherheitsgruppen).- ErrorCode
-
Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten.
- Message
-
Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren.
HTTP Status Code: 400
- SecurityGroupNotFound
-
Wird zurückgegeben, wenn eine der angegebenen Sicherheitsgruppen nicht in der Virtual Private Cloud (VPC) des Subnetzes vorhanden ist.
- ErrorCode
-
Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten.
- Message
-
Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren.
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-456789abcdefWeitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs:
