Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
BatchUpdateCluster
Appliquez la mise à jour du service à la liste des clusters fournis. Pour plus d'informations sur les mises à jour de service et leur application, consultez la section Application des mises à jour de service.
Syntaxe de la requête
{
"ClusterNames": [ "string" ],
"ServiceUpdate": {
"ServiceUpdateNameToApply": "string"
}
}
Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- ClusterNames
-
Les noms des clusters pour appliquer les mises à jour.
Type : tableau de chaînes
Membres du tableau : nombre maximum de 20 éléments.
Obligatoire : oui
- ServiceUpdate
-
L'identifiant unique de la mise à jour du service
Type : objet ServiceUpdateRequest
Obligatoire : non
Syntaxe de la réponse
{
"ProcessedClusters": [
{
"ACLName": "string",
"ARN": "string",
"AutoMinorVersionUpgrade": boolean,
"AvailabilityMode": "string",
"ClusterEndpoint": {
"Address": "string",
"Port": number
},
"DataTiering": "string",
"Description": "string",
"Engine": "string",
"EnginePatchVersion": "string",
"EngineVersion": "string",
"IpDiscovery": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "string",
"Name": "string",
"NetworkType": "string",
"NodeType": "string",
"NumberOfShards": number,
"ParameterGroupName": "string",
"ParameterGroupStatus": "string",
"PendingUpdates": {
"ACLs": {
"ACLToApply": "string"
},
"Resharding": {
"SlotMigration": {
"ProgressPercentage": number
}
},
"ServiceUpdates": [
{
"ServiceUpdateName": "string",
"Status": "string"
}
]
},
"SecurityGroups": [
{
"SecurityGroupId": "string",
"Status": "string"
}
],
"Shards": [
{
"Name": "string",
"Nodes": [
{
"AvailabilityZone": "string",
"CreateTime": number,
"Endpoint": {
"Address": "string",
"Port": number
},
"Name": "string",
"Status": "string"
}
],
"NumberOfNodes": number,
"Slots": "string",
"Status": "string"
}
],
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SnsTopicStatus": "string",
"Status": "string",
"SubnetGroupName": "string",
"TLSEnabled": boolean
}
],
"UnprocessedClusters": [
{
"ClusterName": "string",
"ErrorMessage": "string",
"ErrorType": "string"
}
]
}
Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
- ProcessedClusters
-
La liste des clusters qui ont été mis à jour.
Type : tableau d’objets Cluster
- UnprocessedClusters
-
La liste des clusters pour lesquels aucune mise à jour n'a été appliquée.
Type : tableau d’objets UnprocessedCluster
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Types d'erreurs courants.
- InvalidParameterValueException
-
Code d’état HTTP : 400
- ServiceUpdateNotFoundFault
-
Code d’état HTTP : 400
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :