Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
AddStorageSystem
Crea un AWS recurso para un sistema de almacenamiento en las instalaciones sobre el que DataSync Discovery va a recopilar información.
Sintaxis de la solicitud
{
"AgentArns": [ "string" ],
"ClientToken": "string",
"CloudWatchLogGroupArn": "string",
"Credentials": {
"Password": "string",
"Username": "string"
},
"Name": "string",
"ServerConfiguration": {
"ServerHostname": "string",
"ServerPort": number
},
"SystemType": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parámetros de solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en formato JSON.
- AgentArns
-
Especifica el nombre de recurso de Amazon (ARN) del DataSync agente que se conecta a la interfaz de administración del sistema de almacenamiento en las instalaciones y que lee desde el sistema de almacenamiento en las instalaciones.
Tipo: matriz de cadenas
Miembros de la matriz: número fijo de 1 elemento.
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$Obligatorio: sí
- ClientToken
-
Especifica un token de cliente para garantizar que las solicitudes con esta operación de API sean idempotentes. Si no especifica un token de cliente, DataSync genera uno de un uno de en el.
Tipo: String
Patrón:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}Obligatorio: sí
- CloudWatchLogGroupArn
-
Especifica el ARN del grupo de CloudWatch registros de Amazon para monitorear y registrar los eventos del trabajo de detección.
Tipo: String
Limitaciones de longitud máxima máxima máxima máxima máxima máxima máxima máxima máxima máxima máxima máxima máxima máxima de
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$Obligatorio: no
- Credentials
-
Especifica el nombre de usuario y la contraseña para acceder a la interfaz de administración del sistema de almacenamiento en las instalaciones.
Tipo: objeto Credentials
Obligatorio: sí
- Name
-
Especifica un nombre conocido para el sistema de almacenamiento local.
Tipo: String
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.
Patrón:
^[\p{L}\p{M}\p{N}\s+=._:@\/-]+$Obligatorio: no
- ServerConfiguration
-
Especifica el nombre del servidor y el puerto de red necesarios para conectarse a la interfaz de administración del sistema de almacenamiento local.
Tipo: objeto DiscoveryServerConfiguration
Obligatorio: sí
- SystemType
-
Especifica el tipo de sistema de almacenamiento local sobre el que desea que DataSync Discovery recopile información.
nota
DataSyncActualmente, Discovery es compatible NetApp con los sistemas de almacenamiento conectado a estructura (FAS) y All Flash FAS (AFF) que ejecutan ONTAP 9.7 o versiones posteriores.
Tipo: String
Valores válidos:
NetAppONTAPObligatorio: sí
- Tags
-
Especifica las etiquetas que le ayudan a clasificar, filtrar y buscar sus recursos de AWS. Le recomendamos crear al menos un nombre para el sistema de almacenamiento en las instalaciones.
Tipo: Matriz de objetos TagListEntry
Miembros de la matriz: número mínimo de 0 elementos. Número máximo de 50 elementos.
Obligatorio: no
Sintaxis de la respuesta
{
"StorageSystemArn": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- StorageSystemArn
-
El ARN del sistema de almacenamiento local que puede usar con DataSync Discovery.
Tipo: String
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$
Errores
Para obtener información sobre los errores comunes a todas las acciones, consulteErrores comunes.
- InternalException
-
Esta excepción se produce cuando se produce un error en el AWS DataSync servicio.
Código de estado HTTP: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con formato incorrecto.
Código de estado HTTP: 400
Ejemplos
Solicitud de muestra
El siguiente ejemplo agrega un sistema de almacenamiento local a DataSync Discovery.
{ "ServerConfiguration": { "ServerHostname": "172.16.0.0", "ServerPort": 443 }, "SystemType": "NetAppONTAP", "AgentArns": [ "arn:aws:datasync:us-east-1:111222333444:agent/agent-012345abcde012345" ], "CloudWatchLogGroupArn": "arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync/discovery:*", "Tags": [ { "Key": "Migration Plan", "Value": "1" } ], "Name": "MyOnPremStorage", "Credentials": { "Username": "admin", "Password": "1234" } }
Respuesta de ejemplo
Una respuesta devuelve el ARN del sistema de almacenamiento local que acaba de agregar a DataSync Discovery.
{ "StorageSystemArn": "arn:aws:datasync:us-east-1:111222333444:system/storage-system-abcdef01234567890" }
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
