As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
StartDiscoveryJob
Executa uma tarefa deDataSync descoberta em seu sistema de armazenamento local. Se você ainda não adicionou o sistema de armazenamento aoDataSync Discovery, faça isso primeiro usando a AddStorageSystemoperação.
Sintaxe da solicitação
{
"ClientToken": "string",
"CollectionDurationMinutes": number,
"StorageSystemArn": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parâmetros de solicitação
Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte Parâmetros comuns.
A solicitação aceita os dados a seguir no formato JSON.
- ClientToken
-
Especifica um token de cliente para garantir que as solicitações com essa operação de API sejam idempotentes. Se você não especificar um token do cliente, o token do clienteDataSync gera um para você.
Tipo: string
Padrão:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}Obrigatório: Sim
- CollectionDurationMinutes
-
Especifique o trabalho de descoberta.
nota
Para recomendações mais precisas, recomendamos uma duração de pelo menos 14 dias. Durações mais longas permitem a coleta de um número suficiente de pontos de dados e fornecem uma representação realista do desempenho e da utilização do armazenamento.
Tipo: inteiro
Intervalo válido: valor mínimo de 60. Valor máximo 44640.
Obrigatório: Sim
- StorageSystemArn
-
Especifique o nome do recurso da Amazon (ARN) do sistema de armazenamento do local no qual deseja executar o trabalho de descoberta.
Tipo: String
Restrições de tamanho: tamanho máximo de 128.
Padrão:
^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}$Obrigatório: Sim
- Tags
-
Especifica rótulos que ajudam você a categorizar, filtrar e pesquisar seus recursos da AWS.
Tipo: matriz de objetos TagListEntry
Membros da matriz: número mínimo de 0 itens. Número máximo de 50 itens.
Obrigatório: não
Sintaxe da resposta
{
"DiscoveryJobArn": "string"
}Elementos de resposta
Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- DiscoveryJobArn
-
O ARN do trabalho de descoberta que você iniciou.
Tipo: String
Restrições de tamanhos: tamanho máximo de 256.
Padrão:
^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}$
Erros
Para obter informações sobre os erros comuns a todas as ações, consulteErros comuns.
- InternalException
-
Essa exceção é lançada quando ocorre um erro noAWS DataSync serviço.
Código de status HTTP: 500
- InvalidRequestException
-
Essa exceção é gerada quando o cliente envia uma solicitação mal formada.
Código de status HTTP: 400
Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
