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á.
AddStorageSystem
Cria um AWS recurso para um sistema de armazenamento local sobre o qual você deseja que o DataSync Discovery colete informações.
Sintaxe da solicitação
{
"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 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.
- AgentArns
-
Especifica o nome do recurso da Amazon (ARN) do DataSync agente que se conecta e lê a partir da interface de gerenciamento do seu sistema de armazenamento local.
Tipo: matriz de strings
Membros da matriz: número fixo de 1 item.
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}:agent/agent-[0-9a-z]{17}$Obrigatório: Sim
- 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 de cliente, DataSync gerará um automaticamente.
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
- CloudWatchLogGroupArn
-
Especifica o ARN do grupo de registros da Amazon para monitorar e CloudWatch registrar eventos de trabalho de descoberta.
Tipo: String
Restrições de tamanho: tamanho máximo de 562.
Padrão:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$Obrigatório: não
- Credentials
-
Especifica o nome do usuário e a senha para acessar a interface de gerenciamento do seu sistema de armazenamento local.
Tipo: objeto Credentials
Obrigatório: Sim
- Name
-
Especifica um nome familiar para seu sistema de armazenamento local.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.
Padrão:
^[\p{L}\p{M}\p{N}\s+=._:@\/-]+$Obrigatório: não
- ServerConfiguration
-
Especifica o nome do servidor e a porta de rede necessários para se conectar à interface de gerenciamento do seu sistema de armazenamento local.
Tipo: objeto DiscoveryServerConfiguration
Obrigatório: Sim
- SystemType
-
Especifica o tipo de sistema de armazenamento local sobre o qual você deseja que o DataSync Discovery colete informações.
nota
DataSyncAtualmente, o Discovery oferece suporte a sistemas NetApp Fabric-Attached Storage (FAS) e All Flash FAS (AFF) executando o ONTAP 9.7 ou posterior.
Tipo: String
Valores válidos:
NetAppONTAPObrigatório: Sim
- Tags
-
Especifica rótulos que ajudam você a categorizar, filtrar e pesquisar seus recursos da AWS. Recomendamos criar pelo menos uma etiqueta de nome para o seu sistema de armazenamento local.
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
{
"StorageSystemArn": "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.
- StorageSystemArn
-
O ARN do sistema de armazenamento local que você pode usar com DataSync o Discovery.
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}$
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 no AWS DataSync serviço.
Código de status HTTP: 500
- InvalidRequestException
-
Essa exceção é lançada quando o cliente envia uma solicitação malformada.
Código de status HTTP: 400
Exemplos
Exemplo de solicitação
O exemplo a seguir adiciona um sistema de armazenamento local ao 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" } }
Exemplo de resposta
Uma resposta retorna o ARN do sistema de armazenamento local que você acabou de adicionar ao DataSync Discovery.
{ "StorageSystemArn": "arn:aws:datasync:us-east-1:111222333444:system/storage-system-abcdef01234567890" }
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:
