Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Attiva un AWS DataSync agente da distribuire nel tuo ambiente di storage. Il processo di attivazione associa l'agente al tuo. Account AWS
Se non hai ancora implementato un agente, vedi Ho bisogno di un DataSync agente?
Sintassi della richiesta
{
"ActivationKey": "string",
"AgentName": "string",
"SecurityGroupArns": [ "string" ],
"SubnetArns": [ "string" ],
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"VpcEndpointId": "string"
}Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- ActivationKey
-
Specifica la chiave di attivazione del tuo DataSync agente. Se non disponi di una chiave di attivazione, vedi Attivazione del tuo agente.
Tipo: stringa
Limiti di lunghezza: lunghezza massima di 29.
Modello:
[A-Z0-9]{5}(-[A-Z0-9]{5}){4}Campo obbligatorio: sì
- AgentName
-
Specificate un nome per il vostro agente. Ti consigliamo di specificare un nome facile da ricordare.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Modello:
^[a-zA-Z0-9\s+=._:@/-]+$Campo obbligatorio: no
- SecurityGroupArns
-
Speciifica l'Amazon Resource Name (ARN) del gruppo di sicurezza che consente il traffico tra l'agente e l'endpoint del servizio VPC. È possibile specificare un solo ARN.
Tipo: matrice di stringhe
Membri dell'array: numero minimo di 1 elemento.
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$Campo obbligatorio: no
- SubnetArns
-
Speciifica l'ARN della sottorete in cui si trova l'endpoint del servizio VPC. È possibile specificare un solo ARN.
Tipo: matrice di stringhe
Membri dell'array: numero minimo di 1 elemento.
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/.*$Campo obbligatorio: no
- Tags
-
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse. AWS Ti consigliamo di creare almeno un tag per il tuo agente.
Tipo: matrice di oggetti TagListEntry
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.
Campo obbligatorio: no
- VpcEndpointId
-
Specifica l'ID dell'endpoint del servizio VPC che stai utilizzando. Ad esempio, ha il seguente aspetto: un ID endpoint VPC.
vpce-01234d5aff67890e1Importante
L'endpoint del servizio VPC utilizzato deve includere il nome del DataSync servizio (ad esempio,).
com.amazonaws.us-east-2.datasyncTipo: stringa
Modello:
^vpce-[0-9a-f]{17}$Campo obbligatorio: no
Sintassi della risposta
{
"AgentArn": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- AgentArn
-
L'ARN dell'agente che hai appena attivato. Utilizzate l'ListAgentsoperazione per restituire un elenco di agenti nel vostro Account AWS and Regione AWS.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^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}$
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InternalException
-
Questa eccezione viene generata quando si verifica un errore nel AWS DataSync servizio.
Codice di stato HTTP: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
Esempi
Richiesta di esempio
L'esempio seguente attiva un agente. DataSync
{
"ActivationKey": "AAAAA-1AAAA-BB1CC-33333-EEEEE",
"AgentName": "MyAgent",
"Tags": [{
"Key": "Job",
"Value": "TransferJob-1"
}]
}Risposta di esempio
La risposta restituisce l'ARN dell'agente attivato.
{
"AgentArn": "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44baca3"
}Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
