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à.
DescribeLocationS3
Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento per un bucket S3.
Sintassi della richiesta
{
"LocationArn": "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.
- LocationArn
-
Speciifica l'Amazon Resource Name (ARN) della posizione Amazon S3.
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}:location/loc-[0-9a-z]{17}$Campo obbligatorio: sì
Sintassi della risposta
{
"AgentArns": [ "string" ],
"CreationTime": number,
"LocationArn": "string",
"LocationUri": "string",
"S3Config": {
"BucketAccessRoleArn": "string"
},
"S3StorageClass": "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.
- AgentArns
-
Gli DataSync agenti distribuiti sul tuo Outpost quando utilizzi Amazon S3 su Outposts. ARNs
Per ulteriori informazioni, consulta Deploy your agent on. DataSync AWS Outposts
Tipo: matrice di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 4 articoli.
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}$ - CreationTime
-
L'ora in cui è stata creata la sede Amazon S3.
Tipo: Timestamp
- LocationArn
-
L'ARN della sede Amazon S3.
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}:location/loc-[0-9a-z]{17}$ - LocationUri
-
L'URL della posizione Amazon S3 descritta.
Tipo: stringa
Vincoli di lunghezza: lunghezza massima di 4360.
Modello:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - S3Config
-
Speciifica l'Amazon Resource Name (ARN) AWS Identity and Access Management del ruolo DataSync (IAM) utilizzato per accedere al bucket S3.
Per ulteriori informazioni, consulta Fornire l' DataSync accesso ai bucket S3.
Tipo: oggetto S3Config
- S3StorageClass
-
Quando Amazon S3 è una posizione di destinazione, questa è la classe di storage che hai scelto per i tuoi oggetti.
Alcune classi di storage hanno comportamenti che possono influire sui costi di storage di Amazon S3. Per ulteriori informazioni, consulta Considerazioni sulla classe di storage con i trasferimenti Amazon S3.
Tipo: stringa
Valori validi:
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InternalException
-
Questa eccezione viene generata quando si verifica un errore nel servizio. AWS DataSync
Codice di stato HTTP: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
Esempi
Esempio
L'esempio seguente restituisce informazioni sulla posizione Amazon S3 specificata nella richiesta di esempio.
Richiesta di esempio
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}Esempio
Questo esempio illustra un utilizzo di DescribeLocation S3.
Risposta di esempio
{
"CreationTime": 1532660733.39,
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
"LocationUri": "s3://amzn-s3-demo-bucket",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role",
}
"S3StorageClass": "STANDARD"
}Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
