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.
StartDiscoveryJob
Ejecuta un trabajo deDataSync detección en su sistema de almacenamiento local. Si aún no ha agregado el sistema de almacenamiento aDataSync Discovery, hágalo primero mediante la AddStorageSystemoperación.
Sintaxis de la solicitud
{
"ClientToken": "string",
"CollectionDurationMinutes": number,
"StorageSystemArn": "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.
- 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 forma automática.
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í
- CollectionDurationMinutes
-
Especifica en minutos cuánto tiempo de ejecución desea que tenga la.
nota
Para obtener recomendaciones más precisas, recomendamos una duración de al menos 14 días. Las duraciones más largas permiten recopilar una cantidad suficiente de puntos de datos y proporcionan una representación realista del rendimiento y la utilización del almacenamiento.
Tipo: entero
Rango válido: valor mínimo de 60. Valor máximo de 44640.
Obligatorio: sí
- StorageSystemArn
-
Especifica el nombre de recurso de Amazon (ARN) del sistema de almacenamiento local en el que desea ejecutar el trabajo de descubrimiento.
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}$Obligatorio: sí
- Tags
-
Especifica las etiquetas que le ayudan a clasificar, filtrar y buscar sus recursos de AWS.
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
{
"DiscoveryJobArn": "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.
- DiscoveryJobArn
-
El ARN del trabajo de descubrimiento que ha iniciado.
Tipo: String
Limitaciones de longitud: longitud máxima de 256.
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}/job/discovery-job-[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 elAWS 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
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:
